phycool-create-story-depth-gate

Validates story records against seven depth gates before database upsert.

10|3|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/Cynthia1070711/PHYCOOL_Tools --skill phycool-create-story-depth-gate-cynthia1070711
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: phycool-create-story-depth-gate
Source: https://github.com/Cynthia1070711/PHYCOOL_Tools/tree/main/config-templates/claude/skills/phycool-create-story-depth-gate
Command: npx skills add https://github.com/Cynthia1070711/PHYCOOL_Tools --skill phycool-create-story-depth-gate-cynthia1070711

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires better-sqlite3, and includes scripts (resource) components.

What problem does it solve? Formal checklist gates can pass a story that still references unread skills, superseded ADRs, dead commits, or corrupted database fields. This Skill enforces substantive verification of a story record before it is marked ready-for-dev, catching iteration pollution, cross-story file conflicts, and self-write corruption that surface only later during development. ## Core Features & Use Cases - Seven depth gates (D1-D7): Verifies required skills were actually read, cross-references ADR/IDD versions and forbidden changes, traces PRD requirement sources, live-reverifies UI stories via Chrome MCP, detects stale file/commit references, checks sibling-story file conflicts, and validates written DB field integrity. - WARN-as-BLOCK policy: Warnings default to blocking (exit 2) unless explicitly accepted with a reason via --accept-warn, preventing silent accumulation of unresolved issues. - Use Case: Before upserting a newly created story into the SQLite context database, run the gate script against the story ID to receive a markdown report of PASS/WARN/BLOCK per gate, with findings appended to the story's dev_notes. ## Quick Start Run the depth gate on my story by executing node .claude/skills/phycool-create-story-depth-gate/scripts/run-depth-gate.js with the story ID and show me the report.

Frequently Asked Questions about phycool-create-story-depth-gate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run the depth gate on a story?

Run node run-depth-gate.js with the story ID from the scripts directory. Use --only=D1,D4 to run specific gates, --skip-d4 to bypass Chrome MCP checks, or --dry-run to print the report without writing to dev_notes.

What do the depth gate exit codes mean?

Exit 0 means all gates passed, exit 1 means warnings exist but the story can proceed, exit 2 means a block was found and the story returns to backlog, and exit 3 indicates a script error rather than a gate failure.

Why does the depth gate block on SSL certificate mismatch?

Gate D4 compares the Kestrel certificate thumbprint against CurrentUser Root and My stores. A mismatch causes Chrome to reject localhost with ERR_CERT_AUTHORITY_INVALID, blocking live UI verification until certificates are re-trusted and the server restarted.

Can I skip the Chrome MCP live verification gate?

Yes, use --skip-d4 for CI environments without Chrome, or --d4-manual after manually verifying via Chrome MCP with a marker recorded in dev_notes. Skipping records a warning, and warnings default to blocking unless accepted with --accept-warn.

What does gate D7 self-write verification detect?

D7 checks written story fields for minimum lengths, corruption patterns like triple backslashes or unreplaced template placeholders, phase and checkbox counts, required fields, and lifecycle invariant violations between timestamps and status values.