Codex: Codex 高度なヒント

# Alice は3つの独立したモジュールを同時に処理

タスク1：src/auth/ モジュールをリファクタリング
タスク2：src/api/ に Swagger ドキュメントを追加
タスク3：src/utils/ のパフォーマンスを最適化

# 3つのタスクは異なるディレクトリを変更 — 並列実行可能
# 推定時間節約：60%

# 良い慣例
/add src/auth/login.ts          # 関連ファイルのみ追加
/add src/types/auth.ts          # 型定義を追加

# 悪い慣例
/add src/**/*.ts                # ファイルが多すぎる、コンテキストを浪費

# AGENTS.md
## プロジェクト構造
- src/auth/ - 認証モジュール
- src/api/ - API ルート
- src/utils/ - ユーティリティ関数

## 規約
- TypeScript の strict モードを使用
- すべての API にエラー処理が必要

# Bob が大規模プロジェクトで作業
/status                    # 表示：コンテキスト75%使用

# 最適化
/remove src/legacy/        # 無関係なファイルを削除
/compact                   # 履歴を圧縮

# まだ足りない
/new                       # 新しいセッションを開始
/add src/payments/         # 現在のタスク関連のファイルのみ追加

# シナリオ：Codex がテストを実行し、失敗した
> Codex: Tests failed, 3 cases did not pass
> あなた：失敗したケースの詳細を確認し、1つずつ修正

# シナリオ：Codex が間違ったファイルを変更
> Codex: config.ts を変更（constants.ts を変更すべきだった）
> あなた：config.ts の変更を取り消し、constants.ts を変更

# 変更を確認
git diff

# 特定のファイルを復元
git checkout -- src/wrong-file.ts

# すべての変更を取り消し
git checkout -- .

# 前のコミットに戻る
git reset --hard HEAD~1

# 最初の試み
> "Migrate Express to Fastify"
  結果：一部のルートが正しく変換されていない

# 修正を追加
> "Check the /api/users route, the conversion syntax is wrong, refer to Fastify official docs"
  結果：ルートの修正完了

# 修正を継続
> "Middleware conversion also has issues, error handling needs Fastify's setNotFoundHandler"
  結果：ミドルウェアの修正完了

# バグ修正テンプレート
"Fix <Bug-description> in <file>.
Error message: <error-log>
Expected behavior: <correct-behavior>
Ensure <verify-command> passes."

# 機能追加テンプレート
"Add <feature> to <module>.
Follow the code style of <existing-file>.
Include input validation and error handling.
Write unit tests."

# リファクタリングテンプレート
"Refactor <old-impl> to <new-impl>.
Maintain the external interface.
Ensure all existing tests pass.
Add new tests covering the new implementation."

# ワンコマンド：コード修正 → テスト → コミット
codex --full-auto "Fix all lint errors, run tests, if passing then git commit -m 'fix: lint errors'"