Agent setup
You don't carry the methodology in your head, and you don't paste the canon into a chat. The agent learns the rules from the tool; you bring the judgment. Two pieces make that automatic.
1. The repo carries its own brief
Drop a CLAUDE.md at the repo root. Claude Code reads it on open, so any agent you start there is briefed before you've said a word. A ready template lives atdocs/conventions/specline-CLAUDE.md; it tells the agent it's a Specline repo, how to shape and migrate plans with you, and to reach for Specline tools.
2. Specline is sitting right there as a tool
With the MCP server registered at user scope, the agent discovers specline_spec / specline_rules / specline_checkin every repo. The brief tells it where it is; the tools let it act. It onboards itself.
What a day looks like
- Open a fresh agent chat in the repo (with
CLAUDE.mdpresent). - Say it in your own words:
Let's shape a new feature: <your idea>. — or — Migrate this plan into Specline with me: <the file>.
- The agent pulls the canon (
specline_spec), asks you the shaping questions, and writes the spec folder indocs/drafts/— checking itself withspecline_checkas it goes (only parse-level integrity runs against a draft). - You read the result in one sitting and approve it — moving it to
docs/specs/— or send it back. That's the approve gate — your call, not the machine's.
Here's what you don't have to do: remember the spec structure, check it's right by hand, or learn the rules before you start. The agent knows the structure (from specline_spec), Specline checks it, and specline_rules lists the checks on demand.
You don't need Claude Code for this
Any agent with shell access does the same: have it run specline spec to load the canon and specline check --format json to check its work. MCP just makes the discovery automatic.