mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-05 01:50:27 +08:00
feat(workflow): add workflow:replan command with session-level replanning support
## Changes
### New Command: workflow:replan
- Created `.claude/commands/workflow/replan.md` with comprehensive session-level replanning
- Supports dual modes: session-wide and task-specific replanning
- Interactive boundary clarification using guided questioning
- Updates multiple artifacts: IMPL_PLAN.md, TODO_LIST.md, task JSONs, session metadata
- Comprehensive backup management with restore capability
### Key Features
1. **Interactive Clarification**: Guided questions to define modification scope
- Modification scope (tasks only, plan update, task restructure, comprehensive)
- Affected modules detection
- Task change types (add, remove, merge, split, update)
- Dependency relationship updates
2. **Session-Aware Operations**:
- Auto-detects active sessions from `.workflow/active/`
- Updates all session artifacts consistently
- Maintains backup history in `.process/backup/replan-{timestamp}/`
3. **Comprehensive Artifact Updates**:
- IMPL_PLAN.md section modifications
- TODO_LIST.md task list updates
- Task JSON files (requirements, implementation, dependencies)
- Session metadata tracking
4. **Impact Analysis**: Automatically determines affected files and operations
### Deprecation
- Added deprecation notice to `/task:replan` in both command and reference files
- Updated `COMMAND_REFERENCE.md` to:
- Add workflow:replan to Core Workflow section
- Mark task:replan as deprecated with migration guidance
### Migration Path
- Old: `/task:replan IMPL-1 "changes"`
- New: `/workflow:replan IMPL-1 "changes"`
### Files Modified
- `.claude/commands/task/replan.md`: Added deprecation notice
- `.claude/commands/workflow/replan.md`: New command implementation
- `.claude/skills/command-guide/reference/commands/task/replan.md`: Deprecation notice
- `.claude/skills/command-guide/reference/commands/workflow/replan.md`: Reference documentation
- `COMMAND_REFERENCE.md`: Updated command listings
This change enhances workflow replanning capabilities by providing interactive,
session-aware modifications that maintain consistency across all workflow artifacts.
This commit is contained in:
Claude
@@ -7,6 +7,14 @@ allowed-tools: Read(*), Write(*), Edit(*), TodoWrite(*), Glob(*), Bash(*)
|
||||
|
||||
# Task Replan Command (/task:replan)
|
||||
|
||||
> **⚠️ DEPRECATION NOTICE**: This command is maintained for backward compatibility. For new workflows, use `/workflow:replan` which provides:
|
||||
> - Session-level replanning with comprehensive artifact updates
|
||||
> - Interactive boundary clarification
|
||||
> - Updates to IMPL_PLAN.md, TODO_LIST.md, and session metadata
|
||||
> - Better integration with workflow sessions
|
||||
>
|
||||
> **Migration**: Replace `/task:replan IMPL-1 "changes"` with `/workflow:replan IMPL-1 "changes"`
|
||||
|
||||
## Overview
|
||||
Replans individual tasks or batch processes multiple tasks with change tracking and backup management.
|
||||
|
||||
|
||||
895
.claude/commands/workflow/replan.md
Normal file
895
.claude/commands/workflow/replan.md
Normal file
@@ -0,0 +1,895 @@
|
||||
---
|
||||
name: replan
|
||||
description: Interactive workflow replanning with session-level artifact updates and boundary clarification through guided questioning
|
||||
argument-hint: "[--session session-id] [task-id] \"requirements\"|file.md [--interactive]"
|
||||
allowed-tools: Read(*), Write(*), Edit(*), TodoWrite(*), Glob(*), Bash(*)
|
||||
---
|
||||
|
||||
# Workflow Replan Command (/workflow:replan)
|
||||
|
||||
## Overview
|
||||
Intelligently replans workflow sessions or individual tasks with interactive boundary clarification and comprehensive artifact updates.
|
||||
|
||||
**Dual Mode Design**:
|
||||
- **Session Replan Mode**: Updates multiple session artifacts (IMPL_PLAN.md, TODO_LIST.md, task JSONs)
|
||||
- **Task Replan Mode**: Focused task updates within session context
|
||||
|
||||
## Core Principles
|
||||
**Task System**: @~/.claude/workflows/task-core.md
|
||||
**Workflow Architecture**: @~/.claude/workflows/workflow-architecture.md
|
||||
|
||||
## Key Features
|
||||
- **Interactive Clarification**: Guided questioning to define modification boundaries
|
||||
- **Session-Aware**: Understands and updates all session artifacts
|
||||
- **Impact Analysis**: Automatically detects affected files and dependencies
|
||||
- **Comprehensive Updates**: Modifies IMPL_PLAN.md, TODO_LIST.md, task JSONs, session metadata
|
||||
- **Backup Management**: Preserves previous versions of all modified files
|
||||
- **Change Tracking**: Documents all modifications with rationale
|
||||
|
||||
## Operation Modes
|
||||
|
||||
### Mode 1: Session Replan (Default)
|
||||
|
||||
#### Auto-detect Active Session
|
||||
```bash
|
||||
/workflow:replan "添加双因素认证支持"
|
||||
```
|
||||
Automatically detects active session from `.workflow/active/`
|
||||
|
||||
#### Explicit Session
|
||||
```bash
|
||||
/workflow:replan --session WFS-oauth-integration "添加双因素认证支持"
|
||||
```
|
||||
|
||||
#### File-based Input
|
||||
```bash
|
||||
/workflow:replan --session WFS-oauth requirements-update.md
|
||||
```
|
||||
|
||||
#### Interactive Mode
|
||||
```bash
|
||||
/workflow:replan --session WFS-oauth --interactive
|
||||
```
|
||||
Fully guided step-by-step modification process
|
||||
|
||||
### Mode 2: Task Replan
|
||||
|
||||
#### Direct Task Update
|
||||
```bash
|
||||
/workflow:replan IMPL-1 "修改为使用 OAuth2.0 标准"
|
||||
```
|
||||
Auto-detects session from active sessions
|
||||
|
||||
#### Task with Session
|
||||
```bash
|
||||
/workflow:replan --session WFS-oauth IMPL-2 "增加单元测试覆盖率到 90%"
|
||||
```
|
||||
|
||||
#### Task Interactive Mode
|
||||
```bash
|
||||
/workflow:replan IMPL-1 --interactive
|
||||
```
|
||||
|
||||
## Execution Flow
|
||||
|
||||
### Phase 1: Mode Detection & Session Discovery
|
||||
|
||||
**Step 1.1: Detect Operation Mode**
|
||||
```bash
|
||||
# Check if task ID provided (IMPL-N or IMPL-N.M format)
|
||||
if [[ "$1" =~ ^IMPL-[0-9]+(\.[0-9]+)?$ ]]; then
|
||||
MODE="task"
|
||||
TASK_ID="$1"
|
||||
else
|
||||
MODE="session"
|
||||
fi
|
||||
```
|
||||
|
||||
**Step 1.2: Discover/Validate Session**
|
||||
```bash
|
||||
# If --session provided, use it
|
||||
# Otherwise, auto-detect active session
|
||||
active_session=$(find .workflow/active/ -name "WFS-*" -type d 2>/dev/null | head -1)
|
||||
|
||||
# Validate session exists
|
||||
if [ ! -d ".workflow/active/$SESSION_ID" ]; then
|
||||
echo "ERROR: Session $SESSION_ID not found"
|
||||
exit 1
|
||||
fi
|
||||
```
|
||||
|
||||
**Step 1.3: Load Session Context**
|
||||
```bash
|
||||
# Read session metadata
|
||||
Read(file_path=".workflow/active/$SESSION_ID/workflow-session.json")
|
||||
|
||||
# List existing tasks
|
||||
Glob(pattern=".workflow/active/$SESSION_ID/.task/IMPL-*.json")
|
||||
|
||||
# Read planning document
|
||||
Read(file_path=".workflow/active/$SESSION_ID/IMPL_PLAN.md")
|
||||
```
|
||||
|
||||
**Output**: Session validated, context loaded, mode determined
|
||||
|
||||
---
|
||||
|
||||
### Phase 2: Interactive Requirement Clarification
|
||||
|
||||
**Purpose**: Use guided questioning to precisely define modification scope and boundaries
|
||||
|
||||
#### Session Mode Clarification
|
||||
|
||||
**Question 1: Modification Scope**
|
||||
```javascript
|
||||
AskUserQuestion({
|
||||
questions: [{
|
||||
question: "修改范围是什么?",
|
||||
header: "Scope",
|
||||
options: [
|
||||
{
|
||||
label: "仅更新任务细节",
|
||||
value: "tasks_only",
|
||||
description: "只修改现有任务的实现细节,不改变整体规划"
|
||||
},
|
||||
{
|
||||
label: "修改规划方案",
|
||||
value: "plan_update",
|
||||
description: "需要更新 IMPL_PLAN.md 中的技术方案或架构设计"
|
||||
},
|
||||
{
|
||||
label: "重构任务结构",
|
||||
value: "task_restructure",
|
||||
description: "需要添加、删除或重组任务,更新 TODO_LIST.md"
|
||||
},
|
||||
{
|
||||
label: "全面重规划",
|
||||
value: "comprehensive",
|
||||
description: "大幅修改需求,需要更新所有规划文档和任务"
|
||||
}
|
||||
],
|
||||
multiSelect: false
|
||||
}]
|
||||
})
|
||||
```
|
||||
|
||||
**Question 2: Affected Modules** (if scope >= plan_update)
|
||||
```javascript
|
||||
AskUserQuestion({
|
||||
questions: [{
|
||||
question: "哪些功能模块会受到影响?",
|
||||
header: "Modules",
|
||||
options: [
|
||||
// Dynamically generated from existing tasks' focus_paths
|
||||
{ label: "认证模块 (src/auth)", value: "auth" },
|
||||
{ label: "用户管理 (src/user)", value: "user" },
|
||||
{ label: "API 接口 (src/api)", value: "api" },
|
||||
{ label: "全部模块", value: "all" }
|
||||
],
|
||||
multiSelect: true
|
||||
}]
|
||||
})
|
||||
```
|
||||
|
||||
**Question 3: Task Changes** (if scope >= task_restructure)
|
||||
```javascript
|
||||
AskUserQuestion({
|
||||
questions: [{
|
||||
question: "任务变更类型?",
|
||||
header: "Task Changes",
|
||||
options: [
|
||||
{ label: "添加新任务", value: "add", description: "创建新的 IMPL-*.json 任务" },
|
||||
{ label: "删除现有任务", value: "remove", description: "移除不需要的任务" },
|
||||
{ label: "合并任务", value: "merge", description: "将多个任务合并为一个" },
|
||||
{ label: "拆分任务", value: "split", description: "将一个任务拆分为多个子任务" },
|
||||
{ label: "仅更新内容", value: "update", description: "保持任务结构,只修改内容" }
|
||||
],
|
||||
multiSelect: true
|
||||
}]
|
||||
})
|
||||
```
|
||||
|
||||
**Question 4: Dependency Changes** (if task changes detected)
|
||||
```javascript
|
||||
AskUserQuestion({
|
||||
questions: [{
|
||||
question: "是否需要更新任务依赖关系?",
|
||||
header: "Dependencies",
|
||||
options: [
|
||||
{ label: "是,需要重新梳理依赖", value: "yes" },
|
||||
{ label: "否,保持现有依赖", value: "no" }
|
||||
],
|
||||
multiSelect: false
|
||||
}]
|
||||
})
|
||||
```
|
||||
|
||||
#### Task Mode Clarification
|
||||
|
||||
**Question 1: Update Type**
|
||||
```javascript
|
||||
AskUserQuestion({
|
||||
questions: [{
|
||||
question: "需要更新任务的哪些部分?",
|
||||
header: "Update Type",
|
||||
options: [
|
||||
{ label: "需求和验收标准 (requirements & acceptance)", value: "requirements" },
|
||||
{ label: "实现方案 (implementation_approach)", value: "implementation" },
|
||||
{ label: "文件范围 (focus_paths)", value: "paths" },
|
||||
{ label: "依赖关系 (depends_on)", value: "dependencies" },
|
||||
{ label: "全部更新", value: "all" }
|
||||
],
|
||||
multiSelect: true
|
||||
}]
|
||||
})
|
||||
```
|
||||
|
||||
**Question 2: Ripple Effect**
|
||||
```javascript
|
||||
AskUserQuestion({
|
||||
questions: [{
|
||||
question: "此修改是否影响其他任务?",
|
||||
header: "Impact",
|
||||
options: [
|
||||
{ label: "是,需要同步更新依赖任务", value: "yes" },
|
||||
{ label: "否,仅影响当前任务", value: "no" },
|
||||
{ label: "不确定,请帮我分析", value: "analyze" }
|
||||
],
|
||||
multiSelect: false
|
||||
}]
|
||||
})
|
||||
```
|
||||
|
||||
**Output**:
|
||||
- User selections stored in clarification context
|
||||
- Modification boundaries clearly defined
|
||||
- Impact scope determined
|
||||
|
||||
---
|
||||
|
||||
### Phase 3: Impact Analysis & Planning
|
||||
|
||||
**Step 3.1: Analyze Required Changes**
|
||||
|
||||
Based on clarification responses, determine affected files:
|
||||
|
||||
```typescript
|
||||
interface ImpactAnalysis {
|
||||
affected_files: {
|
||||
impl_plan: boolean; // IMPL_PLAN.md needs update
|
||||
todo_list: boolean; // TODO_LIST.md needs update
|
||||
session_meta: boolean; // workflow-session.json needs update
|
||||
tasks: string[]; // Array of task IDs (IMPL-*.json)
|
||||
};
|
||||
|
||||
operations: {
|
||||
type: 'create' | 'update' | 'delete' | 'merge' | 'split';
|
||||
target: string; // File path or task ID
|
||||
reason: string; // Why this change is needed
|
||||
}[];
|
||||
|
||||
backup_strategy: {
|
||||
timestamp: string; // ISO timestamp for backup folder
|
||||
files: string[]; // All files to backup
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
**Step 3.2: Generate Modification Plan**
|
||||
|
||||
```markdown
|
||||
## 修改计划
|
||||
|
||||
### 影响范围
|
||||
- [ ] IMPL_PLAN.md: 更新技术方案第 3 节
|
||||
- [ ] TODO_LIST.md: 添加 2 个新任务,删除 1 个废弃任务
|
||||
- [ ] IMPL-001.json: 更新实现方案
|
||||
- [ ] IMPL-002.json: 添加依赖关系
|
||||
- [ ] workflow-session.json: 更新任务计数
|
||||
|
||||
### 变更操作
|
||||
1. **创建**: IMPL-004.json (双因素认证实现)
|
||||
2. **更新**: IMPL-001.json (添加 2FA 准备工作)
|
||||
3. **删除**: IMPL-003.json (已被新方案替代)
|
||||
|
||||
### 备份策略
|
||||
备份到: .workflow/active/WFS-oauth/.process/backup/replan-2025-11-20T10-30-00/
|
||||
```
|
||||
|
||||
**Step 3.3: User Confirmation**
|
||||
|
||||
```javascript
|
||||
AskUserQuestion({
|
||||
questions: [{
|
||||
question: "确认执行上述修改计划?",
|
||||
header: "Confirm",
|
||||
options: [
|
||||
{ label: "确认执行", value: "confirm", description: "开始应用所有修改" },
|
||||
{ label: "调整计划", value: "adjust", description: "重新回答问题调整范围" },
|
||||
{ label: "取消操作", value: "cancel", description: "放弃本次重规划" }
|
||||
],
|
||||
multiSelect: false
|
||||
}]
|
||||
})
|
||||
```
|
||||
|
||||
**Output**: Modification plan confirmed or adjusted
|
||||
|
||||
---
|
||||
|
||||
### Phase 4: Backup Creation
|
||||
|
||||
**Step 4.1: Create Backup Directory**
|
||||
```bash
|
||||
timestamp=$(date -u +"%Y-%m-%dT%H-%M-%S")
|
||||
backup_dir=".workflow/active/$SESSION_ID/.process/backup/replan-$timestamp"
|
||||
mkdir -p "$backup_dir"
|
||||
```
|
||||
|
||||
**Step 4.2: Backup All Affected Files**
|
||||
```bash
|
||||
# Backup planning documents
|
||||
if [ -f ".workflow/active/$SESSION_ID/IMPL_PLAN.md" ]; then
|
||||
cp ".workflow/active/$SESSION_ID/IMPL_PLAN.md" "$backup_dir/"
|
||||
fi
|
||||
|
||||
if [ -f ".workflow/active/$SESSION_ID/TODO_LIST.md" ]; then
|
||||
cp ".workflow/active/$SESSION_ID/TODO_LIST.md" "$backup_dir/"
|
||||
fi
|
||||
|
||||
# Backup session metadata
|
||||
cp ".workflow/active/$SESSION_ID/workflow-session.json" "$backup_dir/"
|
||||
|
||||
# Backup affected task JSONs
|
||||
for task_id in "${affected_tasks[@]}"; do
|
||||
cp ".workflow/active/$SESSION_ID/.task/$task_id.json" "$backup_dir/"
|
||||
done
|
||||
```
|
||||
|
||||
**Step 4.3: Create Backup Manifest**
|
||||
```bash
|
||||
cat > "$backup_dir/MANIFEST.md" <<EOF
|
||||
# Replan Backup Manifest
|
||||
|
||||
**Timestamp**: $timestamp
|
||||
**Reason**: $replan_reason
|
||||
**Scope**: $modification_scope
|
||||
|
||||
## Backed Up Files
|
||||
$(ls -1 "$backup_dir" | grep -v MANIFEST.md)
|
||||
|
||||
## Restoration Command
|
||||
\`\`\`bash
|
||||
# To restore from this backup:
|
||||
cp $backup_dir/* .workflow/active/$SESSION_ID/
|
||||
\`\`\`
|
||||
EOF
|
||||
```
|
||||
|
||||
**Output**: All files safely backed up with manifest
|
||||
|
||||
---
|
||||
|
||||
### Phase 5: Apply Modifications
|
||||
|
||||
**Step 5.1: Update IMPL_PLAN.md** (if needed)
|
||||
|
||||
```typescript
|
||||
// Identify sections to update based on affected modules
|
||||
// Use Edit tool to modify specific sections
|
||||
|
||||
Edit({
|
||||
file_path: `.workflow/active/${SESSION_ID}/IMPL_PLAN.md`,
|
||||
old_string: "### 3.2 认证流程\n\n当前使用简单密码认证...",
|
||||
new_string: "### 3.2 认证流程\n\n采用双因素认证 (2FA):\n1. 用户名密码验证\n2. TOTP 令牌验证\n3. 会话令牌颁发..."
|
||||
})
|
||||
|
||||
// Update modification date
|
||||
Edit({
|
||||
file_path: `.workflow/active/${SESSION_ID}/IMPL_PLAN.md`,
|
||||
old_string: "**Last Modified**: 2025-11-15",
|
||||
new_string: "**Last Modified**: 2025-11-20"
|
||||
})
|
||||
```
|
||||
|
||||
**Step 5.2: Update TODO_LIST.md** (if needed)
|
||||
|
||||
```typescript
|
||||
// Add new tasks
|
||||
Edit({
|
||||
file_path: `.workflow/active/${SESSION_ID}/TODO_LIST.md`,
|
||||
old_string: "- [ ] IMPL-003: 实现用户登录",
|
||||
new_string: `- [ ] IMPL-003: 实现用户登录
|
||||
- [ ] IMPL-004: 实现 TOTP 双因素认证`
|
||||
})
|
||||
|
||||
// Mark deleted tasks as obsolete
|
||||
Edit({
|
||||
file_path: `.workflow/active/${SESSION_ID}/TODO_LIST.md`,
|
||||
old_string: "- [ ] IMPL-005: 简单密码重置",
|
||||
new_string: "- [x] ~~IMPL-005: 简单密码重置~~ (已废弃,替换为 IMPL-004)"
|
||||
})
|
||||
```
|
||||
|
||||
**Step 5.3: Update Task JSONs**
|
||||
|
||||
For each affected task:
|
||||
|
||||
```typescript
|
||||
// Read current task
|
||||
const task = Read(`.workflow/active/${SESSION_ID}/.task/${task_id}.json`);
|
||||
|
||||
// Parse and modify
|
||||
const updated_task = {
|
||||
...task,
|
||||
context: {
|
||||
...task.context,
|
||||
requirements: [
|
||||
...task.context.requirements,
|
||||
"支持 TOTP 双因素认证"
|
||||
],
|
||||
acceptance: [
|
||||
...task.context.acceptance,
|
||||
"2FA 验证流程通过测试"
|
||||
]
|
||||
},
|
||||
flow_control: {
|
||||
...task.flow_control,
|
||||
implementation_approach: [
|
||||
{
|
||||
step: 1,
|
||||
title: "集成 TOTP 库",
|
||||
description: "添加 speakeasy 库用于生成和验证 TOTP 令牌",
|
||||
modification_points: [
|
||||
"安装 speakeasy npm 包",
|
||||
"创建 TOTP 工具函数"
|
||||
],
|
||||
logic_flow: [
|
||||
"用户启用 2FA → 生成密钥",
|
||||
"生成 QR 码供用户扫描",
|
||||
"存储加密的 2FA 密钥"
|
||||
],
|
||||
depends_on: [],
|
||||
output: "totp_setup"
|
||||
},
|
||||
// ... more steps
|
||||
]
|
||||
}
|
||||
};
|
||||
|
||||
// Write back
|
||||
Write({
|
||||
file_path: `.workflow/active/${SESSION_ID}/.task/${task_id}.json`,
|
||||
content: JSON.stringify(updated_task, null, 2)
|
||||
});
|
||||
```
|
||||
|
||||
**Step 5.4: Create New Tasks** (if needed)
|
||||
|
||||
```typescript
|
||||
const new_task = {
|
||||
id: "IMPL-004",
|
||||
title: "实现 TOTP 双因素认证",
|
||||
status: "pending",
|
||||
|
||||
meta: {
|
||||
type: "feature",
|
||||
agent: "@code-developer"
|
||||
},
|
||||
|
||||
context: {
|
||||
requirements: [
|
||||
"支持 TOTP 双因素认证",
|
||||
"用户可启用/禁用 2FA",
|
||||
"提供备用恢复码"
|
||||
],
|
||||
focus_paths: ["src/auth/2fa", "src/utils/totp", "tests/auth"],
|
||||
acceptance: [
|
||||
"用户可以成功启用 2FA",
|
||||
"TOTP 验证码正确验证",
|
||||
"备用恢复码可以使用"
|
||||
],
|
||||
depends_on: ["IMPL-001"]
|
||||
},
|
||||
|
||||
flow_control: {
|
||||
pre_analysis: [],
|
||||
implementation_approach: [
|
||||
// ... implementation steps
|
||||
],
|
||||
target_files: [
|
||||
"src/auth/2fa/totp.ts",
|
||||
"src/auth/2fa/recovery.ts",
|
||||
"tests/auth/2fa.test.ts"
|
||||
]
|
||||
}
|
||||
};
|
||||
|
||||
Write({
|
||||
file_path: `.workflow/active/${SESSION_ID}/.task/IMPL-004.json`,
|
||||
content: JSON.stringify(new_task, null, 2)
|
||||
});
|
||||
```
|
||||
|
||||
**Step 5.5: Delete Obsolete Tasks** (if needed)
|
||||
|
||||
```bash
|
||||
# Move to backup instead of hard delete
|
||||
mv ".workflow/active/$SESSION_ID/.task/IMPL-003.json" "$backup_dir/"
|
||||
```
|
||||
|
||||
**Step 5.6: Update Session Metadata**
|
||||
|
||||
```typescript
|
||||
const session = Read(`.workflow/active/${SESSION_ID}/workflow-session.json`);
|
||||
|
||||
const updated_session = {
|
||||
...session,
|
||||
progress: {
|
||||
...session.progress,
|
||||
current_tasks: ["IMPL-001", "IMPL-002", "IMPL-004"], // Updated list
|
||||
last_replan: new Date().toISOString(),
|
||||
replan_history: [
|
||||
...(session.replan_history || []),
|
||||
{
|
||||
timestamp: new Date().toISOString(),
|
||||
reason: replan_reason,
|
||||
scope: modification_scope,
|
||||
backup_location: backup_dir,
|
||||
changes: {
|
||||
added_tasks: ["IMPL-004"],
|
||||
removed_tasks: ["IMPL-003"],
|
||||
updated_tasks: ["IMPL-001", "IMPL-002"]
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
};
|
||||
|
||||
Write({
|
||||
file_path: `.workflow/active/${SESSION_ID}/workflow-session.json`,
|
||||
content: JSON.stringify(updated_session, null, 2)
|
||||
});
|
||||
```
|
||||
|
||||
**Output**: All modifications applied, artifacts updated
|
||||
|
||||
---
|
||||
|
||||
### Phase 6: Verification & Summary
|
||||
|
||||
**Step 6.1: Verify Consistency**
|
||||
|
||||
```bash
|
||||
# Verify all task JSONs are valid
|
||||
for task_file in .workflow/active/$SESSION_ID/.task/IMPL-*.json; do
|
||||
if ! jq empty "$task_file" 2>/dev/null; then
|
||||
echo "ERROR: Invalid JSON in $task_file"
|
||||
exit 1
|
||||
fi
|
||||
done
|
||||
|
||||
# Verify task count within limits (max 10)
|
||||
task_count=$(ls .workflow/active/$SESSION_ID/.task/IMPL-*.json | wc -l)
|
||||
if [ "$task_count" -gt 10 ]; then
|
||||
echo "WARNING: Task count ($task_count) exceeds recommended limit of 10"
|
||||
fi
|
||||
|
||||
# Verify dependency graph is acyclic
|
||||
# (Check no circular dependencies)
|
||||
```
|
||||
|
||||
**Step 6.2: Generate Change Summary**
|
||||
|
||||
```markdown
|
||||
## 重规划完成
|
||||
|
||||
### 会话信息
|
||||
- **Session**: WFS-oauth-integration
|
||||
- **时间**: 2025-11-20 10:30:00 UTC
|
||||
- **备份**: .workflow/active/WFS-oauth/.process/backup/replan-2025-11-20T10-30-00/
|
||||
|
||||
### 变更摘要
|
||||
**范围**: 全面重规划 (comprehensive)
|
||||
**原因**: 添加双因素认证支持
|
||||
|
||||
### 修改的文件
|
||||
- ✓ IMPL_PLAN.md: 更新了第 3 节认证方案
|
||||
- ✓ TODO_LIST.md: 添加 1 个任务,删除 1 个任务
|
||||
- ✓ IMPL-001.json: 更新实现方案
|
||||
- ✓ IMPL-002.json: 添加 2FA 相关依赖
|
||||
- ✓ IMPL-004.json: 新建双因素认证任务
|
||||
- ✓ workflow-session.json: 更新任务列表和历史记录
|
||||
|
||||
### 任务变更
|
||||
- **新增**: IMPL-004 (实现 TOTP 双因素认证)
|
||||
- **删除**: IMPL-003 (简单密码重置 - 已废弃)
|
||||
- **更新**: IMPL-001, IMPL-002
|
||||
|
||||
### 下一步建议
|
||||
1. 运行 `/workflow:action-plan-verify --session WFS-oauth` 验证规划质量
|
||||
2. 运行 `/workflow:status` 查看更新后的任务列表
|
||||
3. 运行 `/workflow:execute` 开始执行新规划
|
||||
|
||||
### 回滚方法
|
||||
如需回滚到重规划前的状态:
|
||||
\`\`\`bash
|
||||
cp .workflow/active/WFS-oauth/.process/backup/replan-2025-11-20T10-30-00/* .workflow/active/WFS-oauth/
|
||||
\`\`\`
|
||||
```
|
||||
|
||||
**Output**: Summary displayed to user, replan complete
|
||||
|
||||
---
|
||||
|
||||
## TodoWrite Progress Tracking
|
||||
|
||||
### Session Mode Progress
|
||||
|
||||
```json
|
||||
[
|
||||
{"content": "检测模式和发现会话", "status": "completed", "activeForm": "检测模式和发现会话"},
|
||||
{"content": "交互式需求明确", "status": "completed", "activeForm": "交互式需求明确"},
|
||||
{"content": "影响分析和计划生成", "status": "completed", "activeForm": "影响分析和计划生成"},
|
||||
{"content": "创建备份", "status": "completed", "activeForm": "创建备份"},
|
||||
{"content": "更新 IMPL_PLAN.md", "status": "completed", "activeForm": "更新 IMPL_PLAN.md"},
|
||||
{"content": "更新 TODO_LIST.md", "status": "completed", "activeForm": "更新 TODO_LIST.md"},
|
||||
{"content": "更新 3 个任务 JSON 文件", "status": "completed", "activeForm": "更新任务 JSON 文件"},
|
||||
{"content": "更新会话元数据", "status": "completed", "activeForm": "更新会话元数据"},
|
||||
{"content": "验证一致性", "status": "completed", "activeForm": "验证一致性"}
|
||||
]
|
||||
```
|
||||
|
||||
### Task Mode Progress
|
||||
|
||||
```json
|
||||
[
|
||||
{"content": "检测会话和加载任务", "status": "completed", "activeForm": "检测会话和加载任务"},
|
||||
{"content": "交互式更新类型确认", "status": "completed", "activeForm": "交互式更新类型确认"},
|
||||
{"content": "分析影响范围", "status": "completed", "activeForm": "分析影响范围"},
|
||||
{"content": "创建备份", "status": "completed", "activeForm": "创建备份"},
|
||||
{"content": "更新 IMPL-001.json", "status": "completed", "activeForm": "更新 IMPL-001.json"},
|
||||
{"content": "更新会话元数据", "status": "completed", "activeForm": "更新会话元数据"}
|
||||
]
|
||||
```
|
||||
|
||||
## Error Handling
|
||||
|
||||
### Session Errors
|
||||
```bash
|
||||
# No active session found
|
||||
ERROR: No active session found
|
||||
Run /workflow:session:start to create a session
|
||||
|
||||
# Session not found
|
||||
ERROR: Session WFS-invalid not found
|
||||
Available sessions:
|
||||
- WFS-oauth-integration
|
||||
- WFS-user-profile
|
||||
|
||||
# No changes detected
|
||||
WARNING: No modifications specified
|
||||
Please provide requirements or use --interactive mode
|
||||
```
|
||||
|
||||
### Task Errors
|
||||
```bash
|
||||
# Task not found
|
||||
ERROR: Task IMPL-999 not found in session WFS-oauth
|
||||
Available tasks: IMPL-001, IMPL-002, IMPL-003
|
||||
|
||||
# Task already completed
|
||||
WARNING: Task IMPL-001 is completed
|
||||
Consider creating a new task for additional work
|
||||
|
||||
# Circular dependency detected
|
||||
ERROR: Circular dependency detected: IMPL-001 → IMPL-002 → IMPL-001
|
||||
Please resolve dependency conflicts
|
||||
```
|
||||
|
||||
### Validation Errors
|
||||
```bash
|
||||
# Task limit exceeded
|
||||
ERROR: Replan would create 12 tasks (limit: 10)
|
||||
Consider:
|
||||
1. Combining related tasks
|
||||
2. Splitting into multiple sessions
|
||||
3. Removing unnecessary tasks
|
||||
|
||||
# Invalid JSON generated
|
||||
ERROR: Generated invalid JSON for IMPL-004
|
||||
Backup preserved at: [backup_path]
|
||||
Rolling back changes...
|
||||
```
|
||||
|
||||
## Examples
|
||||
|
||||
### Example 1: Session Replan - Add Feature
|
||||
|
||||
```bash
|
||||
/workflow:replan "添加双因素认证支持"
|
||||
|
||||
# Interactive clarification
|
||||
Q: 修改范围是什么?
|
||||
A: 全面重规划 (comprehensive)
|
||||
|
||||
Q: 哪些功能模块会受到影响?
|
||||
A: [✓] 认证模块 (src/auth)
|
||||
[✓] API 接口 (src/api)
|
||||
|
||||
Q: 任务变更类型?
|
||||
A: [✓] 添加新任务
|
||||
[✓] 仅更新内容
|
||||
|
||||
Q: 是否需要更新任务依赖关系?
|
||||
A: 是,需要重新梳理依赖
|
||||
|
||||
# Modification plan shown...
|
||||
# User confirms...
|
||||
|
||||
# Execution
|
||||
✓ 创建备份
|
||||
✓ 更新 IMPL_PLAN.md
|
||||
✓ 更新 TODO_LIST.md
|
||||
✓ 创建 IMPL-004.json
|
||||
✓ 更新 IMPL-001.json, IMPL-002.json
|
||||
✓ 更新 workflow-session.json
|
||||
|
||||
# Summary displayed
|
||||
重规划完成!
|
||||
新增 1 个任务,更新 2 个任务
|
||||
备份位置: .workflow/active/WFS-oauth/.process/backup/replan-2025-11-20T10-30-00/
|
||||
```
|
||||
|
||||
### Example 2: Task Replan - Update Requirements
|
||||
|
||||
```bash
|
||||
/workflow:replan IMPL-001 "需要支持 OAuth2.0 标准,而不是自定义认证"
|
||||
|
||||
# Interactive clarification
|
||||
Q: 需要更新任务的哪些部分?
|
||||
A: [✓] 需求和验收标准 (requirements & acceptance)
|
||||
[✓] 实现方案 (implementation_approach)
|
||||
|
||||
Q: 此修改是否影响其他任务?
|
||||
A: 是,需要同步更新依赖任务
|
||||
|
||||
# Impact analysis
|
||||
分析发现以下任务受影响:
|
||||
- IMPL-002 (依赖 IMPL-001 的认证结果)
|
||||
- IMPL-003 (使用相同的认证接口)
|
||||
|
||||
# Modification plan
|
||||
将更新:
|
||||
- IMPL-001.json: 需求和实现方案
|
||||
- IMPL-002.json: 依赖说明
|
||||
- IMPL-003.json: 接口调用方式
|
||||
|
||||
# User confirms...
|
||||
|
||||
✓ 创建备份
|
||||
✓ 更新 IMPL-001.json
|
||||
✓ 更新 IMPL-002.json
|
||||
✓ 更新 IMPL-003.json
|
||||
✓ 更新 workflow-session.json
|
||||
|
||||
任务重规划完成!
|
||||
更新了 3 个任务文件
|
||||
```
|
||||
|
||||
### Example 3: Interactive Session Replan
|
||||
|
||||
```bash
|
||||
/workflow:replan --interactive
|
||||
|
||||
# Step-by-step guided process
|
||||
Q: 选择活动会话?
|
||||
A: WFS-oauth-integration
|
||||
|
||||
Q: 你想要修改什么?
|
||||
A: [text input] "需要添加 API 速率限制功能"
|
||||
|
||||
Q: 修改范围是什么?
|
||||
A: 修改规划方案 (plan_update)
|
||||
|
||||
Q: 哪些功能模块会受到影响?
|
||||
A: [✓] API 接口 (src/api)
|
||||
|
||||
Q: 任务变更类型?
|
||||
A: [✓] 添加新任务
|
||||
|
||||
Q: 是否需要更新任务依赖关系?
|
||||
A: 否,保持现有依赖
|
||||
|
||||
# Rest of the flow continues...
|
||||
```
|
||||
|
||||
## Related Commands
|
||||
|
||||
**Prerequisites**:
|
||||
- `/workflow:session:start` - Create or discover session before replanning
|
||||
- `/workflow:plan` - Initial planning that creates session artifacts
|
||||
|
||||
**Related Operations**:
|
||||
- `/workflow:action-plan-verify` - Verify replan quality after making changes
|
||||
- `/workflow:status` - Review updated task breakdown
|
||||
- `/task:replan` - Legacy command for project-level task replanning (deprecated)
|
||||
|
||||
**Follow-up Commands**:
|
||||
- `/workflow:execute` - Execute updated plan
|
||||
- `/workflow:review` - Review changes after implementation
|
||||
|
||||
## Migration from task:replan
|
||||
|
||||
### Key Differences
|
||||
|
||||
| Aspect | task:replan (Old) | workflow:replan (New) |
|
||||
|--------|-------------------|------------------------|
|
||||
| Scope | Single task or batch | Session-level or task-level |
|
||||
| Context | Project-level (.task/) | Session-level (.workflow/active/) |
|
||||
| Artifacts | Only task JSON | IMPL_PLAN.md, TODO_LIST.md, task JSONs, session metadata |
|
||||
| Interaction | Minimal | Interactive boundary clarification |
|
||||
| Backup | .task/backup/ | Session-specific .process/backup/ |
|
||||
|
||||
### Migration Guide
|
||||
|
||||
**Old command**:
|
||||
```bash
|
||||
/task:replan IMPL-1 "Add OAuth2 support"
|
||||
```
|
||||
|
||||
**New command**:
|
||||
```bash
|
||||
/workflow:replan IMPL-1 "Add OAuth2 support"
|
||||
```
|
||||
|
||||
**Batch mode** (old):
|
||||
```bash
|
||||
/task:replan --batch verification-report.md
|
||||
```
|
||||
|
||||
**New approach** (use action-plan-verify + workflow:replan):
|
||||
```bash
|
||||
/workflow:action-plan-verify --session WFS-oauth
|
||||
# Review recommendations, then:
|
||||
/workflow:replan --session WFS-oauth "Apply verification recommendations"
|
||||
```
|
||||
|
||||
## Implementation Notes
|
||||
|
||||
### File Structure Assumptions
|
||||
|
||||
```
|
||||
.workflow/active/WFS-session-name/
|
||||
├── workflow-session.json # Session metadata
|
||||
├── IMPL_PLAN.md # Planning document
|
||||
├── TODO_LIST.md # Task checklist
|
||||
├── .task/
|
||||
│ ├── IMPL-001.json # Task definitions
|
||||
│ ├── IMPL-002.json
|
||||
│ └── IMPL-003.json
|
||||
└── .process/
|
||||
├── context-package.json # Context from planning
|
||||
└── backup/
|
||||
└── replan-2025-11-20T10-30-00/
|
||||
├── MANIFEST.md
|
||||
├── IMPL_PLAN.md
|
||||
├── TODO_LIST.md
|
||||
├── workflow-session.json
|
||||
└── IMPL-*.json
|
||||
```
|
||||
|
||||
### Interactive Question Design Principles
|
||||
|
||||
1. **Progressive Disclosure**: Start broad, get specific based on answers
|
||||
2. **Context-Aware Options**: Dynamically generate options from session data
|
||||
3. **Clear Descriptions**: Each option explains what will happen
|
||||
4. **Escape Hatches**: Always provide "cancel" or "adjust" options
|
||||
5. **Validation**: Confirm plan before executing destructive operations
|
||||
|
||||
### Change Tracking Strategy
|
||||
|
||||
All modifications are tracked in:
|
||||
1. **Session metadata**: `workflow-session.json` replan_history array
|
||||
2. **Backup manifest**: MANIFEST.md in backup folder
|
||||
3. **Git commits**: Encourage users to commit after replanning
|
||||
@@ -7,6 +7,14 @@ allowed-tools: Read(*), Write(*), Edit(*), TodoWrite(*), Glob(*), Bash(*)
|
||||
|
||||
# Task Replan Command (/task:replan)
|
||||
|
||||
> **⚠️ DEPRECATION NOTICE**: This command is maintained for backward compatibility. For new workflows, use `/workflow:replan` which provides:
|
||||
> - Session-level replanning with comprehensive artifact updates
|
||||
> - Interactive boundary clarification
|
||||
> - Updates to IMPL_PLAN.md, TODO_LIST.md, and session metadata
|
||||
> - Better integration with workflow sessions
|
||||
>
|
||||
> **Migration**: Replace `/task:replan IMPL-1 "changes"` with `/workflow:replan IMPL-1 "changes"`
|
||||
|
||||
## Overview
|
||||
Replans individual tasks or batch processes multiple tasks with change tracking and backup management.
|
||||
|
||||
|
||||
@@ -0,0 +1,895 @@
|
||||
---
|
||||
name: replan
|
||||
description: Interactive workflow replanning with session-level artifact updates and boundary clarification through guided questioning
|
||||
argument-hint: "[--session session-id] [task-id] \"requirements\"|file.md [--interactive]"
|
||||
allowed-tools: Read(*), Write(*), Edit(*), TodoWrite(*), Glob(*), Bash(*)
|
||||
---
|
||||
|
||||
# Workflow Replan Command (/workflow:replan)
|
||||
|
||||
## Overview
|
||||
Intelligently replans workflow sessions or individual tasks with interactive boundary clarification and comprehensive artifact updates.
|
||||
|
||||
**Dual Mode Design**:
|
||||
- **Session Replan Mode**: Updates multiple session artifacts (IMPL_PLAN.md, TODO_LIST.md, task JSONs)
|
||||
- **Task Replan Mode**: Focused task updates within session context
|
||||
|
||||
## Core Principles
|
||||
**Task System**: @~/.claude/workflows/task-core.md
|
||||
**Workflow Architecture**: @~/.claude/workflows/workflow-architecture.md
|
||||
|
||||
## Key Features
|
||||
- **Interactive Clarification**: Guided questioning to define modification boundaries
|
||||
- **Session-Aware**: Understands and updates all session artifacts
|
||||
- **Impact Analysis**: Automatically detects affected files and dependencies
|
||||
- **Comprehensive Updates**: Modifies IMPL_PLAN.md, TODO_LIST.md, task JSONs, session metadata
|
||||
- **Backup Management**: Preserves previous versions of all modified files
|
||||
- **Change Tracking**: Documents all modifications with rationale
|
||||
|
||||
## Operation Modes
|
||||
|
||||
### Mode 1: Session Replan (Default)
|
||||
|
||||
#### Auto-detect Active Session
|
||||
```bash
|
||||
/workflow:replan "添加双因素认证支持"
|
||||
```
|
||||
Automatically detects active session from `.workflow/active/`
|
||||
|
||||
#### Explicit Session
|
||||
```bash
|
||||
/workflow:replan --session WFS-oauth-integration "添加双因素认证支持"
|
||||
```
|
||||
|
||||
#### File-based Input
|
||||
```bash
|
||||
/workflow:replan --session WFS-oauth requirements-update.md
|
||||
```
|
||||
|
||||
#### Interactive Mode
|
||||
```bash
|
||||
/workflow:replan --session WFS-oauth --interactive
|
||||
```
|
||||
Fully guided step-by-step modification process
|
||||
|
||||
### Mode 2: Task Replan
|
||||
|
||||
#### Direct Task Update
|
||||
```bash
|
||||
/workflow:replan IMPL-1 "修改为使用 OAuth2.0 标准"
|
||||
```
|
||||
Auto-detects session from active sessions
|
||||
|
||||
#### Task with Session
|
||||
```bash
|
||||
/workflow:replan --session WFS-oauth IMPL-2 "增加单元测试覆盖率到 90%"
|
||||
```
|
||||
|
||||
#### Task Interactive Mode
|
||||
```bash
|
||||
/workflow:replan IMPL-1 --interactive
|
||||
```
|
||||
|
||||
## Execution Flow
|
||||
|
||||
### Phase 1: Mode Detection & Session Discovery
|
||||
|
||||
**Step 1.1: Detect Operation Mode**
|
||||
```bash
|
||||
# Check if task ID provided (IMPL-N or IMPL-N.M format)
|
||||
if [[ "$1" =~ ^IMPL-[0-9]+(\.[0-9]+)?$ ]]; then
|
||||
MODE="task"
|
||||
TASK_ID="$1"
|
||||
else
|
||||
MODE="session"
|
||||
fi
|
||||
```
|
||||
|
||||
**Step 1.2: Discover/Validate Session**
|
||||
```bash
|
||||
# If --session provided, use it
|
||||
# Otherwise, auto-detect active session
|
||||
active_session=$(find .workflow/active/ -name "WFS-*" -type d 2>/dev/null | head -1)
|
||||
|
||||
# Validate session exists
|
||||
if [ ! -d ".workflow/active/$SESSION_ID" ]; then
|
||||
echo "ERROR: Session $SESSION_ID not found"
|
||||
exit 1
|
||||
fi
|
||||
```
|
||||
|
||||
**Step 1.3: Load Session Context**
|
||||
```bash
|
||||
# Read session metadata
|
||||
Read(file_path=".workflow/active/$SESSION_ID/workflow-session.json")
|
||||
|
||||
# List existing tasks
|
||||
Glob(pattern=".workflow/active/$SESSION_ID/.task/IMPL-*.json")
|
||||
|
||||
# Read planning document
|
||||
Read(file_path=".workflow/active/$SESSION_ID/IMPL_PLAN.md")
|
||||
```
|
||||
|
||||
**Output**: Session validated, context loaded, mode determined
|
||||
|
||||
---
|
||||
|
||||
### Phase 2: Interactive Requirement Clarification
|
||||
|
||||
**Purpose**: Use guided questioning to precisely define modification scope and boundaries
|
||||
|
||||
#### Session Mode Clarification
|
||||
|
||||
**Question 1: Modification Scope**
|
||||
```javascript
|
||||
AskUserQuestion({
|
||||
questions: [{
|
||||
question: "修改范围是什么?",
|
||||
header: "Scope",
|
||||
options: [
|
||||
{
|
||||
label: "仅更新任务细节",
|
||||
value: "tasks_only",
|
||||
description: "只修改现有任务的实现细节,不改变整体规划"
|
||||
},
|
||||
{
|
||||
label: "修改规划方案",
|
||||
value: "plan_update",
|
||||
description: "需要更新 IMPL_PLAN.md 中的技术方案或架构设计"
|
||||
},
|
||||
{
|
||||
label: "重构任务结构",
|
||||
value: "task_restructure",
|
||||
description: "需要添加、删除或重组任务,更新 TODO_LIST.md"
|
||||
},
|
||||
{
|
||||
label: "全面重规划",
|
||||
value: "comprehensive",
|
||||
description: "大幅修改需求,需要更新所有规划文档和任务"
|
||||
}
|
||||
],
|
||||
multiSelect: false
|
||||
}]
|
||||
})
|
||||
```
|
||||
|
||||
**Question 2: Affected Modules** (if scope >= plan_update)
|
||||
```javascript
|
||||
AskUserQuestion({
|
||||
questions: [{
|
||||
question: "哪些功能模块会受到影响?",
|
||||
header: "Modules",
|
||||
options: [
|
||||
// Dynamically generated from existing tasks' focus_paths
|
||||
{ label: "认证模块 (src/auth)", value: "auth" },
|
||||
{ label: "用户管理 (src/user)", value: "user" },
|
||||
{ label: "API 接口 (src/api)", value: "api" },
|
||||
{ label: "全部模块", value: "all" }
|
||||
],
|
||||
multiSelect: true
|
||||
}]
|
||||
})
|
||||
```
|
||||
|
||||
**Question 3: Task Changes** (if scope >= task_restructure)
|
||||
```javascript
|
||||
AskUserQuestion({
|
||||
questions: [{
|
||||
question: "任务变更类型?",
|
||||
header: "Task Changes",
|
||||
options: [
|
||||
{ label: "添加新任务", value: "add", description: "创建新的 IMPL-*.json 任务" },
|
||||
{ label: "删除现有任务", value: "remove", description: "移除不需要的任务" },
|
||||
{ label: "合并任务", value: "merge", description: "将多个任务合并为一个" },
|
||||
{ label: "拆分任务", value: "split", description: "将一个任务拆分为多个子任务" },
|
||||
{ label: "仅更新内容", value: "update", description: "保持任务结构,只修改内容" }
|
||||
],
|
||||
multiSelect: true
|
||||
}]
|
||||
})
|
||||
```
|
||||
|
||||
**Question 4: Dependency Changes** (if task changes detected)
|
||||
```javascript
|
||||
AskUserQuestion({
|
||||
questions: [{
|
||||
question: "是否需要更新任务依赖关系?",
|
||||
header: "Dependencies",
|
||||
options: [
|
||||
{ label: "是,需要重新梳理依赖", value: "yes" },
|
||||
{ label: "否,保持现有依赖", value: "no" }
|
||||
],
|
||||
multiSelect: false
|
||||
}]
|
||||
})
|
||||
```
|
||||
|
||||
#### Task Mode Clarification
|
||||
|
||||
**Question 1: Update Type**
|
||||
```javascript
|
||||
AskUserQuestion({
|
||||
questions: [{
|
||||
question: "需要更新任务的哪些部分?",
|
||||
header: "Update Type",
|
||||
options: [
|
||||
{ label: "需求和验收标准 (requirements & acceptance)", value: "requirements" },
|
||||
{ label: "实现方案 (implementation_approach)", value: "implementation" },
|
||||
{ label: "文件范围 (focus_paths)", value: "paths" },
|
||||
{ label: "依赖关系 (depends_on)", value: "dependencies" },
|
||||
{ label: "全部更新", value: "all" }
|
||||
],
|
||||
multiSelect: true
|
||||
}]
|
||||
})
|
||||
```
|
||||
|
||||
**Question 2: Ripple Effect**
|
||||
```javascript
|
||||
AskUserQuestion({
|
||||
questions: [{
|
||||
question: "此修改是否影响其他任务?",
|
||||
header: "Impact",
|
||||
options: [
|
||||
{ label: "是,需要同步更新依赖任务", value: "yes" },
|
||||
{ label: "否,仅影响当前任务", value: "no" },
|
||||
{ label: "不确定,请帮我分析", value: "analyze" }
|
||||
],
|
||||
multiSelect: false
|
||||
}]
|
||||
})
|
||||
```
|
||||
|
||||
**Output**:
|
||||
- User selections stored in clarification context
|
||||
- Modification boundaries clearly defined
|
||||
- Impact scope determined
|
||||
|
||||
---
|
||||
|
||||
### Phase 3: Impact Analysis & Planning
|
||||
|
||||
**Step 3.1: Analyze Required Changes**
|
||||
|
||||
Based on clarification responses, determine affected files:
|
||||
|
||||
```typescript
|
||||
interface ImpactAnalysis {
|
||||
affected_files: {
|
||||
impl_plan: boolean; // IMPL_PLAN.md needs update
|
||||
todo_list: boolean; // TODO_LIST.md needs update
|
||||
session_meta: boolean; // workflow-session.json needs update
|
||||
tasks: string[]; // Array of task IDs (IMPL-*.json)
|
||||
};
|
||||
|
||||
operations: {
|
||||
type: 'create' | 'update' | 'delete' | 'merge' | 'split';
|
||||
target: string; // File path or task ID
|
||||
reason: string; // Why this change is needed
|
||||
}[];
|
||||
|
||||
backup_strategy: {
|
||||
timestamp: string; // ISO timestamp for backup folder
|
||||
files: string[]; // All files to backup
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
**Step 3.2: Generate Modification Plan**
|
||||
|
||||
```markdown
|
||||
## 修改计划
|
||||
|
||||
### 影响范围
|
||||
- [ ] IMPL_PLAN.md: 更新技术方案第 3 节
|
||||
- [ ] TODO_LIST.md: 添加 2 个新任务,删除 1 个废弃任务
|
||||
- [ ] IMPL-001.json: 更新实现方案
|
||||
- [ ] IMPL-002.json: 添加依赖关系
|
||||
- [ ] workflow-session.json: 更新任务计数
|
||||
|
||||
### 变更操作
|
||||
1. **创建**: IMPL-004.json (双因素认证实现)
|
||||
2. **更新**: IMPL-001.json (添加 2FA 准备工作)
|
||||
3. **删除**: IMPL-003.json (已被新方案替代)
|
||||
|
||||
### 备份策略
|
||||
备份到: .workflow/active/WFS-oauth/.process/backup/replan-2025-11-20T10-30-00/
|
||||
```
|
||||
|
||||
**Step 3.3: User Confirmation**
|
||||
|
||||
```javascript
|
||||
AskUserQuestion({
|
||||
questions: [{
|
||||
question: "确认执行上述修改计划?",
|
||||
header: "Confirm",
|
||||
options: [
|
||||
{ label: "确认执行", value: "confirm", description: "开始应用所有修改" },
|
||||
{ label: "调整计划", value: "adjust", description: "重新回答问题调整范围" },
|
||||
{ label: "取消操作", value: "cancel", description: "放弃本次重规划" }
|
||||
],
|
||||
multiSelect: false
|
||||
}]
|
||||
})
|
||||
```
|
||||
|
||||
**Output**: Modification plan confirmed or adjusted
|
||||
|
||||
---
|
||||
|
||||
### Phase 4: Backup Creation
|
||||
|
||||
**Step 4.1: Create Backup Directory**
|
||||
```bash
|
||||
timestamp=$(date -u +"%Y-%m-%dT%H-%M-%S")
|
||||
backup_dir=".workflow/active/$SESSION_ID/.process/backup/replan-$timestamp"
|
||||
mkdir -p "$backup_dir"
|
||||
```
|
||||
|
||||
**Step 4.2: Backup All Affected Files**
|
||||
```bash
|
||||
# Backup planning documents
|
||||
if [ -f ".workflow/active/$SESSION_ID/IMPL_PLAN.md" ]; then
|
||||
cp ".workflow/active/$SESSION_ID/IMPL_PLAN.md" "$backup_dir/"
|
||||
fi
|
||||
|
||||
if [ -f ".workflow/active/$SESSION_ID/TODO_LIST.md" ]; then
|
||||
cp ".workflow/active/$SESSION_ID/TODO_LIST.md" "$backup_dir/"
|
||||
fi
|
||||
|
||||
# Backup session metadata
|
||||
cp ".workflow/active/$SESSION_ID/workflow-session.json" "$backup_dir/"
|
||||
|
||||
# Backup affected task JSONs
|
||||
for task_id in "${affected_tasks[@]}"; do
|
||||
cp ".workflow/active/$SESSION_ID/.task/$task_id.json" "$backup_dir/"
|
||||
done
|
||||
```
|
||||
|
||||
**Step 4.3: Create Backup Manifest**
|
||||
```bash
|
||||
cat > "$backup_dir/MANIFEST.md" <<EOF
|
||||
# Replan Backup Manifest
|
||||
|
||||
**Timestamp**: $timestamp
|
||||
**Reason**: $replan_reason
|
||||
**Scope**: $modification_scope
|
||||
|
||||
## Backed Up Files
|
||||
$(ls -1 "$backup_dir" | grep -v MANIFEST.md)
|
||||
|
||||
## Restoration Command
|
||||
\`\`\`bash
|
||||
# To restore from this backup:
|
||||
cp $backup_dir/* .workflow/active/$SESSION_ID/
|
||||
\`\`\`
|
||||
EOF
|
||||
```
|
||||
|
||||
**Output**: All files safely backed up with manifest
|
||||
|
||||
---
|
||||
|
||||
### Phase 5: Apply Modifications
|
||||
|
||||
**Step 5.1: Update IMPL_PLAN.md** (if needed)
|
||||
|
||||
```typescript
|
||||
// Identify sections to update based on affected modules
|
||||
// Use Edit tool to modify specific sections
|
||||
|
||||
Edit({
|
||||
file_path: `.workflow/active/${SESSION_ID}/IMPL_PLAN.md`,
|
||||
old_string: "### 3.2 认证流程\n\n当前使用简单密码认证...",
|
||||
new_string: "### 3.2 认证流程\n\n采用双因素认证 (2FA):\n1. 用户名密码验证\n2. TOTP 令牌验证\n3. 会话令牌颁发..."
|
||||
})
|
||||
|
||||
// Update modification date
|
||||
Edit({
|
||||
file_path: `.workflow/active/${SESSION_ID}/IMPL_PLAN.md`,
|
||||
old_string: "**Last Modified**: 2025-11-15",
|
||||
new_string: "**Last Modified**: 2025-11-20"
|
||||
})
|
||||
```
|
||||
|
||||
**Step 5.2: Update TODO_LIST.md** (if needed)
|
||||
|
||||
```typescript
|
||||
// Add new tasks
|
||||
Edit({
|
||||
file_path: `.workflow/active/${SESSION_ID}/TODO_LIST.md`,
|
||||
old_string: "- [ ] IMPL-003: 实现用户登录",
|
||||
new_string: `- [ ] IMPL-003: 实现用户登录
|
||||
- [ ] IMPL-004: 实现 TOTP 双因素认证`
|
||||
})
|
||||
|
||||
// Mark deleted tasks as obsolete
|
||||
Edit({
|
||||
file_path: `.workflow/active/${SESSION_ID}/TODO_LIST.md`,
|
||||
old_string: "- [ ] IMPL-005: 简单密码重置",
|
||||
new_string: "- [x] ~~IMPL-005: 简单密码重置~~ (已废弃,替换为 IMPL-004)"
|
||||
})
|
||||
```
|
||||
|
||||
**Step 5.3: Update Task JSONs**
|
||||
|
||||
For each affected task:
|
||||
|
||||
```typescript
|
||||
// Read current task
|
||||
const task = Read(`.workflow/active/${SESSION_ID}/.task/${task_id}.json`);
|
||||
|
||||
// Parse and modify
|
||||
const updated_task = {
|
||||
...task,
|
||||
context: {
|
||||
...task.context,
|
||||
requirements: [
|
||||
...task.context.requirements,
|
||||
"支持 TOTP 双因素认证"
|
||||
],
|
||||
acceptance: [
|
||||
...task.context.acceptance,
|
||||
"2FA 验证流程通过测试"
|
||||
]
|
||||
},
|
||||
flow_control: {
|
||||
...task.flow_control,
|
||||
implementation_approach: [
|
||||
{
|
||||
step: 1,
|
||||
title: "集成 TOTP 库",
|
||||
description: "添加 speakeasy 库用于生成和验证 TOTP 令牌",
|
||||
modification_points: [
|
||||
"安装 speakeasy npm 包",
|
||||
"创建 TOTP 工具函数"
|
||||
],
|
||||
logic_flow: [
|
||||
"用户启用 2FA → 生成密钥",
|
||||
"生成 QR 码供用户扫描",
|
||||
"存储加密的 2FA 密钥"
|
||||
],
|
||||
depends_on: [],
|
||||
output: "totp_setup"
|
||||
},
|
||||
// ... more steps
|
||||
]
|
||||
}
|
||||
};
|
||||
|
||||
// Write back
|
||||
Write({
|
||||
file_path: `.workflow/active/${SESSION_ID}/.task/${task_id}.json`,
|
||||
content: JSON.stringify(updated_task, null, 2)
|
||||
});
|
||||
```
|
||||
|
||||
**Step 5.4: Create New Tasks** (if needed)
|
||||
|
||||
```typescript
|
||||
const new_task = {
|
||||
id: "IMPL-004",
|
||||
title: "实现 TOTP 双因素认证",
|
||||
status: "pending",
|
||||
|
||||
meta: {
|
||||
type: "feature",
|
||||
agent: "@code-developer"
|
||||
},
|
||||
|
||||
context: {
|
||||
requirements: [
|
||||
"支持 TOTP 双因素认证",
|
||||
"用户可启用/禁用 2FA",
|
||||
"提供备用恢复码"
|
||||
],
|
||||
focus_paths: ["src/auth/2fa", "src/utils/totp", "tests/auth"],
|
||||
acceptance: [
|
||||
"用户可以成功启用 2FA",
|
||||
"TOTP 验证码正确验证",
|
||||
"备用恢复码可以使用"
|
||||
],
|
||||
depends_on: ["IMPL-001"]
|
||||
},
|
||||
|
||||
flow_control: {
|
||||
pre_analysis: [],
|
||||
implementation_approach: [
|
||||
// ... implementation steps
|
||||
],
|
||||
target_files: [
|
||||
"src/auth/2fa/totp.ts",
|
||||
"src/auth/2fa/recovery.ts",
|
||||
"tests/auth/2fa.test.ts"
|
||||
]
|
||||
}
|
||||
};
|
||||
|
||||
Write({
|
||||
file_path: `.workflow/active/${SESSION_ID}/.task/IMPL-004.json`,
|
||||
content: JSON.stringify(new_task, null, 2)
|
||||
});
|
||||
```
|
||||
|
||||
**Step 5.5: Delete Obsolete Tasks** (if needed)
|
||||
|
||||
```bash
|
||||
# Move to backup instead of hard delete
|
||||
mv ".workflow/active/$SESSION_ID/.task/IMPL-003.json" "$backup_dir/"
|
||||
```
|
||||
|
||||
**Step 5.6: Update Session Metadata**
|
||||
|
||||
```typescript
|
||||
const session = Read(`.workflow/active/${SESSION_ID}/workflow-session.json`);
|
||||
|
||||
const updated_session = {
|
||||
...session,
|
||||
progress: {
|
||||
...session.progress,
|
||||
current_tasks: ["IMPL-001", "IMPL-002", "IMPL-004"], // Updated list
|
||||
last_replan: new Date().toISOString(),
|
||||
replan_history: [
|
||||
...(session.replan_history || []),
|
||||
{
|
||||
timestamp: new Date().toISOString(),
|
||||
reason: replan_reason,
|
||||
scope: modification_scope,
|
||||
backup_location: backup_dir,
|
||||
changes: {
|
||||
added_tasks: ["IMPL-004"],
|
||||
removed_tasks: ["IMPL-003"],
|
||||
updated_tasks: ["IMPL-001", "IMPL-002"]
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
};
|
||||
|
||||
Write({
|
||||
file_path: `.workflow/active/${SESSION_ID}/workflow-session.json`,
|
||||
content: JSON.stringify(updated_session, null, 2)
|
||||
});
|
||||
```
|
||||
|
||||
**Output**: All modifications applied, artifacts updated
|
||||
|
||||
---
|
||||
|
||||
### Phase 6: Verification & Summary
|
||||
|
||||
**Step 6.1: Verify Consistency**
|
||||
|
||||
```bash
|
||||
# Verify all task JSONs are valid
|
||||
for task_file in .workflow/active/$SESSION_ID/.task/IMPL-*.json; do
|
||||
if ! jq empty "$task_file" 2>/dev/null; then
|
||||
echo "ERROR: Invalid JSON in $task_file"
|
||||
exit 1
|
||||
fi
|
||||
done
|
||||
|
||||
# Verify task count within limits (max 10)
|
||||
task_count=$(ls .workflow/active/$SESSION_ID/.task/IMPL-*.json | wc -l)
|
||||
if [ "$task_count" -gt 10 ]; then
|
||||
echo "WARNING: Task count ($task_count) exceeds recommended limit of 10"
|
||||
fi
|
||||
|
||||
# Verify dependency graph is acyclic
|
||||
# (Check no circular dependencies)
|
||||
```
|
||||
|
||||
**Step 6.2: Generate Change Summary**
|
||||
|
||||
```markdown
|
||||
## 重规划完成
|
||||
|
||||
### 会话信息
|
||||
- **Session**: WFS-oauth-integration
|
||||
- **时间**: 2025-11-20 10:30:00 UTC
|
||||
- **备份**: .workflow/active/WFS-oauth/.process/backup/replan-2025-11-20T10-30-00/
|
||||
|
||||
### 变更摘要
|
||||
**范围**: 全面重规划 (comprehensive)
|
||||
**原因**: 添加双因素认证支持
|
||||
|
||||
### 修改的文件
|
||||
- ✓ IMPL_PLAN.md: 更新了第 3 节认证方案
|
||||
- ✓ TODO_LIST.md: 添加 1 个任务,删除 1 个任务
|
||||
- ✓ IMPL-001.json: 更新实现方案
|
||||
- ✓ IMPL-002.json: 添加 2FA 相关依赖
|
||||
- ✓ IMPL-004.json: 新建双因素认证任务
|
||||
- ✓ workflow-session.json: 更新任务列表和历史记录
|
||||
|
||||
### 任务变更
|
||||
- **新增**: IMPL-004 (实现 TOTP 双因素认证)
|
||||
- **删除**: IMPL-003 (简单密码重置 - 已废弃)
|
||||
- **更新**: IMPL-001, IMPL-002
|
||||
|
||||
### 下一步建议
|
||||
1. 运行 `/workflow:action-plan-verify --session WFS-oauth` 验证规划质量
|
||||
2. 运行 `/workflow:status` 查看更新后的任务列表
|
||||
3. 运行 `/workflow:execute` 开始执行新规划
|
||||
|
||||
### 回滚方法
|
||||
如需回滚到重规划前的状态:
|
||||
\`\`\`bash
|
||||
cp .workflow/active/WFS-oauth/.process/backup/replan-2025-11-20T10-30-00/* .workflow/active/WFS-oauth/
|
||||
\`\`\`
|
||||
```
|
||||
|
||||
**Output**: Summary displayed to user, replan complete
|
||||
|
||||
---
|
||||
|
||||
## TodoWrite Progress Tracking
|
||||
|
||||
### Session Mode Progress
|
||||
|
||||
```json
|
||||
[
|
||||
{"content": "检测模式和发现会话", "status": "completed", "activeForm": "检测模式和发现会话"},
|
||||
{"content": "交互式需求明确", "status": "completed", "activeForm": "交互式需求明确"},
|
||||
{"content": "影响分析和计划生成", "status": "completed", "activeForm": "影响分析和计划生成"},
|
||||
{"content": "创建备份", "status": "completed", "activeForm": "创建备份"},
|
||||
{"content": "更新 IMPL_PLAN.md", "status": "completed", "activeForm": "更新 IMPL_PLAN.md"},
|
||||
{"content": "更新 TODO_LIST.md", "status": "completed", "activeForm": "更新 TODO_LIST.md"},
|
||||
{"content": "更新 3 个任务 JSON 文件", "status": "completed", "activeForm": "更新任务 JSON 文件"},
|
||||
{"content": "更新会话元数据", "status": "completed", "activeForm": "更新会话元数据"},
|
||||
{"content": "验证一致性", "status": "completed", "activeForm": "验证一致性"}
|
||||
]
|
||||
```
|
||||
|
||||
### Task Mode Progress
|
||||
|
||||
```json
|
||||
[
|
||||
{"content": "检测会话和加载任务", "status": "completed", "activeForm": "检测会话和加载任务"},
|
||||
{"content": "交互式更新类型确认", "status": "completed", "activeForm": "交互式更新类型确认"},
|
||||
{"content": "分析影响范围", "status": "completed", "activeForm": "分析影响范围"},
|
||||
{"content": "创建备份", "status": "completed", "activeForm": "创建备份"},
|
||||
{"content": "更新 IMPL-001.json", "status": "completed", "activeForm": "更新 IMPL-001.json"},
|
||||
{"content": "更新会话元数据", "status": "completed", "activeForm": "更新会话元数据"}
|
||||
]
|
||||
```
|
||||
|
||||
## Error Handling
|
||||
|
||||
### Session Errors
|
||||
```bash
|
||||
# No active session found
|
||||
ERROR: No active session found
|
||||
Run /workflow:session:start to create a session
|
||||
|
||||
# Session not found
|
||||
ERROR: Session WFS-invalid not found
|
||||
Available sessions:
|
||||
- WFS-oauth-integration
|
||||
- WFS-user-profile
|
||||
|
||||
# No changes detected
|
||||
WARNING: No modifications specified
|
||||
Please provide requirements or use --interactive mode
|
||||
```
|
||||
|
||||
### Task Errors
|
||||
```bash
|
||||
# Task not found
|
||||
ERROR: Task IMPL-999 not found in session WFS-oauth
|
||||
Available tasks: IMPL-001, IMPL-002, IMPL-003
|
||||
|
||||
# Task already completed
|
||||
WARNING: Task IMPL-001 is completed
|
||||
Consider creating a new task for additional work
|
||||
|
||||
# Circular dependency detected
|
||||
ERROR: Circular dependency detected: IMPL-001 → IMPL-002 → IMPL-001
|
||||
Please resolve dependency conflicts
|
||||
```
|
||||
|
||||
### Validation Errors
|
||||
```bash
|
||||
# Task limit exceeded
|
||||
ERROR: Replan would create 12 tasks (limit: 10)
|
||||
Consider:
|
||||
1. Combining related tasks
|
||||
2. Splitting into multiple sessions
|
||||
3. Removing unnecessary tasks
|
||||
|
||||
# Invalid JSON generated
|
||||
ERROR: Generated invalid JSON for IMPL-004
|
||||
Backup preserved at: [backup_path]
|
||||
Rolling back changes...
|
||||
```
|
||||
|
||||
## Examples
|
||||
|
||||
### Example 1: Session Replan - Add Feature
|
||||
|
||||
```bash
|
||||
/workflow:replan "添加双因素认证支持"
|
||||
|
||||
# Interactive clarification
|
||||
Q: 修改范围是什么?
|
||||
A: 全面重规划 (comprehensive)
|
||||
|
||||
Q: 哪些功能模块会受到影响?
|
||||
A: [✓] 认证模块 (src/auth)
|
||||
[✓] API 接口 (src/api)
|
||||
|
||||
Q: 任务变更类型?
|
||||
A: [✓] 添加新任务
|
||||
[✓] 仅更新内容
|
||||
|
||||
Q: 是否需要更新任务依赖关系?
|
||||
A: 是,需要重新梳理依赖
|
||||
|
||||
# Modification plan shown...
|
||||
# User confirms...
|
||||
|
||||
# Execution
|
||||
✓ 创建备份
|
||||
✓ 更新 IMPL_PLAN.md
|
||||
✓ 更新 TODO_LIST.md
|
||||
✓ 创建 IMPL-004.json
|
||||
✓ 更新 IMPL-001.json, IMPL-002.json
|
||||
✓ 更新 workflow-session.json
|
||||
|
||||
# Summary displayed
|
||||
重规划完成!
|
||||
新增 1 个任务,更新 2 个任务
|
||||
备份位置: .workflow/active/WFS-oauth/.process/backup/replan-2025-11-20T10-30-00/
|
||||
```
|
||||
|
||||
### Example 2: Task Replan - Update Requirements
|
||||
|
||||
```bash
|
||||
/workflow:replan IMPL-001 "需要支持 OAuth2.0 标准,而不是自定义认证"
|
||||
|
||||
# Interactive clarification
|
||||
Q: 需要更新任务的哪些部分?
|
||||
A: [✓] 需求和验收标准 (requirements & acceptance)
|
||||
[✓] 实现方案 (implementation_approach)
|
||||
|
||||
Q: 此修改是否影响其他任务?
|
||||
A: 是,需要同步更新依赖任务
|
||||
|
||||
# Impact analysis
|
||||
分析发现以下任务受影响:
|
||||
- IMPL-002 (依赖 IMPL-001 的认证结果)
|
||||
- IMPL-003 (使用相同的认证接口)
|
||||
|
||||
# Modification plan
|
||||
将更新:
|
||||
- IMPL-001.json: 需求和实现方案
|
||||
- IMPL-002.json: 依赖说明
|
||||
- IMPL-003.json: 接口调用方式
|
||||
|
||||
# User confirms...
|
||||
|
||||
✓ 创建备份
|
||||
✓ 更新 IMPL-001.json
|
||||
✓ 更新 IMPL-002.json
|
||||
✓ 更新 IMPL-003.json
|
||||
✓ 更新 workflow-session.json
|
||||
|
||||
任务重规划完成!
|
||||
更新了 3 个任务文件
|
||||
```
|
||||
|
||||
### Example 3: Interactive Session Replan
|
||||
|
||||
```bash
|
||||
/workflow:replan --interactive
|
||||
|
||||
# Step-by-step guided process
|
||||
Q: 选择活动会话?
|
||||
A: WFS-oauth-integration
|
||||
|
||||
Q: 你想要修改什么?
|
||||
A: [text input] "需要添加 API 速率限制功能"
|
||||
|
||||
Q: 修改范围是什么?
|
||||
A: 修改规划方案 (plan_update)
|
||||
|
||||
Q: 哪些功能模块会受到影响?
|
||||
A: [✓] API 接口 (src/api)
|
||||
|
||||
Q: 任务变更类型?
|
||||
A: [✓] 添加新任务
|
||||
|
||||
Q: 是否需要更新任务依赖关系?
|
||||
A: 否,保持现有依赖
|
||||
|
||||
# Rest of the flow continues...
|
||||
```
|
||||
|
||||
## Related Commands
|
||||
|
||||
**Prerequisites**:
|
||||
- `/workflow:session:start` - Create or discover session before replanning
|
||||
- `/workflow:plan` - Initial planning that creates session artifacts
|
||||
|
||||
**Related Operations**:
|
||||
- `/workflow:action-plan-verify` - Verify replan quality after making changes
|
||||
- `/workflow:status` - Review updated task breakdown
|
||||
- `/task:replan` - Legacy command for project-level task replanning (deprecated)
|
||||
|
||||
**Follow-up Commands**:
|
||||
- `/workflow:execute` - Execute updated plan
|
||||
- `/workflow:review` - Review changes after implementation
|
||||
|
||||
## Migration from task:replan
|
||||
|
||||
### Key Differences
|
||||
|
||||
| Aspect | task:replan (Old) | workflow:replan (New) |
|
||||
|--------|-------------------|------------------------|
|
||||
| Scope | Single task or batch | Session-level or task-level |
|
||||
| Context | Project-level (.task/) | Session-level (.workflow/active/) |
|
||||
| Artifacts | Only task JSON | IMPL_PLAN.md, TODO_LIST.md, task JSONs, session metadata |
|
||||
| Interaction | Minimal | Interactive boundary clarification |
|
||||
| Backup | .task/backup/ | Session-specific .process/backup/ |
|
||||
|
||||
### Migration Guide
|
||||
|
||||
**Old command**:
|
||||
```bash
|
||||
/task:replan IMPL-1 "Add OAuth2 support"
|
||||
```
|
||||
|
||||
**New command**:
|
||||
```bash
|
||||
/workflow:replan IMPL-1 "Add OAuth2 support"
|
||||
```
|
||||
|
||||
**Batch mode** (old):
|
||||
```bash
|
||||
/task:replan --batch verification-report.md
|
||||
```
|
||||
|
||||
**New approach** (use action-plan-verify + workflow:replan):
|
||||
```bash
|
||||
/workflow:action-plan-verify --session WFS-oauth
|
||||
# Review recommendations, then:
|
||||
/workflow:replan --session WFS-oauth "Apply verification recommendations"
|
||||
```
|
||||
|
||||
## Implementation Notes
|
||||
|
||||
### File Structure Assumptions
|
||||
|
||||
```
|
||||
.workflow/active/WFS-session-name/
|
||||
├── workflow-session.json # Session metadata
|
||||
├── IMPL_PLAN.md # Planning document
|
||||
├── TODO_LIST.md # Task checklist
|
||||
├── .task/
|
||||
│ ├── IMPL-001.json # Task definitions
|
||||
│ ├── IMPL-002.json
|
||||
│ └── IMPL-003.json
|
||||
└── .process/
|
||||
├── context-package.json # Context from planning
|
||||
└── backup/
|
||||
└── replan-2025-11-20T10-30-00/
|
||||
├── MANIFEST.md
|
||||
├── IMPL_PLAN.md
|
||||
├── TODO_LIST.md
|
||||
├── workflow-session.json
|
||||
└── IMPL-*.json
|
||||
```
|
||||
|
||||
### Interactive Question Design Principles
|
||||
|
||||
1. **Progressive Disclosure**: Start broad, get specific based on answers
|
||||
2. **Context-Aware Options**: Dynamically generate options from session data
|
||||
3. **Clear Descriptions**: Each option explains what will happen
|
||||
4. **Escape Hatches**: Always provide "cancel" or "adjust" options
|
||||
5. **Validation**: Confirm plan before executing destructive operations
|
||||
|
||||
### Change Tracking Strategy
|
||||
|
||||
All modifications are tracked in:
|
||||
1. **Session metadata**: `workflow-session.json` replan_history array
|
||||
2. **Backup manifest**: MANIFEST.md in backup folder
|
||||
3. **Git commits**: Encourage users to commit after replanning
|
||||
@@ -39,6 +39,7 @@ These commands orchestrate complex, multi-phase development processes, from plan
|
||||
|---|---|
|
||||
| `/workflow:plan` | Orchestrate 5-phase planning workflow with quality gate, executing commands and passing context between phases. |
|
||||
| `/workflow:lite-plan` | ⚡ **NEW** Lightweight interactive planning and execution workflow with in-memory planning, smart code exploration, three-dimensional multi-select confirmation (task approval + execution method + code review), and parallel task execution support. |
|
||||
| `/workflow:replan` | ⚡ **NEW** Interactive workflow replanning with session-level artifact updates and boundary clarification through guided questioning. Supports both session-wide and task-specific modifications. |
|
||||
| `/workflow:execute` | Coordinate agents for existing workflow tasks with automatic discovery. |
|
||||
| `/workflow:resume` | Intelligent workflow session resumption with automatic progress analysis. |
|
||||
| `/workflow:review` | Optional specialized review (security, architecture, docs) for completed implementation. |
|
||||
@@ -122,7 +123,7 @@ Commands for managing individual tasks within a workflow session.
|
||||
| `/task:create` | Create implementation tasks with automatic context awareness. |
|
||||
| `/task:breakdown` | Intelligent task decomposition with context-aware subtask generation. |
|
||||
| `/task:execute` | Execute tasks with appropriate agents and context-aware orchestration. |
|
||||
| `/task:replan` | Replan individual tasks with detailed user input and change tracking. |
|
||||
| `/task:replan` | ⚠️ **DEPRECATED** Use `/workflow:replan` instead. Legacy command for task replanning (maintained for backward compatibility). |
|
||||
|
||||
## Memory and Versioning Commands
|
||||
|
||||
|
||||
Reference in New Issue
Block a user