Training
Certification Leadership Frameworks Agentic for Business
Community Keynotes Retreat Blog Book A Consultation
Protocol 04 of 18 · Track, Mindset · How we think

Cataloguing, folder structures for agentic development

How we lay out a project so agents can navigate, find context, and make decisions. Naming conventions, context files, status files: the boring parts that make everything else work.

Protocol 03 Agents, the folder is the agent All 18 Protocol 05 GitHub hygiene, check-in and check-out
Why this matters

The pain it
solves

If Protocol 03 says the agent is a folder, Protocol 04 says how you arrange those folders determines whether anything actually works.

This is the boring protocol. It is the protocol participants will try to skip. It is also the one that separates a setup that holds together for a year from a setup that turns into chaos after week three.

The teaching

What this
actually is

The canonical project layout

Every Infinite Leverage project has the same top-level shape. Same names. Same places. If you have seen one IL project, you can find your way around any IL project in 90 seconds.

  • CLAUDE.md and AGENTS.md at the root
    Loaded by every agent on every run. CLAUDE.md is your project's brain stem; AGENTS.md is the cross-agent contract.
  • docs/ with subfolders
    docs/plans, docs/product, docs/qa, docs/operations. Standardised so any agent knows where to look for context.
  • brand/ for design system and voice
    Tokens, components, voice notes, examples. The folder the writer and designer read before doing anything (Protocol 08).
  • .claude/agents/ with one folder per agent
    Each agent gets its own folder with its role file and context. Folder is the agent (Protocol 03).
  • public/project-status.html
    Single source of truth for status. Readable by humans in a browser, parseable by agents (Protocol 13).
  • src/ for code
    The actual application. App Router routes, components, libraries. Source code lives here and nowhere else.

Two rules that compound over time

These are the boring rules. They are also the ones that decide whether your project still makes sense to a fresh agent (or a fresh hire) six months from now.

  • One name per concept
    Pick docs or documents. Pick product or pm. Pick epic or ticket. Then use that name everywhere, forever. Inconsistent naming costs every agent a search.
  • Naming conventions live in CLAUDE.md
    Every agent loads CLAUDE.md on first read. Put your project's vocabulary there: file naming, branch naming, where things go. The conventions teach themselves.

Why this is the protocol people skip

Cataloguing is the boring protocol. People want to skip to building. The few who do not skip it are the ones whose projects are still legible after a year.

A line: a well-catalogued project ages like a library. A badly catalogued project ages like a junk drawer.

Try it yourself 15 minutes

Scaffold an IL-layout project in 15 minutes

You can do this in a brand-new repo or alongside an existing project. The goal is to set up the folder shape, write a one-page CLAUDE.md, and watch the next agent inherit the conventions.

  1. Step 01
    Create the top-level folders

    In your project root, run: mkdir -p docs/{plans,product,qa,operations} brand .claude/agents public src.

  2. Step 02
    Write a one-paragraph CLAUDE.md

    Open CLAUDE.md at the root. Write three lines: what this project is, the one-name-per-concept list (Epic vs Ticket, etc), and any non-obvious rule ("no em dashes in copy, no periods at end of headings").

  3. Step 03
    Drop in AGENTS.md

    Copy AGENTS.md from your nearest existing project or the IL template. This is the file that tells every agent the cross-project rules.

  4. Step 04
    Add the first agent

    In .claude/agents/, copy one of your existing agents (writer, PM, whichever you use most). The folder is the agent.

  5. Step 05
    Test it with a fresh prompt

    Open Claude Code in the project. Ask: "Read CLAUDE.md and tell me the rules of this project in three bullets." Watch Claude load the file and play back your conventions.

Outcome

A fresh project with the IL shape, CLAUDE.md teaching every agent the conventions, and the first agent ready to run. Future-you and every future agent inherit the layout for free.

Official resources

Straight from
the source

What you walk out with

By the end of this
protocol

At the retreat

You learn it by
doing it

You rename one file on purpose, watch an agent fail to find it, then restore the name and document the convention so it never happens again.

Connects to

Other protocols this
compounds with

← Previous, Protocol 03 Next, Protocol 05 →