capturing-session-learningslisted

# Agents.md Session Capture Review the current session for context that was missing and would have helped the host agent. Propose targeted additions to the right agent-instruction file by scope. ## Platform Adaptation | Capability | Claude Code | Codex | |---|---|---| | Find files | `Glob` / `Grep` | `shell` (`find`, `grep`) | | Read a file | `Read` | `shell` (`cat`) | | Edit a file | `Edit` | `apply_patch` / `shell` heredoc | | User confirmation | `AskUserQuestion` | `ask_user` / built-in approval prompt | | Shell commands | `Bash` | `shell` | The skill body refers to actions abstractly. The host agent maps to its own tool inventory. ## Step 1: Reflect What context was missing during this session that would have helped the host agent? - Bash commands that were used or discovered - Code style patterns followed - Testing approaches that worked - Environment / configuration quirks - Warnings or gotchas encountered - Tool preferences (e.g. "always use ripgrep over grep here") ## Step 2: Discover candidate files Find every agent-instruction file in scope (project + user-global), dedupe symlinked pairs via `realpath`: ```bash { find . \( \ -name "AGENTS.md" \ -o -name "AGENTS.local.md" \ -o -name "CLAUDE.md" \ -o -name "CLAUDE.local.md" \ -o -name ".claude.md" \ -o -name ".claude.local.md" \ \) -not -path '*/node_modules/*' -not -path '*/.git/*' 2>/dev/null ls ~/.claude/CLAUDE.md ~/.codex/AGENTS.md 2>/dev/null } | xargs -I{} re