.projectstore

.projectstore / метод / 1

Цикл із незалежною перевіркою всередині.

Агенти пишуть код швидко — і так само швидко знову вирішують уже вирішене: кожна нова сесія починає з нуля. Вихід не в розумнішому агентові. Це «зібрати контекст → діяти → перевірити» над проєктом, а не лише над кодом.

Цикл

Вісім кроків. Два з них — перевірки агентом, який не писав чернетку.

рішення розробка ↺ правки агент бере в роботу ↺ правка дошка, граф зв’язків і мапа коду оновлюються наступна сесія це бачить Завданнявід вас ADR · спец. · сторі«чому» на диску незалежна перевіркаcriticчистий контекст Висхвалюєте plannerде в коді реалізаціякод + тести незалежна перевіркаreviewerза критеріями готово ✓критерії виконано
  1. 01Ви кажете, що вам потрібно. Агент відкриває артефакт, перш ніж відкрити редактор.
  2. 02ADR — коли щось треба вирішити, епік і сторі — для роботи, специфікація — коли «як» неочевидне. Спершу попередній перегляд, запис — після вашого «Так».
  3. 03Critic із чистим контекстом, не зацікавлений у чернетці, атакує її. Чекайте на «revise».
  4. 04Ви схвалюєте правки. Артефакт отримує позначку reviewed і потрапляє в беклог.
  5. 05Агент береться за сторі. Planner читає, як попередні епіки лягли в код, і каже, де місце цій зміні.
  6. 06Код і тести за планом сторі.
  7. 07Reviewer із чистим контекстом звіряє диф із кожним критерієм приймання й просить доказ.
  8. 08Готово, з доказом під кожним критерієм. Дошка, граф зв’язків і мапа коду перебудовуються.
Агенти

6 агентів. Усім, крім одного, дозволено лише читати.

Радники перевіряють, планують і впорядковують, але нічого не змінюють. Один clerk зберігає лише те, що ви схвалили, після вашого «Так».

criticлише читання · незалежний

Після того як написано або змінено ADR, специфікацію, епік, сторі чи дизайн

Шукає слабкі місця, звіряє кожне твердження з джерелом і питає, де план може дати збій. Без лестощів.

opus · max
plannerлише читання · незалежний

Перед початком роботи над сторі (story plan)

Дивиться, де в коді живуть попередні епіки. Каже, де місце зміни, що використати повторно, на що зважати і в якому порядку працювати.

opus · max
reviewerлише читання · незалежний

Після написання коду, перед комітом або story close

Вимагає доказу для кожного критерію приймання, зокрема зі специфікації. Потім перевіряє коректність, регресії та тести.

opus · max
librarianлише читання · пропонує

Час від часу, перед релізами, коли vault швидко росте

Знаходить те, чого не впіймає жодне правило: дослідження, що суперечать прийнятому ADR, дублікати, відсутні зв’язки, файли, які час архівувати.

opus · max
archaeologistлише читання · пропонує

Один раз, після прив’язки наявної кодової бази

Знаходить рішення, які ніхто не записав, — у коді, конфігураційних файлах та історії git. Пропонує для них ADR із доказами.

opus · max
clerkпише · після вашого «Так»

Лише під час виконання команди ProjectStore, лише після вашого «Так»

Зберігає саме те, що ви схвалили, і нічого більше. Потім перебудовує дошку і запускає перевірки. Нічого не пише від себе і нічого не питає.

sonnet · max

Типові моделі — для Claude Code. У Codex кожна роль — це однойменний skill, що просить Codex запустити цю роль, наприклад $projectstore-critic для critic; він використовує модель сесії, якщо ви не задали іншу.

Запобіжники

Усе тримається на механізмах, а не на дисципліні.

Немає сторі — нагадування

Агентові, який почав правити код без відкритого сторі, нагадують його відкрити. Зміна розміром із фічу починається у vault.

Без рев’ю — позначка лишається

Артефакт, що потребує рев’ю, має review_status: pending, доки не застосовано прохід critic. «Ще без рев’ю» — це стан, який можуть прочитати інструменти, а не те, що хтось мусить пам’ятати.

Doctor без ШІ

doctor детерміновано перевіряє механічну узгодженість vault. У CI він працює без агента і без токенів.

Де шукати — згенеровано

graph.md містить зв’язки кожного артефакту в обох напрямках; code-map.md каже, де живе код кожного епіка. Перед архітектурним вибором агента спершу спрямовують до індексу ADR.

Після /compact vault повертається

У Claude Code після /compact, який ви запустили, сесія знову починається з огляду vault і з тих його файлів, яких торкалася розмова до стиснення.

Другу сесію попереджають

Сесія, що починається, коли інша працює над тим самим vault, відкривається з попередженням про кілька сесій: спершу пошукайте, потім створюйте щось нове.

«Готово» означає «доведено»

Сторі закривається з доказом під кожним критерієм.

epics/CHECKOUT/stories/story-saved-cards-are-listed-at-checkout.md
---
type: story
epic: "CHECKOUT"
title: "Saved cards are listed at checkout"
status: done
code_refs: ["src/billing/cards/", "tests/cards.test.ts"]
closed_at: "2026-07-14T16:02:11Z"
---

## Acceptance Criteria

- [x] Збережені картки показано першими — evidence: tests/cards.test.ts:21
- [x] Для відхиленої картки показано причину відмови банку — evidence: tests/cards.test.ts:58
- [x] Номер картки не потрапляє в логи — evidence: tests/cards.test.ts:73

Planner сказав, де місце зміни, ще до коду, і план потрапив у сторі після вашого «Так»; reviewer після цього звірив диф із кожним критерієм. Кожен рядок доказу — це тест, команда, що виконалась, або рядок коду.

Будь-який агент може прочитати цей запис, із плагіном чи без: через CLI, що відповідає у форматі JSON і не потребує токенів, або через 8 MCP-інструментів сервера лише для читання.

  • orientation
  • search
  • status
  • get_artifact
  • lineage
  • neighbors
  • code_refs
  • doctor
Дрібний шрифт

Чому це працює →Один vault, багато людей →Встановити →