codex-aidlc-plugin

A Codex plugin that adds the AWS AI-DLC workflow as a Codex skill and vendors the official awslabs/aidlc-workflows rule bundle for project-local use.

This is the Codex counterpart to dynamicdevs/opencode-aidlc-plugin.

What you get

One Codex skill wrapping the AI-DLC adaptive workflow and recognizing the same command-style intents as the OpenCode plugin:

| Intent | Purpose | | ---------------- | ------------------------------------------------------------- | | /aidlc | 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 generation) | | /aidlc-test | Generate and run build and test | | /aidlc-status | Read-only workflow status | | /aidlc-resume | Resume an in-progress AI-DLC project | | /aidlc-refine | Amend intent, units, or design without losing state | | /aidlc-reflect | Retrospective of the AI-DLC cycle |

The skill references AI-DLC rules at .aidlc/aidlc-rules/aws-aidlc-rules/core-workflow.md. The helper scripts install that rule bundle into your project when needed.

Requirements

• Codex with local plugin support
• Node.js 18+ for the cross-platform helper and validation scripts
• PowerShell 7+ only if you prefer the PowerShell helper

Install

Load this directory as a local Codex plugin. The plugin manifest lives at:

.codex-plugin/plugin.json

The package also exposes an npx setup command for installing the AI-DLC rule bundle into a project:

npx codex-aidlc-plugin@latest setup

or with an explicit target:

npx codex-aidlc-plugin@latest setup --root /path/to/project

From a local checkout, run one of the helpers:

node scripts/install-aidlc-rules.js --root /path/to/project

or:

.\scripts\install-aidlc-rules.ps1 -Root C:\path\to\project

This will copy the vendored rules into:

<project>/.aidlc/aidlc-rules/

Existing project rules are skipped by default so customized rules are not overwritten.

Options

npx codex-aidlc-plugin@latest setup --root /path/to/project --force

node scripts/install-aidlc-rules.js --root /path/to/project --force

.\scripts\install-aidlc-rules.ps1 -Root C:\path\to\project -Force

Use --force or -Force only when you intentionally want to replace an existing .aidlc/aidlc-rules/ directory.

Usage

Once the plugin is available to Codex, ask for AI-DLC directly:

Using AI-DLC, build a feature that lets users export reports.

Or use an OpenCode-compatible command-style prompt:

/aidlc-analyze src/auth

The skill loads the AI-DLC core workflow, resolves project-local or vendored rule details, writes workflow artifacts under aidlc-docs/, and honors the AWS AI-DLC approval gates.

Updating

To refresh project-local rules after updating this plugin, rerun the installer with force:

node scripts/install-aidlc-rules.js --root /path/to/project --force

Your project's .aidlc/aidlc-rules/ directory is never overwritten unless force is explicitly used.

How it relates to Codex plugins

This is a regular Codex plugin. Its runtime behavior is delivered through the aidlc skill under skills/aidlc/SKILL.md; there are no MCP servers or app connectors required.

Maintainer notes

npm run validate

Publishing is tag-driven. After merging a version bump, create and push a matching semver tag:

git tag v0.1.0
git push origin v0.1.0

The GitHub Actions publish workflow verifies that the tag matches both package.json and .codex-plugin/plugin.json, then publishes to npm using the NPM_TOKEN repository secret.

The validation script checks:

• .codex-plugin/plugin.json
• skills/aidlc/SKILL.md
• vendored AI-DLC rule locations
• both Node and PowerShell installer behavior when available

To bump the vendored AWS AI-DLC rules, update skills/aidlc/references/aidlc-rules/ from the desired awslabs/aidlc-workflows release and update NOTICE.

Author

Built by Jonathan Gonzalez at Dynamic Devs - [email protected].

Licensing

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