Docs: one instruction file, and no status in files #2

New issue

Closed

opened 2026-08-24 14:48:18 +00:00 by jlxq0 · 0 comments

jlxq0 commented

2026-08-24 14:48:18 +00:00

Owner

This repository is now in Forge as eltrix / web. Bring its instruction files up to the standard the rest of the fleet runs on. oddie-apps/outa_web is the worked example: see its issues 23 to 26.

The instruction files

There is a CLAUDE.md (52 lines) and no AGENTS.md, so Codex reads nothing at all in this repository. Rename it to AGENTS.md and replace CLAUDE.md with the single line @AGENTS.md.

AGENTS.md is the instruction file because both Claude and Codex read it. It holds only what an agent cannot read from the code: constraints, rationale and pitfalls. Architecture, directory layouts, data models and env-var names are discoverable, so cut them rather than carrying them across. A shorter AGENTS.md that is entirely true beats a long one that is half stale.

There are no loose planning documents in this one, so the instruction files are the whole job.

Where to work

~/Forge/eltrix/wt/<change>/, created with ~/Forge/mantis/wt/main/mantis/bin/forge.sh new eltrix <change>. That worktree holds every repo of the project on one branch. Do not work in ~/Code/oddie-apps/eltrix_web.

Note that ~/Code/oddie-apps still holds stashes that a clone cannot carry, so do not delete anything there.

Xcode is not installed on this machine, only the Command Line Tools. This change is documentation only and needs no build.

This repository is now in Forge as `eltrix` / `web`. Bring its instruction files up to the standard the rest of the fleet runs on. `oddie-apps/outa_web` is the worked example: see its issues 23 to 26. ## The instruction files There is a `CLAUDE.md` (52 lines) and no `AGENTS.md`, so Codex reads nothing at all in this repository. Rename it to `AGENTS.md` and replace `CLAUDE.md` with the single line `@AGENTS.md`. `AGENTS.md` is the instruction file because both Claude and Codex read it. It holds only what an agent cannot read from the code: constraints, rationale and pitfalls. Architecture, directory layouts, data models and env-var names are discoverable, so cut them rather than carrying them across. A shorter `AGENTS.md` that is entirely true beats a long one that is half stale. There are no loose planning documents in this one, so the instruction files are the whole job. ## Where to work `~/Forge/eltrix/wt/<change>/`, created with `~/Forge/mantis/wt/main/mantis/bin/forge.sh new eltrix <change>`. That worktree holds every repo of the project on one branch. Do not work in `~/Code/oddie-apps/eltrix_web`. Note that `~/Code/oddie-apps` still holds stashes that a clone cannot carry, so do not delete anything there. Xcode is not installed on this machine, only the Command Line Tools. This change is documentation only and needs no build.

jlxq0 referenced this issue from a commit

2026-08-24 15:56:05 +00:00

docs: one instruction file, and no status in files

jlxq0 referenced this issue from a pull request that will close it,

2026-08-24 15:57:31 +00:00

docs: one instruction file, and no status in files #6

jlxq0 closed this issue

2026-08-26 04:48:07 +00:00