update-design

To record design decisions, extract choices and rationale from conversations, then update relevant sections like Overview, Architecture, Implementation Plan, and TODOs in your DESIGN.md file to maintain accurate project documentation.

Keeping a changelog updated requires adding timestamped entries to the Changelog section of DESIGN.md whenever design or implementation decisions are made, ensuring project evolution is accurately tracked over time.

Yes, you can write design documentation in Japanese. The system supports both English and Japanese for documentation content and user communication when recording design and implementation decisions.

Tracking design decisions requires a `.claude/docs/DESIGN.md` file with predefined sections like Overview, Architecture, Implementation Plan, TODOs, and Changelog to properly structure and maintain your project's decision history.

Documenting alternatives for a database choice involves capturing the selected option, the reasons for choosing it, and any alternatives considered, then recording these formally in the design documentation during your project conversation.