govkit-spec-planning

name	govkit-spec-planning
description	Generate a feature plan (plan.md) and eval_criteria.yaml from NFRs and acceptance scenarios. Use when the user asks to plan a feature or invokes /govkit-spec-planning.

Spec Planning

Plan the implementation of the named feature. When invoked, determine the feature name from the user's request; if it is not provided, ask before proceeding.

Inputs to read

Feature specs:

• NFRs: features/<feature_name>/nfrs.md
• Acceptance: features/<feature_name>/acceptance.feature

Architecture standards:

• docs/{{docs_area}}/architecture/ (all files)

Evaluation standards:

• docs/{{docs_area}}/evaluation/eval_criteria.md

Existing artifacts (read if present, update if needed):

• features/<feature_name>/eval_criteria.yaml

Instructions

1. Read all inputs listed above.
2. Summarize the business goal and scope of the feature. 2a. Populate the plan's ### Out of scope from nfrs.md ## Out of scope:
   • If nfrs.md has a non-empty ## Out of scope section, copy its entries into the plan verbatim (author-declared — no marker).
   • If ## Out of scope is missing or empty, infer the deferred capabilities from the spec's negative space (domain neighbors with no scenarios), then BOTH:
     • insert <!-- INFERRED: not declared in nfrs.md ## Out of scope; confirm with feature owner --> directly under the plan's ### Out of scope heading, and
     • state in the planning summary that Out-of-scope was inferred and should be confirmed.
3. Identify required design elements aligned to Hexagonal Architecture:
   • Inbound ports (ports/inbound/)
   • Domain logic modules (services/)
   • Outbound ports (ports/outbound/)
   • Adapters (adapters/)
   • API route entrypoints (api/)
4. Flag any deviation from architecture contracts:
   • ARCH_CONTRACT.md, BOUNDARIES.md, API_CONVENTIONS.md, SECURITY_AUTH_PATTERNS.md
5. Determine ADR need. Mark ADR required if any of these occur:
   • New outbound dependency or external integration
   • Boundary change or exception
   • New pattern or approach not already documented

Output A: Plan

Write features/<feature_name>/plan.md with:

• Task checklist (files/modules to create or edit)
• Test plan (unit, integration, contract)
• LLM eval hooks and where they run
• Risks, open questions, and follow-ups
• ADR status (required or not required)

Output B: Feature Eval Criteria

Write or update features/<feature_name>/eval_criteria.yaml conforming to docs/{{docs_area}}/evaluation/eval_criteria.md. Include at minimum:

• FIRST enforcement settings
• 7 Virtues enforcement settings
• Any LLM-specific dimensions required by this feature
• Dataset or prompt-set reference placeholder
• Fail-on-regression behavior

Output A first, then Output B. No implementation code in this step.

Data projects

For data projects (marker type: data), adjust the spec outputs:

• NFR categories are freshness, quality, pii, lineage, cost (plus reliability, observability, compliance where relevant). Tag scenarios @nfr-<category> — the eval gate cross-checks every populated category against the tags.
• eval_criteria.yaml uses the data schema: mode: deterministic (or none), and each criterion's measurement names a query or CI check with threshold as a predicate string. No LLM evaluator tools.
• Cite the data quality, freshness, and lineage contracts under docs/data/architecture/ instead of API conventions and auth patterns.