Skip to content

Commit 97ed2ef

Browse files
author
catlog22
committed
refactor: update agent usage description and streamline planning strategy references
1 parent fcd0b9a commit 97ed2ef

1 file changed

Lines changed: 7 additions & 61 deletions

File tree

  • .claude/skills/workflow-lite-plan

.claude/skills/workflow-lite-plan/SKILL.md

Lines changed: 7 additions & 61 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ Produces exploration results, a structured plan (plan.json), independent task fi
4040

4141
**Output Directory**: `.workflow/.lite-plan/{task-slug}-{YYYY-MM-DD}/`
4242

43-
**Agent Usage**: Low → Direct Claude planning (no agent) | Medium/High`cli-lite-planning-agent`
43+
**Agent Usage**: All complexities`cli-lite-planning-agent`
4444

4545
**Schema Reference**: `~/.ccw/workflows/cli-templates/schemas/plan-overview-base-schema.json`
4646

@@ -51,7 +51,7 @@ Produces exploration results, a structured plan (plan.json), independent task fi
5151
| LP-0 | Initialize workflowPreferences | autoYes, forceExplore |
5252
| LP-1 | Complexity assessment → parallel cli-explore-agents (1-4) | exploration-*.json + manifest |
5353
| LP-2 | Aggregate + dedup clarification_needs → multi-round AskUserQuestion | clarificationContext (in-memory) |
54-
| LP-3 | Low: Direct Claude planning / Medium+High: cli-lite-planning-agent | plan.json + .task/TASK-*.json |
54+
| LP-3 | cli-lite-planning-agent | plan.json + .task/TASK-*.json |
5555
| LP-4 | Display plan → AskUserQuestion (Confirm + Execution + Review) | userSelection |
5656
| LP-5 | Build executionContext → Skill("lite-execute") | handoff (Mode 1) |
5757

@@ -85,7 +85,7 @@ bash(`mkdir -p ${sessionFolder} && test -d ${sessionFolder} && echo "SUCCESS: ${
8585
TodoWrite({ todos: [
8686
{ content: `LP-Phase 1: Exploration [${complexity}] ${selectedAngles.length} angles`, status: "in_progress", activeForm: `Exploring: ${selectedAngles.join(', ')}` },
8787
{ content: "LP-Phase 2: Clarification", status: "pending" },
88-
{ content: `LP-Phase 3: Planning [${planningStrategy}]`, status: "pending" },
88+
{ content: "LP-Phase 3: Planning [cli-lite-planning-agent]", status: "pending" },
8989
{ content: "LP-Phase 4: Confirmation", status: "pending" },
9090
{ content: "LP-Phase 5: Execution", status: "pending" }
9191
]})
@@ -154,12 +154,7 @@ function selectAngles(taskDescription, count) {
154154

155155
const selectedAngles = selectAngles(task_description, complexity === 'High' ? 4 : (complexity === 'Medium' ? 3 : 1))
156156

157-
// Direct Claude planning ONLY for: Low + no prior analysis + single angle
158-
const planningStrategy = (
159-
complexity === 'Low' && !hasPriorAnalysis && selectedAngles.length <= 1
160-
) ? 'Direct Claude Planning' : 'cli-lite-planning-agent'
161-
162-
console.log(`Exploration Plan: ${complexity} | ${selectedAngles.join(', ')} | ${planningStrategy}`)
157+
console.log(`Exploration Plan: ${complexity} | ${selectedAngles.join(', ')} | cli-lite-planning-agent`)
163158
```
164159

165160
**Launch Parallel Explorations**:
@@ -328,56 +323,7 @@ taskFiles.forEach(taskPath => {
328323
})
329324
```
330325
331-
**Low Complexity** — Direct planning by Claude:
332-
```javascript
333-
const schema = Bash(`cat ~/.ccw/workflows/cli-templates/schemas/plan-overview-base-schema.json`)
334-
335-
const manifest = file_exists(`${sessionFolder}/explorations-manifest.json`)
336-
? JSON.parse(Read(`${sessionFolder}/explorations-manifest.json`))
337-
: { explorations: [] }
338-
manifest.explorations.forEach(exp => {
339-
console.log(`\n### Exploration: ${exp.angle}\n${Read(exp.path)}`)
340-
})
341-
342-
// When handoffSpec exists, use it as primary planning input
343-
// implementation_scope[].acceptance_criteria -> convergence.criteria
344-
// implementation_scope[].target_files -> files[]
345-
// implementation_scope[].objective -> task title/description
346-
if (handoffSpec) {
347-
console.log(`\n### Handoff Spec from ${handoffSpec.source}`)
348-
console.log(`Scope items: ${handoffSpec.implementation_scope.length}`)
349-
handoffSpec.implementation_scope.forEach((item, i) => {
350-
console.log(` ${i+1}. ${item.objective} [${item.priority}] — Done when: ${item.acceptance_criteria.join('; ')}`)
351-
})
352-
}
353-
354-
// Generate tasks — MUST incorporate exploration insights OR handoff spec
355-
// When handoffSpec: map implementation_scope[] → tasks[] (1:1 or group by context)
356-
// Field names: convergence.criteria (not acceptance), files[].change (not modification_points), test (not verification)
357-
const tasks = [
358-
{
359-
id: "TASK-001", title: "...", description: "...", depends_on: [],
360-
convergence: { criteria: ["..."] }, // From handoffSpec: item.acceptance_criteria
361-
files: [{ path: "...", change: "..." }], // From handoffSpec: item.target_files + item.change_summary
362-
implementation: ["..."], test: "..."
363-
}
364-
]
365-
366-
const taskDir = `${sessionFolder}/.task`
367-
Bash(`mkdir -p "${taskDir}"`)
368-
tasks.forEach(task => Write(`${taskDir}/${task.id}.json`, JSON.stringify(task, null, 2)))
369-
370-
const plan = {
371-
summary: "...", approach: "...",
372-
task_ids: tasks.map(t => t.id), task_count: tasks.length,
373-
complexity: "Low", estimated_time: "...", recommended_execution: "Agent",
374-
_metadata: { timestamp: getUtc8ISOString(), source: "direct-planning", planning_mode: "direct", plan_type: "feature" }
375-
}
376-
Write(`${sessionFolder}/plan.json`, JSON.stringify(plan, null, 2))
377-
// MUST continue to LP-Phase 4 — DO NOT execute code here
378-
```
379-
380-
**Medium/High Complexity** — Invoke cli-lite-planning-agent:
326+
**Invoke cli-lite-planning-agent**:
381327
382328
```javascript
383329
Task(
@@ -645,7 +591,7 @@ lite-plan (LP-Phase 1-5)
645591
| Error | Resolution |
646592
|-------|------------|
647593
| Exploration agent failure | Skip exploration, continue with task description only |
648-
| Planning agent failure | Fallback to direct planning by Claude |
594+
| Planning agent failure | Retry with reduced complexity or suggest breaking task |
649595
| Clarification timeout | Use exploration findings as-is |
650596
| Confirmation timeout | Save context, display resume instructions |
651597
| Modify loop > 3 times | Suggest breaking task or using /workflow-plan |
@@ -665,7 +611,7 @@ Auto mode authorizes the complete plan-and-execute workflow with a single confir
665611
- [ ] Parallel exploration agents launched with run_in_background=false
666612
- [ ] Explorations manifest built from auto-discovered files
667613
- [ ] Clarification needs aggregated, deduped, and presented in batches of 4
668-
- [ ] Plan generated via direct Claude (Low) or cli-lite-planning-agent (Medium/High)
614+
- [ ] Plan generated via cli-lite-planning-agent
669615
- [ ] Plan output as two-layer: plan.json (task_ids[]) + .task/TASK-*.json
670616
- [ ] User confirmation collected (or auto-approved in auto mode)
671617
- [ ] executionContext fully built with all artifacts and session references

0 commit comments

Comments
 (0)