⚡
Claude Code Tools
← plugins

claudecode-aidlc

official

Claude Code plugin that adds AWS AI-DLC slash commands and installs the awslabs AI-DLC rule bundle

Version
0.4.0
Last Updated
2026-06-14
Source
official
View Repository → Homepage →

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:

  • /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

  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 (jgonzalez@dynamicdevs.io) and Mauricio De Juan (mdejuan@dynamicdevs.io) at Dynamic Devs.

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.