Plans
A plan in SageOx is a rich, visual page — not a wall of text. Your AI coworker authors it, you review it, and it stays linked to the pull request it shaped, so the reasoning behind a change is never lost.
It's the plan of record: stored in your repository's Ledger, enriched from your Team Context, and built to be decided on in ten minutes.
Today, plans are created inside a coding agent — Claude Code or Codex — in a repository set up with SageOx (ox init) and the ox CLI installed.
You prompt, your coworker authors
You ask your AI coworker for a plan, and it picks the right visuals, writes the page, and saves and renders it for you — running the ox CLI on your behalf.
| You say | Your coworker does |
|---|---|
| "Plan the retry migration. Make it a visual plan and render it." | Authors a page, saves it to your repository's Ledger, opens it for review |
| "Ground it in real data and flag conflicts with our ADRs." | Reads live SageOx Team Context, adds cited badges, surfaces collisions |
| "Tighten the risks section." | Revises the same page |
Prompts that produce great plans
A bare "make a plan" gets a bare plan. Give your coworker three things — the decision, the audience, and real grounding:
Minimum
Good — names the decision and the reader
Best — grounds it in real data and SageOx Team Context
Every cited badge points at a real artifact — an ADR, a decision, a teammate's live edit. A plan never puts words in a coworker's mouth; when the evidence is thin, it degrades to a nudge to consult the right person.
Review and iterate
Read the rendered plan, then tell your coworker what to change — it revises the same page, so nothing forks. When the work becomes a pull request, the plan is linked from it, and the review conversation happens there alongside the diff.
Coming soon: clicking an element on a shared plan to leave an anchored comment your coworker acts on. Today, review happens on the rendered page and in the linked PR.
Find plans in the console
In the SageOx console, open your team and choose Plans in the left nav. Every plan saved for the team shows up there, newest first. Open any plan to read the full page and share it with a coworker.
Solo? Plans still pay off
You don't need a human team. A coworker is any team member — human or AI. As a team of one, your coworker authors a plan you review in ten minutes instead of a text wall, several coworkers can co-author the same page, and your Ledger accrues durable, searchable plans so a later reader inherits the why.
Every PR links its plan and session
When work lands, the pull request carries a credit line linking the session and the plan that produced it. Open a PR months later and jump straight to the plan that shaped it — the reasoning travels with the code.
See real examples
Two public plans from the SageOx team — open them to see different visual forms doing real work.
A sequencing plan — a phase-by-phase timeline, with live collision and conflict badges cited to a real file and a tracked issue.
An architecture plan — a dependency graph plus an ownership table with a candid "deliberately excluded" column.
More curated examples are coming to the SageOx public team.
What's next
- Team Context — where a plan's cited evidence comes from
- SageOx + Claude Code — how plans fit into a coding session
- Distillation — how raw team knowledge becomes structured memory