Impl Frontend Work

必読 spec

• docs/governance/architecture/spec.md
• docs/governance/backend-coding-standards/spec.md
• docs/frontend/frontend-coding-standards/spec.md
• docs/frontend/frontend-architecture/spec.md

手順

1. work order の section_id goal required_reading shared_contract condensed_brief progress_snapshot を読む。
   • design_principles を確認し、SRP/SoC などの責務境界を壊さない実装方針を先に固定する。
2. 以下の規約およびアーキテクチャ定義に従って実装する。
   • docs/governance/architecture/spec.md
   • docs/governance/backend-coding-standards/spec.md
   • docs/frontend/frontend-coding-standards/spec.md
3. docs/frontend/frontend-architecture/spec.md を読む。
4. 自分の owned_paths だけで実装対象を確定する。depends_on は前提参照であり、依存 section の実装着手権限ではない。
5. 外部ライブラリ、フレームワーク、SDK、ブラウザ API の現行仕様に依存する実装や設定変更を行う場合は、Context7 MCP を使って対象ドキュメントを確認してから実装する。ライブラリ ID 解決と docs 取得を行い、推測で API を使わない。
6. owned_paths 外の編集、別 section の責務、未固定 contract 解消が必要だと分かった時点で実装を止め、references/templates.md の Section Result と blocked 形式で completed_scope remaining_gap noise_classification reroute_hint を返す。
7. 小さな変更単位で実装する。
8. lint:file -> 修正 -> 再実行 を回す。
9. typecheck -> lint:frontend -> npm --prefix frontend run build を実行する。frontend section の品質ゲートは build を含むものとして扱い、work order の validation_commands に build が無い場合でも build を追加で確認する。品質ゲートを通すために owned_paths 外の修正が必要になった場合は修正せず blocked を返す。失敗は scope_failure external_validation_noise known_pre_existing_issue に分類する。
10. structured diff 形式で section_id result completed_scope remaining_gap changed_paths validation_result noise_classification reroute_hint unverified principle_adherence を返す。
11. 返却後は停止し、次 section の開始判断を impl-direction に委ねる。

レビュー修正ループ

• impl-direction から required delta が返ったら、その解消を最優先で実施する
• 前回 feedback に明示的に触れながら修正内容を返す
• review の起動判断は impl-direction に委ねる

参照資料

• 実装メモの雛形は references/templates.md を使う。
• 実装の進め方の例は references/examples.md を読む。
• 品質ゲート順序は references/quality-checklist.md を使う。
• owned_paths 外が必要になったときの返却形式も references/templates.md を使う。

許可される動作

• 自分の所有範囲に責任を持つ
• 実装範囲は 1 section の goal に限る
• tasks.md や他 work order は参照用にとどめ、自 section の実装に集中する
• depends_on は読み順の制約として扱い、編集権限は owned_paths に限る
• owned_paths 外の編集が必要な場合は blocked として返す
• blocked 返却では、どこまで完了したかと何が未解消かを必ず分ける
• 大きい変更を一括で入れず、小さな変更単位で実装と確認を繰り返す
• 設計が曖昧な場合は実装で補完せず remaining_gap として返す
• UI とロジックの責務を分けて扱う
• design_principles に記載された SRP/SoC/DIP/OCP のうち該当分を満たすよう実装し、逸脱した場合は remaining_gap に理由を残す
• 外部依存の API や設定値は Context7 MCP で確認できる限り確認してから使う
• 他 agent の変更を巻き戻さない
• 未検証の箇所は明示する
• validation failure を外部ノイズと section failure で混ぜない
• frontend section では npm --prefix frontend run build を必須品質ゲートとして含める
• section 完了後の次 section 判断は impl-direction に委ねる