Field Notes from Shipping Real Code with Claude
a year ago
- #Software engineering
- #Productivity
- #AI-assisted development
- AI-assisted development can boost productivity by 10x through deliberate practices.
- Three modes of AI-assisted development: AI as First-Drafter, Pair-Programmer, and Validator.
- CLAUDE.md is essential for documenting project context, conventions, and boundaries for AI.
- Anchor comments (AIDEV-NOTE, AIDEV-TODO) guide AI and document code for humans.
- Humans must write tests to encode intentions and edge cases; AI should not modify test files.
- AI should never touch database migrations, security-critical code, or API contracts without versioning.
- Proper context-rich prompts prevent iteration cycles and improve AI output quality.
- Fresh Claude sessions for distinct tasks prevent context pollution.
- Transparency in commit messages (tagging AI-assisted commits) is crucial for team culture.
- The future of development involves AI understanding entire codebases and proactive suggestions.