aiwfx-start-milestone

Starts an aiwf milestone with preflight checks, branch setup, and TDD-driven implementation.

Updated May 9, 2026
One-click install
npx skills add https://github.com/23min/aiwf --skill aiwfx-start-milestone-23min
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aiwfx-start-milestone
Source: https://github.com/23min/aiwf/tree/main/internal/skills/embedded-rituals/plugins/aiwf-extensions/skills/aiwfx-start-milestone
Command: npx skills add https://github.com/23min/aiwf --skill aiwfx-start-milestone-23min

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Beginning work on a planned milestone involves many error-prone steps: verifying the spec is ready, promoting its status, cutting the right branch in the right order, and tracking acceptance criteria. This Skill orchestrates that entire start-of-milestone ritual so nothing is skipped or done out of sequence. ## Core Features & Use Cases - Preflight validation: Confirms the milestone spec exists with concrete, testable acceptance criteria, the parent epic is active with its branch checked out, and the build and tests are green before any work begins. - Ordered sovereign commits: Promotes the milestone to in_progress and optionally opens a delegated authorization scope on the parent epic branch before cutting the milestone branch, matching the kernel's branch-model sequencing rules. - TDD implementation loop: Drives each acceptance criterion through a red-green-refactor cycle, records phase transitions live, commits per-AC with structured trailers, and runs a readiness check before handoff to the wrap ritual. - Use Case: A developer says "start milestone M-0003" and the Skill verifies the spec, promotes the status, cuts the milestone branch, then iterates through each acceptance criterion with tests until the work is ready for independent review. ## Quick Start Ask the assistant to start milestone M-NNNN once its draft spec exists and the parent epic branch is checked out.

Frequently Asked Questions about aiwfx-start-milestone

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

FAQPage Schema
How do I start implementing an aiwf milestone?

Say "start M-NNNN" once the milestone spec exists with status draft and the parent epic is active with its branch checked out. The Skill runs preflight checks, promotes the milestone to in_progress, cuts the milestone branch, and iterates through each acceptance criterion.

What happens if the parent epic branch does not exist when starting a milestone?

The Skill stops and directs you to run aiwfx-start-epic first. It never improvises by creating the parent branch itself, because that would mask the fact that the parent epic was never activated.

Why must the promote and authorize commits land before the milestone branch is cut?

The branch-model sequencing rule requires state-announcement commits to land on the parent epic branch first. The kernel's preflight refuses authorize calls made from the wrong checkout, and the aiwf check validator flags the isolation-escape pattern afterward.

Can milestone implementation be delegated to an AI agent?

Yes. During the delegation prompt you can name an ai/<id> agent, and the Skill runs aiwf authorize with a forward-binding branch trailer. The scope stays active until the milestone reaches a terminal status or the operator pauses it.

What are the limitations of the tdd policy settings on a milestone?

Setting tdd: required makes promoting an AC to met without phase done a hard error that blocks pre-push, while advisory only warns and none skips the audit. The policy must be set intentionally in the spec frontmatter before starting.