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

• Claude Code
• Node.js 18+ (used by the setup command)

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

1. 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.
2. 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.

Licensing

This package is MIT licensed. The vendored rule bundle under rules/ comes from awslabs/aidlc-workflows and is licensed MIT-0; see NOTICE.