agent-os

🧭

Chart, shape, batch, deliver

A foggy effort becomes decision tickets, a bounded branch becomes implementation-ready issues, and the developer chooses individual delivery or an explicit integrated batch. When you cannot state the goal yet, guide-me questions it out first.

🧾

Evidence before claims

The verify-before-done discipline turns "it works" into a command, an exit status and a result. A check that ran proves only what that check exercised — and unverified claims get named as unverified.

🚧

Authority follows the request

An implementation request authorizes in-scope repository work. The agent asks only for unresolved product decisions and stops delivery at the requested boundary.

🔍

Control the contract

Skills lock outcomes, boundaries and ground truth while leaving local tactics to the implementer. Material delivery gets independent review; a fully qualified small fix may skip it.

🤝

Two platforms, one source

Every skill ships once and loads in both Claude Code and Codex. Manual workflows are opted into explicitly on both; disciplines trigger themselves from the situation.

📐

Policy you can edit

A single policy.md is installed as a managed block in your global instruction files, and every repo grows its own living project policy through an interview instead of a template.

What it looks like

The optional on-ramp in action — a vague desire becomes an approved plain-language goal, planning takes over, and evidence lands before any completion claim:

text

User:
/guide-me Reports feel useless for our big customers and I
don't know what to do about it.

Agent:
Is the pain seeing the data, or taking it with them?

User:
Taking it with them. They paste screenshots into slides today.

Agent:
Plain-language summary: "This work gives large customers a proper way
to take a filtered result with them. It will not change what they can
see, only what they can carry away." Approve, or challenge it?

User:
Approved.

Agent:
Continuing into chart-work with that summary as the TLDR of the map.

    ...later, after shaping and delivery...

Command: npm test -- report-export
Exit: 0
Result: API, authorization, and CSV encoding cases pass.

Delivered to the requested boundary: one verified pull request.
Merge stays with you.

Read the whole journey in The work loop.

agent-osExplicit workflows, automatic disciplines