Menu
Verify that a fresh agent can take over the RDD project from documentation alone
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/kofj/rdd --skill rdd-fresh-checkThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
| name | rdd-fresh-check |
| description | Verify that a fresh agent can take over the RDD project from documentation alone |
Purpose: Verify that a fresh agent can take over the project from documentation alone.
The fresh-agent-check is a critical quality gate that ensures project documentation is complete enough for a new agent to continue work without requiring tacit knowledge from previous sessions.
When to Use:
Command: /rdd-fresh-check [--verbose]
Without fresh-agent-check, projects accumulate:
Fresh-agent-check simulates a new agent reading only the documentation to verify:
┌─────────────────────────────────────────────────────────────┐
│ FRESH AGENT CHECK │
├─────────────────────────────────────────────────────────────┤
│ 1. Can I understand what this project does? │
│ Read: docs/01-charter.md │
│ Question: What is the vision and goals? │
│ │
│ 2. Can I understand where we are? │
│ Read: docs/stages/stage-roadmap.md │
│ Question: What is the current stage and progress? │
│ │
│ 3. Can I understand what to do next? │
│ Read: docs/11-next-steps.md │
│ Question: What is the immediate next action? │
│ │
│ 4. Can I understand past decisions? │
│ Read: docs/08-autonomous-decisions.md │
│ Question: Why were key decisions made? │
│ │
│ 5. Can I understand known issues? │
│ Read: docs/12-technical-debt.md │
│ Question: What needs to be fixed? │
│ │
│ 6. Can I understand current stage details? │
│ Read: docs/stages/stage-N.md │
│ Question: What are we building and why? │
│ │
│ 7. Can I take over without asking questions? │
│ Question: Is there any missing context? │
│ │
└─────────────────────────────────────────────────────────────┘
After reading docs/01-charter.md:
## Project Understanding Checklist
[ ] I can state the project vision in one sentence
[ ] I can list the primary goals (3-5)
[ ] I know what is explicitly out of scope
[ ] I understand the success criteria
[ ] I know the key stakeholders
If any answer is "No": Charter is incomplete
After reading docs/stages/stage-roadmap.md:
## Progress Understanding Checklist
[ ] I know which stage is currently active
[ ] I know the overall progress percentage
[ ] I understand the stage dependencies
[ ] I know what stages are complete
[ ] I know what stages are upcoming
If any answer is "No": Roadmap is incomplete
After reading docs/11-next-steps.md:
## Next Action Checklist
[ ] I know exactly what to do next
[ ] The next action is specific and actionable
[ ] I know how to execute the next action
[ ] I understand the expected outcome
[ ] I know about any blockers
If any answer is "No": Next steps are incomplete
After reading docs/08-autonomous-decisions.md:
## Decision History Checklist
[ ] Key decisions are documented
[ ] Each decision has background context
[ ] Each decision has rationale
[ ] Each decision has impact on subsequent stages
[ ] Alternatives considered are documented
If any answer is "No": ADRs are incomplete
After reading docs/12-technical-debt.md:
## Known Issues Checklist
[ ] All known issues are listed
[ ] Each issue has priority
[ ] Each issue has resolution plan
[ ] Each issue has source stage
[ ] Critical issues are identified
If any answer is "No": Tech debt ledger is incomplete
After reading docs/stages/stage-N.md:
## Current Stage Checklist
[ ] Goals are clear and specific
[ ] Non-goals are explicit
[ ] Hypotheses are testable
[ ] Acceptance criteria are measurable
[ ] Rollback plan is defined
[ ] Implementation notes are current (if in progress)
If any answer is "No": Stage document is incomplete
Final verification:
## Context Completeness Checklist
[ ] I can continue work without asking clarifying questions
[ ] I don't need to read code to understand the project
[ ] I don't need historical knowledge from previous sessions
[ ] All technical terms are explained or linked
[ ] All assumptions are documented
If any answer is "No": Context is incomplete
Symptom: Documentation refers to things not explained.
Examples:
Fix: Make implicit knowledge explicit.
Symptom: Decisions or code can't be understood from docs alone.
Examples:
Fix: Add the missing context to documentation.
Symptom: Documentation doesn't match reality.
Examples:
Fix: Update documentation to current state.
Symptom: References to non-existent or wrong documents.
Examples:
Fix: Fix or remove broken references.
Read each document in order and answer the check questions:
1. Read docs/01-charter.md → Answer Project Understanding questions
2. Read docs/stages/stage-roadmap.md → Answer Progress questions
3. Read docs/11-next-steps.md → Answer Next Action questions
4. Read docs/08-autonomous-decisions.md → Answer Decision History questions
5. Read docs/12-technical-debt.md → Answer Known Issues questions
6. Read docs/stages/stage-N.md → Answer Current Stage questions
7. Answer Context Completeness questions
# Run automated verification
task rdd:fresh-check
# Or with verbose output
task rdd:fresh-check --verbose
═══════════════════════════════════════════════════════════════
FRESH AGENT CHECK REPORT
═══════════════════════════════════════════════════════════════
Project: [Project Name]
Date: YYYY-MM-DD HH:MM
───────────────────────────────────────────────────────────────
SECTION STATUS ISSUES
───────────────────────────────────────────────────────────────
Project Understanding ✅ PASS 0
Progress Understanding ✅ PASS 0
Next Action ✅ PASS 0
Decision History ⚠️ WARN 2
Known Issues ✅ PASS 0
Current Stage ✅ PASS 0
Context Completeness ⚠️ WARN 1
───────────────────────────────────────────────────────────────
OVERALL ⚠️ WARN 3 issues
───────────────────────────────────────────────────────────────
ISSUES FOUND
───────────────────────────────────────────────────────────────
1. [Decision History] ADR-3 is missing "Impact on Subsequent Stages"
File: docs/08-autonomous-decisions.md
Fix: Add impact section to ADR-3
2. [Decision History] ADR-5 references ADR-2 but ADR-2 doesn't exist
File: docs/08-autonomous-decisions.md
Fix: Create ADR-2 or fix reference
3. [Context Completeness] Term "MVP cache layer" used but not explained
File: docs/stages/stage-2.md
Fix: Add explanation or link to definition
───────────────────────────────────────────────────────────────
RECOMMENDATION
───────────────────────────────────────────────────────────────
Fix 3 issues before stage completion.
Run fresh-agent-check again after fixes.
═══════════════════════════════════════════════════════════════
| Skill | Integration |
|---|---|
rdd-stage-auto | Run at Gate 5 before completion |
rdd-knowledge | Update documentation based on findings |
rdd-diagnosis | Use for doc diagnosis |
Before completing a stage, run this check:
## Fresh Agent Check (Stage Completion)
Before marking stage complete, verify:
[ ] Charter is still accurate
[ ] Roadmap reflects current progress
[ ] Next steps are updated for next stage
[ ] All stage decisions are in ADRs
[ ] All new issues are in tech debt ledger
[ ] Stage document has implementation notes
[ ] No tacit knowledge required to continue
Run: /rdd-fresh-check
If PASS: Stage can be completed
If WARN: Fix issues, then complete stage
If FAIL: Must fix issues before stage completion
For related information, see:
.claude/skills/rdd-core/SKILL.md - Core RDD concepts.claude/skills/rdd-knowledge/SKILL.md - Knowledge managementdocs/03-stage-based-development.md - Stage completion criteria