notetaker-fundamentals
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:
More from thebushidocollective/han
android-jetpack-compose
Use when building Android UIs with Jetpack Compose, managing state with remember/mutableStateOf, or implementing declarative UI patterns.
1.1Kfastapi-async-patterns
Use when FastAPI async patterns for building high-performance APIs. Use when handling concurrent requests and async operations.
785storybook-story-writing
Use when creating or modifying Storybook stories for components. Ensures stories follow CSF3 format, properly showcase component variations, and build successfully.
487atomic-design-fundamentals
Use when applying Atomic Design methodology to organize UI components into quarks, atoms, molecules, organisms, templates, and pages. Core principles and hierarchy.
367solid-principles
Use during implementation when designing modules, functions, and components requiring SOLID principles for maintainable, flexible architecture.
250angular-rxjs-patterns
Use when handling async operations in Angular applications with observables, operators, and subjects.
216