Blog/Simon Willison/Claude Docs Best Practices

• Claude Docs Best Practices - Simon Willison

  • Key Insight

    • Documentation best practice for Claude Code:

      • If you have an AGENTS.md file, you can source it in your CLAUDE.md using @AGENTS.md to maintain a single source of truth.
        

  • Context

    • This tip addresses documentation organization in Claude/Code
    • Enables centralized agent configuration management
    • Prevents duplication across documentation files

  • Implementation

    • Create a dedicated AGENTS.md file for agent configurations
    • Reference it in CLAUDE.md using the @ syntax
    • Maintains consistency across documentation

  • Related

    • AI/Coding
    • Documentation
    • Claude
    • My/Pref/Dev/AI/Config/Management