project-promote

name: project-promote description: Load when a project has outgrown its current play level (Sprint→Build or Build→Platform) or needs to be scaled back. Use when user says 'this is bigger than a sprint now' or 'we need to treat this as a real product'. Updates .speck/project.json and adapts artifacts. disable-model-invocation: false

The user input to you can be provided directly by the agent or as a command argument - you MUST consider it before proceeding with the prompt (if not empty).

User input:

$ARGUMENTS

What This Does

/project-promote transitions a project between play levels:

• Sprint → Build: Expand the lightweight PRD, create context.md + COMMERCIAL.md, offer first epic
• Build → Platform: Scaffold constitution + design-system, flag missing artifacts
• Downgrade: Supported — strip artifacts and reduce requirements

Play levels live in .speck/project.json as play_level.

Step 1: Read Current State

Read .speck/project.json to determine current play level. If file doesn't exist, assume platform (backward compatible).

Also check what artifacts exist:

• PRD.md — sprint PRD or full PRD?
• sprint-log.md — Sprint tracking log
• context.md, COMMERCIAL.md — Build artifacts
• constitution.md, design-system.md — Platform artifacts
• specs/projects/ — Epic/story structure

Step 2: Determine Target Level

Parse arguments for target level:

• "to build", "promote to build", "--to build" → Build
• "to platform", "promote to platform" → Platform
• "downgrade to sprint" → Sprint
• "downgrade to build" → Build

If not specified, infer from context:

• Sprint → assume promoting to Build
• Build → assume promoting to Platform
• Platform → ask (promote or downgrade?)

Confirm with user before proceeding:

Current play level: Sprint
Target play level: Build

This will:
- Expand your PRD.md with full sections
- Create context.md (constraints and requirements)
- Create COMMERCIAL.md (revenue and business model)
- Preserve your sprint-log.md as history
- Offer to create your first epic

Shall I proceed? [Y/n]

Step 3: Execute Transition

Sprint → Build

1. Expand PRD.md

   • Read existing sprint PRD
   • Ask 3-5 targeted questions to fill out the full PRD:
     • "Who exactly are your users? Any segments?"
     • "What's the full feature set beyond the MVP you shipped?"
     • "What are your 90-day goals?"
   • Expand using .speck/templates/project/prd-template.md as structure
   • Preserve sprint PRD content as a "Sprint History" appendix section

2. Create context.md

   • Run /project-context flow (or inline a condensed version)
   • Focus on: tech constraints, team size, timeline, budget

3. Create COMMERCIAL.md

   • Revenue model details
   • Pricing strategy
   • GTM approach
   • Key business metrics

4. Update .speck/project.json

   {
     "play_level": "build",
     "promoted_from": "sprint",
     "promoted_at": "[ISO date]"
   }
   

5. Preserve sprint-log.md — rename to sprint-log-history.md so it's clear it's historical

6. Offer first epic:

   Build promotion complete!
   
   Your sprint insights suggest these as strong first epics:
   1. [Inferred from sprint PRD build plan]
   2. [Inferred from sprint PRD kill criteria learnings]
   3. Start fresh with /epic-specify
   
   Which would you like to tackle first? [1/2/3/skip]
   

Build → Platform

1. Gap analysis — check what's missing:

   • architecture.md missing? Flag it.
   • constitution.md missing? Offer to create it.
   • design-system.md missing? Offer to create it.
   • ux-strategy.md missing? Offer to create it.

2. Scaffold missing artifacts (only those the user confirms):

   Platform promotion requires these artifacts. Which shall we create now?
   
   [ ] constitution.md — technical principles and governance
   [ ] architecture.md — system design (recommended before planning)
   [ ] design-system.md — UI components and tokens
   [ ] ux-strategy.md — UX principles and user journeys
   
   Select all that apply [1,2,3,4 or 'all' or 'skip']:
   

3. Update .speck/project.json:

   {
     "play_level": "platform",
     "promoted_from": "build",
     "promoted_at": "[ISO date]"
   }
   

4. Next steps:

   Platform promotion staged!
   
   Recommended next steps (in order):
   1. /project-architecture — design the system before planning
   2. /project-plan — create comprehensive PRD and epic breakdown
   3. /project-roadmap — sequence your epics
   

Downgrade (Platform/Build → Sprint or Build)

Downgrades reduce artifact requirements without deleting work.

1. Confirm: "Downgrading reduces audit requirements but keeps all existing files. Continue?"
2. Update .speck/project.json with new play level
3. Note: "Your existing artifacts are preserved — the audit will simply check fewer requirements."

Output Format

✅ Promoted to [Target Level]!

From: [Previous Level]
To: [New Level]

Created:
- [list of new files]

Preserved:
- [list of renamed/kept files]

Updated:
- .speck/project.json

Next Steps:
- [context-appropriate recommendations]

CLI Alternative

You can also use the CLI:

npx github:telum-ai/speck promote --to build
npx github:telum-ai/speck promote --to platform
npx github:telum-ai/speck promote --to sprint   # downgrade