Готовый плагин для Claude Code: слэш-команды, агенты, хуки и шаблоны для процесса idea → research → plan → review-spec → spec-interview (опционально) → tasklist → implement → review → qa.

• Что это
• Быстрый старт
• Скрипты и проверки
• Слэш-команды
• Предпосылки
• Диагностика путей
• Документация
• Примеры
• Вклад
• Лицензия

AIDD — это AI-Driven Development: LLM работает не как «один большой мозг», а как команда ролей внутри привычного SDLC. Плагин для Claude Code помогает уйти от вайб-коддинга: фиксирует артефакты (PRD/plan/tasklist/отчёты), проводит через quality‑гейты и добавляет агентов, слэш‑команды, хуки и структуру aidd/.

Ключевые возможности:

• Слэш-команды и агенты для цепочки idea → research → plan → review-spec → spec-interview (опционально) → tasklist → implement → review → qa.
• Skill-first промпты: shared topology разделена между skills/aidd-core, skills/aidd-policy, skills/aidd-docio, skills/aidd-flow-state, skills/aidd-observability, skills/aidd-loop, skills/aidd-rlm, skills/aidd-stage-research (EN); stage entrypoints определяются stage skill-файлами.
• Research обязателен перед планированием: research-check требует статус reviewed.
• Гейты PRD/Plan Review/QA и безопасные хуки (stage-aware).
• Rolling context pack (pack-first): aidd/reports/context/<ticket>.pack.md.
• Hooks mode: по умолчанию AIDD_HOOKS_MODE=fast, строгий режим — AIDD_HOOKS_MODE=strict.
• Автоформат + тест‑политика по стадиям: implement — без тестов, review — targeted, qa — full.
• Loop mode implement↔review: loop pack/review pack, diff boundary guard, loop-step/loop-run.
• Единый формат ответов AIDD:ANSWERS + Q-идентификаторы в AIDD:OPEN_QUESTIONS (план ссылается на PRD QN без дублирования).
• Конвенции веток и коммитов через aidd/config/conventions.json.

• Stage/shared runtime entrypoints (canonical): python3 skills/*/runtime/*.py (Python-only canon с 2026-02-09).
• Runtime wrappers в skills/*/scripts/*.sh удалены.
• Hooks могут использовать shell entrypoints как platform glue (hooks/*).
• tools/* используется только для import stubs и repo-only tooling.
• Canonical runtime API lives in skills/*/runtime/*.py; tools/*.sh are retired.
• Начиная с 2026-02-09, новые интеграции должны вызывать Python entrypoints (skills/*/runtime/*.py) с PYTHONPATH=${CLAUDE_PLUGIN_ROOT}.
• Rollback criteria: если cutover ломает tests/repo_tools/ci-lint.sh или tests/repo_tools/smoke-workflow.sh, допускается временный wrapper fallback для конкретного entrypoint с обязательным follow-up task.
• Stage lexicon: public stage review-spec работает как umbrella для internal review-plan и review-prd.

• Кросс-агентный канон: docs/agent-skill-best-practices.md.
• Языковые/lint правила: docs/skill-language.md + tests/repo_tools/lint-prompts.py.
• Для user-invocable stage skills обязателен раздел ## Command contracts (interface-only карточки: When to run, Inputs, Outputs, Failure mode, Next action).
• Детали реализации не дублируются в SKILL.md; deep guidance уходит в supporting files.
• ## Additional resources описывает progressive disclosure через явные when: + why: для каждого ресурса.

/plugin marketplace add GrinRus/ai_driven_dev
/plugin install feature-dev-aidd@aidd-local

/feature-dev-aidd:aidd-init

/feature-dev-aidd:aidd-init создаёт ./aidd и .claude/settings.json с дефолтами automation.tests. Для обновления/детекта под стек используйте:

/feature-dev-aidd:aidd-init --detect-build-tools

/feature-dev-aidd:idea-new STORE-123 "Checkout: скидки, купоны, защита от double-charge"
/feature-dev-aidd:researcher STORE-123
/feature-dev-aidd:plan-new STORE-123
/feature-dev-aidd:review-spec STORE-123
/feature-dev-aidd:spec-interview STORE-123
/feature-dev-aidd:tasks-new STORE-123
/feature-dev-aidd:implement STORE-123
/feature-dev-aidd:review STORE-123
/feature-dev-aidd:qa STORE-123

Примечания:

• Вопросы могут появляться после /feature-dev-aidd:idea-new, /feature-dev-aidd:review-spec и /feature-dev-aidd:spec-interview (если запускаете).
• slug_hint формируется автоматически внутри /feature-dev-aidd:idea-new из note (LLM summary → slug token); вручную передавать его не нужно.
• Ответы давайте в AIDD:ANSWERS (формат Answer N), а фиксацию/синхронизацию должен выполнить тот же агент/команда, которые задали вопросы.

• /feature-dev-aidd:aidd-init без --force добавляет новые артефакты и не перезаписывает существующие.
• Для обновления шаблонов используйте --force или перенесите изменения вручную.
• Source of truth: stage content templates находятся в skills/*/templates/*; templates/aidd/** хранит только bootstrap config/placeholders.
• Root AGENTS.md — dev‑гайд репозитория; пользовательский канон процесса — aidd/AGENTS.md (копируется из skills/aidd-core/templates/workspace-agents.md).

Ниже перечислены canonical Python-команды runtime API.

tests/repo_tools/ — repo-only утилиты для CI/линтинга; в плагин не входят.

review runtime commands are canonical at skills/review/runtime/*.

CI required-check parity:

• Required: lint-and-test, smoke-workflow, dependency-review.
• Security rollout: security-secret-scan + security-sast работают как advisory, пока AIDD_SECURITY_ENFORCE!=1; при AIDD_SECURITY_ENFORCE=1 становятся required.

• skills/aidd-core/runtime/* — shared core runtime API (canonical).
• skills/aidd-docio/runtime/* — shared DocIO runtime API (md_*, actions_*, context_*).
• skills/aidd-flow-state/runtime/* — shared flow/state runtime API (set-active-*, progress*, tasklist*, stage_result, status_summary, prd_check, tasks_derive).
• skills/aidd-observability/runtime/* — shared observability runtime API (doctor, tools_inventory, tests_log, dag_export, identifiers).
• skills/aidd-loop/runtime/* — shared loop runtime API (canonical).
• skills/<stage>/runtime/* — stage-local runtime API (single owner per stage).
• tools/*.sh удалены из runtime API.

RLM evidence используется как основной источник интеграций/рисков/связей (pack-first + slice on demand).

Troubleshooting пустого контекста:

• Уточните --paths/--keywords (указывайте реальный код, не только aidd/).
• Если rlm_status=pending, выполните agent‑flow по worklist и пересоберите RLM pack.

Migration policy (legacy -> RLM-only):

• Legacy pre-RLM research context/targets artifacts не участвуют в runtime/gates.
• Для старых workspace-артефактов пересоберите research: python3 ${CLAUDE_PLUGIN_ROOT}/skills/researcher/runtime/research.py --ticket <ticket> --auto.
• Если rlm_status=pending, выполните handoff на shared owner: python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-rlm/runtime/rlm_finalize.py --ticket <ticket>.
• Для readiness в plan/review/qa нужен минимальный RLM набор: rlm-targets, rlm-manifest, rlm.worklist.pack, rlm.nodes, rlm.links, rlm.pack.

RLM artifacts (pack-first):

• Pack summary: aidd/reports/research/<ticket>-rlm.pack.json.
• Slice-инструмент: python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-rlm/runtime/rlm_slice.py --ticket <ticket> --query "<token>" [--paths path1,path2] [--lang kt,java].
• Бюджет RLM pack: config/conventions.json → rlm.pack_budget (max_chars, max_lines, top-N limits).

Loop = 1 work_item → implement → review → (revise)* → ship. Если после SHIP есть открытые итерации в AIDD:NEXT_3/AIDD:ITERATIONS_FULL, loop-run выбирает следующий work_item, обновляет aidd/docs/.active.json (work_item/stage) и продолжает implement.

Ключевые артефакты:

• aidd/reports/loops/<ticket>/<scope_key>.loop.pack.md — тонкий контекст итерации.
• aidd/reports/loops/<ticket>/<scope_key>/review.latest.pack.md — краткий feedback с verdict.

Команды:

• Manual: /feature-dev-aidd:implement <ticket> → /feature-dev-aidd:review <ticket>.
• Loop CLI: python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-loop/runtime/loop_step.py --ticket <ticket> (fresh sessions).
• One-shot: python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-loop/runtime/loop_run.py --ticket <ticket> --max-iterations 5.
• Scope guard: python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-core/runtime/diff_boundary_check.py --ticket <ticket>.
• Stream (optional): python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-loop/runtime/loop_step.py --ticket <ticket> --stream=text|tools|raw, python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-loop/runtime/loop_run.py --ticket <ticket> --stream.

Пример запуска из корня проекта:

CLAUDE_PLUGIN_ROOT="/path/to/ai_driven_dev" PYTHONPATH="$CLAUDE_PLUGIN_ROOT" python3 "$CLAUDE_PLUGIN_ROOT/skills/aidd-loop/runtime/loop_run.py" --ticket ABC-123 --max-iterations 5

Примечание:

• Ralph plugin использует stop-hook в той же сессии (completion promise). AIDD loop-mode — fresh sessions.
• Для max-iterations используйте формат с пробелом: --max-iterations 5 (без =).
• Если CLAUDE_PLUGIN_ROOT/AIDD_PLUGIN_DIR не задан, loop-скрипты пытаются auto-detect по пути скрипта и печатают WARN; при недоступности авто‑детекта — BLOCKED.
• Stream логи: aidd/reports/loops/<ticket>/cli.loop-*.stream.log (human) и aidd/reports/loops/<ticket>/cli.loop-*.stream.jsonl (raw).
• Loop run log: aidd/reports/loops/<ticket>/loop.run.log.
• Настройки cadence/tests хранятся в .claude/settings.json в корне workspace (без aidd/.claude).

Правила:

• Loop pack first, без больших вставок логов/диффов (ссылки на aidd/reports/**).
• Review не расширяет scope: новое → AIDD:OUT_OF_SCOPE_BACKLOG или новый work_item.
• Review pack обязателен; при наличии review report + loop pack допускается авто‑пересборка.
• Финальный Status в командах implement/review/qa должен совпадать со stage_result.
• Allowed paths берутся из Expected paths итерации (AIDD:ITERATIONS_FULL).
• Loop-mode тесты следуют stage policy: implement — без тестов, review — targeted, qa — full.
• Tests evidence: tests_log со status=skipped + reason_code считается evidence при tests_required=soft (для hard → BLOCKED).

• bash, git, python3.
• Claude Code с доступом к plugin marketplace.
• Инструменты сборки/тестов вашего стека (по желанию).
• MCP интеграции опциональны: .mcp.json не входит в плагин по умолчанию.

Поддерживаются macOS/Linux. Для Windows используйте WSL или Git Bash.

• Плагин живёт в корне репозитория (директории agents/, skills/, hooks/, tools/).
• Рабочие артефакты разворачиваются в ./aidd после /feature-dev-aidd:aidd-init.
• Если команды или хуки не находят workspace, запустите /feature-dev-aidd:aidd-init или укажите CLAUDE_PLUGIN_ROOT.
• Для быстрой проверки окружения используйте python3 ${CLAUDE_PLUGIN_ROOT}/skills/aidd-observability/runtime/doctor.py.

• Канон ответа и pack-first: aidd/AGENTS.md + skills/aidd-policy/SKILL.md.
• Пользовательский гайд (runtime): aidd/AGENTS.md; dev‑гайд репозитория: AGENTS.md.
• Skill-first topology: skills/aidd-core, skills/aidd-policy, skills/aidd-docio, skills/aidd-flow-state, skills/aidd-observability, skills/aidd-loop, skills/aidd-rlm, skills/aidd-stage-research (EN).
• Английская версия: README.en.md.

Демо‑проекты и вспомогательные скрипты не поставляются — репозиторий остаётся language‑agnostic. При необходимости держите демо‑проекты вне плагина и описывайте их в документации вашего workspace.

• Репозиторные проверки (maintainer only): tests/repo_tools/ci-lint.sh, tests/repo_tools/smoke-workflow.sh.

Правила вкладов: CONTRIBUTING.md.

MIT, подробнее: LICENSE.