docs(brainstorm-with-docs): добавлены ROADMAP и DEV-HANDOFF на время разработки
- Зачем:
- решения и рассуждения по скиллу были размазаны по памяти агента,
README и комментарию у шва; нужен durable in-repo источник, который
переживёт смену сессии и не зависит от конкретного агента.
- Что:
- ROADMAP.md: статус v1, отложенные решения (R1 рекомендованный ответ
на вопрос, R2 дотошность грилла, F1 строка дивергенции, F4 связь с
grill-with-docs, F5a docs/agents), v2-крупное и отклонённое (F6).
- DEV-HANDOFF.md: контекст для возобновления, неочевидные обоснования
(frontmatter-переносимость, гейт под auto mode, агайл), suggested skills.
- README.md: ссылка на ROADMAP с пометкой про dev-only docs.
- Проверка:
- markdown-ссылка README → ROADMAP.md резолвится.
This commit is contained in:
1 parent
f24b342123
commit
01d1de88d3
3 files changed
+134
No files matched your search
@@ -0,0 +1,55 @@
|
||||
# Roadmap & backlog — brainstorm-with-docs
|
||||
|
||||
Single source of truth for what's done, pending, and deferred. In-repo and
|
||||
versioned so it survives across sessions and tools (not just an agent's memory).
|
||||
|
||||
## Status
|
||||
|
||||
- **v1 — shipped.** Commits `50640d8` (initial) and `f24b342` (review fixes).
|
||||
Working hybrid: context inspection, glossary/`CONTEXT.md` + lightweight ADR
|
||||
discipline, active grilling, option comparison, durable artifacts, and a
|
||||
stop-before-implementation gate that allows investigation but forbids state
|
||||
changes.
|
||||
- **Next process step:** live test on real tasks (started ~2026-06-03). Findings
|
||||
feed the decisions below.
|
||||
|
||||
## Pending decisions (small, near-term)
|
||||
|
||||
- **R1 — restore "recommend an answer per question."** `grill-with-docs` and
|
||||
`grill-me` both require giving a recommended answer with each question; v1
|
||||
dropped it (likely accidental). Cheap to restore in `SKILL.md` step 4.
|
||||
*Decision pending: restore now, or after the first live test.*
|
||||
- **R2 — interview relentlessness.** v1 softened grill's "interview relentlessly,
|
||||
walk every branch" into "don't interview forever, move to synthesis" (from
|
||||
superpowers brainstorming). Decide after the live test whether it feels
|
||||
under-rigorous and needs hardening — or whether that's what `grill-with-docs`
|
||||
stays for (see R4).
|
||||
- **F1 — divergence one-liner.** Add one `<core_rule>`: "among the options, at
|
||||
least one must be something the user did not already imply." Deliberately
|
||||
deferred to keep the v1 baseline test clean. Marked as `TODO(F1)` at the SEAM
|
||||
in `SKILL.md` step 5. Reconsider right after the first live test.
|
||||
- **F4 — relationship to `grill-with-docs`.** This skill overlaps it (grill +
|
||||
CONTEXT/ADR). Decide: document when-to-use-which in `README.md`, or supersede
|
||||
`grill-with-docs`. Not a strict superset (we lack full multi-context, R2).
|
||||
- **F5a — read `docs/agents/*.md` in step 1.** On repos using Matt Pocock's
|
||||
skill-config convention, the spec/layout path is more reliable from there than
|
||||
guessing. Cheap addition to the step-1 read list.
|
||||
|
||||
## v2 (larger)
|
||||
|
||||
- **Divergence phase** at the SEAM (`SKILL.md` step 5): full idea-generation
|
||||
toolkit — axis of variation, archetype stances (MVP / robust / radical),
|
||||
inversion, steal-from-adjacent-domain, cost-shifting, pre-mortem, constraint
|
||||
relaxation, null option. F1 is the cheap precursor to this.
|
||||
- **"Design for isolation / clarity" lens** (from superpowers brainstorming):
|
||||
evaluate options by whether each unit has one clear purpose and a clean
|
||||
interface.
|
||||
- **Fuller multi-context.** v1 handles a single root `CONTEXT.md` and only
|
||||
mentions `CONTEXT-MAP.md`. Restore grill-with-docs's full model: `CONTEXT-MAP.md`
|
||||
+ per-context `CONTEXT.md` + per-context `docs/adr/` + a Relationships section.
|
||||
|
||||
## Rejected (do not revisit without new evidence)
|
||||
|
||||
- **F6 — "space-separated `allowed-tools` won't parse."** False. Claude Code docs
|
||||
accept space- or comma-separated or YAML list; and `allowed-tools` is
|
||||
pre-approval, not a restriction. No change needed.
|
||||
Reference in new issue
Block a user