cordsjon

sh:dor

0
0
# Install this skill:
npx skills add cordsjon/20_agentflow --skill "sh:dor"

Install specific skill from multi-skill repository

# 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.

# SKILL.md


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.

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.