Pillar

Context Architecture

How a codebase explains itself — context files, documentation and conventions structured so the right material is found at the right time, by a person or a tool.

01

AGENTS.md vs CLAUDE.md vs .cursorrules: When One File Isn't Enough

Whether to keep one context file or several, the three cases where a second file is justified, and why the symlink workaround usually disappoints.

02

Agent Memory: Four Layers, and Which One Is Worth Building

Nothing persists that you did not persist deliberately. The four things people mean by agent memory, why task handoff pays first, and why recording dead ends matters more than recording progress.

03

The AGENTS.md Specification: Anatomy of a Repository Context File

What belongs in an AGENTS.md file, the six sections that carry the weight, why short files outperform comprehensive ones, and where context files stop working.

Other pillars