feat(skills): добавлен скилл brainstorm-with-docs (v1)
- Зачем:
- нужен ручной скилл для брейнсторма и дизайна, который удерживает
словарь смыслов (CONTEXT.md) и лёгкие ADR, активно прожаривает план
и не сваливается в реализацию.
- Что:
- SKILL.md: процесс (контекст → классификация → декомпозиция →
грилл → синтез опций → подтверждение → артефакт), единый HARD-GATE
«исследуй, но не меняй состояние» с поправкой на auto mode.
- artifacts/: шаблоны spec, research-note, adr, runbook, prd, context
(по файлу на тип для progressive disclosure).
- README.md с MIT-атрибуцией grill-with-docs (Pocock) и brainstorming
(obra/superpowers); шов для будущей фазы дивергенции в шаге 5.
- frontmatter переносим: Claude читает все поля, Codex — name+description.
- Проверка:
- python3 yaml-парс frontmatter; markdown-ссылки на artifacts/ резолвятся.
This commit is contained in:
1 parent
0a348da22a
commit
50640d8cb5
8 files changed
+572
No files matched your search
@@ -0,0 +1,38 @@
|
||||
# Research Note
|
||||
|
||||
Use when the work is exploratory and the final answer is not yet known. The
|
||||
output is *findings and a direction*, not a committed design.
|
||||
|
||||
When the question is resolved, the research note often graduates into a spec
|
||||
(`artifacts/spec.md`) or an ADR (`artifacts/adr.md`).
|
||||
|
||||
## Template
|
||||
|
||||
```markdown
|
||||
# Title
|
||||
|
||||
## Question
|
||||
|
||||
## Context
|
||||
|
||||
## Known facts
|
||||
|
||||
## Assumptions
|
||||
|
||||
## Options / hypotheses
|
||||
|
||||
## Findings
|
||||
|
||||
## Recommendation
|
||||
|
||||
## Remaining unknowns
|
||||
|
||||
## Next checks
|
||||
```
|
||||
|
||||
## Notes
|
||||
|
||||
- Keep **Known facts** and **Assumptions** strictly separate. Conflating them is
|
||||
how a guess hardens into an unexamined "fact".
|
||||
- **Remaining unknowns** and **Next checks** are what make a research note
|
||||
useful to the next agent — they say where to dig next.
|
||||
Reference in new issue
Block a user