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/ резолвятся.
39 lines
809 B
Markdown
39 lines
809 B
Markdown
# PRD — Product Requirements Document
|
|
|
|
Use **only** for product-facing work with user-visible behaviour. For internal
|
|
engineering, infra, or architecture work use `artifacts/spec.md` instead — don't
|
|
force everything into a PRD.
|
|
|
|
## Template
|
|
|
|
```markdown
|
|
# Title
|
|
|
|
## Problem statement
|
|
|
|
## Users
|
|
|
|
## Goals
|
|
|
|
## Non-goals
|
|
|
|
## User stories
|
|
|
|
## Requirements
|
|
|
|
## Out of scope
|
|
|
|
## Success criteria
|
|
|
|
## Open questions
|
|
```
|
|
|
|
## Notes
|
|
|
|
- A PRD describes *what* and *why* from the user's point of view, not *how*. The
|
|
engineering "how" belongs in a spec.
|
|
- **Non-goals** and **Out of scope** are deliberately separate: non-goals are
|
|
things we chose not to optimise for; out of scope is work explicitly deferred.
|
|
- **Success criteria** must be observable — how will we know the behaviour is
|
|
right once shipped?
|