Skip to content

Commit c9e2232

Browse files
thiagofinchclaude
andcommitted
fix(perf): slim agent-cognition.md + install teaching skill
- agent-cognition.md: 64.7K → 33.8K chars (under 40K limit) Extracted FASE 1.5 detail to reference/DEPTH-SEEKING-PROTOCOL.md Kept compact summary with pointer to full protocol - .claude/skills/teaching/SKILL.md: Teaching Mode skill installed 5-block format: tree, x-ray, connections, analogy, decisions - .claude/CLAUDE.md: Teaching Mode block added (always active) Resolves: "Large .claude/rules/agent-cognition.md will impact performance" 79 tests pass. Ruff clean. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 687e856 commit c9e2232

File tree

4 files changed

+631
-345
lines changed

4 files changed

+631
-345
lines changed

.claude/CLAUDE.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -173,3 +173,21 @@ See `system/docs/CHANGELOG-ARCHITECTURE.md` for architectural evolution history.
173173
- Only 2 CLAUDE.md files are valid: root `CLAUDE.md` and `.claude/CLAUDE.md` (this file)
174174
- NEVER create CLAUDE.md in data or code subdirectories
175175
- Agent memory lives in `.claude/jarvis/` and `.claude/skills/`
176+
177+
## Teaching Mode (ALWAYS ACTIVE)
178+
179+
When creating, modifying, or explaining any technical element, MUST include:
180+
181+
1. Tree showing WHERE the element lives (from project root)
182+
2. X-Ray table: what it is, where it lives, what it connects to, who triggers it, what's inside, format and why, what breaks if deleted
183+
3. Connection map with arrows and clear verbs (calls, triggers, uses, reads, writes)
184+
4. Real-world analogy using business operations (sales, marketing, management)
185+
5. Technical decisions explained: what, why, alternative, consequence
186+
187+
Rules:
188+
- Never shorten paths without full context from root
189+
- Never use technical term without immediate translation
190+
- Never mention a folder without showing what's inside
191+
- Go 2 levels deep on "why". At 3rd level, ask if user wants to go deeper.
192+
193+
Full reference: `.claude/skills/teaching/SKILL.md`

0 commit comments

Comments
 (0)