dev-spec-kit research — ground the spec in current sources, never invent
dev-spec-kit's law is research-first, never-invent: every non-obvious claim traces to a source. Before a requirement that depends on outside knowledge is finalized, gather current context and attach it.
Steps
- Scope to the requirement/intake at hand and the specific question ("current OAuth 2.1 PKCE requirements", "the vitest JSON reporter schema").
- Search + read — use the web tools; open the primary/authoritative sources (official docs, RFCs, the library's own repo), not just summaries.
- Adversarially check the key claims against a second source before relying on them; note anything you could not confirm.
- Write back the findings into the intake/spec as a short, cited evidence block (claim → URL), linked to the requirement it informs. Keep it tight — the most decision-relevant facts only.
Rules (RFC-2119)
- Every factual claim you add MUST carry its source URL; an uncited "best practice" is exactly the invention this skill exists to prevent.
- You MUST flag staleness and disagreement between sources rather than silently picking one.
- Research informs the criteria; it does not replace them — the requirement still needs a bound,
falsifiable
@check. Findings can become akind=judgerubric only when the criterion is genuinely unmeasurable by a test. - Verify claims against the actual page (fetch it); do not answer "current" questions from memory.