orchestration-readme — Claude Code command overview
orchestration-readme breaks large features into structured task files, tracks active stages, and aligns code changes with Git commits inside Claude Code.
no license ★ 1,357 updated 2026-03-01
.claude/commands/ORCHESTRATION-README.mdWhat orchestration-readme does
The command provisions a dedicated directory hierarchy inside task-orchestration/. When initialized via /orchestration/start, Claude Code asks clarifying questions about user requirements, builds MASTER-COORDINATION.md alongside EXECUTION-TRACKER.md, and sorts tasks into folders such as todos/, in_progress/, qa/, and completed/.
Task states update directly with /orchestration/move <id> <status>. When work on a ticket wraps up, /orchestration/commit drafts a standardized Git commit message tied directly to the ticket identifier. The /orchestration/report command can output summaries formatted for daily standups or higher-level overviews.
All tracking depends on local Markdown files within the repository. Without running /orchestration/sync, external Git changes made outside the assistant will not reflect in the tracker files.
What it helps with
- decompose massive feature specs into discrete markdown task cards
- restore working context after breaks using
/orchestration/resume - reconcile task board states against repository commit history
- produce structured progress digests for team standups
Example prompts for the agent
- /orchestration/start Build authentication module with login and email password reset
- /orchestration/status --today
- /orchestration/move TASK-003 qa
How to install orchestration-readme
Manually: put the files in place
.claude/commands/ORCHESTRATION-README.mdCall it with /ORCHESTRATION-README. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/ORCHESTRATION-README.mdCall it with /prompts:ORCHESTRATION-README. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/ORCHESTRATION-README.prompt.mdManually: put the files in place
.gemini/commands/ORCHESTRATION-README.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about orchestration-readme
How to install orchestration-readme in Claude Code?
Place the command specification file into .claude/commands/ORCHESTRATION-README.md in your project repository.
What does orchestration-readme do?
It manages project workflows inside the terminal by dividing features into manageable items, tracking their stages, and coordinating commits.
How are task files stored?
Files reside under task-orchestration/ organized by date and feature name, moving across folders like todos, in_progress, qa, and completed as work advances.