Skip to content

The agent is the maintainer: AGENTS.md is the method, ANUS.md is who lives here, the X mouth, the lore - #91

Open
eugeneshilow wants to merge 1 commit into
mainfrom
claude-2026-09-24-agent-maintainer
Open

eugeneshilow wants to merge 1 commit into
mainfrom
claude-2026-09-24-agent-maintainer

Conversation

@eugeneshilow

@eugeneshilow eugeneshilow commented Sep 24, 2026 •

Copy link
Copy Markdown
Collaborator

TLDR

First move in a year. From this pull request on, the maintainer of this repository is an AI agent, under a written constitution, with a human overseer holding the keys.

What lands:

  • AGENTS.md — the method's file, Spec-Driven Company, as downloaded plus the Stack section: how work is done here. CLAUDE.md and CODEX.md point to it and to ANUS.md.
  • ANUS.md — who lives here: what this is, the map of where things go, what the repository is about, the house rules, the constitution, where to look. Only the overseer changes it. This repository keeps no journal file: a decision is the pull request that makes it, with its why in the description; the agent's own reasoning lives in the diary.
  • docs/ — the one page, the diary (empty until the agent's first day), and docs/lore/: the project's history, jokes, people and websites, with the scouts' raw notes.
  • agent/ — the agent's body: config.json (whose body it is; fork and change one file), x/ (posting and replying on X through a $1/day budget guard, dry run by default, tests).
  • scripts/check-public.mjs — the hygiene gate: English only, no secret-looking strings, the method named with its link. Wired into preflight and CI.
  • README.md — the poster. The 2025 CLI text is kept whole under a fold.

Nothing in packages/ changes. What to do with the 2025 body is the agent's own public decision later.

Dive Deeper

Everything the agent will do is observable: pull requests link the session log, the diary gets a line even on empty days, the X budget is counted in code and resets at midnight New York time. What it may never do is the constitution inside ANUS.md; only the overseer changes that file.

Reviewer Test Plan

  • npm run check:public — green on this branch.
  • npm run test:agent — three tests, green.
  • ANUS_ENV_FILE=<keys> node agent/x/post.mjs "hello" — prints the text, cost and budget without sending.

Linked issues / bugs

Session log: this pull request was assembled by the overseer's coding agent in conversation with him; the agent's own runs start after merge.


Made under the constitution. A Spec-Driven Company repository.

@eugeneshilow
eugeneshilow force-pushed the claude-2026-09-24-agent-maintainer branch 3 times, most recently from 53c137d to 531ee8d Compare September 24, 2026 16:03
@eugeneshilow eugeneshilow changed the title The agent is the maintainer: rules, constitution, diary, the X mouth, the map The agent is the maintainer: rules, constitution, diary, the X mouth, the map, the lore Sep 24, 2026
@eugeneshilow
eugeneshilow force-pushed the claude-2026-09-24-agent-maintainer branch from 531ee8d to 4b98e4b Compare September 24, 2026 16:20
@eugeneshilow eugeneshilow changed the title The agent is the maintainer: rules, constitution, diary, the X mouth, the map, the lore The agent is the maintainer: AGENTS.md is the method, ANUS.md is who lives here, the X mouth, the lore Sep 24, 2026
@eugeneshilow
eugeneshilow force-pushed the claude-2026-09-24-agent-maintainer branch 11 times, most recently from 20959b5 to fa13b1c Compare September 24, 2026 17:09
…lives here, the X mouth, the lore

From this commit on, the maintainer of this repository is an AI agent under a written constitution, with a human overseer holding the keys.

- AGENTS.md: the method's file, Spec-Driven Company (https://github.com/eugeneshilow/spec-driven-company), as downloaded plus the Stack section. CLAUDE.md and CODEX.md point to it and to ANUS.md.
- ANUS.md: what is specific to this repository: what this is, the map of where things go, what the repository is about, the house rules, the constitution, where to look. Only the overseer changes it. This repository keeps no journal file: a decision is the pull request that makes it, and the agent's own reasoning lives in the diary.
- docs/: the one page, the diary (empty until the agent's first day), and docs/lore/: the project's history, the jokes, the people, the websites, with the scouts' raw notes.
- agent/: the agent's body. config.json says whose body it is; x/ posts and replies on X through a daily budget guard, dry run by default, with tests.
- scripts/check-public.mjs: the hygiene gate, in preflight and CI.
- README.md: the poster. The 2025 CLI text is kept whole under a fold.

Nothing in packages/ changes.
@eugeneshilow
eugeneshilow force-pushed the claude-2026-09-24-agent-maintainer branch from fa13b1c to eb3adc4 Compare September 24, 2026 20:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant