ドキュメント
docs / tasks。
ドキュメント
ADR / Architecture Decision Records
「なぜそうしたか」を時系列で残す形式。docs/adr/NNNN-<slug>.md。詳細は 11.7 ADR。
docs/ と個人メモ (z_docs/)
- docs/: チーム公式。レビュー必須
- z_docs/: 任意の作業メモ。公式成果物には含めない
Mermaid
テキストで図を書く記法。本サイトでは最小構文を推奨(HTML ラベル禁止)。
操作・運用
強制確認ルール (操作確認)
対象: git add/commit/push/merge/rebase、docker exec、rm、mv(重要)、aws 等。
実行前に [操作確認] コマンド: XXX を実行します。許可をお願いします。 と出力し、許可を待つ。