Goal Plans

Goal plans turn an objective into a structured project plan before an agent creates work. The contract is deterministic by default, approval-gated for hosted creation, and keeps provider credentials out of every request body.

Generate a preview

todos plans generate --objective "Create project. Add todos. Run agent." --org 11111111-1111-4111-8111-111111111111

The response includes a project, ordered tasks, dependencies, acceptance criteria, verification steps, and the prompt contract used to produce the plan.

Refine a plan

todos plans refine --plan plan_123 --objective "Create project. Add todos. Run agent." --feedback "Add owner review before execution" --org 11111111-1111-4111-8111-111111111111

Refinements preserve revisionOf lineage, so agents can compare plan versions and explain what changed before applying work.

API

Send objective, optional provider and model, and optional revisionOf plus refinement. Hosted work is preview-only unless dryRun is false; creation still waits for approval unless approvalBeforeCreate is explicitly disabled.

MCP tools

Agents can call generate_plan to preview or create approved plans and refine_plan to produce a revision against an existing plan. These tools are intentionally hidden from read-only profiles because they can create hosted work when dry-run mode is disabled.