calm-guidelisted
Install: claude install-skill Eilodon/CALM
# CALM MCP workflow — quick trigger
**Read `AGENTS.md` at the project root in full now, if it exists.** When
present it is the single source of truth for this workflow — this skill
exists to make sure you actually reach for it at the right moment, not to
hold a second copy of its content that would silently drift out of sync with
it over time.
**If `AGENTS.md` doesn't exist at the project root** — a brand-new install of
this plugin, before its own SessionStart bootstrap has had a chance to
scaffold one, or a non-Claude-Code MCP client where no scaffold ever ran —
this is still very likely a CALM-instrumented repo if a "calm" MCP server is
connected. Call the **`calm_workflow` MCP Prompt** (no arguments) instead: it
renders the exact same workflow-guide text straight from the connected
server's own binary, no project-root file needed. Only conclude "CALM isn't
active here" if that prompt call itself is unavailable or fails.
## If you only have room for the short version right now
1. **Orient** — `repo_overview()` always first, then `hotspots()`/
`fitness_report()` as needed.
2. **Locate** — `locate(query)` (search + file_overview + symbol_info in one
call) or `search(query, kind=...)`.
3. **Inspect** — `source(symbol)` for a symbol-precise read, or
`understand(symbol)` for locate+source+callers together.
4. **Trace** — `callers(symbol)`, `callees(symbol)`, `path(from, to)`,
`dependencies(path)`.
5. **Pre-Edit** — `edit_context(symbol)`: mandatory before touchin