Skip to content

enhance(spec-grill): route natural-language intent instead of requiring mode arguments #177

@sungjunlee

Description

@sungjunlee

Summary

Replace the argument-first spec-grill invocation contract with an intent router. Users should not need to memorize modes like map, fill, or audit; those can remain accepted power-user aliases, but the primary workflow should be natural-language routing.

Proposed Behavior

  • No argument or ambiguous request -> emit a Grill Report, no edits.
  • Candidate discovery language -> emit a Candidate Boundary Report, no edits.
  • Missing capability language -> propose the next missing capability, then ask for confirmation before editing.
  • Specific capability language -> resolve the mentioned capability or candidate and deep-review it, no edits by default.
  • Overlap, stale, or weak-predicate language -> emit a Capability Audit Report, no edits.

Acceptance Criteria

  • skills/spec-grill/SKILL.md has an Intent Router section instead of an argument-first Invocation section.
  • The skill explicitly says users do not need to memorize arguments.
  • Power-user aliases such as map, fill, audit, and exact capability slugs are documented as optional shorthand only.
  • Ambiguous requests are report-only by default.
  • Editing requires clear edit intent or explicit confirmation.

Notes

Part of #176.

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