diff --git a/portability.md b/portability.md index 4ecf8f6..972de4f 100644 --- a/portability.md +++ b/portability.md @@ -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 diff --git a/retrofit-playbook.md b/retrofit-playbook.md index 3b8d2ee..9292e87 100644 --- a/retrofit-playbook.md +++ b/retrofit-playbook.md @@ -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. diff --git a/subagents-handbook.md b/subagents-handbook.md index ca3c7d3..0b44f15 100644 --- a/subagents-handbook.md +++ b/subagents-handbook.md @@ -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