phase-init

Create phase specification files from templates into docs/specs/<feature-id>.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Instantiate a phase artefact (requirements-spec / design-spec / test-spec) from the Programme bundle's template into docs/specs/<feature-id>/. Refuses to overwrite existing artefacts.

Core Features & Use Cases

  • Create a phase-spec for a feature by selecting phase (requirements, design, or test) and a feature-id.
  • Writes to docs/specs/<feature-id>/<phase>-spec.md if not exists.
  • Prevents overwriting existing artefacts and reports if a spec already exists.

Quick Start

Execute phase-init <phase> <feature-id> to generate the corresponding phase specification for the feature.

Frequently Asked Questions about phase-init

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

FAQPage Schema
How do I create a phase specification for a feature from a standard template?

To create a phase specification, instantiate a template artefact into docs/specs/<feature-id>/<phase>-spec.md by providing the phase and feature-id, which creates the directory as needed and refuses to overwrite existing files.

What happens if I try to generate a phase artefact where a spec already exists?

When a spec already exists, the artefact generation process refuses to overwrite it and reports that the specification already exists, preserving your existing phase artefacts safely.

When do I need to generate separate requirements, design, or test specifications?

You generate separate requirements, design, or test specifications when you need to instantiate structured phase artefacts from a Programme bundle template into a feature's dedicated docs/specs directory.

How do I start writing phase specs for a new feature ID?

Start writing phase specs by executing the instantiation command with your selected phase and feature-id, which validates the inputs and writes the corresponding phase-spec.md file into the correct directory.

Does the phase artefact generator overwrite existing phase docs?

No, the phase artefact generator does not overwrite existing phase docs; it enforces input validation and safely preserves existing specifications by refusing to write over them.

What is the best way to manage feature specification files across multiple SDLC phases?

The best way to manage feature specifications across SDLC phases is generating standardized artefacts from templates into a unified docs/specs/<feature-id> directory, ensuring existing specs remain preserved.