docs(reviews): 2026-05-10 gap analysis に規約成立後の方針更新ディスクレーマ追記

[win2cot]

背景

docs/reviews/2026-05-10-scaffold-vs-design-gap-analysis.md は 2026-05-10 時点の整理。以降の規約成立(2026-05-14 PR #135 マージで 設計規約 / コーディング規約 / ADR-0001 / ADR-0002 確定、後続 ADR-0006 / ADR-0008 等)により、§G-5(クリーンアーキ 4 層 + ArchUnit の解釈)/ §G-6(環境別 yml 分割の検討) の方針が更新されているが、原 doc には反映されていない。

このため、未来の参照者が gap analysis を読んで旧方針(ArchUnit 採用 / 環境別 yml 分割 / Secrets Manager 経由の DB password 等)を実装してしまうリスクがある。

実際 Sprint 0 N1〜N8 Issue 本文がこの旧方針を引きずっていたことを 2026-05-24 に発見、Issue 本文を書き換えた(別 Issue でトラッキング)。再発防止として gap analysis 自体にディスクレーマを追記する。

やること

docs/reviews/2026-05-10-scaffold-vs-design-gap-analysis.md の冒頭(タイトル直下の「実施日 / 対象 / 目的」ブロックの直後)に以下のディスクレーマを追記:

---

> **⚠ 規約成立後の方針更新について(2026-05-24 追記)**
>
> 本 doc は 2026-05-10 時点の整理。以降の規約成立(2026-05-14 PR #135 マージ、ADR-0002 / ADR-0006 / ADR-0008 等)により、以下の項目は方針が更新されている。最新は **設計規約 / コーディング規約 / 各 ADR を参照**:
>
> - § G-5「クリーンアーキ 4 層 + ArchUnit」 → **Spring Modulith による feature-by-package + 各 feature 内 4 層** のハイブリッド構成(設計規約 §1.1)。**ArchUnit 採用は当面保留**(ADR-0002)、依存方向検証は Spring Modulith `ApplicationModules.verify()` に集約。
> - § G-6「環境別 application-{local,staging,prod}.yml の分割」 → **採用しない**。コーディング規約 §20.2 で `@Profile` 全面禁止、infrastructure-plan §3.4 で単一 yml + 環境変数注入に統一。
> - § G-6「シークレットは AWS Secrets Manager 参照」 → tasks-webapi の RDS は IAM 認証で DB password 不使用(infrastructure-plan §3.5)。OIDC Issuer URI は機密ではなく環境変数で十分。
> - § 推奨アクション「各 Issue を 1 PR とし」 → schema 変更を伴う実装は **migration と JPA Entity を 1 PR で同時 commit**(N1 / N3 のような分割は禁止、別 Issue として起票も推奨しない)。
>
> 本 doc 自体は 2026-05-10 の整理として保持(履歴的価値)。実装着手時は上記更新方針を優先。

---

§G-5 / §G-6 / §推奨アクションの個別セクション末尾にも、それぞれ短い注記(「※本セクションの方針は 2026-05-14 以降に更新済、冒頭ディスクレーマ参照」)を入れる。

受入条件

• 冒頭ディスクレーマ追記
• §G-5 / §G-6 / §推奨アクション 末尾の注記 3 箇所追記
• doc only のため ./gradlew :webapi:check 不要、CI green(spotless / NullAway 影響なし)
• Cross-reference: 設計規約 §1.1、ADR-0002、コーディング規約 §20.2、infrastructure-plan §3.4 / §3.5 への明示リンク

参照

• 本 Issue の起票根拠: 2026-05-24 N1〜N8 Issue 見直しレビュー(sprint0-N1-N8-rewrite-draft.md § 横断追加タスク 案 2)
• 対象 doc: docs/reviews/2026-05-10-scaffold-vs-design-gap-analysis.md
• 参照規約 / ADR: 設計規約 §1.1 / コーディング規約 §20.2 / ADR-0002 / ADR-0006 / ADR-0008 / infrastructure-plan §3.4 / §3.5

[claude-automation-impl]

着手宣言

Issue #249 の実装に着手します。

方針サマリ

対象ファイル: docs/reviews/2026-05-10-scaffold-vs-design-gap-analysis.md

変更内容:

1. 冒頭(実施日/対象/目的ブロック直後の --- の後)にディスクレーマブロックを挿入
   • 設計規約 §1.1 / ADR-0002 / コーディング規約 §20.2 / infrastructure-plan §3.4 / §3.5 への明示リンク付き
2. §G-5 末尾に注記追加(冒頭ディスクレーマへの参照)
3. §G-6 末尾に注記追加(冒頭ディスクレーマへの参照)
4. §推奨アクション 末尾に注記追加(冒頭ディスクレーマへの参照)

CI への影響: doc のみのため ./gradlew :webapi:check 不要、Spotless/NullAway 影響なし。