本ファイルは本リポジトリ固有の指示である。
共通規約(sabas0ba/dotfiles の
CLAUDE.md および README)を前提とし、衝突する場合は本ファイルを優先する。
作業は dotfiles が定義する Nix 開発シェル、またはそこから構築したコンテナ環境の 内部で行う。ホストのグローバル環境を汚染しない。
cd ~/repos/dotfiles && nix develop # 開発シェル
make docker-shell # コンテナ
環境の詳細、ツールの追加手順、規約は以下を参照する。
docs/50-development.md — 本プロジェクトの開発環境README.md — 規約の所在CLAUDE.md — Claude Code 向けの補足本プロジェクトの実装に必要なツール(コンパイラ、リンカ、ninja、qemu 等)は
dotfiles 側の nix/packages.nix に追記して取得する。
開発シェルの外部でツールを導入しない。
設計検討段階。実装は未着手。本リポジトリは設計文書のみを含む。
指示がない限り、ファイルの作成や実装に着手しない。 検討中の内容の具象化を目的とした対話が主である。
docs/adr/ に ADR として記録する。
決定を覆す場合は当該 ADR を Superseded とし、新しい ADR を追加する。既存の ADR を書き換えないdocs/99-open-questions.md に集約する。
決定したものは ADR へ移し、当該項目を削除するdowel は正式名称である(docs/adr/0014-name-final.md)。
経緯と調査は docs/adr/0006-naming.md を参照。
docs/ と各 README は英語で記述する(docs/50-development.md 5節)。
コード中のコメントと doc コメントは日本語のままとする。
ADR は記録であり、書かれた当時の言語のまま保持する。
.work/(git ignore 対象)に置く