Review Spec Auto

Read a spec artifact READ-ONLY and emit a findings-first review report to the active thread's inbox/open/ folder. This skill reads the spec, checks every one of the eight semantic-contract elements against the handoff-grade bar, drafts the report end-to-end, and writes one record per review run. It does not ask clarifying questions and it does not walk findings with the user one-at-a-time. It does not commit.

Inputs

This skill accepts ONE input: the path to a spec artifact. The path may be passed absolute or relative to the repo root.

If the path is not supplied, ASK the user which spec to review — do not pick by recency. If multiple plausible spec artifacts exist and the user's reference is vague ("the spec", "the latest spec", "v2", "the auth spec"), ASK the user which artifact is intended. There is NO global "latest spec" algorithm and no fallback to the highest version number. Silently picking by version or recency would hide a real decision — which spec variant the user intends to review, which version branch survived discussion — behind a sort order. If v2-onboarding-spec.md and v2-spec.md coexist, ASK.

Eight Semantic-Contract Elements

A spec MUST cover all EIGHT of the following elements in its body. This skill checks every one of them against the handoff-grade bar: