Codex Area Workflow

這份文件整理 Codex 在本 repo 內執行 area rebuild 任務時的固定工作節奏，重點不是 area 設計本身，而是「每輪先讀什麼、一次做多大、何時停、何時 commit、何時更新 tracker」。

area 設計規則與驗證總覽仍以 AREA 開發手冊 為主；這份文件偏向 agent 操作守則。

Before You Touch Files

若任務涉及 existing/new area、maps、.roo、world links 或 area planning，先讀：

  1. AGENTS.md
  2. area/rebuild_plan.md
  3. 對應 plans/area/NNNN-*.md
  4. 需要時再讀 plans/0001-world-map-area-rebuild.md
  5. 需要 world / template context 時再讀 ref/Readme.md

若是 runtime area work，再補看：

Fixed Prompt Semantics

固定主 prompt：

繼續實作下一個待建 area

這句話在本 workflow 內的正確解讀是：

Unit Of Work

預設一次只做一個 area milestone。

允許：

不建議：

Branch Rules

若目前在 develop 或 main，且下一步是從 todo 啟動一個新的 area milestone，預設先切 codex/<area>-implementation。

例外：

While Working

每輪至少持續維持三件事：

若用到 ref/Readme.md 做選讀決策，記得補：

When To Stop And Ask

預設能自己判斷就自己往前做，但遇到下列情況應停下：

若只是一般 loader / parser / VNUM 問題，應先自行排查，不要太早中斷。

Commit Rules

commit 與 review 的最小單位，預設是單一 area milestone。

這表示：

若 delivery_gate 是：

Validation Rhythm

依任務類型決定驗證成本：

不要把 docs-only 或 spec-only 任務一律升級成重 build。

Required Closeout

每輪結束前，至少做：

  1. 更新 area/rebuild_plan.md
  2. 視需要更新單區 plan
  3. 視需要更新 docs/current-game/areas.*
  4. 判斷要不要做經驗回寫
  5. 檢查 delivery_gate 是否與實際狀態一致

Relationship To Other Docs