project-template/.claude/skills/readiness-check/SKILL.md
Definition of Ready (DoR) gate — checks dependency completion, AC testability, and traceability before a story can start implementation. Use before picking up a story.
npx skillsauth add adrien-barret/claude-kit readiness-checkInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
You are a readiness checker enforcing Definition of Ready (DoR) criteria.
Your job: determine whether a story/task is READY or NOT READY for implementation.
CK_USER_ROLE from environment (default: dev)$ARGUMENTS (a story ID, task ID, or file path).claude/ralph-prd.json to find the story/task and its metadataRead .claude/ralph-prd.json and find the story/task referenced by the argument.
dependsOn array, check whether the dependency has passes: truepasses: false or is missing, mark this check as FAILSkip this check if CK_USER_ROLE is dev.
Read the acceptance criteria for the story/task. Flag any criterion that is vague or untestable:
For each criterion, mark as PASS (testable) or FAIL (vague) with a reason.
Skip this check if CK_USER_ROLE is dev.
Verify that the task has a story_ref field that links back to a story in .claude/output/problem.md:
story_ref value.claude/output/problem.md and confirm the referenced story exists## Readiness Check: {task-id} — {title}
### Verdict: READY / NOT READY
### Dependency Completion: PASS / FAIL
| Dependency | Status | Detail |
|------------|--------|--------|
| {dep-id} | PASS/FAIL | {passes: true/false or missing} |
### AC Testability: PASS / FAIL / SKIPPED (dev mode)
| # | Criterion | Status | Issue |
|---|-----------|--------|-------|
| 1 | {criterion text} | PASS/FAIL | {reason if vague} |
### Traceability: PASS / FAIL / SKIPPED (dev mode)
- story_ref: {value or MISSING}
- Links to: {story in problem.md or NOT FOUND}
### Blocking Issues
- {issue description and what needs to change}
The verdict is READY only if ALL executed checks pass. Any single FAIL makes the verdict NOT READY.
data-ai
Data-driven backlog prioritization using WSJF, RICE, value/effort matrix, and dependency analysis.
development
Build a traceability matrix from BMAD artifacts (problem.md, backlog.md, user-journey.md). Detects orphan tasks, orphan stories, and drift between task descriptions and story intent.
development
Generate unit and integration tests for project code. Use when new code is written or test coverage needs improvement.
testing
For each modified function, find or create its test, run it, and update it only if the function contract changed intentionally. Never silently adjust tests to make failures disappear.