type: project
name: {Project Name}
slug: {project-slug}
status: {idea | design | mvp | active | hold | killed}
readiness_pct: {0-100}
owner_agent: {agent-slug or "human"}
products: [{product-slug}, ...]
created: {YYYY-MM-DD}
last_updated: {YYYY-MM-DD}
{Project Name}
Один документ на проект. Росте по мірі роботи. НЕ роздрібнювати у багато файлів.
Meta
Why this exists: {навіщо проект, бізнес-сенс, очікувана цінність}
KPIs:
- {метрика 1: target / current}
- {метрика 2: target / current}
Status snapshot: {1-2 речення про де зараз і що блокує}
Stakeholders:
- Owner: {name}
- Команда: {хто з людей дотичний}
- Agent: {який agent з /agents/ за нього відповідає}
Design
Як це має працювати. Архітектура, флоу, ролі. Заповнюється на етапі дизайну, оновлюється коли архітектура змінюється.
Архітектура
{High-level схема, компоненти, dataflow}
Інтеграції
- {service-slug} — {навіщо}
Ролі / агенти всередині
- {agent-slug} — {що робить}
Ключові рішення
{Архітектурні рішення з обґрунтуванням. Якщо багато — винести у decisions/ADR-NNNN-*.md.}
Implementation
Як це реально працює зараз. Інструкції для людей і агентів. Заповнюється по мірі реалізації.
Поточний стан
{Що працює, що не працює, де живе код}
Як запустити / задеплоїти
{команди}
Як підтримувати
- {рутинне обслуговування}
- {troubleshooting common issues}
Референси
- Code: {шлях до /srv/projects/...}
- Service: {systemd unit / docker compose / cron}
- Logs: {де дивитись}
- Credentials: {/srv/passepartout/...}
Notes & Backlog
Майбутні ідеї, TODO, побажання. Все що «класно було б додати», але не критично зараз.
TODO
Ідеї на майбутнє
Discovered solutions
{Сюди Scout-агент додає знахідки з GitHub/HuggingFace що ляжуть у проект}
Legacy
Якщо існувала стара папка/файл по проекту — лінк сюди. Видалити коли все мігровано.
- Стара wiki-папка: {/srv/wiki/old-name/}
- Memory-файл: {project_*.md в /root/.claude/projects/-/memory/}