Skip to content

spec-series: split capability contract authoring into spec-grill #158

@sungjunlee

Description

@sungjunlee

Problem

The old backlog-charter grill mode is the right workflow for spec/capabilities.md, but it is hidden behind a CHARTER-named skill. On existing repos, users naturally need a second layer after CHARTER.md; without a discoverable skill they stop too early.

Proposal

  • Create skills/spec-grill/SKILL.md for spec/capabilities.md create/refine.
  • Move the capabilities template, extract-signals helper, tests, and grill heuristics under spec-grill.
  • Make brownfield/onboarding language explicit: after spec-charter create, existing repos should be guided to spec-grill.

Acceptance Criteria

  • skills/spec-grill/SKILL.md exists and declares name: spec-grill.
  • spec-grill frontmatter discovers capability specs, component contracts, repo boundaries, and grill phrasing.
  • extract-signals output points to spec-grill, not backlog-charter grill.
  • Existing tests for signal extraction still pass.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions