kstack-agents-md

AGENTS.md を書くときの規約。CLAUDE.md など、coding agent が作業の前に読む指示ファイルにも同じく適用する。理由を理解した上で適用すること。

実装の事実ではなく、コードに現れないリポジトリの規約を書く

AGENTS.md には、コードのどこにも現れないリポジトリの規約を書く。実環境を変えるコマンド（terraform apply、デプロイ、DB migration）の実行手順と認証、user の承認が要る操作、レビューと commit の運用がこれにあたる。コードや設定ファイルを読めば分かる実装の事実（ファイル構成と各ファイルの中身、有効にした機能、resource や設定の値）は書かない。

<!-- Bad: コードを読めば分かる実装を要約している -->

## アーキテクチャ

- `main.tf` — VPC、subnet、NAT gateway
- `modules/s3/` — S3 bucket。versioning と SSE-S3 を有効にし、`prevent_destroy` で保護している

## 監査ログ