Use cases

A large codebase without drowning the agent.

The agent does not need the whole repository. It needs what you know about the repository: which subsystem owns what, what was decided and why, what broke last time. Keep that in Morion, and every ticket arrives with its slice.

30 minClaude Code · Motools: mo_take_task · mo_ask · notes_create

1Give each kind of knowledge its own folder

Morion indexes notes, not source code. The code stays in the repo, where your agent already reads it with its own tools. Morion holds the layer above the code: architecture notes, decisions, lessons, specs, rules, and the tickets themselves. A big codebase loses that layer first, and an agent cannot rebuild it by grepping.

Create one project for the codebase. Inside it, create one folder per kind of knowledge. Open each folder’s settings. On the General tab, set Role in project: architecture, lessons, specs, rules, or the default general. The role tells Mo which folders to search when it builds a work packet. Then, on the AI Access tab, turn AI access on.

Keep the kanban folder, your work queue, separate from the reference folders.

Project · Morion app
Morion Featureskanban · 338 notes
Mo Architecture Notesrole: architecture
Mo Lessonsrole: lessons
Feature Specsrole: specs
Morion Specs For LLMrole: rules
Morion Releases Logsrole: general

2Let the agent write the first notes

You do not write hundreds of notes up front. Ask the agent that already knows the repo to write the first ones: one architecture note per subsystem, in its own words, with the file paths and the invariants a change must keep. Ten to twenty notes is a good first pass.

From then on, notes appear at the moments they matter. A decision becomes a note when you make it. A lesson becomes a note when a fix lands. A spec becomes a note before the ticket. The agent writes them over MCP as part of finishing work; the Morion skill tells it to.

you, in Claude Code, at the repo root Read src/core, src/server and src/web. For each subsystem write one note into the Morion folder "Mo Architecture Notes": what it owns, its entry points, the invariants a change must keep, and the tests that pin them. One note per subsystem, under 80 lines each. claude notes_create "Auto-code runner: what it owns and what must not change" notes_create "Work packets: every entry point and its checks" notes_create "Desktop shell: start, stop and crash recovery" … 14 notes written.

3Take a ticket with its work packet

Now a ticket is more than a title. When an agent takes it with mo_take_task, Mo returns a work packet: the ticket body, the comments that matter, the project brief, the related architecture notes, lessons, specs and rules from the reference folders, and the topics it belongs to. The agent reads three notes instead of three hundred files.

you → Claude CodeTake the ticket “Add resume to the Codex adapter” from Morion, claim it, and start from the work packet. Read the architecture note it links before you touch the adapter.

Auto-code does the same at the mo_stage gate, so the implementer in a workflow starts with the same slice a human would hand it.

claude mo_take_task {taskId: "Add resume to the Codex adapter", claim: true} work packet task Add resume to the Codex adapter · acceptance: 3 items comments 2 relevant of 7 ("resume is supported by the agent's SDK", "keep the process id empty on resume") brief Morion app · project brief, 14 lines related architecture: "Codex adapter: sessions and resume" lessons: "Resume after a crashed run" specs: "Resume contract for agent sessions" topics auto-code-harness, codex-adapter warnings none

On a broad ticket, a migration or a redesign, ask for more: mo_take_task takes relatedCount up to 20. If no folder has a role, the packet says so and searches the whole project instead.

4Ask Mo before you touch an old decision

Before a change that touches an old decision, ask Mo from Claude Code: it calls mo_ask, which runs on your login. The answer cites the notes and marks each claim: decided, provisional, superseded, unknown. A conflict between two notes comes back as a conflict. A gap is a gap. You get the state of the knowledge, not a confident summary of it.

you → Claude CodeAsk Mo in Morion: can Auto-code resume the implementer’s session after a crash, or does every run start fresh? Show me the sources.

In the app, the same question works in Mo Assistant, the in-app chat, on Pro with a provider key.

mo_ask · Morion app3 sources · verified
Can Auto-code resume the implementer’s session after a crash, or does every run start fresh?
Mo

It depends on the resolution on the card. Resume session continues where the agent stopped; New session starts fresh.

  • Re-opened resolutions: "Resume session continues the agent session that already has the context."decided
  • Resume contract for agent sessions: keep the process id empty on resumedecided
  • Resume after a crashed run: a resumed session re-reads the ticket before it actsprovisional

Conflict: none. Gap: no note says how old a session can be and still resume.

5Keep CLAUDE.md down to the rules

Rules that must load in every session stay in the file: coding principles, the verification commands, the kanban etiquette (claim, comment, move to Review). Everything historical moves out: shipped-feature recaps, postmortems, old plans. The file ends with a table that says which Morion folder holds what.

you → Claude CodeGo through CLAUDE.md. Move every shipped-feature recap, postmortem and old plan into the Morion folder it belongs to. Keep the rules and the verification commands, and end the file with a table that says which folder holds what.

Keep it short enough to load in every session. The CLAUDE.md use case has the snippet.

6Questions

Does Morion index my source code?

No. Morion indexes notes: architecture notes, decisions, lessons, specs and tickets. Your agent reads the code with its own tools; Morion hands it the knowledge about the code.

How long should CLAUDE.md be?

Short enough to load every session: rules, verification commands and the board etiquette. History, postmortems and old plans belong in notes an agent can look up when a ticket needs them.

7What you have now

Every ticket in the queue arrives with its slice of the codebase: the architecture note, the decision behind it, the lesson from last time. The agent reads three notes, not the repository. When it finishes, it writes the lesson back, so the next ticket starts one note richer.

CLAUDE.md stays short. Ask Mo tells you what is decided and what is still open, with the note it came from, and your agent gets the same answer over MCP.

Download