Fix doc drift surfaced by doc-auditor dry run

- Handbook: evaluator/security-auditor are opus/xhigh, not opus/high (matches wrappers).
- portability.md / retrofit-playbook.md: how-i-work.md is ~50 lines, not 'under 50' (it is 52).
- retrofit-playbook.md daily rhythm: close out with /handoff, not the old manual paste, matching README and the handbook.
This commit is contained in:
Keysat
2026-06-13 00:08:24 -05:00
parent 5f7a51199c
commit 56b868b4e6
3 changed files with 4 additions and 6 deletions
+1 -1
View File
@@ -14,7 +14,7 @@
agents/ ← ~/.claude/agents symlinks here (global subagents) agents/ ← ~/.claude/agents symlinks here (global subagents)
``` ```
Companions: `how-i-work.md` (the always-loaded user layer, under 50 lines), `retrofit-playbook.md` (the one-time conversion manual), and `subagents-handbook.md` (designing and running delegated agents). This document is reference material — never symlink it into anything always-loaded. Companions: `how-i-work.md` (the always-loaded user layer, ~50 lines), `retrofit-playbook.md` (the one-time conversion manual), and `subagents-handbook.md` (designing and running delegated agents). This document is reference material — never symlink it into anything always-loaded.
## The principle ## The principle
+2 -4
View File
@@ -152,9 +152,7 @@ cd ~/Projects/PROJECT-NAME
claude "describe the task here" claude "describe the task here"
``` ```
**Close out every session** (60 seconds — this is what makes closing feel safe instead of like loss): **Close out every session** (60 seconds — this is what makes closing feel safe instead of like loss): run `/handoff`. It updates the Current state section, commits, and pushes.
> Update the Current state section in CLAUDE.md, commit, and push.
Then `/exit`. Then `/exit`.
@@ -190,7 +188,7 @@ claude
Paste: Paste:
> In my git repo at ~/Projects/standards (create it if it doesn't exist yet), add a file called how-i-work.md. Read the AGENTS.md files in my other repos here and fill it with everything that's about me or repeated across all of them — how I like to work and communicate, workflow rules (the close-out ritual, never commit secrets, verify commands by running them), and the structural conventions (AGENTS.md canonical with a CLAUDE.md symlink, scoped guides in docs/guides with index lines). Under 50 lines. Then symlink ~/.claude/CLAUDE.md to it, commit, and push the repo to my Gitea. Don't change the other repos — they stay self-contained. > In my git repo at ~/Projects/standards (create it if it doesn't exist yet), add a file called how-i-work.md. Read the AGENTS.md files in my other repos here and fill it with everything that's about me or repeated across all of them — how I like to work and communicate, workflow rules (the close-out ritual, never commit secrets, verify commands by running them), and the structural conventions (AGENTS.md canonical with a CLAUDE.md symlink, scoped guides in docs/guides with index lines). Around 50 lines. Then symlink ~/.claude/CLAUDE.md to it, commit, and push the repo to my Gitea. Don't change the other repos — they stay self-contained.
Notes: Notes:
- **Repos stay self-contained.** Cloud sessions and other machines never see this file. Anything a repo *needs* lives in the repo; this layer is preferences plus a safety net. - **Repos stay self-contained.** Cloud sessions and other machines never see this file. Anything a repo *needs* lives in the repo; this layer is preferences plus a safety net.
+1 -1
View File
@@ -132,7 +132,7 @@ the catalog. The security-auditor runs them.
how long they're allowed to think before answering — it scales reasoning depth, not how long they're allowed to think before answering — it scales reasoning depth, not
capability ceiling. Both live in the wrapper frontmatter; frontmatter effort capability ceiling. Both live in the wrapper frontmatter; frontmatter effort
overrides the session level while that agent runs. Match the dial to where the cost overrides the session level while that agent runs. Match the dial to where the cost
actually lives: evaluator and security-auditor are **opus/high** because the report actually lives: evaluator and security-auditor are **opus/xhigh** because the report
*is* the reasoning; reviewer, researcher, exerciser, spec-checker, and *is* the reasoning; reviewer, researcher, exerciser, spec-checker, and
portability-checker are **sonnet/medium** because their cost is dominated by frequency, portability-checker are **sonnet/medium** because their cost is dominated by frequency,
tool-call turns, or procedure-following — not thinking depth. The deep insight: a well-proceduralized tool-call turns, or procedure-following — not thinking depth. The deep insight: a well-proceduralized