orrery

Author an orrery plan — a YAML file under the orrery plans directory that the orrery CLI executes step-by-step. Use ONLY when the user explicitly asks to create an orrery plan (e.g., "make an orrery plan", "use orrery discovery", "/discovery"). Do NOT use for general planning, architectural discussion, or decomposing ideas unless the output is an orrery plan file.

Implement a single step from an orrery plan (YAML file under the orrery plans directory) when invoked by the orrery orchestrator. Do NOT use for general coding, bug fixes, or implementation work outside of an orrery plan run.

Final reporting phase for a single step of an orrery plan, invoked by the orrery orchestrator after orrery-verify completes (or when reporting blocked status). Outputs structured JSON consumed by the orrery orchestrator. Do NOT use for general status summaries or reports outside of an orrery plan run.

Review changes made for a single step of an orrery plan (YAML file under the orrery plans directory) when invoked by the orrery orchestrator, and produce structured feedback for the editor agent. Do NOT use for general code review outside of an orrery plan run.

Verify a single step from an orrery plan (YAML file under the orrery plans directory) when invoked by the orrery orchestrator after orrery-execute. Runs the plan step's acceptance criteria, tests, and linting. Do NOT use for general test runs, linting, or verification work outside of an orrery plan run.

Analyze and improve an existing orrery plan (YAML file under the orrery plans directory). Reviews plan structure, dependencies, context quality, and acceptance criteria, then edits the plan file directly. Use ONLY when the user explicitly asks to refine an orrery plan and provides a plan file argument (e.g., /refine-plan my-plan.yaml). Run `orrery plans-dir` to find the plans directory. Do NOT use for general plan or design-doc review.

Explore an existing orrery plan (YAML file under the orrery plans directory) through conversational dialogue before committing to execution. Use ONLY when the user explicitly asks to simulate an orrery plan and provides a plan file argument (e.g., /simulate-plan my-plan.yaml, /simulate-plan my-plan). Run `orrery plans-dir` to find the plans directory. Do NOT use for general "what if" brainstorming outside of an orrery plan.