claudecode-aidlc
A Claude Code plugin that adds the
AWS AI-DLC workflow as slash commands and installs the official
awslabs/aidlc-workflows rule bundle
into your project.
Adapted for Claude Code from the original
opencode-aidlc plugin.
What you get
Nine slash commands wrapping the AI-DLC adaptive workflow:
| Command | Purpose |
|---|
/aidlc:start | Start the AI-DLC workflow on a new intent |
/aidlc:analyze | Reverse-engineer an existing codebase (brownfield) |
/aidlc:plan | Generate or refresh the execution plan for approval |
/aidlc:build | Run the Construction phase (per-unit design + code gen) |
/aidlc:test | Generate and run build & test |
/aidlc:status | Read-only workflow status |
/aidlc:resume | Resume an in-progress AI-DLC project |
/aidlc:refine | Amend intent / units / design without losing state |
/aidlc:reflect | Retrospective of the AI-DLC cycle |
The commands reference the AI-DLC rules at
.aidlc/aidlc-rules/aws-aidlc-rules/core-workflow.md, which setup installs for
you.
Requirements
Install
There are two ways to get the commands. Either way, you still run setup once
per project to install the AI-DLC rule bundle into .aidlc/.
Option A — install as a plugin (recommended)
Add the marketplace and install the plugin from inside Claude Code:
/plugin marketplace add dynamicdevs/claudecode-aidlc-plugin
/plugin install aidlc@dynamicdevs-aidlc
Claude Code auto-discovers the nine commands from the plugin — no copy step is
needed. Then, in your project, install the rule bundle:
npx claudecode-aidlc@latest setup
Option B — copy commands into the project (no marketplace)
If you'd rather keep the commands as plain project/user-level command files,
let setup copy them for you:
# project-level: .claude/commands + ./.aidlc rules
npx claudecode-aidlc@latest setup --copy-commands
# user-level: ~/.claude/commands
npx claudecode-aidlc@latest setup --copy-commands --global
What setup does
- Installs the AI-DLC rule bundle into
.aidlc/aidlc-rules/ only if it does
not already exist — it never overwrites rules you have customized. The
latest release is downloaded from awslabs/aidlc-workflows; if you are offline,
a copy vendored in this plugin is used instead.
- With
--copy-commands, also copies the nine command files into
.claude/commands/aidlc/ (or ~/.claude/commands/ with --global).
Options
npx claudecode-aidlc setup --copy-commands # copy commands to .claude/commands/aidlc
npx claudecode-aidlc setup --global # with --copy-commands, use ~/.claude/commands
npx claudecode-aidlc setup --force # overwrite existing command files
npx claudecode-aidlc setup --no-rules # skip installing the rule bundle
Rules are always installed at the project level (in ./.aidlc/), even with
--global, because they live alongside aidlc-docs/ for each project.
Pin it as a project dependency (optional)
If you'd rather lock the version in your repo instead of using @latest:
npm install -D claudecode-aidlc # or: pnpm add -D claudecode-aidlc
npx claudecode-aidlc setup
Updating
To pull the latest upstream rules, delete .aidlc/aidlc-rules/ and re-run
setup. Your existing rules are never overwritten in place.
If you installed via the marketplace, update the plugin from Claude Code:
/plugin marketplace update dynamicdevs-aidlc
With --copy-commands, re-run setup --copy-commands --force to refresh the
command files.
How it relates to Claude Code plugins
This is a standard Claude Code plugin: .claude-plugin/plugin.json declares the
plugin and points commands at ./commands, which Claude Code auto-discovers.
.claude-plugin/marketplace.json lets users add it as a single-plugin
marketplace. There are no runtime hooks today — all behavior is delivered
through the slash commands and the rule bundle installed by setup.
Author
Built by Jonathan González at Dynamic Devs —
[email protected].
Maintainer notes
npm run build # regenerate commands/*.md from src/commands.js
npm run vendor:rules # refresh the offline rules/ bundle from the pinned release
To bump the vendored rules, update PINNED_VERSION in src/rules.js and run
npm run vendor:rules.
