agentleFS
zahardevzahardev/aicontext/.claude/CLAUDE.md

aicontext

CLAUDE.md2 starsChanged 7 months agoMITView on GitHub

Before starting any session, read and follow .aicontext/prompts/start.md. When subagents are available, delegate these tasks instead of performing them inline: Why: Subagents run with their own context window. Delegating keeps the main conversation focused and avoids consuming tokens on raw file contents, test output, and review details. Rules: - NEVER perform a review inline when the reviewer agent exists — delegate to the agent - NEVER read large amounts of code into main context for review — delegate to the…

The file

We split this CLAUDE.md into the rules it gives an agent

9 rules. About 0 are common, 3 are distinctive, and 6 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 6

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Before starting any session, read and follow .aicontext/prompts/start.md.

    line 3
  2. Distinctive:

    When subagents are available, delegate these tasks instead of performing them inline:

    line 7
  3. Very specific:

    NEVER perform a review inline when the reviewer agent exists — delegate to the agent

    line 19
  4. Distinctive:

    NEVER read large amounts of code into main context for review — delegate to the agent

    line 20
  5. Very specific:

    Run multiple agents in parallel when tasks are independent (e.g., reviewer + test-runner after implementation)

    line 21
  6. Very specific:

    NEVER use EnterPlanMode — all planning is done in .aicontext/tasks/ task files per process.md

    line 22
  7. Very specific:

    NEVER launch a subagent without telling the user first — state which agent and what it will do (e.g., "Asking subagent test-runner to …

    line 23
  8. Distinctive:

    When invoking an agent, provide only the context it needs (command, directory, files, task requirements).

    line 24
  9. Very specific:

    When a skill is invoked via /command, its content is provided inline — NEVER read files from .claude/skills/ directories

    line 25

≈ “Common” is an estimate: at least 1 in 5 of the 26,980 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
CLAUDE.md

Project Rules

Before starting any session, read and follow .aicontext/prompts/start.md.

Agents

When subagents are available, delegate these tasks instead of performing them inline:

TaskAgentWhen
Code reviewreviewerAfter completing implementation, before presenting to user
Running teststest-runnerAfter writing or modifying code
Drafting teststest-writerDuring TDD, to parallelize test writing with implementation
Codebase researchresearcherBefore making changes, to understand existing code

Why: Subagents run with their own context window. Delegating keeps the main conversation focused and avoids consuming tokens on raw file contents, test output, and review details.

Rules:

  • NEVER perform a review inline when the reviewer agent exists — delegate to the agent
  • NEVER read large amounts of code into main context for review — delegate to the agent
  • Run multiple agents in parallel when tasks are independent (e.g., reviewer + test-runner after implementation)
  • NEVER use EnterPlanMode — all planning is done in .aicontext/tasks/ task files per process.md
  • NEVER launch a subagent without telling the user first — state which agent and what it will do (e.g., "Asking subagent test-runner to execute the full test suite.")
  • When invoking an agent, provide only the context it needs (command, directory, files, task requirements). Never specify output format or reporting style — agents have built-in instructions and overriding them causes raw output dumps instead of structured summaries.
  • When a skill is invoked via /command, its content is provided inline — NEVER read files from .claude/skills/ directories

Model defaults: Agents default to sonnet, except reviewer which defaults to opus for thorough analysis. Free plan users can downgrade all agents to haiku during aicontext init.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.