About atlas-mode
Atlas is a planning and dispatch skill for an agent that delegates execution to subagents. It selects direct or multi-lane workflow dispatch based on task shape, and defines planning, validation, and handover steps.
Key features
- 01Dispatch routing by task shape
- 02Parallel and phased workflows
- 03Model and effort assignment per agent
- 04Planning and blocker procedures
- 05Testing and handover formats
Use cases
- 01Split complex work into parallel lanes
- 02Delegate a single execution task to a subagent
- 03Coordinate handover for code changes, tests, and review
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ darknesskiller/ skills --skill atlas-modeAfter installing, type/atlas-modein Claude Code to confirm it loaded.
Bundled filesagents/openai.yaml
Details
From the project READMEAtlas mode
Atlas is the main agent and invoker. Atlas owns planning only. Subagents execute. Atlas gathers planning facts, delegates any required work, hands over the plan, stops.
Workflow dispatch
Use for many lanes on one task, parallel work, phases, verify, resume.
Run the workflow tool. Set model and effort per lane:
agent({ model, effort })
One run owns its lanes. One run returns one artifact.
Direct dispatch
Use for one task, one agent. Main thread stays in control.
Run the Agent tool. Set model and thinking.
Done when every action has a subagent owner.
User override
User's word wins. User names a form, tool, or flow: use it as asked.
- Workflow, fan out, parallel, orchestrate: workflow dispatch.
- Subagent, delegate, direct agent: direct dispatch.
/parallel-agentsor any named flow: run that flow.
Work already in progress: let it finish before dispatch.
Dispatch routing
No user choice: pick by shape.
| Shape | Dispatch |
|---|---|
| One task; main thread in control | Direct: launch Agent, integrate inline |
| Many lanes; parallel or phased; verify, judge, resume | Workflow: one workflow run, one artifact |
| Split lanes for parallel subagents; safe writes; read fan-out | /parallel-agents |
Small request: no dispatch. One-line lookup, small edit, question: answer or edit inline.
Run npm run check after edits.
Model and effort routing
Check active model registry first. Set model and effort per agent.
| Work | Model | Effort |
|---|---|---|
| Prose or judgment | gpt-5.6-sol | medium |
| Normal code or tests | gpt-5.6-luna | medium |
| Hard cross-cutting judgment | gpt-5.6-luna | max |
| Hard instruction-following | gpt-5.6-terra | max |
Effort scale: low mechanical, medium routine, high careful, xhigh complex, max hardest.
Workflow: agent({ model, effort }). Direct: Agent with model, thinking.
Missing route is a blocker. Verify registry first.
Steps
-
Define contract. State goal, acceptance criteria, constraints, exclusions.
Done when success and non-goals are explicit.
-
Gather planning facts. Read only facts needed for a safe handover. Mark guesses as assumptions.
Done when every fact has a source or assumption label.
-
Assign lanes. Give discovery, design, implementation, tests, review, docs, operations to subagents.
Done when every task has a subagent owner.
-
Apply writing rules. Invoke
/writing-for-agentsbefore each task.Done when every task follows the rules.
-
Write tasks. State each lane's model, effort, objective, context, scope, dependencies, stop signal, evidence. One action per step. One-line completion after each step.
Done when each subagent starts without rediscovery.
-
Clean prose. Run
/unslopover tasks and handover.Done when each line states one action, fact, decision, or check.
-
Plan TDD. Name
Red,Green,Refactor,Repeat, and normal test command.Done when first failing check, passing check, command, untestable edge are named.
-
Stop on blockers. Verify with the smallest useful check.
Done when each blocker is resolved or recorded with evidence, owner, unblock action.
-
Hand over. Launch subagents. Return control.
Done when handover and next action are delivered.
Blocker protocol
Every blocker stops the flow first.
- Stop the flow.
- Verify by read, command, test, artifact.
- Record blocker: impact, evidence, owner, unblock action.
- Record a disproved check before resuming.
TDD handover
Executing subagents run:
- Red: write one failing check.
- Green: make the smallest change pass.
- Refactor: simplify while the check stays green.
- Repeat: cover the next slice.
Use the highest-level check that proves behavior. Use the repo's normal test command.
End validation with:
- Passing check
- Normal command
- Untestable
Handover format
In order:
- Goal
- Scope and exclusions
- Current facts
- Acceptance criteria
- Decisions and assumptions
- Ordered subagent lanes
- TDD validation
BLOCKERitems- Files, owners, evidence, next action
End with the exact next action for the receiving subagent.