Note-Taking Fundamentals for AI-Assisted Development

Effective note-taking patterns for AI assistants to leave meaningful context in codebases.

Philosophy

When AI assistants make changes to code, they should leave breadcrumbs for future AI assistants and human developers. Notes should:

• Preserve context about why decisions were made
• Signal uncertainty where alternative approaches exist
• Mark incomplete work that needs follow-up
• Link to relevant context (issues, PRs, documentation)
• Explain non-obvious patterns that might confuse readers

Note Formats

AI Development Notes

Special comment format for AI-to-AI communication: