writing-phase-prompts

Create an ORCHESTRATION-PROMPT.md for multi-phase software projects.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/tuvens/phased-development --skill writing-phase-prompts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-phase-prompts
Source: https://github.com/tuvens/phased-development/tree/main/skills/writing-phase-prompts
Command: npx skills add https://github.com/tuvens/phased-development --skill writing-phase-prompts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps a VP of Engineering or orchestrator create a high-quality ORCHESTRATION-PROMPT.md when a new phase needs to be planned by hand, migrated from an existing project, or documented as a special case.

Core Features & Use Cases

It turns phase-planning requirements into a complete prompt that covers role definition, sprint sequencing, quality expectations, merge gates, naming conventions, and complexity guidance. It is especially useful when a project is moving through a new phase, when the latest conventions must be preserved from recent phases, or when the standard /start-phase flow is not the right fit. It also ensures the generated prompt references the testing and codex delegation conventions required by the broader phased-development workflow.

Quick Start

Use this skill to draft an ORCHESTRATION-PROMPT.md for the next phase of our project, following the repository template and the latest phase conventions.

Frequently Asked Questions about writing-phase-prompts

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

FAQPage Schema
How do I draft an orchestration prompt for multi-phase software projects?▼

Drafting an orchestration prompt involves defining role expectations, sprint sequencing, merge gates, and naming conventions into a structured ORCHESTRATION-PROMPT.md file. This ensures the multi-phase software project follows standardized quality directives and testing protocols.

What is Sprint 0 in phase orchestration planning?▼

Sprint 0 in phase orchestration planning is the initial setup sequence required within an ORCHESTRATION-PROMPT.md. It establishes branch conventions, complexity ratings, and codex delegation references before active development sprints begin.

When should I hand-author a phase orchestration prompt instead of using standard flows?▼

Hand-authoring a phase orchestration prompt is necessary when migrating existing phases, documenting special cases, or preserving the latest conventions for mature projects where the standard automated flow does not fit.

How do I document merge order and naming conventions for a new project phase?▼

Documenting merge order and naming conventions requires specifying branch rules and integration sequences within the ORCHESTRATION-PROMPT.md. This defines how code branches merge sequentially to maintain stability across the phase.

Does phase orchestration require codex delegation references?▼

Phase orchestration requires codex delegation references to connect the prompt with broader testing protocols and delegation conventions. This ensures the generated ORCHESTRATION-PROMPT.md aligns with the required phased-development workflow.

What limitations exist when migrating existing phases to a new orchestration plan?▼

Migrating existing phases to a new orchestration plan requires manually mapping prior conventions to the required phase-prompt structure. Limitations arise if the source project lacks clear documentation for merge order, complexity ratings, or testing protocols.