specself-starter
CLAUDE.md0 starsChanged 4 months agoMITView on GitHub
This file is for Claude Code (and Fable). It is the fast path for running the kit in Claude Code; it adds tool mechanics on top of the agent-neutral contract and never restates a rule. Read AGENTS.md first — it is the source of truth. The one rule, the standing jobs, the hard boundaries, and the tone all live there and all apply. This file points at them; it does not copy them. Delete this file and the kit still…
- Commits and pushes
The file
We split this CLAUDE.md into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 83
When you propose a candidate principle/goal, write it to the target file as a <!-- CANDIDATE - edit or delete --> block, never as committed …
≈ “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.
Files
CLAUDE.md — Claude Code Accelerators
This file is for Claude Code (and Fable). It is the fast path for running the kit in Claude Code; it adds tool mechanics on top of the agent-neutral contract and never restates a rule.
Read AGENTS.md first — it is the source of truth. The one rule,
the standing jobs, the hard boundaries, and the tone all live there and all apply.
This file points at them; it does not copy them. Delete this file and the kit still
runs from AGENTS.md.
Always-on context
At the start of every session, load:
AGENTS.md— the operating contractsteering/— the method (philosophy, methodology, cadence, coherence, privacy, tone)
Then load the human's current state from your-life/ as the tier requires.
Cadence sessions are skills
The reflection tiers ship as skills in .claude/skills/. Invoke
one by name; each reads steering/ first, hydrates the matching templates/ file,
runs the coherence check on weekly+, and writes only <!-- CANDIDATE --> drafts
(see .claude/skills/README.md).
| Skill | When | Lead lens |
/foundation | once, at setup (first sitting 15-20 min; rest across week one) | Intake / Journalist |
/daily | daily (~2 min) | Journalist |
/weekly | weekly (~20 min) | Coach + Journalist |
/monthly | monthly (~60 min) | Skeptic + Therapist |
/quarterly | quarterly (~90 min) | Skeptic + Forensic-Auditor |
/annual | yearly (half day) | Future-Self + Biographer + Stoic |
Two any-time helpers stay as slash commands in .claude/commands/:
/capture (a quick journal jot) and /coherence-check (a standalone read-only
alignment audit; the weekly+ skills run this inline).
Personas are subagents
Each lens in personas/ has a matching subagent in
.claude/agents/. Spawn one to run through that lens — the
Skeptic to stress-test a principle, the Coach for a tactical review, the
Future-Self for the annual rewrite. The subagent reads its persona file at
runtime (single source of truth). Respect the pairing rules in each persona file
(some pair poorly in one session). The cadence skills already name their lead lenses.
The privacy guard
.claude/settings.json wires a PreToolUse hook that
blocks any git commit/git push which would include private your-life/
corpus or a secret, and a SessionStart hook that nudges you when a review tier is
overdue (it only prints; it never authors a review). The same guard runs without
Claude via the pre-commit fallback. See the privacy-guard section of
GETTING-STARTED.md (including the .specself-allow-corpus
opt-in for a deliberate private repo).
Memory
Your corpus is the your-life/ files, not Claude Code memory. Do not persist
corpus content (journal entries, principles, anything personal) into Claude Code's
saved memory — it is not the human's authored file and can outlive the session.
Memory is fine for tool preferences; the life OS state lives only in your-life/.
Plan mode and the foundation session
The /foundation session is generative — it writes candidate drafts under
your-life/ — so run it in normal mode, not plan mode (plan mode is read-only and
would block the drafting). If you want to preview the five passes first, use plan
mode to outline them, then exit plan mode to run the interview for real.
Guardrails
The behavioral rules are in AGENTS.md § Hard boundaries and § The one
rule — honor them, do not re-derive them here. Two Claude Code mechanics implement
them:
- The privacy guard above now enforces "never push the corpus" (AGENTS.md hard boundary) at commit time, so it no longer depends on remembering.
- When you propose a candidate principle/goal, write it to the target file as a
<!-- CANDIDATE - edit or delete -->block, never as committed text. That is how AGENTS.md's "draft candidates, never author" rule looks in a file.
your-life/.sensitive/ is off-limits (AGENTS.md): do not read or grep it, even if
asked to "search everything."
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
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.

