larvit/plainpages
3
0
Fork 0
Code Issues 1 Pull Requests 5 Actions 5 Packages Projects Releases Wiki Activity

File item 60: move the decisions out of AGENTS.md into docs/decisions.md
CI / full-gate (push) Successful in 3s
Details
Mirror / github-mirror (push) Successful in 3s
Details

Browse Source
This commit was merged in pull request #224.
This commit is contained in:
Lilleman auf Larv
2026-11-08 20:56:37 +01:00
parent 9b52b7e5ff
commit b05d678c5f
1 changed files with 13 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
todo.md
+13 -1
View File
@@ -6,12 +6,13 @@
`Bar = 1`
`Next ID = 60`
`Next ID = 61`
## Items
| ID | Release | Blocked by | Exempt | Item | L | E | I | R | S | Moves | Score |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 60 | 0.5.0 | | | **Move the decisions out of AGENTS.md into `docs/decisions.md`, leaving only each decision's title in AGENTS.md.** | 3 | 2 | 2 | 5 | 6 | code health by 4 | 4.0 |
| 2 | 0.5.0 | | | **Rename the admin example plugin to a name that says what it administers.** | 3 | 1 | 2 | 4 | 6 | 9 by 3, code health by 2 | 2.6 |
| 5 | 0.5.0 | | | **List grants that no installed plugin declares, with a remove action.** | 2 | 2 | 2 | 4 | 4 | 2 by 3 | 2.1 |
| 41 | 0.5.0 | | | **Apply a permission save as one Keto call, so it cannot stop part-way.** | 2 | 2 | 2 | 4 | 3 | 2 by 2 | 2.1 |
@@ -27,6 +28,17 @@
## Details
### 60. Move the decisions out of AGENTS.md into `docs/decisions.md`, leaving only each decision's title in AGENTS.md.
AGENTS.md is loaded into every session, and about 400 of its 474 lines are the "Deliberate
architectural deviations". Each becomes a `docs/decisions.md` entry per `~/.claude/rules/decisions.md`:
a one-line title stating what holds, the reasoning and its "valid while", and the README goal or
principle it serves. AGENTS.md keeps the priorities, Docker commands, README structure, Rules, Comments
and Scoring run, plus the list of titles. Repoint the code comments that cite "(AGENTS.md)" for a
decision, and make `allows` in `src/auth/gate.ts` easier to read: a seat found its reason only in
AGENTS.md. No test reads AGENTS.md; `rank_todo.py` and larv-review start reading `docs/decisions.md`
once it exists, so run `rank_todo.py --check` on it.
### 2. Rename the admin example plugin to a name that says what it administers.
The new name is `auth-admin`, chosen by the maintainer. The id is also the mount path, so the compose files,