sh-dor

name	sh-dor
description	Run the Definition of Ready gate check before implementing a task. Verifies a task is ready for implementation including spec-panel score >= 7.0 requirement.

Definition of Ready (DOR) Gate

Gate: Must pass BEFORE implementation begins. An item that fails DOR cannot enter TODO-Today queue. It stays in BACKLOG#Refining.

Full DOR Checklist

• User Stories defined — at least 1 US with "As a [role], I want [goal], so that [benefit]"
• Acceptance Criteria written — each US has explicit, testable AC (Given/When/Then or bullet list)
• Spec document exists — requirements doc with functional requirements
• Spec panel score >= 7.0 — /sh:spec-panel critique passed (or issues addressed and re-scored). Score below 7.0 blocks graduation to Ready
• Architecture decided — if new modules/APIs: design doc exists
• Dependencies identified — any blocking work listed and either complete or explicitly deferred
• Test strategy known — which test types needed (unit, integration, E2E), approximate count
• No constraint violations — feature doesn't conflict with project's constraints
• Estimated size — S (1-3 queue items), M (4-8), L (9+) — tagged in BACKLOG

Bug DOR-lite

Lightweight gate for [bug] or [hotfix] items. No US template, no spec-panel score required.

• Root cause identified — specific file/line/mechanism documented
• Fix plan — 1-3 concrete steps; if > 3 steps it's a feature, use full DOR
• Regression test named — which test file + test case will catch this
• No constraint violations — fix doesn't conflict with project constraints
• Estimate — XS (1 item) or S (2 items); larger = use full DOR

Hotfix Fast-Track

If a bug is actively blocking development (server down, build broken, data corruption):

1. Add bullet to INBOX.md immediately
2. Triage classifies as [hotfix], moves directly to TODO-Today (skips Ideation/Refining)
3. Bug DOR-lite satisfied at triage time
4. Autopilot executes as next queue item

Enforcement

Gate: Score >= 7.0 + all checklist items -> graduate to Ready
Any item missing or score < 7.0 -> stay in Refining, iterate

The /sh:workflow skill MUST NOT generate a queue for an item that hasn't passed DOR.