RustでRDBMSをスクラッチから実装する学習プロジェクトに対する、Claude Code 向けの補助ガイド。
- 最初に
AGENTS.mdを読む - 次に、変更対象に近い
docs/とテストを確認する - 振る舞いが曖昧なら、新規抽象化を提案する前に既存実装と既存テストを優先して読む
- 複数ステップの作業、複数ファイル変更、振る舞い変更では編集前に短いプランを提示する
- 入口情報は
AGENTS.mdに寄せ、詳細ルールはdocs/に寄せる - 大きな文書をここに集約せず、必要なら将来的に
.claude/配下へ分割できる粒度を保つ - 最小差分で進め、タスクが要求しない広いリファクタは避ける
- コード変更では意図を説明するコメントを必要箇所に残す
- 共通ルール:
AGENTS.md - 概要と現在地:
docs/overview.md - アーキテクチャ:
docs/architecture.md - 設計判断:
docs/decisions.md - コーディングルール:
docs/coding-rules.md - ハーネス設計:
docs/harness-engineering.md - 実装計画:
docs/plans/
rustup update
cargo test --workspace
cargo test -p <crate>
cargo fmt
cargo clippy --workspace