README.md

Эти шаблоны помогают ПРАВИЛЬНО начать любой IT-проект.

Основаны на Теории 9 вопросов из architect/theory/QUESTIONS.md

ПОСЛЕДОВАТЕЛЬНОСТЬ (обязательная!)

ПОСЛЕДОВАТЕЛЬНЫЕ (делаем по порядку):
  1. ПОЧЕМУ  → Проблема
  2. ЗАЧЕМ   → Видение
  3. ЧТО     → Решение
  4. КТО     → Команда
  5. КАК     → Архитектура

ПАРАЛЛЕЛЬНЫЕ (можно одновременно после КАК):
  6. ЧЕМ     → Технологии
  7. ГДЕ     → Инфраструктура
  8. КОГДА   → Roadmap

ИТОГОВОЕ:
  9. СКОЛЬКО → Ресурсы и оценка

ПРАВИЛО: Нельзя переходить к следующему вопросу, пока не ответил на предыдущий!

СТРУКТУРА ПРОЕКТА

project/
├── concept/                    ← КОНЦЕПЦИЯ (9 документов)
│   ├── 01_PROBLEM.md          ← ПОЧЕМУ: проблема
│   ├── 02_VISION.md           ← ЗАЧЕМ: видение
│   ├── 03_SOLUTION.md         ← ЧТО: решение
│   ├── 04_STAKEHOLDERS.md     ← КТО: команда и стейкхолдеры
│   ├── 05_ARCHITECTURE.md     ← КАК: архитектура
│   ├── 06_TECH_STACK.md       ← ЧЕМ: технологии
│   ├── 07_INFRASTRUCTURE.md   ← ГДЕ: инфраструктура
│   ├── 08_ROADMAP.md          ← КОГДА: план развития
│   └── 09_RESOURCES.md        ← СКОЛЬКО: оценка ресурсов
│
├── PROJECT.md                  ← ГЛАВНЫЙ ДОКУМЕНТ (все в одном)
└── README.md                   ← Быстрый старт

КАК ИСПОЛЬЗОВАТЬ

Вариант 1: Полная документация (рекомендуется)

Для серьёзных проектов — создавать все 9 документов отдельно.

# Копировать ВСЕ шаблоны
cp -r $WORKSPACE/architect/templates/project-start/concept/ project/concept/

# Заполнять ПО ПОРЯДКУ
vim project/concept/01_PROBLEM.md      # Шаг 1
vim project/concept/02_VISION.md       # Шаг 2
...

Время: 1-2 недели подготовки
Результат: Полная документация перед первой строкой кода

Вариант 2: Быстрый старт

Для малых проектов — один документ PROJECT.md.

# Копировать шаблон
cp $WORKSPACE/architect/templates/project-start/PROJECT_TEMPLATE.md project/PROJECT.md

# Заполнить разделы
vim project/PROJECT.md

Время: 1-2 дня
Результат: Быстрый старт с минимальной документацией

ШАБЛОНЫ ДОКУМЕНТОВ

Корневой README проекта

../project.readme.md — главный документ проекта (для человека + Claude)

cp $WORKSPACE/architect/templates/project.readme.md projects/org/{name}/README.md

Содержит: что строим, каналы, стек, структура, документы, фазы, секция ДЛЯ CLAUDE, история.

Концепция (9 вопросов)

ЗАПОЛНЕНИЕ ШАБЛОНОВ

Инструкция

Пример

Файл	Что заполнить	Время
`01_PROBLEM.md`	Какая проблема? Кто страдает? Сколько стоит?	4-6 часов
`02_VISION.md`	Как мир изменится? Какую ценность создаём?	4 часа
`03_SOLUTION.md`	Что именно делаем? Границы проекта	6 часов
`04_STAKEHOLDERS.md`	Кто участвует? Роли и ответственность	2 часа
`05_ARCHITECTURE.md`	Как устроена система? Компоненты, паттерны	8-12 часов
`06_TECH_STACK.md`	Какие технологии? Почему именно они?	4 часа
`07_INFRASTRUCTURE.md`	Где разворачиваем? Dev/Staging/Prod	4 часа
`08_ROADMAP.md`	Какие фазы? Что когда делаем?	6 часов
`09_RESOURCES.md`	Сколько времени? Денег? Людей?	4 часа

## ПРОБЛЕМА

[ЗАПОЛНИ: Какая проблема решается?]

### Кто страдает?

[ЗАПОЛНИ: Список кто страдает от проблемы]

## ПРОБЛЕМА

Создание CRM занимает 3 месяца и стоит $50,000.

### Кто страдает?

- Малый бизнес — не могут позволить custom разработку
- Программисты — пишут одно и то же 100 раз
- Стартапы — не могут быстро тестировать идеи

ТЕГИ ДЛЯ ПОИСКА

Добавляйте теги в начало каждого документа:

---
tags:
  - problem-statement
  - b2b-saas
  - no-code
  - platform
market: enterprise
stage: concept
priority: high
---

По типу документа:
- problem-statement, vision, solution, architecture, roadmap

По рынку:
- b2b-saas, b2c, marketplace, platform, enterprise

По технологиям:
- python, typescript, react, fastapi, postgresql, docker

ЧАСТЫЕ ОШИБКИ

❌ НЕ ДЕЛАТЬ

❌ Пропускать ПОЧЕМУ и начинать с КАК
   → Будете делать то, что не нужно

❌ Делать все документы параллельно
   → Противоречия и несогласованность

❌ Копировать шаблон и не заполнять
   → Бесполезная документация

❌ Писать "TODO" вместо реального анализа
   → Пустая трата времени

✅ ДЕЛАТЬ

✅ Идти строго по порядку 1 → 2 → 3 → ...
✅ Заполнять один документ полностью, потом следующий
✅ Удалять инструкции после заполнения
✅ Добавлять реальные цифры и факты
✅ Обновлять документы при изменениях

ПРИМЕРЫ

Реальные проекты с этими шаблонами

СВЯЗИ

FAQ

Q: Обязательно создавать все 9 документов?
A: Для серьёзного проекта — да. Для прототипа можно один PROJECT.md.

Q: Сколько времени занимает заполнение?
A: 1-1.5 недели полной подготовки ИЛИ 1-2 дня быстрого старта.

Q: Можно начать с КАК (архитектуры)?
A: Нет! Сначала ПОЧЕМУ → ЗАЧЕМ → ЧТО, потом КАК.

Q: Что если не знаю ответ на вопрос?
A: Провести исследование (market research, competitor analysis) ДО заполнения шаблона.

Шаблоны для начала ЛЮБОГО проекта

НАЗНАЧЕНИЕ