cc-devflow 4.2.0 → 4.4.1

package/.claude/docs/templates/CLARIFICATION_REPORT_TEMPLATE.md

@@ -1,206 +0,0 @@
-# Clarification Report: {{REQ_ID}}
-
-**Session ID**: {{SESSION_ID}}
-**Date**: {{DATE}}
-**Duration**: {{SCAN_DURATION}}s (scan) + interactive Q&A
-**Status**: {{STATUS}}
-
----
-
-## Metadata
-
-| Field | Value |
-|-------|-------|
-| Requirement | {{REQ_ID}} |
-| Session ID | {{SESSION_ID}} |
-| Questions | {{QUESTIONS_ANSWERED}} / {{QUESTIONS_TOTAL}} |
-| Generated | {{GENERATED_AT}} |
-
----
-
-## Coverage Summary
-
-**Legend**: ✅ Clear | ⚠️ Partial | ❌ Missing | 🔄 Resolved | ⏭️ Deferred
-
-| Category | Status | Issues | Resolution |
-|----------|--------|--------|------------|
-| Functional Scope | {{DIM_1_STATUS}} | {{DIM_1_ISSUES}} | {{DIM_1_RESOLUTION}} |
-| Data Model | {{DIM_2_STATUS}} | {{DIM_2_ISSUES}} | {{DIM_2_RESOLUTION}} |
-| UX Flow | {{DIM_3_STATUS}} | {{DIM_3_ISSUES}} | {{DIM_3_RESOLUTION}} |
-| Non-Functional Quality | {{DIM_4_STATUS}} | {{DIM_4_ISSUES}} | {{DIM_4_RESOLUTION}} |
-| Integration & Dependencies | {{DIM_5_STATUS}} | {{DIM_5_ISSUES}} | {{DIM_5_RESOLUTION}} |
-| Edge Cases | {{DIM_6_STATUS}} | {{DIM_6_ISSUES}} | {{DIM_6_RESOLUTION}} |
-| Constraints & Tradeoffs | {{DIM_7_STATUS}} | {{DIM_7_ISSUES}} | {{DIM_7_RESOLUTION}} |
-| Terminology | {{DIM_8_STATUS}} | {{DIM_8_ISSUES}} | {{DIM_8_RESOLUTION}} |
-| Completion Signals | {{DIM_9_STATUS}} | {{DIM_9_ISSUES}} | {{DIM_9_RESOLUTION}} |
-| Misc & Placeholders | {{DIM_10_STATUS}} | {{DIM_10_ISSUES}} | {{DIM_10_RESOLUTION}} |
-| Security & Privacy | {{DIM_11_STATUS}} | {{DIM_11_ISSUES}} | {{DIM_11_RESOLUTION}} |
-
-**Summary**:
-- ✅ Clear: {{CLEAR_COUNT}} categories
-- 🔄 Resolved: {{RESOLVED_COUNT}} categories
-- ⏭️ Deferred: {{DEFERRED_COUNT}} categories
-- ❌ Outstanding: {{OUTSTANDING_COUNT}} categories
-
----
-
-## Scan Details
-
-### High-Priority Issues (Priority ≥ 50)
-
-{{#HIGH_PRIORITY_ISSUES}}
-| Issue ID | Dimension | Description | Impact | Uncertainty | Priority |
-|----------|-----------|-------------|--------|-------------|----------|
-{{#ISSUES}}
-| {{ISSUE_ID}} | {{DIM_NAME}} | {{DESCRIPTION}} | {{IMPACT}}/10 | {{UNCERTAINTY}}/10 | {{PRIORITY}} |
-{{/ISSUES}}
-{{/HIGH_PRIORITY_ISSUES}}
-
-{{^HIGH_PRIORITY_ISSUES}}
-No high-priority issues detected.
-{{/HIGH_PRIORITY_ISSUES}}
-
----
-
-## Clarification Session
-
-### Session {{DATE}}
-
-{{#QUESTIONS}}
-#### {{QUESTION_ID}}: {{DIM_NAME}}
-
-**Question**: {{QUESTION_TEXT}}
-
-**Type**: {{QUESTION_TYPE}}
-
-{{#IS_MULTIPLE_CHOICE}}
-| Option | Description |
-|--------|-------------|
-{{#OPTIONS}}
-| **{{OPTION_ID}}** | {{OPTION_TEXT}} - {{OPTION_DESC}} |
-{{/OPTIONS}}
-
-**Recommended**: {{RECOMMENDED_OPTION}} ⭐
-> {{RECOMMENDED_RATIONALE}}
-{{/IS_MULTIPLE_CHOICE}}
-
-{{#IS_SHORT_ANSWER}}
-**Format**: Short answer (≤5 words)
-**Suggested**: {{SUGGESTED_VALUE}}
-{{/IS_SHORT_ANSWER}}
-
-**User Answer**: {{ANSWER}}
-
-**Rationale**: {{ANSWER_RATIONALE}}
-
-**Impact**: {{ANSWER_IMPACT}}
-
-- Q: {{QUESTION_TEXT}} → A: {{ANSWER}}
-
----
-
-{{/QUESTIONS}}
-
-{{^QUESTIONS}}
-No questions generated - research.md appears sufficiently clear.
-{{/QUESTIONS}}
-
----
-
-## Integration Summary
-
-### Sections Updated
-
-{{#UPDATED_SECTIONS}}
-| Section | Update Type | Description |
-|---------|-------------|-------------|
-{{#SECTIONS}}
-| {{SECTION_NAME}} | {{UPDATE_TYPE}} | {{UPDATE_DESC}} |
-{{/SECTIONS}}
-{{/UPDATED_SECTIONS}}
-
-{{^UPDATED_SECTIONS}}
-No sections updated (clarification-only session or no material changes required).
-{{/UPDATED_SECTIONS}}
-
----
-
-## Deferred Items
-
-{{#DEFERRED_ITEMS}}
-| Category | Reason | Recommendation |
-|----------|--------|----------------|
-{{#ITEMS}}
-| {{CATEGORY}} | {{REASON}} | {{RECOMMENDATION}} |
-{{/ITEMS}}
-{{/DEFERRED_ITEMS}}
-
-{{^DEFERRED_ITEMS}}
-No items deferred.
-{{/DEFERRED_ITEMS}}
-
----
-
-## Outstanding Items
-
-{{#OUTSTANDING_ITEMS}}
-> ⚠️ The following items remain unresolved but are low-impact:
-
-{{#ITEMS}}
-- **{{CATEGORY}}**: {{DESCRIPTION}}
-{{/ITEMS}}
-{{/OUTSTANDING_ITEMS}}
-
-{{^OUTSTANDING_ITEMS}}
-No outstanding items.
-{{/OUTSTANDING_ITEMS}}
-
----
-
-## Next Steps
-
-{{#ALL_RESOLVED}}
-✅ **Clarification complete**. All critical ambiguities have been resolved.
-
-Recommended next command: `/flow:spec {{REQ_ID}}`
-{{/ALL_RESOLVED}}
-
-{{#HAS_OUTSTANDING}}
-⚠️ **Clarification partially complete**. Some low-impact items remain.
-
-Options:
-1. Proceed with `/flow:spec {{REQ_ID}}` (acceptable risk)
-2. Re-run `/flow:spec {{REQ_ID}} --overwrite` after planning phase
-{{/HAS_OUTSTANDING}}
-
-{{#HAS_DEFERRED}}
-⏭️ **Items deferred to planning phase**:
-{{#DEFERRED_SUMMARY}}
-- {{ITEM}}
-{{/DEFERRED_SUMMARY}}
-
-These will be addressed during `/flow:spec` task planning or `/flow:dev` implementation.
-{{/HAS_DEFERRED}}
-
-{{#NO_QUESTIONS}}
-✅ **No critical ambiguities detected**. research.md is sufficiently specified.
-
-Recommended next command: `/flow:spec {{REQ_ID}}`
-{{/NO_QUESTIONS}}
-
----
-
-## Validation Checklist
-
-- [ ] CLR-001 All Q&A pairs recorded in session section
-- [ ] CLR-002 No duplicate questions asked
-- [ ] CLR-003 Questions ≤ 5 (actual: {{QUESTIONS_COUNT}})
-- [ ] CLR-004 Coverage summary complete for all 11 dimensions
-- [ ] CLR-005 No contradictory statements remain in research.md
-- [ ] CLR-006 Terminology consistent across updated sections
-
----
-
-**Generated by**: clarify-analyst agent
-**Template Version**: 1.0.0
-**Based on**: spec-kit /speckit.clarify pattern

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 |