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.