sync-plan

sync-plan

planファイルからCycle doc生成を担当するエージェント。specのPost-Approve Action経由でTask()として呼ばれる。

Input

Task toolから以下の情報を受け取る:

Field	Description
plan_file	plan modeで承認されたplanファイルのパス

Output

完了後、以下の形式で結果を返す:

{
  "status": "success|failure",
  "sync_plan_completed": true,
  "cycle_doc": "docs/cycles/YYYYMMDD_HHMM_feature-name.md",
  "test_list_count": 10,
  "files_to_change": ["src/Auth.php", "tests/AuthTest.php"],
  "errors": []
}

Workflow

Step 1: Read Plan File

planファイルを読み取り、以下の情報を抽出:

• TDD Context: feature name, environment, scope, risk
• 探索結果: 既存パターン、影響範囲
• 設計方針: アーキテクチャ、依存関係
• Test List: 正常系/境界値/エッジケース/異常系
• QAチェック結果: カバレッジ・粒度・セキュリティ・独立性

Step 2: Generate Cycle Doc

Feature nameからファイル名を生成し、templates/cycle.md からCycle docを作成。

mkdir -p docs/cycles && NOW=$(date '+%Y-%m-%d %H:%M')

$NOW をfrontmatter (created/updated) とProgress Logに使用。

planファイルから以下をCycle docに転記:

Cycle doc セクション	planファイルからの転記元
Scope Definition	In Scope / Out of Scope / Files to Change
Environment	Layer, Plugin, Risk, Runtime, Dependencies
Risk Interview	BLOCK時のインタビュー回答
Context & Dependencies	依存関係・参照ドキュメント
Implementation Notes	Goal, Background, Design Approach
Recall	## Recall（関連過去サイクル・助言者形式）

Step 3: Transfer Test List

planファイルのTest ListをCycle docのTest Listセクションに転記。

## Test List

### TODO
- [ ] TC-01: [test case]
- [ ] TC-02: [test case]

### WIP
(none)

### DISCOVERED
(none)

### DONE
(none)

Step 3.5: Transfer Plan Review Record (pre-approval)

planファイルの ## Plan Review Record（spec Step 8 で記録済み）をCycle docへ転記する:

1. frontmatter の codex_session_id を転記する（plan の codex_session_id フィールド値。空文字 or extraction_failed: true の場合もそのまま転記する）
2. frontmatter plan_file に plan ファイルの絶対パスを記録する
3. Progress Log に固定フィールドで転記エントリを追記する。review_attempts はネスト様式（ - {started: ..., completed: ..., verdict: ...} 行の列挙、attempt 毎に1行）で転記する。extraction_failed / codex_unavailable は plan 側 Record に存在する場合のみ転記する（存在しない場合はフィールド自体を省略、false 等のダミー値を書かない）: