Update AGENTS.md and various SKILL.md files to improve documentation structure, clarify design phase references, and ensure consistency in file paths. Adjust links to design documents for better navigation and organization across phases.
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: phase-review
|
||||
description: Ревью срезов и фаз проекта h-school по их же критериям приёмки — с дописыванием недостающих тестов, исправлением найденного и журналом проверенного в docs/phases/reviewed.md. Обязательно используй этот скилл, когда просят «сделай ревью», «проведи ревью», «проверь срез», «проверь непроверенные срезы», «что ещё не проверено», «review the slice» — и вообще при любой просьбе проверить, действительно ли сделанная фаза сделана. Не для ревью одного диффа или пул-реквеста: там нужен /code-review. Не для волны разработчиков — /phase-orch (он может запустить этот скилл как одного из агентов). Не для планирования нового среза — /slice-work.
|
||||
description: Ревью срезов и фаз проекта h-school по их же критериям приёмки — с дописыванием недостающих тестов, исправлением найденного и журналом проверенного в docs/phases/<slice>/reviewed.md. Обязательно используй этот скилл, когда просят «сделай ревью», «проведи ревью», «проверь срез», «проверь непроверенные срезы», «что ещё не проверено», «review the slice» — и вообще при любой просьбе проверить, действительно ли сделанная фаза сделана. Не для ревью одного диффа или пул-реквеста: там нужен /code-review. Не для волны разработчиков — /phase-orch (он может запустить этот скилл как одного из агентов). Не для планирования нового среза — /slice-work.
|
||||
---
|
||||
|
||||
# Ревью срезов
|
||||
@@ -16,8 +16,9 @@ description: Ревью срезов и фаз проекта h-school по их
|
||||
|
||||
## Журнал
|
||||
|
||||
`docs/phases/reviewed.md` — единственный источник правды о том, что уже проверено. Если файла
|
||||
нет, создай его с заголовком и одной строкой о том, что это такое.
|
||||
`docs/phases/<slice>/reviewed.md` — правда о проверке **этого** среза. Сводка ссылок —
|
||||
короткий `docs/phases/reviewed.md`. Чужие журналы не читать. Если файла среза нет, создай
|
||||
его и добавь строку в сводку.
|
||||
|
||||
Раздел на срез:
|
||||
|
||||
@@ -38,8 +39,9 @@ description: Ревью срезов и фаз проекта h-school по их
|
||||
|
||||
## Как выбрать, что проверять
|
||||
|
||||
1. Прочитай `docs/phases/README.md` — там срезы, их фазы и статусы.
|
||||
2. Прочитай журнал.
|
||||
1. Оглавление `docs/phases/README.md` и сводка `docs/phases/reviewed.md` — только чтобы выбрать
|
||||
срез. Дальше — индекс, фазы и `reviewed.md` **этой** папки, не остальные.
|
||||
2. Прочитай журнал этого среза.
|
||||
3. Срез попадает в очередь, если:
|
||||
- его нет в журнале; **или**
|
||||
- `git log <коммит-из-журнала>..HEAD -- <пути среза>` непустой — код менялся после проверки;
|
||||
@@ -80,7 +82,7 @@ description: Ревью срезов и фаз проекта h-school по их
|
||||
**3. «Things that will bite you».** Этот раздел `AGENTS.md` — список уже случившихся регрессий.
|
||||
Проверить, что ни одна не вернулась, дешевле, чем поймать её второй раз.
|
||||
|
||||
**4. Дизайн-док среза** (`docs/design/*.md`, ссылка есть в индексе фаз). Расхождение кода с
|
||||
**4. Дизайн-док среза** (`docs/design/<slice>/`, ссылка есть в индексе среза). Расхождение кода с
|
||||
принятым решением — находка, даже если тесты зелёные. Но сначала спроси себя, не устарел ли док:
|
||||
бывает, что решение сознательно поменяли, и тогда чинить надо документ.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user