
Agentic architecture for analytics teams
Working with Claude Code reminds me of Pac-Man: the agent chomps through trails of Markdown files, eating context as it goes. Markdown was the language of my statistics homework. Now it’s the information infrastructure of agentic analytics.
Generating files is cheap, but every unreviewed file adds another turn to the maze. Without structure, agents get lost in a probabilistic array of instructions. Two analysts following their own context files get answers that are confidently inconsistent.
I implement runbooks and Markdown architecture for my analytics team. A root CLAUDE.md maps the knowledge tree: team context, business and metric definitions, and database and development best practices. Shared context keeps the team converging on the same facts. I review and simplify every file, which maintains human voice and prevents drift.



