phase-gate

Validate requirements, design, test, and code artefacts for phase-gate progression.

41|6|Updated Jul 12, 2025
One-click install
npx skills add https://github.com/SteveGJones/ai-first-sdlc-practices --skill phase-gate-stevegjones
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: phase-gate
Source: https://github.com/SteveGJones/ai-first-sdlc-practices/tree/main/plugins/sdlc-programme/skills/phase-gate
Command: npx skills add https://github.com/SteveGJones/ai-first-sdlc-practices --skill phase-gate-stevegjones

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Phase-gate validation ensures completeness of feature artefacts across the requirements, design, test and code phases, blocking progress when artefacts are missing or cross-phase references are broken.

Core Features & Use Cases

  • Validates four phase artefact types (requirements, design, test, code) for a feature.
  • Blocks progression on missing artefacts or broken cross-phase references.
  • Reports the specific missing items and reference errors to guide remediation.

Quick Start

Run phase-gate for a given feature to validate requirements, design, test, and code artefacts.

Frequently Asked Questions about phase-gate

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

FAQPage Schema
How do I enforce phase completeness for software feature artefacts?

Automated phase-gate validation enforces completeness by checking requirements, design, test, and code artefacts in docs/specs/<feature-id>, blocking progression when items are missing or cross-phase references are broken.

What is cross-phase reference validation in SDLC feature development?

Cross-phase reference validation is the process of verifying that links between requirements, design, test, and code artefacts remain intact across the SDLC. It ensures that each phase's output correctly references and aligns with the preceding phase's artefacts.

How do I block feature progression when requirements artefacts are missing?

You can block feature progression by applying a phase-gate validator to the feature's artefact directory. The validator checks for the existence of requirements, design, test, and code documents and halts progression if required artefacts are not found.

Does phase-gate validation work with artefacts stored in docs/specs directories?

Yes, phase-gate validation operates directly on docs/specs/<feature-id> directories to locate and validate feature artefacts. It uses Python validators to check the existence and cross-phase reference integrity of the files stored there.

Why does feature progression get blocked by broken cross-phase references?

Feature progression is blocked when cross-phase references are broken because the validators detect integrity gaps between requirements, design, test, and code artefacts, reporting specific reference errors to guide remediation.

What are the limitations of automated phase-gate validation for software engineering?

Automated phase-gate validation is limited to checking artefact existence and cross-phase reference integrity within the specified directory. It does not validate the qualitative content of the artefacts themselves, only their structural presence and linkage.