architect/templates/arh/project.readme.md

{Название проекта}

Тип: {business | saas | infrastructure}
Статус: {design | development | production}
Версия: {0.1.0}
Обновлено: {YYYY-MM-DD}

{Одна строка — суть проекта: что строим и зачем}


ЧТО МЫ СТРОИМ

Задача: {какую проблему решаем}

Решение: {что именно строим, что получится в итоге}

Контекст: {откуда взялась задача, что было до, почему сейчас}


КАНАЛЫ

Канал Платформа Статус URL
{Основной сайт} {Drupal 11} {dev} {https://...}
{Канал 2} {Платформа} {planned}

СТЕК

Слой Технология Версия
Backend {Drupal / Laravel / Python} {11.x}
Database {MySQL / PostgreSQL} {8.x}
Frontend {Twig / React / Vue}
Hosting {Beget / VPS}

СТРУКТУРА

{project}/
├── management/    ← Управление: статус, задачи, воркфлоу
├── biz/           ← Бизнес-слой: видение, требования
├── it/            ← IT-реализация
│   ├── design/   ← Проектирование: ТЗ, архитектура
│   ├── docs/     ← Документация (по слоям или темам)
│   ├── data/     ← Данные и скрипты обработки
│   └── {app}/   ← Код приложения (drupal / laravel / etc.)
└── testing/       ← Тестирование

ДОКУМЕНТЫ

Управление

Документ Назначение
management/STATUS.md Текущий статус, метрики, блокеры
management/TODO.md Задачи по фазам
management/WORKFLOW.md Как работаем, критерии перехода фаз

Бизнес

Документ Назначение
biz/VISION.md Видение, цели, аудитория
biz/REQUIREMENTS.md Требования бизнеса к IT
biz/BRIEF.md Краткое резюме для клиента

IT — Проектирование

Документ Назначение
it/design/BRIEF.md Краткое ТЗ
it/design/REQUIREMENTS.md Детальные требования
it/design/DESIGN.md Архитектура решения

IT — {Специфика проекта: название слоя}

Документ Назначение
{путь} {назначение}
{путь} {назначение}

ФАЗЫ

# Фаза Статус
1 {Инициализация} ✅ Готово
2 {Проектирование} ✅ Готово
3 {Разработка} ⚠️ В работе
4 {Тестирование} 📋 Запланировано
5 {Деплой} 📋 Запланировано

Текущая фаза: {N} — {Название} — {что конкретно делаем}


ДЛЯ CLAUDE

Фокус сейчас: {одно предложение — что делаем в текущей фазе}

Ключевые файлы:
- {файл} — {почему важен сейчас}
- {файл} — {почему важен сейчас}

Следующий шаг: {конкретная задача — не фаза, а действие}

Полные контексты:
- CLAUDE.md — AI-контекст проекта
- {it/CLAUDE.md} — IT-контекст (если есть)


ИСТОРИЯ

{YYYY-MM-DD} — v{X.Y.Z} — {Название версии / этапа}

{YYYY-MM-DD} — v{0.1.0} — Инициализация