orchestrate-nightly

Orchestrates multi-agent epic execution with build-only workers and batched reviews.

Updated May 5, 2026
One-click install
npx skills add https://github.com/josippapez/ai-setup --skill orchestrate-nightly-josippapez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orchestrate-nightly
Source: https://github.com/josippapez/ai-setup/tree/main/claude/plugins/orchestrate-nightly/skills/orchestrate-nightly
Command: npx skills add https://github.com/josippapez/ai-setup --skill orchestrate-nightly-josippapez

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Coordinating large coding epics with subagents is expensive and slow when every chunk triggers multiple fresh reviewer agents and oversized models. This Skill runs an experimental nightly orchestration workflow that cuts cost and wall-clock time by using build-only workers on cheaper models, batching reviews every two chunks, and routing fixes to a cheap fixer agent. ## Core Features & Use Cases - Phased state machine: Drives work through Gate, Intake, Explore, Refine, Design, Decompose, Plan, Execute, Review, and Converge phases with explicit transition checkpoints and a resumable markdown store in .orchestration/. - Cost-optimized dispatch: Assigns haiku, sonnet, or opus models per chunk based on complexity and risk tags, batches reviews two chunks at a time, and sends fix-lists to a cheap md-fixer instead of the original builder. - Measured experimentation: Compares nightly cost and wall-clock against the stable orchestrate workflow using bench/orchestration-cost.cjs, reported in every close-out brief. - Use Case: You ask the agent to "orchestrate nightly" on a multi-file feature epic; it decomposes the work into 2-4 chunks, dispatches sonnet builders, reviews them in batches while building continues, and lands the work only after your approval. ## Quick Start Say "orchestrate nightly" or run /orchestrate-nightly and describe the epic you want built so the orchestrator can gate, decompose, and execute it.

Frequently Asked Questions about orchestrate-nightly

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

FAQPage Schema
How do I run the nightly orchestration workflow in Claude Code?

Trigger it explicitly by saying "nightly", "orchestrate nightly", or running /orchestrate-nightly. It never engages on generic "orchestrate this" requests, which belong to the stable orchestrate skill. Resuming an epic whose EPIC.md records workflow: nightly also picks it up.

What is the difference between orchestrate-nightly and the stable orchestrate skill?

Nightly workers only build and run quality commands themselves, reviews are batched one reviewer per two chunks instead of three to five reviewers per chunk, fix-lists go to a cheap md-fixer, and build models default one tier lower with opus reserved for risk-tagged chunks.

What plugins does orchestrate-nightly require to be installed?

It requires the stable orchestrate plugin for its grilling, grill-with-docs, domain-modeling, and accessibility skills, plus the repo-docs plugin for its MCP tools. The claude/install.sh script installs both, and the codegraph CLI is needed for impact analysis.

How does orchestrate-nightly choose which model builds each chunk?

Model selection uses the issue's complexity and risk frontmatter: low complexity builds on haiku, medium and high on sonnet, high with a risk tag like security or migration on opus, and max on opus. Every dispatch passes an explicit model override.

Where does orchestrate-nightly store epic state and can it resume?

State lives in a git-ignored .orchestration/ directory at the main repo root containing PROJECT.md, EPIC.md, and per-issue files. On resume the orchestrator reconstructs state from issue frontmatter, preserves existing waves, and continues at the earliest incomplete phase.

When should I not use the nightly orchestration workflow?

Avoid it when you did not explicitly request it, when the epic was created by the stable workflow, or when the required companion plugins are missing. It is experimental and measured against the stable workflow, which remains the default for generic orchestration requests.