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)
```
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
+2 -4
View File
@@ -152,9 +152,7 @@ cd ~/Projects/PROJECT-NAME
claude "describe the task here"
```
**Close out every session** (60 seconds — this is what makes closing feel safe instead of like loss):
> Update the Current state section in CLAUDE.md, commit, and push.
**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.
Then `/exit`.
@@ -190,7 +188,7 @@ claude
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:
- **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
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
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
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