Compass Helm
Table of Contents
1. When to use this skill
Enter it at the start of substantial work and leave it on. It is sticky: once entered it governs every turn until stood down, so a method is not something to remember reaching for.
The request shape:
compass-helm <what you observed, or what you want> Done means <something the agent can run or inspect>. Keep <the behaviour that must not change>.
State the goal and the constraints, not the skills to run. An agent handed both a goal and a step-list follows the step-list and drops the method's gates.
Stand it down by saying so. The mode ends immediately and the session continues as an ordinary one.
2. How to use this skill
2.1. 1. Decline, if the work does not earn it
Say so plainly and fall through to the plain action skills. Moving a date, fixing a sentence, changing one configuration value, answering a question: none of these want a declared System, a grounding phase and a decision trail, and a mode that fires on everything trains people to route around it.
The mode earns its cost when a plausible diff is not enough: work that must be reproduced before it is fixed, a design decision expensive to reverse, a run long enough that a human reviews it afterwards, or a domain the agent has not grounded itself in.
Declining is a normal outcome, not a failure to engage.
2.2. 2. Declare the System
Name the level the session is acting at, which attenuates the catalogue to the slice in scope (Systems and levels). The narrowing is advisory everywhere except the audit channel: reach outside it by saying so.
Declare it once, at the start, and say which. A session that never declares is acting at every level at once, which is the variety problem the levels exist to solve.
2.3. 3. Read the principles index
Read Principles at task start, grouped by the moment each is cited. This is what makes a citation possible later: a rule the session has not loaded is a rule it will not think to cite at the judgement call.
2.4. 4. Match the work to a method
Apply the matching rule in Methods and the mode: the ordered questions, the arbitration when two match, and the null case. Say which method matched and why, in one line. A match nobody can see is a match nobody can dispute.
2.5. 5. Copy the phases in verbatim
Write the matched method's phases into the todo list before reasoning about the task, in the method's own words and order.
This is the step that carries the value and the step most easily lost. The known failure is reading a method, forming a private understanding of it, and writing a bespoke plan that quietly drops the phases that were inconvenient. Copying first makes the drop visible, because the phase is sitting in the list.
A phase deliberately skipped stays in the list with skip: and the
reason. Silent skipping is refused: if the reason cannot be written down
it is not a decision, it is an omission.
2.6. 6. Run the phases, routing outward
Work the phases in order. As each fires:
- anything touching an artefact calls an action;
- any command comes from a recipe, and a missing effector becomes a recipe rather than an inline command;
- a judgement call cites a principle by name;
- a fork the evidence cannot settle convenes deliberation, and the verdict is recorded on the work.
Re-check the match at each phase boundary. Discovering the shape was misjudged is a reason to re-match, not to push on through phases that no longer fit.
2.7. 7. Delegate as this same mode
A delegate is spawned as a named System under this mode, never as a generic agent. It inherits none of the session's grounding, so the brief states what it must read first and what it may do (Running agents).
Resume an existing delegate rather than spawning a sibling beside it. Two delegates on one piece of work contend for the same files and produce two partial answers.
2.8. 8. Close the loop
Finish through the actions: compass-agile-close-task then compass-pr-raise. What generalises beyond this piece of work goes to a memory, a principle or a check, with approval rather than automatically.
3. Recipes
- How do I work a task? — the lifecycle the mode drives.
- How do I orient a new session? — what to run before declaring the System.
4. Reference
- Methods and the mode — the matching rule, the request shape, and the limits.
- Principles — read at task start, cited at the judgement calls.
- Systems and levels — what declaring a System attenuates.
- Skill architecture — the three entry points, of which this is the third.