Decision 0070 · Accepted
A research skill, clearer names, and an outcome in every
initiative spec
Flow should help a person discover that something already solves the problem, decline work against the product, or test cheaply before building. Three gaps stand in the way.
- Status
- Accepted
- Built from:
- da88c48
Status: Accepted (2026-11-08). Spec: 070. Amends 0062 (catalog: product and flow renamed, research added after spec 059 removed competitors). Builds on 0041, 0046, and 0068 (the new-skill test).
Context
Flow should help a person discover that something already solves the problem, decline work against the product, or test cheaply before building. Three gaps stand in the way.
- No owner for an explicit research request. Spec 059 removed
competitorsafter one read-only comparison in which it and no skill each scored 10/15 (record). That run judged a one-off answer's constraints, insight, and usefulness. It did not test proactive consideration of alternatives inexplore, a durable artifact from an explicit request, or whether another session can decide from that artifact. - Names that hide jobs.
productchecks fit and evidence, read-only;flowwrites root documents and shares the plugin's name. Users say "check alignment" and "sync the docs". - No outcome sentence. A spec proves the behavior works, not how anyone will judge whether to keep it, so "did it land?" has nothing to look for.
Decision
- Add
research. One skill for "research X" (a sourced note in the project's research home), "competitors for X" (a competitive brief), and "just tell me here" (chat). It passes 0068's test: a recognizable job; source discipline beyond ordinary reasoning (dated findings, observed capability apart from vendor claim and inference, no absence claimed from a failed search); a durable artifact another session can decide from;explorekeeps research it does for a conversation in chat and so does not cover the artifact; optional; and about 450 words. A research write never adopts a recommendation or editsPRODUCT.md. - Rename
producttoalign("check alignment", "are we building the right thing", "did it land"), restoring 0041's name for the same read-only job. Renameflowtosync-docs("sync the docs", "update the docs", "set up Flow here");flowstays the plugin and project name. No alias skills: natural phrases carry over, explicit slash paths change, and the Flow block's pointer is rewritten on its next write. - An initiative spec carries one outcome sentence: what should change for whom, the evidence that will be looked at, and the decision it informs. It references an existing metric definition rather than copying it (0046). Delivery proof (the behavior works and the observation can be obtained) stays distinct from outcome evidence, which
alignjudges after shipping. A typo or internal cleanup carries none.
Alternatives
- Restore
competitorsas it was. Rejected: it tied with no skill as an answer generator; the gap is the artifact and the general research request, and a competitive brief is one use of research. - Fold research into
explore. Rejected:exploreis write-free discussion, and folding a write path into it would weaken that guarantee. - Keep the old names and improve descriptions. Rejected:
flowas a skill and a plugin (/flow:flow) andproductas a check both mislead; descriptions alone did not reach "check alignment". - Keep alias skills for the old names. Rejected: two identical skills in every listing cost words and confuse invocation.
- A metrics section or dashboard in every spec. Rejected: one sentence answers "how will we know"; instrumentation enters scope only when the decision depends on it.
Consequences
- The catalog grows to 15 skills, and the skill-word budget from 10,000 to 10,500 (spec 070).
- Users with saved
/flow:productor/flow:flowhabits must use the new paths; phrases are unaffected. explorelooks for existing alternatives on substantial work, which costs a search on those decisions and saves a build when something already fits.- Whether the research artifact and the alternatives step change decisions is unmeasured; spec 070's outcome line names the observation.