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 at
specline/templates/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_check
in 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 — checking itself withspecline_check(author mode) as it goes. - You read the result in one sitting and sign it, or send it back. That's the ratify 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 --mode author --format json to check its work. MCP just makes the discovery automatic.