spec-quality-gate

Validate READY FOR CODE Notion pages for required Pipeline Operating Mode fields.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/blucsigma05/tbm-apps-script --skill spec-quality-gate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-quality-gate
Source: https://github.com/blucsigma05/tbm-apps-script/tree/main/.claude/scheduled-tasks/spec-quality-gate
Command: npx skills add https://github.com/blucsigma05/tbm-apps-script --skill spec-quality-gate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents wasted engineering cycles caused by “READY FOR CODE” items that have incomplete Pipeline Operating Mode specifications.

Core Features & Use Cases

  • Parking Lot readiness validation: Scans child pages for READY FOR CODE status markers and required spec fields.
  • Structural and field completeness checks: Verifies the required four Pipeline Operating Mode fields (Problem/Verified On, Why, What changes, Acceptance test) plus header structure and artifact source.
  • Automated triage and de-escalation: Produces a backlog-style list of missing-field items and reverts status to AWAITING CODEX REVIEW, adding a Notion callout describing what’s missing and when.

Quick Start

Use the spec-quality-gate to run the daily 8:30am check that identifies any Parking Lot “READY FOR CODE” pages missing required Pipeline Operating Mode fields and automatically reverts them to AWAITING CODEX REVIEW.

Frequently Asked Questions about spec-quality-gate

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

FAQPage Schema
How do I validate Notion pipeline specs before moving them to code?

To validate Notion pipeline specs before coding, fetch the Parking Lot child pages marked READY FOR CODE and verify the required Pipeline Operating Mode fields and header structure are present. The process checks for Problem/Verified On, Why, What changes, and Acceptance test fields to prevent incomplete specs from entering development.

What is pipeline readiness validation for product workflows?

Pipeline readiness validation is the daily process of scanning Parking Lot child pages to ensure READY FOR CODE status markers have complete specifications. It enforces title and H2 status formatting while verifying required Pipeline Operating Mode fields exist before code pickup begins.

How do I automate triage for incomplete Notion spec pages?

Automate triage for incomplete Notion spec pages by generating a backlog-style list of missing-field items and applying Notion updates to revert status to AWAITING CODEX REVIEW. The process adds callouts describing exactly which fields are missing and when validation occurred.

What are the required Pipeline Operating Mode fields for READY FOR CODE items?

The required Pipeline Operating Mode fields for READY FOR CODE items are Problem/Verified On, Why, What changes, and Acceptance test. Additionally, the header structure must include proper title and H2 status formatting along with the artifact source.

Can I run daily automated checks for missing spec fields in Notion?

Yes, you can run daily automated checks for missing spec fields in Notion by fetching Parking Lot pages and children, verifying required Pipeline Operating Mode fields, and automatically reverting incomplete items to AWAITING CODEX REVIEW with callout notifications.

Why does incomplete spec validation fail for Parking Lot child pages?

Incomplete spec validation fails for Parking Lot child pages when READY FOR CODE status markers lack the four required Pipeline Operating Mode fields, proper title formatting, or H2 status structure. The validation identifies these gaps and reverts items to AWAITING CODEX REVIEW.