Level 1 実践: リポジトリを読んで変更計画を作る

約5分

Codex Level 1 の委任範囲と完了条件を、実際のリポジトリ作業で身につけたい方

Level 0 を完了していること

このチュートリアルについて

このチュートリアルでは、Codex へ渡す作業範囲、成果物、確認条件を実際のリポジトリ作業に沿って整理します。

一般論だけでは、既存のルーティング、デザインシステム、検証コマンドに合う実装か判断できません。Level 1 では編集せず、実在するファイルを根拠に調査します。

関連ファイル一覧と変更計画を完成させます。作業量の多さではなく、Level 1 の委任範囲と確認条件を再現できることが目標です。

Codex に渡す前に、目的、対象、対象外、完了条件を短く書きます。次の依頼文をプロジェクトに合わせて調整してください。

編集はまだ行わず、このリポジトリのポートフォリオ表示に関係するファイルを調査してください。各ファイルの役割、既存パターン、変更候補、検証コマンドをパス付きで報告してください。

確認: Codex が作業を始める前に、対象範囲と不明点を説明できれば次へ進みます。

一度に範囲を広げず、各段階の差分や出力を確認してから次へ進みます。

計画の各項目に実在するパスがあり、推測と確認済み情報が区別されていれば完了です。

確認結果には、実行した操作、得られた証拠、未確認事項を残します。成功したときだけでなく、途中で止めた理由も記録します。

作業を止め、差分を確認します。対象ファイルと変更禁止範囲を依頼文へ追加し、承認した範囲だけを再実行します。

「実装する」のような曖昧な条件を、ファイル、コマンド、画面、レビュー結果など観測できる条件へ置き換えます。

次は Level 2 で、委任範囲を一段広げます。