Skip to content

enhance(spec-grill): require multi-class evidence for capability admission #185

@sungjunlee

Description

@sungjunlee

Context

spec-grill already says raw extraction signals are not accepted specs, but capability admission can still lean too heavily on a directory name, commit scope, or single script surface. The desired behavior is deeper confidence before a candidate becomes a durable capability contract.

Desired change

Strengthen capability admission with a multi-evidence rule.

A capability should normally need at least two evidence classes before it is accepted, for example:

  • system-map boundary + scripts
  • source surface + tests
  • README/product signal + command surface
  • recurring commits + docs/tests

A single strong user statement can still override this, but the report should say so explicitly.

Acceptance Criteria

  • skills/spec-grill/SKILL.md admission test requires multiple evidence classes for accepted brownfield capabilities unless explicitly user-authorized.
  • skills/spec-grill/references/capabilities.md explains surface signal vs code-understood evidence with examples.
  • Grill reports distinguish raw signal, supporting evidence, and missing evidence clearly.
  • Directory-only or commit-scope-only candidates remain interview seeds, not accepted capabilities.
  • Existing tests or eval prompts are updated to cover weak-evidence candidate refusal.

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