avandClaude Opus 4.8
2fb533e0e6
Конвейер собран по типу проходов, а не по ролям: гейт (детерминированный, блокирующий) → сверка с дельта-спеками в обе стороны → generative-проходы → архитектура → враждебные постановки → обязательный триаж. Профили quick / standard / deep / design с правилом выбора по факту изменения. Контракт находок: заголовок через последствие, обязательное поле «Последствие», critical без оракула или построенного пути не существует, потолок 7 пунктов и разметка «инлайн | развилка» — отчёт читает оркестратор и молча реализует прочитанное, поэтому потолок защищает код от незаказанных правок. Храповик находка → конвенция → правило → удаление из прозы и промптов; журнал проскочивших дефектов и калибровка инъекцией с вердиктами keep/retune/drop. Секция границ покрытия обязательна: отчёт без неё потребляет ощущение проверенности, ничего не гарантируя. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
24 lines
1.7 KiB
Markdown
24 lines
1.7 KiB
Markdown
# Документация jellybit
|
|
|
|
Три раздела с разной ролью — не путать:
|
|
|
|
- **[specs/](specs/)** — спецификации. Описывают **целевое и текущее**
|
|
устройство системы. Живые и изменяемые: правим по мере развития,
|
|
держим в соответствии с кодом. Отвечают на вопрос «как устроено».
|
|
|
|
- **[adr/](adr/)** — Architecture Decision Records. **Неизменяемый**
|
|
журнал значимых решений, пишется **постфактум**. Хранит главное —
|
|
*почему* так сделано. Передумали → не правим старую запись, заводим
|
|
новую. Процесс — в [adr/README.md](adr/README.md).
|
|
|
|
- **[drafts/](drafts/)** — черновики: заметки, мысли, планы на будущее,
|
|
ещё не принятые решения. Не источник истины и ни к чему не обязывают.
|
|
Когда черновик становится реальностью — его место в specs (как
|
|
устроено) и/или adr (почему решили).
|
|
|
|
Рядом лежат ещё два прикладных раздела: **[conventions/](conventions/)** —
|
|
как мы пишем код (то, что не выражается правилом линтера), и
|
|
**[review/](review/journal.md)** — журнал дефектов, проскочивших ревью:
|
|
эвал-сет для калибровки конвейера
|
|
[review-pipeline](../.claude/skills/review-pipeline/SKILL.md).
|