План реализации рекомендаций по улучшению проекта claude-code-sub-agents

Контекст

На основе анализа выявлено, что проект использует ~25-30% доступного функционала Claude Code для суб-агентов. Необходимо реализовать 12 рекомендаций, каждую в отдельной git-ветке с коммитом и мёрджем в main.

Порядок выполнения (12 веток)

Ветка 1: fix/typo-electron-pro

Файлы: agents/development/electorn-pro.md Действие: git mv agents/development/electorn-pro.md agents/development/electron-pro.md

Ветка 2: fix/update-task-tools

Файлы (11 агентов, где tools содержит TodoWrite):

agents/agent-organizer.md — заменить TodoWrite на TaskCreate, TaskUpdate, TaskList, TaskGet
agents/development/backend-architect.md — заменить TodoWrite → TaskCreate, TaskUpdate, TaskList
agents/development/frontend-developer.md — аналогично
agents/development/mobile-developer.md
agents/development/legacy-modernizer.md
agents/development/full-stack-developer.md
agents/development/ui-designer.md
agents/development/python-pro.md
agents/development/ux-designer.md
agents/quality-testing/debugger.md
agents/business/product-manager.md

Действие: В строке tools: заменить TodoWrite на TaskCreate, TaskUpdate, TaskList (для всех кроме agent-organizer, ему нужен полный набор TaskCreate, TaskUpdate, TaskList, TaskGet).

Ветка 3: feature/add-agent-memory

Файлы (4 агента):

agents/quality-testing/code-reviewer.md — добавить memory: user
agents/quality-testing/architect-review.md — добавить memory: user
agents/quality-testing/debugger.md — добавить memory: user
agents/security/security-auditor.md — добавить memory: user

Действие: Добавить строку memory: user в YAML frontmatter каждого. Также добавить в markdown-тело каждого агента секцию с инструкциями по работе с памятью:

Persistent Memory

As you work, update your agent memory with patterns, conventions, and recurring issues you discover. Before starting work, consult your memory files for relevant prior context.

Ветка 4: feature/add-permission-modes

Файлы:

Read-only агенты → permissionMode: plan:
- agents/quality-testing/code-reviewer.md
- agents/quality-testing/architect-review.md
Implementation-агенты → permissionMode: acceptEdits:
- agents/development/backend-architect.md
- agents/development/frontend-developer.md
- agents/development/full-stack-developer.md
- agents/development/typescript-pro.md
- agents/development/python-pro.md
- agents/development/golang-pro.md
- agents/development/react-pro.md
- agents/development/nextjs-pro.md
- agents/development/mobile-developer.md
- agents/development/electron-pro.md (уже переименован)
- agents/development/legacy-modernizer.md
- agents/development/dx-optimizer.md
- agents/development/ui-designer.md
- agents/development/ux-designer.md
- agents/data-ai/ai-engineer.md
- agents/data-ai/data-engineer.md
- agents/data-ai/data-scientist.md
- agents/data-ai/database-optimizer.md
- agents/data-ai/graphql-architect.md
- agents/data-ai/ml-engineer.md
- agents/data-ai/postgres-pro.md
- agents/data-ai/prompt-engineer.md
- agents/infrastructure/cloud-architect.md
- agents/infrastructure/deployment-engineer.md
- agents/infrastructure/performance-engineer.md
- agents/infrastructure/incident-responder.md
- agents/infrastructure/devops-incident-responder.md
- agents/quality-testing/debugger.md
- agents/quality-testing/qa-expert.md
- agents/quality-testing/test-automator.md
- agents/security/security-auditor.md
- agents/specialization/documentation-expert.md
- agents/specialization/api-documenter.md
- agents/business/product-manager.md
agent-organizer → permissionMode: default (оставить без изменений, default — значение по умолчанию)

Действие: Добавить строку permissionMode: \ в YAML frontmatter.

Ветка 5: feature/add-max-turns

Все агенты, дифференцированные по роли:

agent-organizer: maxTurns: 15 (анализ, не должен быть долгим)
Reviewers (code-reviewer, architect-reviewer): maxTurns: 20
Documentation (documentation-expert, api-documenter): maxTurns: 25
Prompt-engineer: maxTurns: 20
Все остальные (developers, infra, data, security, etc.): maxTurns: 40

Действие: Добавить maxTurns: N в YAML frontmatter каждого агента.

Ветка 6: feature/add-agent-hooks

Файлы (3 агента):

agents/security/security-auditor.md — PreToolUse хук для Bash: hooks: PreToolUse:
- matcher: «Bash» hooks:
  - type: prompt prompt: «Evaluate if this command is safe to run during a security audit. Block any destructive commands (rm -rf, DROP, DELETE, format). Context: $ARGUMENTS»
agents/quality-testing/test-automator.md — Stop хук: hooks: Stop:
- hooks:
  - type: prompt prompt: «Verify that the test automator has completed its work: all test files are created, test commands have been executed, and results are reported. Context: $ARGUMENTS»
agents/quality-testing/code-reviewer.md — Stop хук: hooks: Stop:
- hooks:
  - type: prompt prompt: «Verify that the code review is complete: all changed files have been reviewed, critical issues identified, and a structured summary is provided. Context: $ARGUMENTS»

Действие: Добавить блок hooks: в YAML frontmatter.

Ветка 7: feature/consolidate-agents

Объединения:

incident-responder.md + devops-incident-responder.md → единый incident-responder.md

Объединить экспертизу обоих в один файл
Удалить devops-incident-responder.md

database-optimizer.md + postgres-pro.md → единый database-optimizer.md

Добавить PostgreSQL/PgLite экспертизу в database-optimizer
Удалить postgres-pro.md

ui-designer.md + ux-designer.md → единый ui-ux-designer.md

Объединить визуальный дизайн и UX исследования
Удалить оба старых файла, создать новый

Также: Обновить agent-organizer.md — убрать упоминания удалённых агентов и добавить новые имена.

Ветка 8: feature/convert-to-plugin

Новые файлы:

.claude-plugin/plugin.json: { «name»: «claude-code-sub-agents», «description»: «A comprehensive collection of 30+ specialized AI subagents for Claude Code covering the full software development lifecycle», «version»: «2.0.0», «author»: { «name»: «lst97» }, «repository»: «https://github.com/lst97/claude-code-sub-agents«, «license»: «MIT» }

Действие: Создать директорию .claude-plugin/ и файл plugin.json. Структура проекта уже соответствует plugin layout (директория agents/ на корневом уровне).

Ветка 9: feature/add-mcp-servers-frontmatter

Файлы: Все агенты, использующие MCP-инструменты. Действие: Добавить mcpServers в frontmatter для декларации зависимостей:

Для агентов с mcpcontext7*: mcpServers:

context7

Для агентов с mcpsequential-thinking*: mcpServers:

context7
sequential-thinking

Для агентов с mcpmagic*: mcpServers:

context7
magic

Для агентов с mcpplaywright*: mcpServers:

context7
playwright

И комбинации. MCP-инструменты остаются в tools для обратной совместимости.

Ветка 10: feature/create-skills

Новые файлы в skills/:

skills/review-pr/SKILL.md — ревью PR
skills/fix-issue/SKILL.md — исправление issue
skills/write-tests/SKILL.md — написание тестов

Каждый skill использует context: fork и ссылается на соответствующий агент.

Ветка 11: feature/add-disallowed-tools

Файлы:

agents/agent-organizer.md — добавить disallowedTools: Task (не должен порождать суб-агентов, только рекомендовать)

Действие: Добавить disallowedTools в frontmatter.

Ветка 12: docs/agent-teams-compatibility

Файлы: README.md Действие: Добавить секцию «Agent Teams Compatibility» в README с описанием:

Как агенты работают в режиме Agent Teams
Рекомендации по формированию команд
Ссылка на документацию Agent Teams

Верификация

После каждого мёрджа:

git log —oneline — проверить историю
Проверить что все файлы корректны (frontmatter валиден)

После всех мёрджей:

Полный обзор структуры проекта
Проверка, что все файлы агентов содержат корректный YAML frontmatter

Результат

Проект здесь https://github.com/89simpson/claude-code-sub-agents

Эволюция sub-agents #2