mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-13 02:41:50 +08:00

Files

catlog22 e44a97e812 feat: update empty state messages and hints in English and Chinese locales

refactor: rename variables for clarity in ReviewSessionPage and SessionsPage

fix: update version check logic in SettingsPage

chore: remove unused imports in TeamPage and session-detail components

fix: enhance error handling in MCP server

fix: apply default mode in edit-file tool handler

chore: remove tsbuildinfo file

docs: add Quick Plan & Execute phase documentation for issue discovery

chore: clean up ping output file

2026-02-12 23:15:48 +08:00

3.5 KiB

Raw Blame History

Phase 0: Prep Package Schema & Integration

Schema reference for prep-package.json consumed by ccw-loop Phase 1. Generated by interactive prompt /prompts:prep-loop.

prep-package.json Schema

{
  "version": "1.0.0",
  "generated_at": "ISO8601 (UTC+8)",
  "prep_status": "ready | cancelled | needs_refinement",
  "target_skill": "ccw-loop",

  "environment": {
    "project_root": "absolute path",
    "tech_stack": "string",
    "test_framework": "string"
  },

  "source": {
    "tool": "collaborative-plan-with-file | analyze-with-file | brainstorm-to-cycle | manual",
    "session_id": "string",
    "task_dir": "absolute path to source .task/ directory",
    "task_count": "number",
    "tasks_with_convergence": "number"
  },

  "tasks": {
    "total": "number",
    "by_priority": { "high": 0, "medium": 0, "low": 0 },
    "by_type": { "feature": 0, "fix": 0, "refactor": 0, "enhancement": 0, "testing": 0 }
  },

  "auto_loop": {
    "enabled": true,
    "no_confirmation": true,
    "max_iterations": 10,
    "timeout_per_action_ms": 600000
  }
}

.task/*.json Schema (task-schema.json)

One task per file in .task/ directory, each following task-schema.json with ccw-loop extended fields:

{
  "id": "task-001",
  "description": "Title: detailed description",
  "tool": "gemini",
  "mode": "write",
  "status": "pending",
  "priority": 1,
  "files_changed": ["path/to/file.ts"],
  "created_at": "ISO8601",
  "completed_at": null,
  "_source": { "tool": "collaborative-plan-with-file", "session_id": "...", "original_id": "TASK-001" },
  "_convergence": { "criteria": ["..."], "verification": "...", "definition_of_done": "..." },
  "_type": "feature",
  "_effort": "medium",
  "_depends_on": []
}

Validation Rules

#	Check	Condition	On Failure
1	prep_status	`=== "ready"`	Skip prep, use default INIT
2	target_skill	`=== "ccw-loop"`	Skip prep, use default INIT
3	project_root	Matches current `projectRoot`	Skip prep, warn mismatch
4	freshness	`generated_at` within 24h	Skip prep, warn stale
5	tasks dir	`.task/` directory exists with *.json files	Skip prep, use default INIT
6	tasks content	At least 1 valid task JSON in `.task/`	Skip prep, use default INIT

Integration Points

Phase 1: Session Initialization

// Load prep-package.json (generated by /prompts:prep-loop)
let prepPackage = null
const prepPath = `${projectRoot}/.workflow/.loop/prep-package.json`

if (fs.existsSync(prepPath)) {
  const raw = JSON.parse(Read(prepPath))
  const checks = validateLoopPrepPackage(raw, projectRoot)

  if (checks.valid) {
    prepPackage = raw
    // Load pre-built tasks from .task/*.json
    const taskDir = `${projectRoot}/.workflow/.loop/.task`
    const prepTasks = loadPrepTasks(taskDir)
    // → Inject into state.skill_state.develop.tasks
    // → Set max_iterations from auto_loop config
  } else {
    console.warn(`⚠ Prep package failed validation, using default INIT`)
    prepPackage = null
  }
}

INIT Action (action-init.md)

When prep tasks are loaded:

Skip Step 3 (Analyze Task and Generate Tasks) — tasks already provided
Use prep tasks directly in Step 5 (Update State)
Preserve _convergence fields for VALIDATE action reference

VALIDATE Action

When _convergence exists on a task:

Use convergence.verification as validation command/steps
Use convergence.criteria as pass/fail conditions
Fall back to default test validation if _convergence is null

3.5 KiB Raw Blame History