cc-devflow 4.2.0 → 4.4.1

package/.claude/docs/templates/ERROR_LOG_TEMPLATE.md

@@ -1,80 +0,0 @@
-# Error Log: ${REQ_ID}
-
-> 本文件记录需求开发过程中遇到的所有错误及解决方案。
-> **[PROTOCOL]**: 遇到错误时立即追加，不要等到最后。
-
----
-
-## 错误记录格式
-
-每条错误记录遵循以下结构：
-
-```markdown
-## [TIMESTAMP] E###: TITLE
-
-**Phase**: flow:dev / T### 或 flow:verify / 测试名
-**Error Type**: Test Failure | Build Error | Runtime Error | Type Error | Lint Error
-**Error Message**:
-\`\`\`
-完整错误信息
-\`\`\`
-
-**Root Cause**: 根因分析（解决后填写）
-**Resolution**: 解决方案（解决后填写）
-**Prevention**: 预防措施（可选，防止再犯）
-```
-
----
-
-## 示例记录
-
-## [2026-01-08T10:30:00] E001: Test Failure - Email Validation
-
-**Phase**: flow:dev / T003
-**Error Type**: Test Failure
-**Error Message**:
-```
-FAIL src/auth/login.test.ts
-  × should validate email format
-    Expected: true
-    Received: false
-
-    at Object.<anonymous> (src/auth/login.test.ts:25:20)
-```
-
-**Root Cause**: 正则表达式未处理 + 号邮箱（如 user+tag@example.com）
-**Resolution**: 更新正则为 `/^[^\s@]+@[^\s@]+\.[^\s@]+$/`
-**Prevention**: 添加 + 号邮箱到测试用例，扩充边界测试
-
----
-
-## [2026-01-08T11:15:00] E002: Build Error - Missing Import
-
-**Phase**: flow-dev / T005
-**Error Type**: Build Error
-**Error Message**:
-```
-ERROR in src/components/UserProfile.tsx
-Module not found: Can't resolve '@/utils/formatDate'
-```
-
-**Root Cause**: formatDate 函数移动到 @/utils/date 但未更新 import
-**Resolution**: 更新 import 路径为 `@/utils/date`
-**Prevention**: 使用 IDE 重构功能移动文件，自动更新引用
-
----
-
-## 统计信息
-
-| 指标 | 值 |
-|------|-----|
-| 总错误数 | 0 |
-| 已解决 | 0 |
-| 待解决 | 0 |
-| 最常见类型 | - |
-
-> 注：此统计在开发结束时手动更新
-
----
-
-**[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md

package/.claude/docs/templates/INIT_FLOW_TEMPLATE.md

@@ -1,198 +0,0 @@
-# Flow-Init Execution Flow Template
-
-> Detailed stages for `/flow:init` requirement initialization
-
-<!-- ============================================================
-     调用上下文声明 (Invocation Context Declaration)
-     ============================================================
-
-本模板由 `/flow:init` 命令通过 {TEMPLATE:flow} 引用加载。
-
-模板中的 {SCRIPT:xxx} 占位符引用 flow-init.md 头文件中的 scripts 定义：
-```yaml
-# 来源: .claude/commands/flow/init.md 头文件
-scripts:
-  create: .claude/scripts/create-requirement.sh
-  prereq: .claude/scripts/check-prerequisites.sh
-  research_tasks: .claude/scripts/generate-research-tasks.sh
-  populate_tasks: .claude/scripts/populate-research-tasks.sh
-  consolidate: .claude/scripts/consolidate-research.sh
-  validate_research: .claude/scripts/validate-research.sh
-```
-
-占位符解析:
-- {SCRIPT:prereq}           → bash .claude/scripts/check-prerequisites.sh
-- {SCRIPT:create}           → bash .claude/scripts/create-requirement.sh
-- {SCRIPT:research_tasks}   → bash .claude/scripts/generate-research-tasks.sh
-- {SCRIPT:populate_tasks}   → bash .claude/scripts/populate-research-tasks.sh
-- {SCRIPT:consolidate}      → bash .claude/scripts/consolidate-research.sh
-- {SCRIPT:validate_research} → bash .claude/scripts/validate-research.sh
-============================================================ -->
-
----
-
-## Stage 1: Entry Gate (参数验证)
-
-```bash
-# 1. 解析参数
-REQ_ID|TITLE|PLAN_URLS → 验证 REQ_ID 格式: ^(REQ|BUG)-[0-9]+$
-→ 若 TITLE 含中文/非ASCII，使用模型意译生成 BRANCH_TITLE_EN（英文语义翻译，禁止拼音/音译）
-→ BRANCH_TITLE_EN 仅用于分支名，文档标题仍使用原始 TITLE
-→ 若意译不确定或未生成 ASCII 结果，向用户确认英文分支标题
-
-# 2. 前置条件检查
-bash {SCRIPT:prereq} --json --paths-only
-→ Git 状态干净 + devflow/ 目录存在
-
-# 3. 目录唯一性检查
-→ 确认 devflow/requirements/${REQ_ID}/ 不存在
-```
-
----
-
-## Stage 1.2: Git Branch Creation
-
-```bash
-# 创建功能分支
-Requirements: feature/${REQ_ID}-${slug(BRANCH_TITLE_EN)}
-Bug Fixes:    bugfix/${BUG_ID}-${slug(BRANCH_TITLE_EN)}
-
-# BRANCH_TITLE_EN = TITLE 的英文意译 (语义为准，非拼音，使用模型意译)
-# slug() = lowercase, replace spaces/special chars with hyphens
-```
-
----
-
-## Stage 1.5: Context Loading (路线图与架构)
-
-**目标**: 理解需求在项目中的位置
-
-```bash
-# 检查 ROADMAP.md 和 ARCHITECTURE.md
-→ 如果存在: 加载上下文，展示需求位置
-→ 如果不存在: 提示可选运行 /core-roadmap (不阻塞执行)
-```
-
----
-
-## Stage 2: Directory Initialization
-
-```bash
-# 创建需求目录
-bash {SCRIPT:create} "${REQ_ID}" --title "${TITLE}" --branch-title "${BRANCH_TITLE_EN}" --json
-
-→ 若未生成 BRANCH_TITLE_EN，则省略 --branch-title
-
-# 生成文件
-devflow/requirements/${REQ_ID}/
-├── README.md
-├── EXECUTION_LOG.md
-├── orchestration_status.json
-└── research/ (空目录)
-```
-
----
-
-## Stage 2.5: Research (Subagent Mandatory)
-
-**目标**: 研究默认必跑，但研究过程必须“隔离上下文”。
-
-**规则**: 大内容写入 `research/`，主会话只保留路径引用与决策摘要。
-
-### Mandatory: Call `flow-researcher` Subagent
-
-```
-Task tool call:
-  subagent_type: "flow-researcher"
-  prompt: (JSON) reqId/reqDir/title/planUrls/contextFiles
-```
-
-**产物** (由 subagent 写入):
-- `research/internal/codebase-overview.md`
-- `research/mcp/$(date +%Y%m%d)/**`
-- `research/research-summary.md`
-- `research/tasks.json`
-- `research/research.md`
-
----
-
-## Stage 2.6: Research Consolidation
-
-> 该阶段由 `flow-researcher` subagent 执行（含 tasks 生成/回填/整合/校验）。
-
----
-
-
-
-## Stage 3: README Generation
-
-```bash
-# 生成工作流指南
-→ devflow/requirements/${REQ_ID}/README.md
-→ 包含: 需求概述、工作流步骤、检查清单
-```
-
----
-
-## Stage 4: Exit Gate (5-Level Quality Check)
-
-### Level 1: File Existence Check
-```bash
-→ 验证所有必需文件已创建
-```
-
-### Level 2: Research.md Structure Validation
-```bash
-bash {SCRIPT:validate_research} "${REQ_DIR}" --strict
-→ 检查 research.md 结构
-```
-
-### Level 3: Research.md Content Quality
-```bash
-→ 无 TODO/FIXME/{{PLACEHOLDER}} 标记
-→ 每个 Decision block 完整
-```
-
-### Level 4: Research Tasks Validation
-```bash
-→ 验证 tasks.json 格式和内容
-```
-
-### Level 5: Git & Status & Constitution
-```bash
-→ Git 分支创建成功
-→ orchestration_status.json 正确
-→ Constitution 符合性检查
-```
-
----
-
-## Output Structure
-
-```
-devflow/requirements/${REQ_ID}/
-├── README.md
-├── research/
-│   ├── internal/
-│   │   └── codebase-overview.md
-│   ├── mcp/
-│   │   └── $(date +%Y%m%d)/
-│   │       ├── official/
-│   │       ├── guides/
-│   │       ├── tutorials/
-│   │       └── examples/
-│   ├── research.md
-│   ├── research-summary.md
-│   └── tasks.json
-├── EXECUTION_LOG.md
-└── orchestration_status.json
-```
-
-**Git**:
-- Branch: `feature/${REQ_ID}-${slug(BRANCH_TITLE_EN)}`
-- Status: orchestration_status.json.status = "initialized"
-- Phase: orchestration_status.json.phase = "planning"
-
----
-
-**Last Updated**: 2025-12-19

package/.claude/docs/templates/INTENT_CLARIFICATION_TEMPLATE.md

@@ -1,57 +0,0 @@
-# Requirement Clarification for {{INTENT_SUMMARY}}
-
-> **Session ID**: {{SESSION_ID}}
-> **Timestamp**: {{TIMESTAMP}}
-> **Round**: {{CLARIFICATION_ROUND}}/{{MAX_ROUNDS}}
-
----
-
-## Current Understanding:
-
-### 📊 Analysis Summary
-- **Domain**: {{IDENTIFIED_DOMAIN}}
-- **Target Users**: {{TARGET_USERS}}
-- **Core Function**: {{MAIN_PURPOSE}}
-- **Complexity**: {{COMPLEXITY_LEVEL}}
-- **Confidence**: {{CONFIDENCE_PERCENTAGE}}%
-
-### 🎯 Key Information Collected
-{{COLLECTED_INFORMATION}}
-
-### ❓ Information Gaps
-{{MISSING_INFORMATION}}
-
----
-
-## Critical Questions (Please answer to proceed):
-
-{{#QUESTIONS}}
-### {{QUESTION_NUMBER}}. {{QUESTION_TEXT}}
-
-**Why this matters**: {{EXPLANATION}}
-
-**Examples**: {{HELPFUL_EXAMPLES}}
-
-**Your answer**: _[Please provide your response here]_
-
----
-{{/QUESTIONS}}
-
-## Next Steps:
-
-{{NEXT_ACTION_DESCRIPTION}}
-
-### Progress Indicator:
-```text
-[{{PROGRESS_BAR}}] {{PROGRESS_PERCENTAGE}}% complete
-```
-
-### Estimated Information Completeness:
-- ✅ **Core Definition**: {{CORE_COMPLETENESS}}%
-- {{#FUNCTIONAL_SCOPE_STATUS}}{{FUNCTIONAL_SCOPE_STATUS}}{{/FUNCTIONAL_SCOPE_STATUS}} **Functional Scope**: {{FUNCTIONAL_COMPLETENESS}}%
-- {{#TECHNICAL_CONTEXT_STATUS}}{{TECHNICAL_CONTEXT_STATUS}}{{/TECHNICAL_CONTEXT_STATUS}} **Technical Context**: {{TECHNICAL_COMPLETENESS}}%
-- {{#VALIDATION_STATUS}}{{VALIDATION_STATUS}}{{/VALIDATION_STATUS}} **Validation Criteria**: {{VALIDATION_COMPLETENESS}}%
-
----
-
-**Tip**: The more specific your answers, the better I can help create a comprehensive PRD that meets your needs.

package/.claude/docs/templates/JOURNAL_TEMPLATE.md

@@ -1,75 +0,0 @@
----
-developer: "{DEVELOPER}"
-journal_number: 1
-created_at: "{TIMESTAMP}"
----
-
-# Developer Journal: {DEVELOPER}
-
-> **[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md
-
----
-
-## [{DATE} {TIME}] Session Start
-
-**REQ**: {REQ_ID}
-**Phase**: {PHASE}
-**Task**: {TASK_ID}
-
-### Context Recovery
-
-Previous session ended at:
-- Last completed task: {LAST_TASK}
-- Current blockers: {BLOCKERS}
-- Open questions: {QUESTIONS}
-
-### Session Goals
-
-1. Goal 1
-2. Goal 2
-
----
-
-## [{DATE} {TIME}] Progress Update
-
-### Completed
-
-- [x] Task description
-
-### In Progress
-
-- [ ] Current task
-
-### Blockers
-
-- None
-
-### Notes
-
-- Important observation
-- Decision made
-
----
-
-## [{DATE} {TIME}] Session End
-
-### Summary
-
-Brief summary of what was accomplished.
-
-### Handoff Notes
-
-For next session:
-- Continue with: {NEXT_TASK}
-- Watch out for: {WARNINGS}
-- Questions to resolve: {QUESTIONS}
-
----
-
-<!--
-Journal Guidelines:
-- Max 2000 lines per file
-- When approaching limit, create journal-{N+1}.md
-- Keep entries concise but informative
-- Focus on decisions and blockers, not routine progress
--->

package/.claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md

@@ -1,76 +0,0 @@
-# Mainline Orchestration Template
-
-> Canonical execution flow for requirement delivery (`/flow:init -> /flow:spec -> /flow:dev -> /flow:verify -> /flow:release`)
-
----
-
-## Stage Execution Skeleton
-
-### [1/5] /flow:init
-- 创建需求目录 + 运行时上下文
-- Exit Gate: `status in {initialized, context_packed}`
-
-### [2/5] /flow:spec
-- 统一规格阶段（PRD/Tech/UI/Task Manifest）
-- Exit Gate: `status = spec_complete` 或 `phase = planning`
-
-### [3/5] /flow:dev
-- 按 manifest 执行开发，支持 `--resume`
-- Exit Gate: `status in {development_complete, development_in_progress}`
-
-### [4/5] /flow:verify
-- 快速/严格质量闸
-- 严格模式输出 `report-card.json` 作为发布准入依据
-
-### [5/5] /flow:release
-- 读取 verify 结果并完成发布收口
-- 生成发布计划并清理运行时噪音
-
----
-
-## Progress Display Format
-
-```text
-🎯 CC-DevFlow 主链交付
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-需求: REQ-123 | 支持用户下单
-
-[1/5] ✅ 初始化完成
-[2/5] ✅ 规格完成
-[3/5] 🔄 开发执行中... (8/18 已完成)
-[4/5] ⏳ 等待质量闸...
-[5/5] ⏳ 等待发布...
-```
-
----
-
-## Output Structure
-
-```text
-devflow/requirements/${REQ_ID}/
-├── PRD.md
-├── TECH_DESIGN.md
-├── UI_PROTOTYPE.html            # 条件生成
-├── EPIC.md
-├── TASKS.md
-├── report-card.json             # /flow:verify 产物
-├── SECURITY_REPORT.md
-└── RELEASE_PLAN.md
-```
-
----
-
-## Status Tracking (Suggested)
-
-```json
-{
-  "status": "development_in_progress",
-  "phase": "development",
-  "initialized": true,
-  "spec_complete": true,
-  "development_complete": false,
-  "quality_complete": false,
-  "release_complete": false
-}
-```