spec-aligning

star 19

Verifies implementation aligns with stated requirements and acceptance criteria. Use before implementation (to clarify scope) and before final sign-off (to detect gaps).

haowjy By haowjy schedule Updated 3/1/2026

name: spec-aligning description: Verifies implementation aligns with stated requirements and acceptance criteria. Use before implementation (to clarify scope) and before final sign-off (to detect gaps).

Spec Alignment

Use this skill to sanity-check whether work matches intent.

When Invoked

Good fit when:

  • requirements are spread across multiple messages/files;
  • a large change needs a quick "did we build the right thing?" pass;
  • review or test signals conflict on expected behavior.

Inputs

Use whichever requirement sources are available, typically:

  • explicit user instructions;
  • plan/spec docs (plans, ADRs, acceptance notes);
  • tests that encode intended behavior;
  • recent implementation/review reports.

If sources conflict, call that out and proceed with the most defensible interpretation.

Suggested Approach

Suggested flow (adapt as needed):

  1. Extract the key requirements that matter for the decision at hand.
  2. Compare those requirements against available evidence (code/tests/reports).
  3. Identify confirmed alignment, likely gaps, and unresolved unknowns.
  4. Propose the smallest next step to reduce uncertainty or close a gap.

Output

Keep output concise and decision-oriented. A short structure that often works:

  • what appears aligned;
  • what looks misaligned or risky;
  • what is still unknown;
  • what to do next.

Use explicit evidence when possible, but keep the format flexible for the task.

Install via CLI
npx skills add https://github.com/haowjy/orchestrate --skill spec-aligning
Repository Details
star Stars 19
call_split Forks 4
navigation Branch main
article Path SKILL.md
More from Creator