FIND-20260324-020 · 2026-03-24 · Innovation Veille
Anatomy of the .claude/ Folder — Structured Claude Code Configuration Guide
adhoc
HIGH
Avi Chawla published a detailed breakdown of the .claude/ folder structure used by Claude Code (published March 23, 2026, shared via @_avichawla on X). The article covers CLAUDE.md best practices (keep under 200 lines), the rules/ folder for modular path-scoped instructions, commands/ for custom slash commands, skills/ for auto-invoked workflows, agents/ for subagent personas with isolated context windows, and settings.json for tool allow/deny lists. Key quote: 'CLAUDE.md is your highest-leverage file. Get that right first. Everything else is optimization.'
Source
https://blog.dailydoseofds.com/p/anatomy-of-the-claude-folder
ODS Impact
Directly applicable to ODS ADLC pipeline. ODS already uses this architecture (CLAUDE.md, skills/, commands/, agents/). The article validates the current approach and highlights the rules/ subfolder pattern (path-scoped YAML frontmatter rules) as a scaling mechanism we have not yet adopted. The agents/ personas pattern (with model selection — Haiku for read-only, Sonnet for complex) maps to our subagent strategy. settings.json deny-lists are relevant for tightening agent security in production.
Security Review
License: N/A — article/content | Maintenance: ACTIVE | Risk: LOW | Recommendation: SAFE_TO_USE
Tags
claude-code
ai-agents
developer-tooling
adlc
configuration
best-practices