| Frequency | Placement | Example |
|---|---|---|
| Every task | Auto-loaded (L1) | Core principles, project identity |
| Every session | Session init | Current state, active plan |
| Per domain | Agent/skill prompt | Domain patterns, standards |
| Per decision | On-demand | Decision logs, lessons learned |
| Rarely | External | Vendor docs, API references |
| Layer | Bad (pointer only) | Good (motivating) |
|---|---|---|
| Metadata | "Handles PDF files" | "Extracts text, fills forms, merges documents -- 12 validated patterns for common failures" |
| SKILL.md | "See FORMS.md for details" | "Form filling has 3 failure modes that require specific handling. See FORMS.md" |
| Reference | (terminal) | (terminal) |
| Level | Speed | Size | Agent Analog |
|---|---|---|---|
| L1 Cache | Fastest | Smallest | Auto-loaded principles (CLAUDE.md) |
| L2 Cache | Fast | Medium | Session context (quickstart.md, active plan) |
| L3 Cache | Moderate | Larger | Domain knowledge (agent prompts, standards) |
| Main Memory | Slower | Large | Reference files (decisions, lessons, docs) |
| Disk | Slowest | Largest | External resources (MCP tools, web) |
| Approach | Framing | Reliability |
|---|---|---|
| Rule-based | "Read infrastructure-patterns.md before writing Terraform" | Agent may skip if confident, may not notice the instruction |
| Goal-aligned | "15 validated patterns exist that prevent failures you'd otherwise encounter" | Creates awareness of a gap, which drives retrieval |
| Factor | Human Analog | Agent Manifestation |
|---|---|---|
| Limited working memory | ~7 chunks (Miller, 1956) | Context window capacity |
| Session boundaries | Sleep resets executive state | Each session starts with no episodic memory |
| No introspection | Unconscious incompetence | Cannot "know what it doesn't know" |
| Decision fatigue | Ego depletion (Baumeister) | Every retrieval decision is a decision that might be skipped |
| Recency bias | Availability heuristic (Tversky & Kahneman) | Recently loaded context dominates |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| ``` | |
| panic(cpu 0 caller 0xfffffe0024b36cf0): busy timeout[1], (60s): 'AppleAPFSMedia' (a,4020001) @IOService.cpp:5829 | |
| Debugger message: panic | |
| Memory ID: 0x6 | |
| OS release type: User | |
| OS version: 24G90 | |
| Kernel version: Darwin Kernel Version 24.6.0: Mon Jul 14 11:30:29 PDT 2025; root:xnu-11417.140.69~1/RELEASE_ARM64_T6000 | |
| Fileset Kernelcache UUID: 0843B4A77BE94220E9BFBC6024B71273 | |
| Kernel UUID: D013020A-F19B-3730-8283-F7E47107D27A | |
| Boot session UUID: 8B5D8AA0-0E37-4BF4-A2CA-0F2AFDBBAB59 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| ~/.config/rsync/backups 2>&1 | tee /tmp/backups.log | |
| Running LIVE backup | |
| Backing up special files: | |
| + IFS=, | |
| + read -r program source_path | |
| + [[ -z # backup random files and follow the format; $HOME is assumed ]] | |
| + [[ # backup random files and follow the format; $HOME is assumed = \#* ]] | |
| + continue |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| .android* | |
| .appgatesdp* | |
| .atom/ | |
| # Include only .aws/{config,credentials}, exclude all else | |
| + /.aws/ | |
| - /.aws/cli | |
| - /.aws/sso | |
| .aws/sso/cache/ | |
| .bash_sessions/ | |
| .bun* |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| # print.func example output | |
| # REF: https://gist.github.com/todd-dsm/17560775b7e5e4d22339885eeb276784 | |
| % ./template.sh | |
| -------------------------------------------------------------------------------- | |
| Lets do some STUFF! | |
| -------------------------------------------------------------------------------- | |
| Do thing... |
NewerOlder