0 Fork 0

Files

T

ddadmin 01d1de88d3 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 резолвится.

2026-06-03 00:01:46 +03:00

3.0 KiB

Raw Blame History

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.

3.0 KiB Raw Blame History