docs(dev): 新 feature 追加時のテンプレ手順書 docs/dev/feature-template.md 整備 (N4 / C)

[win2cot]

A-1/A-2/B で整えた 4 層構造を、新 feature 追加時に再現できるように テンプレ手順書 docs/dev/feature-template.md を整備する。

N4 (#86) を 4 分割した C スコープ:

• A-1 (backend: feature 内クリーンアーキ 4 層パッケージ雛形 + shared Open module 新設 (N4 / A-1) #86): package-info.java + shared Open module
• A-2 (backend: 既存クラス(Controller / Repository / Entity)を 4 層パッケージへ移動 (N4 / A-2) #272): 既存クラスの 4 層移動
• B (backend: 基盤(shared/exception + Task POJO/JPA Entity 分離 + Repository ポート) (N4 / B-1) #273): GET /tasks/{id} 4 層実証
• C (本 Issue): docs/dev/feature-template.md

やること

1. docs/dev/feature-template.md 新規作成

新 feature 追加時の手順を網羅:

• パッケージ構造(<feature>/domain / usecase / adapter/web / adapter/persistence / adapter/external / infra)
• package-info.java テンプレ(@NullMarked)
• shared / @ApplicationModule(type = Type.OPEN) の参照ルール(ADR-0003)
• ApplicationModules.verify() テスト追加方針
• @Transactional 境界明示(コーディング規約 §11)
• DTO / Controller / UseCase / Port / Adapter の責務境界
• B (backend: 基盤(shared/exception + Task POJO/JPA Entity 分離 + Repository ポート) (N4 / B-1) #273) GET /tasks/{id} を参照実装として明示

2. 設計規約 §1.1 / ADR-0003 への cross-reference

• docs/specs/設計規約.md §1.1 に docs/dev/feature-template.md への cross-ref を追記
• docs/adr/0003-shared-package-as-open-module.md に docs/dev/feature-template.md への cross-ref を追記

3. commit message に cross-reference

• Refs: docs/specs/設計規約.md §1.1
• Refs: docs/adr/0003-shared-package-as-open-module.md

やらないこと

• ArchUnit 導入の記載 → ADR-0002 保留中、cross-ref のみ
• README.md トップへの参照追加 → 別 Issue
• docs/dev/ index 作成 → 別 Issue

受け入れ条件

• docs/dev/feature-template.md 存在
• 設計規約 §1.1 + ADR-0003 への双方向 cross-ref
• B (backend: 基盤(shared/exception + Task POJO/JPA Entity 分離 + Repository ポート) (N4 / B-1) #273) GET /tasks/{id} を参照実装として明示

参照

• 前提: backend: 基盤(shared/exception + Task POJO/JPA Entity 分離 + Repository ポート) (N4 / B-1) #273 (B) merge 後着手
• 規約: 設計規約 §1.1 / ADR-0003 / コーディング規約 §11
• 関連 Issue: backend: feature 内クリーンアーキ 4 層パッケージ雛形 + shared Open module 新設 (N4 / A-1) #86 / backend: 既存クラス(Controller / Repository / Entity)を 4 層パッケージへ移動 (N4 / A-2) #272 / backend: 基盤(shared/exception + Task POJO/JPA Entity 分離 + Repository ポート) (N4 / B-1) #273
• Sub-tracker: [Phase 1 Sprint 0] scaffold ↔ 設計書 v1.4.x 整合実装(2 週間、2026-06-14 〜 06-27) #121 Phase 1 Sprint 0