Back to hub

Tool

The Markdown Files

Same idea as the note Bub gave SFC Murillo. One small file the agent reads every turn, that tells it everything important — who you are, how you work, what’s in scope. Generate the two prompts to bootstrap yours: a grill-me interview that locks the spec, then a write step. CLAUDE.md, AGENTS.md, or whatever your runtime calls it.

Difficulty
2 / 5

Easy if you let grill-me run. Hard if you skip it and try to back-fit the spec later.

Core tools
  • Claude / Codex / Antigravity / your pick
  • grill-me skill (github.com/mattpocock/skills)
Optional
  • A markdown editor
  • Existing CLAUDE.md / AGENTS.md to extend
  • A repo to commit the system into
What it does

Two copy-ready prompts: a bootstrap that grills you and writes the file, plus an operational prompt for sessions after setup.

Write your note

CLAUDE.md / AGENTS.md / whatever your runtime calls it — always the starting file. Pick the agent, tell us where it runs and what it’s for. Generate gives you a bootstrap prompt (with grill-me) and an operational prompt for sessions after.

1. Agent / LLM product
2. Where it runs
3. Workspace / system name
4. Purpose & out-of-scope
5. Grill-me source
6. Extra rounds
Recommended: keep grill-me on, keep the security round on. Grill-me drags a real spec out of you. Security round stops surprises later.