cc-devflow 4.3.0 → 4.5.0

package/.claude/docs/templates/CODE_REVIEW_TEMPLATE.md

@@ -1,71 +0,0 @@
-# Code Review Report Template
-
-```
----
-reqId: {{REQ_ID}}
-phase: {{PHASE_NAME}}
-phaseSlug: {{PHASE_SLUG}}
-completedTasks:
-  - {{TASK_ID}} {{TASK_DESC}}
-generatedAt: {{ISO8601_TIMESTAMP}}
-reviewer: code-reviewer
-phaseStatus: {{ready_for_next_phase|blocked}}
-decision: {{approve|comment|request_changes|blocker}}
----
-
-- **What changed**: {{concise-overview-within-prd-epic-scope}}
-- **Top risks**:
-  - {{risk-1-or-"None"}}
-  - {{risk-2}}
-- **Alignment Check**:
-  - **PRD scope**: {{within_scope|out_of_scope}} — {{evidence}}
-  - **EPIC alignment**: {{aligned|misaligned}} — {{evidence}}
-- **Previous review follow-up**:
-  - {{status of prior findings or "No prior review"}}
-
-## Findings
-
-{{For each finding:}}
-- [{{severity}}] {{category}} — {{title}}
-  - **Where**: `{{file}}:{{line_range}}`
-  - **Evidence**: {{brief snippet or description}}
-  - **Impact**: {{user / system impact}}
-  - **Scope Fit**: {{affirm requirement reference or flag scope creep}}
-  - **Recommendation**: {{minimal fix or rollback}}
-  - **Tests**: {{tests to add/run}}
-
-## Performance & Reliability
-- Hotspots: {{items|None}}
-- Complexity notes: {{items|None}}
-- Monitoring/Benchmarks: {{plan|None}}
-
-## Security & Compliance
-- Risks: {{items|None}}
-- Secrets/PII: {{status}}
-- Hardening suggestions: {{items|None}}
-
-## Testing & Verification
-- Coverage signals: {{summary}}
-- Gaps: {{items|None}}
-- Suggested test plan: {{Given/When/Then bullets|None}}
-
-## Documentation & DX
-- Updates needed: {{items|None}}
-- Observability: {{logging/metrics recommendations|None}}
-
-## Decision
-- **Phase Gate Result**: {{Pass|Fail}}
-- **Required Actions Before Next Phase**:
-  1. {{action or "None"}}
-- **Optional Follow-ups**:
-  1. {{item or "None"}}
-
-## Next Actions for Main Agent
-1. {{If decision fail → fix blockers referencing findings}}
-2. {{If pass → proceed guidance, e.g., start next phase}}
-```
-
-> **Instructions**:
-> - Never introduce features or fixes outside PRD/EPIC scope. Flag any scope creep.
-> - Reference prior code reviews to confirm resolutions or carry-over risks.
-> - Set `phaseStatus` to `blocked` if any blocker/high severity issues remain; otherwise `ready_for_next_phase`.

package/.claude/docs/templates/DELTA_SPEC_TEMPLATE.md

@@ -1,91 +0,0 @@
----
-delta_id: "{DELTA_ID}"
-req_id: "{REQ_ID}"
-title: "{TITLE}"
-created_at: "{TIMESTAMP}"
-status: "draft"
----
-
-# Delta: {TITLE}
-
-> **[PROTOCOL]**: 变更时更新此头部，然后检查 CLAUDE.md
-
-## Summary
-
-{简要描述变更内容}
-
----
-
-## ADDED Requirements
-
-### Requirement: {Name}
-
-{Description}
-
-#### Scenario: {Scenario Name}
-
-- GIVEN {precondition}
-- WHEN {action}
-- THEN {expected result}
-
----
-
-## MODIFIED Requirements
-
-### Requirement: {Name}
-
-{New description}
-
-(Previously: {old description})
-
-#### Scenario: {Scenario Name}
-
-- GIVEN {precondition}
-- WHEN {action}
-- THEN {expected result}
-
----
-
-## REMOVED Requirements
-
-### Requirement: {Name}
-
-**Reason**: {why removed}
-
-**Migration**: {how to migrate}
-
----
-
-## RENAMED Requirements
-
-- FROM: {Old Name}
-- TO: {New Name}
-
----
-
-## Impact Analysis
-
-### Affected Files
-
-| File | Change Type | Description |
-|------|-------------|-------------|
-| `src/example.ts` | NEW | Example file |
-
-### Dependencies
-
-- Requires: None
-- Blocks: None
-
----
-
-## Verification
-
-- [ ] Unit tests added for new functionality
-- [ ] Integration tests updated
-- [ ] Documentation updated
-- [ ] Backward compatibility verified
-
----
-
-**Author**: {AUTHOR}
-**Reviewed By**: Pending

package/.claude/docs/templates/DESIGN_DECISIONS_TEMPLATE.md

@@ -1,151 +0,0 @@
-# Design Decisions Record
-
-> [INPUT]: 依赖 team-config.json 的 negotiate_topics 定义
-> [OUTPUT]: 对外提供设计决策记录格式
-> [POS]: templates/ 的 Team 协商决策记录模板，被 flow-spec Team 模式消费
-> [PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
-
----
-req_id: "${REQ_ID}"
-created_at: "${TIMESTAMP}"
-updated_at: "${TIMESTAMP}"
-participants: ["tech-architect", "ui-designer", "planner"]
----
-
-# Design Decisions for ${REQ_ID}
-
-本文档记录 spec-design-team 在设计阶段的共享决策。
-
-## Decision Log
-
-<!-- 每个决策按以下格式记录 -->
-
-### DD-001: API 响应格式
-
-**Topic ID**: `api_format`
-**Decision Owner**: tech-architect
-**Participants**: tech-architect, ui-designer
-**Status**: approved | pending | rejected
-
-**Context**:
-描述决策背景和需要解决的问题。
-
-**Decision**:
-最终决策内容。
-
-**Rationale**:
-选择该方案的原因。
-
-**Alternatives Considered**:
-1. 方案 A - 原因
-2. 方案 B - 原因
-
-**Impact**:
-- 前端: 影响描述
-- 后端: 影响描述
-
-**Timestamp**: ${TIMESTAMP}
-
----
-
-### DD-002: 数据字段命名
-
-**Topic ID**: `field_naming`
-**Decision Owner**: tech-architect
-**Participants**: tech-architect, ui-designer, planner
-**Status**: approved | pending | rejected
-
-**Context**:
-统一数据字段命名规范，确保前后端一致。
-
-**Decision**:
-- 命名风格: camelCase / snake_case
-- 关键字段映射表
-
-**Rationale**:
-选择该方案的原因。
-
-**Timestamp**: ${TIMESTAMP}
-
----
-
-### DD-003: 认证策略
-
-**Topic ID**: `auth_strategy`
-**Decision Owner**: tech-architect
-**Participants**: tech-architect, ui-designer
-**Status**: approved | pending | rejected
-
-**Context**:
-确定认证方案。
-
-**Decision**:
-- 认证方式: JWT / Session / OAuth
-- Token 存储: localStorage / httpOnly cookie
-- 刷新策略: 描述
-
-**Rationale**:
-选择该方案的原因。
-
-**Timestamp**: ${TIMESTAMP}
-
----
-
-### DD-004: 状态管理方案
-
-**Topic ID**: `state_management`
-**Decision Owner**: ui-designer
-**Participants**: tech-architect, ui-designer
-**Status**: approved | pending | rejected
-
-**Context**:
-确定前端状态管理方案。
-
-**Decision**:
-- 方案: Redux / Context / Zustand / Jotai
-- 全局状态: 列表
-- 本地状态: 列表
-
-**Rationale**:
-选择该方案的原因。
-
-**Timestamp**: ${TIMESTAMP}
-
----
-
-### DD-005: 组件粒度
-
-**Topic ID**: `component_granularity`
-**Decision Owner**: ui-designer
-**Participants**: ui-designer, planner
-**Status**: approved | pending | rejected
-
-**Context**:
-确定 UI 组件拆分粒度，影响任务分解。
-
-**Decision**:
-- 组件列表及复杂度评估
-- 每个组件预估时间
-
-**Rationale**:
-选择该方案的原因。
-
-**Timestamp**: ${TIMESTAMP}
-
----
-
-## Summary
-
-| Topic | Decision | Owner | Status |
-|-------|----------|-------|--------|
-| api_format | | tech-architect | |
-| field_naming | | tech-architect | |
-| auth_strategy | | tech-architect | |
-| state_management | | ui-designer | |
-| component_granularity | | ui-designer | |
-
-## Changelog
-
-| Date | Topic | Change | By |
-|------|-------|--------|-----|
-| ${TIMESTAMP} | - | Initial creation | spec-lead |

package/.claude/docs/templates/DESIGN_TEMPLATE.md

@@ -1,157 +0,0 @@
-# design.md Template
-
-> **Purpose**: 技术设计文档模板，描述怎么做
-> **Location**: `devflow/requirements/${REQ_ID}/design.md`
-> **Version**: v4.3.0
-
----
-
-```markdown
----
-req_id: "${REQ_ID}"
-title: "${TITLE}"
-created_at: "${CREATED_AT}"
-updated_at: "${UPDATED_AT}"
-version: "1.0.0"
-status: "draft"
----
-
-# ${TITLE} - Technical Design
-
-## How（怎么做）
-
-[NEEDS CLARIFICATION: 技术方案是什么？如何实现？]
-
-### Architecture Overview
-
-${架构概述}
-
-### Technology Stack
-
-- **Frontend**: ${前端技术栈}
-- **Backend**: ${后端技术栈}
-- **Database**: ${数据库选型}
-- **Infrastructure**: ${基础设施}
-
-### Module Changes
-
-${受影响的模块列表}
-
-- `${MODULE_1}`: ${变更说明}
-- `${MODULE_2}`: ${变更说明}
-
-## Implementation（实现细节）
-
-[NEEDS CLARIFICATION: 具体实现步骤是什么？]
-
-### API Design
-
-#### Endpoints
-
-- `${METHOD} ${PATH}` - ${描述}
-  - Request: `${REQUEST_SCHEMA}`
-  - Response: `${RESPONSE_SCHEMA}`
-
-### Data Model
-
-```sql
-${数据库 Schema 变更}
-```
-
-### File Structure
-
-```
-${受影响的文件列表}
-├── ${FILE_1}  # ${说明}
-├── ${FILE_2}  # ${说明}
-└── ${FILE_3}  # ${说明}
-```
-
-### Dependencies
-
-${新增或更新的依赖}
-
-- `${PACKAGE_1}@${VERSION}` - ${用途}
-- `${PACKAGE_2}@${VERSION}` - ${用途}
-
-## Testing Strategy
-
-### Test Coverage
-
-- [ ] Unit Tests: ${覆盖范围}
-- [ ] Integration Tests: ${覆盖范围}
-- [ ] E2E Tests: ${覆盖范围}
-
-### Test Scenarios
-
-1. **${SCENARIO_1}**: ${测试描述}
-2. **${SCENARIO_2}**: ${测试描述}
-
-## Security Considerations
-
-${安全考虑}
-
-- **Authentication**: ${认证方案}
-- **Authorization**: ${授权方案}
-- **Data Protection**: ${数据保护措施}
-
-## Performance Considerations
-
-${性能考虑}
-
-- **Expected Load**: ${预期负载}
-- **Optimization Strategy**: ${优化策略}
-- **Caching**: ${缓存策略}
-
-## Rollout Plan
-
-### Phase 1: ${阶段 1 名称}
-${阶段 1 描述}
-
-### Phase 2: ${阶段 2 名称}
-${阶段 2 描述}
-
-## Risks & Mitigation
-
-| Risk | Impact | Mitigation |
-|------|--------|------------|
-| ${风险 1} | ${影响} | ${缓解措施} |
-| ${风险 2} | ${影响} | ${缓解措施} |
-
----
-
-## Constitutional Constraints
-
-- **Article I: Quality First** - 完整实现或不实现，禁止部分实现
-- **Article VI: Test-First Development** - 测试必须在实现之前
-- **Article X: Requirement Boundary** - 只实现明确请求的功能
-
-详见 `.claude/rules/project-constitution.md`
-```
-
----
-
-## Field Descriptions
-
-| Field | Description | Example |
-|-------|-------------|---------|
-| `req_id` | 需求 ID | "REQ-123" |
-| `title` | 需求标题 | "添加用户认证" |
-| `created_at` | 创建时间 (ISO 8601) | "2026-03-12T10:00:00Z" |
-| `updated_at` | 更新时间 (ISO 8601) | "2026-03-12T15:30:00Z" |
-| `version` | 文档版本 | "1.0.0" |
-| `status` | 状态 | "draft", "approved", "implemented" |
-
-## How vs Implementation
-
-- **How**: 回答"技术方案是什么"，聚焦架构和选型
-- **Implementation**: 回答"具体怎么实现"，聚焦细节和步骤
-
-## [NEEDS CLARIFICATION] 标记
-
-所有模糊点必须标记为 `[NEEDS CLARIFICATION: 具体问题]`，等待用户澄清。
-
----
-
-**Version**: v4.3.0
-**Related**: SPEC_TEMPLATE_DELTA.md（Delta specs 生成）

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