termrain を開発・保守するための資料です。利用方法はルートの README と 日本語 README を参照してください。
| ドキュメント | 内容 |
|---|---|
| 内部設計 | 層ごとの責務、起動・データフロー、非同期レーダーの整合性、変更の置き場所 |
| 責務分離のロードマップ | 現状の分離候補、目標 module 構成、段階的な移行順序、ADR の運用 |
| AI 実行タスク | 曖昧な依頼でも AI が安全に実行できる task ID、scope、完了条件、依存関係 |
| 開発自動化と AI 駆動開発 | ローカル Codex レビュー、GitHub Actions、Dependabot、セキュリティ上の境界、日常の開発フロー |
| Issue調査 | Issue #17のCARTO背景地図でAPIキー要求が表示される原因と再現確認 |
| CARTO APIキー対応調査・実装方針 | Issue #21の認証済みCARTO Voyager対応、利用制限、設定・秘密情報の扱い |
| スクリーンショット | README / PR 用のスクリーンショット管理 |
| Homebrew Formula | tap で配布する Formula の参照コピー |
- 決定的に検査できることは CI で検査する。
- AI は設計・レビューの補助に使い、テスト・人間の判断・リリース承認を置き換えない。
- API key、トークン、個人情報をリポジトリ・ログ・fixture に含めない。
- 利用者に見える振る舞いを変える場合は、英語・日本語の README と CHANGELOG の更新要否を確認する。
- ADR は設計判断の記録、task は実装・検証可能な作業単位である。task ID prefix の意味は AI 実行タスク に定義する。