phased-development

Route Claude Code sessions to orchestration roles based on branch tier.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill keeps Claude Code aligned with phased-development repositories by identifying the current branch tier and selecting the correct orchestration role before work begins.

Core Features & Use Cases

  • Detects whether a session is on planning, phase, epic, sprint, or hotfix branches.
  • Loads the matching downstream role skill and enforces branch-to-role consistency.
  • Supports startup checks, plugin version validation, and peer activity summaries for coordinated multi-session work.
  • Use it when a long-running GitHub project needs multiple Claude Code sessions to coordinate across phases and sprints.

Quick Start

Use the phased-development skill to inspect the repository, determine the current branch tier, and load the appropriate role skill.

Frequently Asked Questions about phased-development

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

FAQPage Schema
How do I coordinate multiple Claude Code sessions across different project phases?

To coordinate multiple Claude Code sessions across project phases, this Skill detects the current branch tier and loads the matching orchestration role. It enforces branch-to-role consistency and provides peer activity summaries for synchronized multi-session work.

What is branch tier routing in phased software development?

Branch tier routing in phased software development identifies whether a session is on planning, phase, epic, sprint, or hotfix branches. It then selects the correct orchestration role to ensure Claude Code aligns with the repository's specific phase conventions.

Do I need an orchestration.yaml file to use branch pattern matching with Claude Code?

Yes, you need a .claude/orchestration.yaml file to use branch pattern matching with Claude Code. This configuration file is required for the Skill to verify roles, check plugin versions, and safely load the proper downstream skill.

How to set up Claude Code for multi-phase planning and sprint implementation?

Set up Claude Code for multi-phase planning and sprint implementation by applying phased-development branch conventions to your repository. The Skill inspects the repository, determines the branch tier, and loads the appropriate role skill for epic coordination and sprint work.

Does Claude Code work with GitHub worktrees for hotfix handling and epic coordination?

Yes, Claude Code works with GitHub worktrees for hotfix handling and epic coordination. The Skill routes sessions to the correct orchestration role by matching branch patterns, ensuring hotfix branches and epic branches load their respective downstream skills.

Why is my Claude Code session loading the wrong role for my current git branch?

If Claude Code loads the wrong role for your git branch, the branch pattern matching may be failing due to missing .claude/orchestration.yaml configuration or unverified branch tier conventions. The Skill requires this file to enforce branch-to-role consistency safely.