family
CLAUDE.md0 starsChanged 5 months agoMITView on GitHub
Family stress-management system. CLI is bin/fam, data in data/family.db, library in famlib/. ritual.md is the family charter (gitignored — read it for context, never commit it or copy personal details into tracked files). Run fam today. It is the canonical, closed-world answer: session gaps, WINS (positive momentum — lead with these), the week rollup line, TODAY'S TARGETS (week entries whose day field is today), BEHIND PLAN (assigned day passed, still pending), NO DAY ASSIGNED (pending, unscheduled — nothing can hide),…
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 9
Run fam today. It is the canonical, closed-world answer: session gaps, WINS (positive momentum — lead with these), the week rollup line, …
≈ “Common” is an estimate: at least 1 in 5 of the 28,029 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
family2 — guidance for Claude sessions
Family stress-management system. CLI is bin/fam, data in data/family.db,
library in famlib/. ritual.md is the family charter (gitignored — read it
for context, never commit it or copy personal details into tracked files).
Answering "what's on today / what's todo"
Run fam today. It is the canonical, closed-world answer: session gaps,
WINS (positive momentum — lead with these), the week rollup line,
TODAY'S TARGETS (week entries whose day field is today), BEHIND PLAN
(assigned day passed, still pending), NO DAY ASSIGNED (pending,
unscheduled — nothing can hide), today's calendar, due/overdue todos,
and nightly habits. Pending entries show a pipeline tag like
[dry since <date>] when mid-stage.
For wider views: fam checkin (the nightly report — superset of today
plus neglect, pulses, droughts), fam horizon (everything open at any
distance, including a WEEK PLAN PENDING section), fam journal list
--days N (session narratives).
Day assignments live on week entries (day column, validated mon..sun);
set or move with fam week day <id> <day>. The "family day" rolls over
at 04:00 — a check-in just after midnight still counts as the prior
night.
Other command map
fam todo list— open one-off todosfam cal list— calendar itemsfam chore list— chore memory (last-done dates, cadence)fam week done/skip <id>— mark week-plan items (done cascades to a linked todo)fam week day <id> <mon..sun>— set/move an entry's day assignmentfam week note <id> "<text>"— free-text context on an entryfam week add ... [--day <d>] [--todo <id>]— add entry, optionally linked to an open todo so the pair can't drift apartfam week link <eid> <tid>— link an existing entry to an open todofam week stage <id> <wash|dry|fold>— track a multi-step entry mid-pipeline; put away =fam week done. Stalled stages (2+ days) become neglect flagsfam week new— drafts next week; REFUSES while any earlier week has pending entries (disposition each first: done or skip)fam journal list [--days N]— read journal entries (full text)fam check— verify event log replays to current statefam recall— search past journal/observationsfam --source <manual|nightly|weekly|transcript|capture>— set provenance when writing during a skill session
Skills
/checkin— nightly review (chores, todos, pulses, habits)/weekly— Sunday planning sweep; builds next week's plan/capture— quick mid-day notes outside a session/setup— found or amend the charter in ritual.md
Conventions
- Aliases only, by construction. People exist as aliases (P1, K1,
Grammy, ...) everywhere — db, reports, journals, tracked files. Real
names never enter the system at all; who-is-who lives as relationship
labels in ritual.md's People section (gitignored). Mentioned person
doesn't resolve via
fam person list+ ritual.md? Stop and ask, thenfam person add. - Tests live in
tests/; run withpytest.
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.

