Репозиторій і стартова база capstone

Стартова база має бути чистою і відтворюваною

Capstone потрібно починати з контрольованої точки: репозиторій, SPEC.md, CLAUDE.md, EVIDENCE.md і мала наступна задача. Спочатку перевірте стан бази, а вже потім починайте функціональну реалізацію.

Новий проєкт може початися з git init, базових каталогів і першого коміту. В наявному репозиторії потрібні чисте дерево та окрема робоча гілка.

Git baseline і .gitignore

1. Перевірте git status і відсутність незбережених змін.
2. Додайте структуру каталогів та стартові документи.
3. Переконайтеся, що .env, залежності, build output, логи й кеші не відстежуються.
4. Перевірте список файлів перед комітом.
5. Створіть окремий baseline-коміт.
6. Зафіксуйте стан, від якого починається перша мала задача.

git status
git diff --stat
git ls-files

CLAUDE.md має бути коротким і локальним

Постійні правила належать до CLAUDE.md, а гіпотези, ідеї та поточні результати — до SPEC.md, EVIDENCE.md або окремих робочих нотаток. Не додавайте до інструкцій секрети чи неперевірені припущення.

• опишіть призначення системи;
• назвіть реальні команди запуску та перевірки;
• зафіксуйте правила внесення змін;
• забороніть дії, які потребують окремого погодження;
• вимагайте у звіті змінені файли та виконані перевірки.

EVIDENCE.md створюється одразу

• що було доручено Claude;
• який корисний результат отримано;
• які рішення прийняв розробник;
• як саме результат перевіряли;
• які ризики або питання залишилися відкритими.

Перша задача повинна бути малою

1. Запустіть проєкт локально.
2. Реалізуйте один happy path.
3. Додайте smoke-check.
4. Запишіть фактичний результат в EVIDENCE.md.
5. Перегляньте diff і за потреби уточніть SPEC.md.
6. Переходьте до наступного кроку лише після перевірки попереднього.