Add best practices, hooks, memory files, and scripts from recent sessions
Includes: spec-driven and test-driven development best practices, reproduce-before-fixing debugging workflow, require-plan-file hook, find-project-root script, session logs, memory files for decisions/ gotchas/process-lessons, and updates to existing best practice topics. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
29
memory/process-lessons.md
Normal file
29
memory/process-lessons.md
Normal file
@@ -0,0 +1,29 @@
|
||||
# Process Lessons
|
||||
|
||||
## Always run git-status-report at session start
|
||||
|
||||
Previous sessions may leave uncommitted work. Running `git-status-report` (or checking git status) at session start catches this pattern before it compounds.
|
||||
|
||||
## Use plan mode for architectural tasks
|
||||
|
||||
Plan mode (Shift+Tab twice) works well for designing systems before implementing. Explore existing patterns, design the architecture, get approval, then execute. Implementation is straightforward when the plan is thorough.
|
||||
|
||||
## PostToolUse exit code 2 feeds errors back to Claude
|
||||
|
||||
Exit code 2 from a PostToolUse hook sends stderr content back to Claude as feedback without blocking the edit. Exit 0 = silent success. Exit 1 = hard block.
|
||||
|
||||
## Agent-type hooks are read-only
|
||||
|
||||
Hooks with `type: "command"` cannot use Edit/Write tools. Lint fixing from hooks must happen via the Agent tool subagent, not directly in hooks.
|
||||
|
||||
## All hooks in a matcher array run in parallel
|
||||
|
||||
Multiple hooks registered for the same matcher execute concurrently, not sequentially. Design hooks to be independent.
|
||||
|
||||
## SSH key for ai_enablement is password-protected
|
||||
|
||||
Needs ssh-agent loaded before git push to Gitea. If push hangs, check that the key is added to the agent.
|
||||
|
||||
## Batch parallel file creation for efficiency
|
||||
|
||||
Creating many independent files in a single Write batch (e.g., 11 best-practices files at once) is significantly faster than sequential creation.
|
||||
Reference in New Issue
Block a user