AgentSkillsCN

Aidd

Aidd

SKILL.md

AIDD Skill (AI-Driven Development)

Полный цикл разработки с несколькими агентами: analyst → architect → developer → reviewer.

Когда использовать

  • •Нужен качественный код с проверками
  • •Структурированная разработка с документацией
  • •Итеративное улучшение через review cycles

Полный цикл запуска

Фаза 1: Подготовка проекта

1.1 Создать структуру

bash
mkdir -p ~/Desktop/BetaVibe/ProjectName
cd ~/Desktop/BetaVibe/ProjectName
git init

# Создать полную .aidd структуру
mkdir -p .aidd/{analyst/{requirements,tasks},architect/{design,decisions},reviewer/reports,status}

1.2 Скопировать шаблоны из эталона

bash
cp -r ~/Desktop/BetaVibe/claude/.aidd/* .aidd/

Это скопирует:

  • •README.md — описание структуры
  • •analyst/requirements/_template.md — шаблон PRD
  • •analyst/tasks/_template.md — шаблон задач
  • •architect/design/_template.md — шаблон архитектуры
  • •architect/decisions/_template.md — шаблон ADR
  • •reviewer/reports/_template.md — шаблон review
  • •status/_template.md — шаблон статуса

1.3 Структура .aidd

code
.aidd/
├── README.md              # Описание структуры
├── analyst/
│   ├── requirements/      # PRD документы
│   │   └── _template.md
│   └── tasks/             # Списки задач
│       └── _template.md
├── architect/
│   ├── design/            # Архитектура
│   │   └── _template.md
│   └── decisions/         # ADR (Architecture Decision Records)
│       └── _template.md
├── reviewer/
│   └── reports/           # Review отчёты
│       └── _template.md
└── status/                # Прогресс фич
    └── _template.md

1.4 Создать prd.json (для простых проектов)

json
{
  "project": "ProjectName",
  "description": "Описание проекта",
  "userStories": [
    {"id": "US-001", "title": "First feature", "passes": false},
    {"id": "US-002", "title": "Second feature", "passes": false}
  ]
}

1.5 Создать CLAUDE.md

markdown
# Project Instructions

## Документация
Вся документация в `.aidd/`:
- Требования: `.aidd/analyst/requirements/`
- Задачи: `.aidd/analyst/tasks/`
- Архитектура: `.aidd/architect/design/`
- ADR: `.aidd/architect/decisions/`
- Reviews: `.aidd/reviewer/reports/`
- Статус: `.aidd/status/`

Используй `_template.md` как основу для новых документов.

## Правила
- Читай prd.json для user stories
- Обновляй статус в `.aidd/status/`
- Commit после каждой story: "feat: US-XXX - title"
- Следуй структуре проекта ТОЧНО

## Output
When done, say: IMPLEMENTATION COMPLETE

1.6 Initial commit

bash
git add .
git commit -m "Initial AIDD setup"

⚠️ ЧЕКЛИСТ ПЕРЕД ЗАПУСКОМ

Код:

  • • .aidd/ структура создана (все папки + шаблоны)
  • • prd.json существует с user stories
  • • CLAUDE.md существует с инструкциями
  • • Git инициализирован + initial commit

Дизайн (для UI проектов):

  • • images/reference.jpg — референс стиля
  • • images/design.png — полный дизайн (если есть)
  • • images/icons/ — все нужные иконки
  • • CLAUDE.md ссылается на images/

НЕ ЗАПУСКАТЬ без полной подготовки!

Фаза 2: Разработка (Developer Agent)

Бэта запускает Claude Code БЕЗ промпта, потом вводит /init:

bash
exec pty:true background:true workdir:~/Desktop/BetaVibe/ProjectName command:"claude --model claude-opus-4-5"

Claude Code запустится и покажет prompt. Затем:

bash
process send-keys sessionId:<id> literal:"/init\n"

Это заставит Claude Code прочитать CLAUDE.md и начать работу.

Мониторинг через process log sessionId:<id>.

Модель: Opus 4.5 (обязательно!).

Фаза 3: Review (Reviewer Agent)

Бэта запускает Reviewer БЕЗ промпта, потом вводит /init:

bash
exec pty:true background:true workdir:~/Desktop/BetaVibe/ProjectName/.aidd/reviewer command:"claude --model claude-opus-4-5"

В папке .aidd/reviewer/ должен быть CLAUDE.md:

markdown
# Reviewer Agent

## Роль
Ты — code reviewer. Проверяешь код на соответствие требованиям.

## Процесс
1. Прочитай `../../prd.json` (требования)
2. Прочитай код проекта
3. Проверь КАЖДУЮ user story
4. Создай отчёт по шаблону `reports/_template.md`

## Вердикт
- ✅ Approved — всё ок
- 🔄 Changes Requested — есть проблемы

Затем:

bash
process send-keys sessionId:<id> literal:"/init\n"

Claude Code прочитает REVIEWER.md и создаст отчёт.

Фаза 4: Исправления (если нужно)

Если отчёт содержит "Changes Requested", Бэта запускает fix в той же сессии developer agent:

bash
process send-keys sessionId:<dev-session-id> literal:"Read latest report in .aidd/reviewer/reports/. Fix all issues. Commit fixes.\n"

Затем снова Фаза 3 (новый review).

Фаза 5: Финализация

Когда отчёт = Approved:

bash
git tag v1.0.0
git log --oneline

Мониторинг

bash
# Количество отчётов
ls .aidd/reviewer/reports/*.md 2>/dev/null | grep -v template | wc -l

# Последний отчёт
cat .aidd/reviewer/reports/$(ls -t .aidd/reviewer/reports/ | grep -v template | head -1)

# Статус stories
cat prd.json | grep passes

Важно

  • •Бэта запускает сам: через exec pty:true background:true и мониторит через process log
  • •Модель: ТОЛЬКО Opus 4.5 (claude-opus-4-5)
  • •Структура: копировать из ~/Desktop/BetaVibe/claude/.aidd/
  • •Шаблоны: использовать _template.md как основу
  • •Цикл: Dev → Review → Fix → Review → ... → Approved

⚠️ Контроль процесса:

  • •Рутину делать самому без вопросов
  • •Важные решения / проблемы / неожиданности → сообщить Павлу и спросить

Агенты в AIDD

АгентПапкаЗадача
analyst.aidd/analyst/PRD + Tasks
architect.aidd/architect/Architecture + ADR
developerкорень проектаКод
reviewer.aidd/reviewer/Review отчёты

Комбинация с Ralph

Можно использовать Ralph для фазы разработки:

  1. •Фаза 2: запустить Ralph loop
  2. •Фаза 3-4: AIDD review cycle