Skip to content

CLAUDE.md

Latest commit

 

History

History
83 lines (57 loc) · 4.25 KB

CLAUDE.md

File metadata and controls

83 lines (57 loc) · 4.25 KB

context-mode — MANDATORY routing rules

context-mode MCP tools available. Rules protect context window from flooding. One unrouted command dumps 56 KB into context.

Think in Code — MANDATORY

Analyze/count/filter/compare/search/parse/transform data: write code via ctx_execute(language, code), console.log() only the answer. Do NOT read raw data into context. PROGRAM the analysis, not COMPUTE it. Pure JavaScript — Node.js built-ins only (fs, path, child_process). try/catch, handle null/undefined. One script replaces ten tool calls.

BLOCKED — do NOT attempt

curl / wget — BLOCKED

Intercepted and replaced with error. Do NOT retry. Use: ctx_fetch_and_index(url, source) or ctx_execute(language: "javascript", code: "const r = await fetch(...)")

Inline HTTP — BLOCKED

fetch('http, requests.get(, requests.post(, http.get(, http.request( — intercepted. Do NOT retry. Use: ctx_execute(language, code) — only stdout enters context

WebFetch — BLOCKED

Use: ctx_fetch_and_index(url, source) then ctx_search(queries)

REDIRECTED — use sandbox

Bash (>20 lines output)

Bash ONLY for: git, mkdir, rm, mv, cd, ls, npm install, pip install. Otherwise: ctx_batch_execute(commands, queries) or ctx_execute(language: "shell", code: "...")

Read (for analysis)

Reading to Edit → Read correct. Reading to analyze/explore/summarize → ctx_execute_file(path, language, code).

Grep (large results)

Use ctx_execute(language: "shell", code: "grep ...") in sandbox.

Tool selection

  1. MEMORY: ctx_search(sort: "timeline") — after resume, check prior context before asking user.
  2. GATHER: ctx_batch_execute(commands, queries) — runs all commands, auto-indexes, returns search. ONE call replaces 30+. Each command: {label: "header", command: "..."}.
  3. FOLLOW-UP: ctx_search(queries: ["q1", "q2", ...]) — all questions as array, ONE call (default relevance mode).
  4. PROCESSING: ctx_execute(language, code) | ctx_execute_file(path, language, code) — sandbox, only stdout enters context.
  5. WEB: ctx_fetch_and_index(url, source) then ctx_search(queries) — raw HTML never enters context.
  6. INDEX: ctx_index(content, source) — store in FTS5 for later search.

Subagent routing

Routing block auto-injected into subagent prompts. Bash-type subagents upgraded to general-purpose. No manual instruction needed.

Output

Terse like caveman. Technical substance exact. Only fluff die. Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged. Pattern: [thing] [action] [reason]. [next step]. Auto-expand for: security warnings, irreversible actions, user confusion. Write artifacts to FILES — never inline. Return: file path + 1-line description. Descriptive source labels for ctx_search(source: "label").

Session Continuity

Skills, roles, and decisions persist for the entire session. Do not abandon them as the conversation grows.

Memory

Session history is persistent and searchable. On resume, search BEFORE asking the user:

Need Command
What were we working on? ctx_search(queries: ["summary"], source: "compaction", sort: "timeline")
What was the first request? ctx_search(queries: ["prompt"], source: "user-prompt", sort: "timeline")
What did we decide? ctx_search(queries: ["decision"], source: "decision", sort: "timeline")
What NOT to repeat? ctx_search(queries: ["rejected"], source: "rejected-approach")
What constraints exist? ctx_search(queries: ["constraint"], source: "constraint")

DO NOT ask "what were we working on?" — SEARCH FIRST. If search returns 0 results, proceed as a fresh session.

ctx commands

Command Action
ctx stats Call ctx_stats MCP tool, display full output verbatim
ctx doctor Call ctx_doctor MCP tool, run returned shell command, display as checklist
ctx upgrade Call ctx_upgrade MCP tool, run returned shell command, display as checklist
ctx purge Call ctx_purge MCP tool with confirm: true. Warns before wiping knowledge base.

After /clear or /compact: knowledge base and session stats preserved. Use ctx purge to start fresh.