QA Gate

Final release gate for any artifact before human review. Every document, skill, blog post, PRD, or code output should pass this gate before the principal sees it.

This is not a code review skill. It is a release gate that determines whether an artifact is ready to move forward.

When to Use

• After any ralphy loop completes a PRD
• Before presenting any deliverable to the principal
• When self-reviewing documents, code, skills, or blog posts
• As the final step before publishing to ClawHub or Gumroad
• When asked to "QA gate this," "validate before publish," "final check," or run a "quality gate"

Optional Mode

• --dual: Use cross-model QA validation when the artifact is high-stakes, ambiguous, or worth the extra cost/latency for a second independent quality pass.

Process

Step 1: Read the artifact completely

Read the entire file. Do not skim. Understand the structure, voice, and intent.

Step 2: Validate against 6 dimensions

1. Factual Accuracy

• Are all claims verifiable?
• Are research citations correct (paper titles, arXiv IDs, findings)?
• Are technical procedures feasible as described?
• Are tool/API references accurate for the current version?

2. Tone & Voice Consistency

• Does the document maintain its intended voice throughout?
• No tonal drift between sections?
• No marketing fluff, tutorial-speak, or filler?
• Appropriate for the target audience (agent, human, or both)?

3. Completeness

• No placeholders (TODO, TBD, FIXME, PLACEHOLDER, [FILL IN])?
• All sections referenced in TOC/structure are present?
• All promised content is delivered?
• No orphaned references or dead links?

4. Structural Integrity

• Heading hierarchy is clean (no skipped levels)?
• Code blocks are properly fenced and syntactically valid?
• Section anchors work?
• Back-links resolve to valid targets?
• Markdown renders correctly?

5. Operational Soundness (for technical documents)

• Procedures are implementable as described?
• Configuration formats match the actual system?
• Commands and scripts are executable?
• Edge cases are addressed?

6. Sensitive Data Check

• No personal information (real names, schedules, addresses)?
• No API keys, tokens, or secrets?
• No internal-only references that shouldn't be public?
• Examples use fictional/generic data?

Step 3: Produce gate verdict

Output must include a clear gate result:

PASS — ready for human review

or

PASS WITH FIXES
- MINOR [location]: issue description

or

FAIL
- CRITICAL [location]: issue description
- MAJOR [location]: issue description
- MINOR [location]: issue description

Step 4: If FAIL, fix and re-validate

Fix all CRITICAL and MAJOR issues. Re-run the gate. Only present to principal after PASS or PASS WITH FIXES.

Integration with PRD Workflows

Add to any PRD as a verification step: