aidlc-workflows README

The project's README from github.com/awslabs/aidlc-workflows. As one markdown file: README.md.

AI-DLC - one core, many harnesses

AI-DLC (AI-Driven Development Life Cycle) turns AI coding assistants into structured, verifiable software-delivery workflows. One harness-neutral core runs natively in Claude Code, Kiro CLI, Kiro IDE, Codex CLI, Cursor, opencode, and GitHub Copilot.

version license

The Quick Start below installs the latest stable AI-DLC release.

Quick Start

1. Install AI-DLC

macOS, Linux, or WSL:

curl -fsSL https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.sh | sh

Windows PowerShell:

irm https://github.com/awslabs/aidlc-workflows/releases/latest/download/install.ps1 | iex

The installer adds the native aidlc command and every harness runtime. Bun and Node.js are not required. If your shell cannot find aidlc, follow the PATH instruction printed by the installer or start a new shell.

Prefer to manage the project files manually? Install the matching native aidlc command, download aidlc-runtime-X.Y.Z.tar.gz from the release, and copy runtime/<harness>/ into your project.

2. Configure a project

From the project root, select the harness you use:

cd /path/to/your-project
aidlc config --harness claude
aidlc doctor

Replace claude with kiro, kiro-ide, codex, cursor, opencode, or copilot. Running aidlc config without --harness starts the interactive setup when a terminal is available.

3. Start a workflow

Open your harness in the configured project and describe the work:

/aidlc Build a REST API for inventory management

Codex CLI uses $aidlc instead of /aidlc. AI-DLC selects a workflow from the request, asks for missing decisions, and stops at approval gates before moving forward.

For provider setup, trust prompts, and harness-specific prerequisites, use the guide in the table below. The complete walkthrough is in Getting Started.

Pick your harness

Harness Configure Open Invoke Guide
Claude Code aidlc config --harness claude claude /aidlc Getting Started
Kiro CLI >= 2.6 aidlc config --harness kiro kiro-cli chat /aidlc Kiro CLI
Kiro IDE aidlc config --harness kiro-ide Open the project /aidlc Kiro IDE
Codex CLI >= 0.145.0 aidlc config --harness codex codex $aidlc Codex CLI
Cursor aidlc config --harness cursor Open Cursor or run agent /aidlc Cursor
opencode >= 1.17 aidlc config --harness opencode opencode /aidlc opencode
GitHub Copilot CLI >= 1.0.74 / VS Code >= 1.130 aidlc config --harness copilot Copilot CLI or VS Code /aidlc GitHub Copilot

Model-provider setup belongs to the harness. Claude Code and the shipped Codex configuration default to Amazon Bedrock; GitHub Copilot uses GitHub sign-in or BYOK; Kiro, Cursor, and opencode use their configured provider. The methodology itself is provider-independent.

AI-DLC works best with capable reasoning models. The current recommended model is Claude Opus 4.8.

Why AI-DLC

Ad-hoc AI coding loses context as projects grow. AI-DLC keeps requirements, decisions, implementation, tests, and operational work connected through one audited lifecycle:

Start with Workflow Profiles to compare Classic, Express, and the focused workflows. See the AI-DLC Workflows 2.0 Specification for the architecture and methodology.

[!IMPORTANT] Generative AI can make mistakes. Review generated output and costs before acting on them. See the AWS Responsible AI Policy.

Documentation

Guide Use it when
Getting Started Installing, configuring, and running your first workflow
User Guide Using workflows, profiles, agents, knowledge, and approval gates
Harness guides Handling provider, trust, and runtime differences
Install and Lifecycle Updating, pinning, installing offline, using mirrors, or uninstalling
Harness Engineer Guide Reshaping stages, agents, rules, sensors, and knowledge
Developer Reference Changing the engine, hooks, packaging, or tests

Repository Layout

Edit core/ or harness/<name>/, never generated dist* output.

Development

Install dependencies and generate every harness:

bun install --frozen-lockfile
bun scripts/package.ts

Useful commands:

bun scripts/package.ts <name>     # generate one harness
bun scripts/package.ts --check    # determinism guard
bun tests/run-tests.ts --ci       # smoke, unit, and integration
bun tests/run-tests.ts --release  # full release acceptance

See the Contributing Guide for the complete development workflow and Porting to a New Harness to add another runtime.

Troubleshooting

Run aidlc doctor from the project root first. Common fixes:

Symptom Fix
aidlc is not found Apply the PATH instruction printed by the installer or start a new shell
Project/runtime version skew Finish the active workflow, then run aidlc config
Codex hooks do not run Trust the project hooks as described in the Codex guide
Bedrock access fails Enable the configured models and verify AWS credentials and region
Plugin stages disappear after refresh Run /aidlc plugin sync
Refreshed skills do not take effect Start a new harness session

See Troubleshooting for diagnostic and recovery procedures.

References

aidlc-workflows (awslabs/aidlc-workflows)

Searching Database…

Что это такое?AI-DLC превращает ИИ-ассистентов для программирования в структурированные, проверяемые процессы разработки ПО. Одно и то же ядро, не привязанное к конкретному харнессу, работает в Claude Code, Kiro, Codex CLI, Cursor, opencode и GitHub Copilot.
Это отдельное приложение или оно подключается к моему текущему агенту для программирования?Это не отдельное приложение, а движок рабочих процессов, не привязанный к конкретному харнессу (14 агентов, 33 этапа, журнал аудита из 95 событий). Он устанавливается как набор правил и команд внутри агентов, которые вы уже используете, например Claude Code, Codex или Cursor.
Как установить и запустить рабочий процесс?Запустите скрипт установки для macOS/Linux/WSL или установщик PowerShell для Windows, чтобы получить команду aidlc. Затем из корня проекта выполните 'aidlc config --harness claude' (или kiro, codex, cursor, opencode, copilot), откройте этот харнесс и вызовите '/aidlc' (или '$aidlc' в Codex), описав задачу.
Какие агенты для программирования поддерживаются и нужно ли мне самому настраивать поставщика модели?Поддерживаются харнессы Claude Code, Kiro CLI/IDE, Codex CLI (>=0.145.0), Cursor, opencode (>=1.17) и GitHub Copilot CLI/VS Code. Поставщик модели настраивается для каждого харнесса: Claude Code и Codex по умолчанию используют Amazon Bedrock, а Copilot работает через вход в GitHub или BYOK.
Работает ли оно само по себе или за ним нужно постоянно следить?AI-DLC останавливается на этапах обязательного одобрения человеком перед переходом к следующему этапу, а README прямо предупреждает: прежде чем что-либо применять, проверьте сгенерированный результат и расходы.
Какую модель AI-DLC рекомендует для лучших результатов?В README сейчас рекомендуется Claude Opus 4.8 как модель, лучше всего подходящая для шагов рабочего процесса AI-DLC, требующих сложных рассуждений.
Зачем использовать это вместо обычного общения с агентом для программирования?Стихийное программирование с ИИ теряет контекст по мере роста проекта. AI-DLC связывает требования, решения, реализацию, тесты и эксплуатацию через один проверяемый жизненный цикл: 5 фаз, 33 этапа, 14 агентов и 11 профилей рабочих процессов.
Какие профили рабочих процессов входят в комплект?Всего 11 профилей рабочих процессов: для новых функций, исправления ошибок, инфраструктуры, безопасности, прототипов (PoC), корпоративной поставки и других типовых задач, включая облегчённые варианты 'Classic' и 'Express'.
Что делать, если команда aidlc или интеграция с харнессом сломалась?Сначала выполните 'aidlc doctor' из корня проекта. Типичные исправления: повторно применить инструкцию установщика по PATH, заново выполнить 'aidlc config' после расхождения версий, подтвердить доверие к хукам проекта в Codex или начать новую сессию харнесса после обновления.
Creator
awslabs
Size
114.8 MB
Stars
5.4K
Age
11mo
Commits · 90 Days