- 市区町村はどう照合するか完全一致 / 前方一致 / 部分一致、大文字・小文字の扱い
- 姓と市区町村をどう組み合わせるかAND / OR、city-only、両方が空の場合の動作
- 0 件の場合、エラーをどこに表示するかフィールド単位 / フォーム全体
BEFORE IMPLEMENTATIONPUBLIC CONCEPT SHOWCASE
00 / START HERE
このまま Coding Agent に
実装させますか？
要件
「注文詳細画面から注文を
キャンセルできるようにしたい。」
実装経路が見えても、仕様の判断までは終わっていません。Forge は Coding Agent の前段で、観測できる事実と、人の権限が必要な判断を分けます。
Order Detail↓Cancel API↓Controller↓Service
! 実装前に確認が必要です
- 01 PAID の注文をキャンセルした場合、返金まで実行するのか？
- 02 誰が PAID 注文をキャンセルできるのか？
- 03 在庫を戻すタイミングはいつか？
✓ 既存 Context から観測済み
実装できる ≠ 決めてよい
Forge は「どう実装するか」を決めるのではなく、実装前に「AI が決めてよいこと」と「人が決めるべきこと」を分けます。
01 / ILLUSTRATIVE SCENARIO
注文キャンセル要件を、
6つの段階で分解する。
Illustrative Scenario
考え方を示すための簡略化した業務シナリオです。実在するリポジトリでの実行結果ではありません。
要件
注文詳細画面から、注文をキャンセルできるようにしたい。
この要件が触れる実装面をたどり、根拠と未確定の判断を段階ごとに整理します。
入力された要件
注文詳細画面から、注文をキャンセルできるようにしたい。
判断の境界
技術的に妥当でも、
承認された判断とは限らない。
WITHOUT / 01
技術的に妥当な仮定
Coding Agent が補うかもしれない前提
PAID→CANCELLED- 自動で返金を実行する
- 在庫を即時に戻す
- 顧客本人ならキャンセル可能
いずれも技術的には自然な選択肢です。しかし、要件や Project Context によって許可された判断とは限りません。
WITH / 02
判断権限で分離
Forge が確認するのは、Project Context から安全に確定できない判断だけです。
02 / VALIDATED REFERENCE
公開コードで追える、
再現可能な Reference Case。
Spring PetClinic の固定リビジョンを使い、「飼い主検索に市区町村の条件を追加する」という要件を、実在する実装面に沿って整理した公開リファレンスです。
成果物は人手で整理した curated reference artifacts です。実行可能な Forge パイプラインや、すべてのリポジトリへの対応を示すものではありません。
01
実際の実装経路
固定 revision の公開コードから、要件に関連する実装面を確認。
01Search FormfindOwners.html
↓
02OwnerControllerprocessFindForm
↓
03OwnerRepositoryfindByLastNameStartingWith
↓
04OwnerControllerTestsobservable behavior
- city大文字・小文字を区別しない前方一致
- lastName + cityAND で組み合わせる
- city-only / 両方空city-only を許可。両方空なら全件を返す
- 検索結果 0 件フォーム全体に
notFoundエラー
city の判断によって、既存の lastName の前方一致動作は変更しません。
04
Coding Agent へ渡す Context
Implementation Package
確認した実装面と Human decision を、再推論が不要な形で引き継ぎます。変更対象
findOwners.htmlOwnerControllerOwnerRepositoryOwnerControllerTests
決定済み仕様
- city: case-insensitive prefix match
- lastName + city: AND
- city-only: supported
- both empty: all owners
- no result: form-level error
テスト
- lastName + city
- city only
- both empty
- city case-insensitive
- AND combination
- no result
このケースでは 3 件の未決定事項を確認し、既存 Context 間の Conflict は検出されませんでした。
03 / VISION
Context から、Engineering Intelligence へ。
Context↓Experience↓Intelligence
Project
Intelligence
一つのプロジェクトについて、要件に必要な Context を理解し、判断・影響範囲・Implementation Handoff を支援する。
現在の公開ショーケースは、この Phase 1 の限定的なフローを示します。Organizational
Intelligence
複数プロジェクトから、共通する標準・Skill・判断・Risk Pattern を蓄積する。
今後の構想であり、現在の公開リポジトリの実装済み機能ではありません。Engineering Intelligence
蓄積した Engineering Experience を、新しいプロジェクトの理解・PoC・開発判断に再利用する。
今後の構想であり、現在の公開リポジトリの実装済み機能ではありません。04 / INSPECT THE EVIDENCE
実装できることと、
AI が決めてよいことは違う。
Forge は、検証可能な根拠と人の判断を分ける Engineering Hypothesis です。公開リポジトリで、その根拠と curated artifacts を確認できます。