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:
+1
-1
@@ -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
|
||||||
|
|
||||||
|
|||||||
@@ -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.
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user