ddadmin
50640d8cb5
- Зачем:
- нужен ручной скилл для брейнсторма и дизайна, который удерживает
словарь смыслов (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/ резолвятся.
753 B
753 B
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
# 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.