Decision 0006 · Accepted
Flow Lite skill and
flat documentation
Decision 0004 retired the flow workflow router and kept the catalog fully manual.
- Status
- Accepted
- Built from:
- da88c48
Status: accepted (2026-10-27)
Context
Decision 0004 retired the flow workflow router and kept the catalog fully manual. Product direction now calls for the smallest useful system: one tiny context-alignment skill, optional manual skills, flat durable docs, and zero-friction adoption without adopter instruction-file changes.
Decision
- Reintroduce
flowas Flow Lite only — alignPRODUCT.md,DESIGN.md,GLOSSARY.md, andARCHITECTURE.mdafter meaningful changes. It is not a pipeline router, orchestrator, or bootstrap. - Invocation split —
flowusesdisable-model-invocation: falseandagents/openai.yamlwithallow_implicit_invocation: trueso hosts may surface it when supported. All other catalog skills remain explicit-only (disable-model-invocation: true,allow_implicit_invocation: false). - Flat durable docs for adopters — default new work to
docs/specs/NNN-short-name.mdand significant rationale todocs/decisions/NNN-short-name.md. Do not introduce PRD, PDR, or ADR parallel trees or mandatory idea/initiative folders. - This repository — move
docs/ideas/anddocs/initiatives/out of the active structure intodocs/archive/. Keepdocs/research/and references.md as maintainer evidence, not adopter scaffolding.
Consequences
- Validator and tests include
flow(fourteen skills after 0005). - Catalog documentation and product narrative describe Flow Lite separately from optional delivery and discovery skills.
- Contributors record bounded work in specs and decisions; root documents stay the current product, design, architecture, and shared-language position.
Supersedes
Partially supersedes 0004 regarding retirement of the flow skill id. The portable catalog, install path, and manual-invocation policy for non-flow skills remain in force.