はじめに

2ヶ月、エンジニア2人（ジュニア寄り）という条件で、あるプロジェクトのPoCをスタートしました。

機能数こそ絞られていましたが、そのまま走り出すと以下のような実装以外のオーバーヘッドで時間を溶かしてしまう懸念がありました。

そこで、プロジェクトの最初の2日間を「迷うポイントを物理的に潰す基盤づくり」に捧げました。

方針：「GitHubとJiraを見れば、すべてが揃っている」

目指したのは、開発者が「次に何をすればいいか」を1秒も迷わない状態です。

Jiraを選択したのは、Claude CodeからAtlassian MCP経由でチケット操作が可能になり、ブラウザを開かずにタスクの更新・確認ができる環境を構築するためです。

Superpowersとは？
AIエージェントに「思考(brainstorming) → 計画(plan) → 実行(execute) → 検証(verify)」という開発規律を強制するフレームワーク。バイブコーディングで起きがちな「思いつき実装」問題を解消します。

ADRでは結論だけでなく、以下の2点を重視しました。

開発中、ジュニアメンバーから「なぜDynamoDBなんですか？ RDBの方が楽では？」という疑問が出た時も、コミュニケーションコストを最小限に抑えられたと感じています。

Superpowersでのステップを丁寧に踏ませた結果、トークン消費が激しく、想定より早く上限に達しました。
利用量上限を事前に深く調査して、Maxプランにしても良かったかもしれません。

AWS CDKでの開発中、IAM権限不足でデプロイが止まる場面がありました。都度リクエストと付与待ちの時間は大きなロスでした。
あらかじめ作業範囲を予測し、開発者用パワーユーザー権限を事前に合意して付与しておくべきだったのが反省点です。

実装フェーズに入ってからのスピードは早かったと思います。

迷う時間が削ぎ落とされているため、メンバーは実装だけに集中できました。

短期間・少人数のプロジェクトほど、決めるべきことを後回しにすると、コミュニケーションコストで破綻します。

設計そのものよりも、迷いを少なくするための仕組みに最初の2日を投資したことで、ジュニア中心のチームでも最短距離でPoCを形にできました。