Что это

KBD Project Reflection & Orchestration — это навык (skill) для автоматизации рефлексии по завершении фазы проекта, работающего по методологии KBD (Knowledge-Based Development). Он генерирует отчёт reflection.md, который подводит итоги выполнения целей фазы, фиксирует внесённые изменения, технический долг, извлечённые уроки и даёт рекомендации для следующей фазы. Навык также автоматически продвигает waypoint (метку текущей фазы) на следующую фазу, обеспечивая бесшовный переход между этапами разработки.

Команда для запуска — /kbd-reflect. Она может быть вызвана без аргументов (использует активную фазу из waypoint) или с явным указанием имени фазы, например /kbd-reflect phase-1-foundation.

Как работает

Предварительные условия

Перед запуском /kbd-reflect все изменения текущей фазы должны быть завершены (статус DONE в progress.json). Если проект использует OpenSpec, изменения должны быть верифицированы (/opsx:verify) и архивированы (/opsx:archive). Для нативного KBD изменения перемещаются в .kbd-orchestrator/changes/archive/<date>-<id>/.

Этапы выполнения

1. Определение проекта и активной фазы — навык считывает идентификатор проекта и определяет текущую фазу (из аргумента или waypoint).
2. Чтение progress.json — собирает данные о выполненной работе всеми инструментами (не только данным навыком).
3. Загрузка данных об изменениях — из архива OpenSpec (openspec/changes/archive/) или нативного KBD (.kbd-orchestrator/changes/archive/).
4. Следование протоколу рефлексии — навык использует шаблон ../prompts/reflect.md для структурирования отчёта.
5. Генерация reflection.md — файл сохраняется в .kbd-orchestrator/phases/<phase>/reflection.md. В отчёте содержатся:
   • Процент достижения целей — каждая цель фазы оценивается как MET (выполнена), PARTIAL (частично) или NOT MET (не выполнена).
   • Доставленные изменения — список всех изменений, внесённых в рамках фазы (из progress.json и архива).
   • Технический долг — описание knowingly принятых компромиссов или неидеальных решений, которые стоит исправить позже.
   • Извлечённые уроки — заметки для базы знаний, которые помогут в будущих фазах.
   • Рекомендуемый фокус для следующей фазы — на чём сосредоточиться при планировании.
6. Продвижение waypoint — навык автоматически переключает waypoint на следующую фазу.
7. Триггер уведомления — выводится сообщение: [kbd] Reflection complete — advance to next phase with /kbd-new-phase.

Примеры использования

/kbd-reflect                             # использует активную фазу из waypoint
/kbd-reflect phase-1-foundation          # явное указание фазы

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

• После завершения всех задач фазы — когда все изменения имеют статус DONE и архивированы.
• Перед началом новой фазы — чтобы зафиксировать результаты и подготовить входные данные для планирования следующего этапа.
• Для поддержания прозрачности — отчёт reflection.md служит документом, который могут читать все участники проекта (включая ИИ-агентов).
• В проектах, использующих KBD или OpenSpec — навык универсален и работает с обеими системами управления изменениями.

Важно знать

• Навык не создаёт изменения — он только анализирует уже завершённые.
• progress.json должен быть актуален — все инструменты, работающие в проекте, обязаны обновлять его при завершении задач.
• Если фаза не указана явно, навык читает waypoint из конфигурации проекта (обычно .kbd-orchestrator/waypoint).
• После выполнения /kbd-reflect waypoint автоматически переключается на следующую фазу. Для начала новой фазы используйте /kbd-new-phase.
• Отчёт reflection.md может быть использован как вход для генерации плана следующей фазы (например, через /kbd-plan).
• Навык не зависит от конкретного языка программирования или фреймворка — он работает на уровне метаданных проекта.

Sync skills to Claude Cowork, Claude Code, Codex, and more.

Install with one command.

npx skillfish add gqadonis/turboquant-rs kbd-reflect