cc-devflow 4.1.4 → 4.1.6

package/.claude/skills/workflow/flow-init/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: flow-init
-description: 'Initialize requirement structure with brainstorming and research. Usage: /flow-init "REQ-123|Title|URLs". Creates BRAINSTORM.md (north star) and research artifacts.'
+description: 'Initialize a requirement with harness state and context package. Use when starting a new REQ/BUG and preparing deterministic execution context for the next stages.'
 ---
 
 # Flow-Init Skill
@@ -9,210 +9,47 @@ description: 'Initialize requirement structure with brainstorming and research.
 
 ## Purpose
 
-初始化需求结构，包含头脑风暴和研究阶段。生成 BRAINSTORM.md 作为需求的「北极星」。
+初始化需求目录的 harness 运行状态，并生成可执行上下文包。
 
 ## Input Format
 
-```
-/flow-init "REQ_ID|TITLE|PLAN_URLS?"
-/flow-init "REQ_ID|TITLE" --branch-only
-/flow-init --interactive
-```
-
-- **REQ_ID**: `^(REQ|BUG)-[0-9]+$`
-- **TITLE**: 需求简短标题
-- **PLAN_URLS**: 计划文档URL (可选，逗号分隔)
-- **--branch-only**: 使用传统分支模式 (不创建 worktree)
-
-## Execution Flow
-
-### Stage 1: Entry Gate
-
-1. **参数解析**
-   - 验证 REQ_ID 格式
-   - 提取 TITLE 和 PLAN_URLS
-   - 若 TITLE 含中文，意译生成 BRANCH_TITLE_EN
-
-2. **前置检查**
-   ```bash
-   bash scripts/check-prerequisites.sh --json --paths-only
-   ```
-   - Git 状态干净
-   - devflow/ 目录存在
-
-3. **唯一性检查**
-   - `devflow/requirements/${REQ_ID}/` 不存在
-
-### Stage 1.2: Git Worktree (Default) or Branch
-
-**Worktree 模式 (默认)**:
-```bash
-# 计算路径
-REPO_NAME=$(basename $(git rev-parse --show-toplevel))
-WORKTREE_DIR="../${REPO_NAME}-${REQ_ID}"
-
-# 分支前缀按类型决定
-if [[ "${REQ_ID}" =~ ^BUG- ]]; then
-  BRANCH_PREFIX="bugfix"
-else
-  BRANCH_PREFIX="feature"
-fi
-BRANCH_NAME="${BRANCH_PREFIX}/${REQ_ID}-${slug(BRANCH_TITLE_EN)}"
-
-# 创建 worktree + 分支
-git worktree add -b "$BRANCH_NAME" "$WORKTREE_DIR"
-
-# 切换到 worktree
-cd "$WORKTREE_DIR"
-```
-
-**分支模式 (--branch-only)**:
 ```bash
-# Requirements
-git checkout -b feature/${REQ_ID}-${slug(BRANCH_TITLE_EN)}
-
-# Bug Fixes
-git checkout -b bugfix/${BUG_ID}-${slug(BRANCH_TITLE_EN)}
+/flow:init "REQ_ID|TITLE|PLAN_URLS?"
 ```
 
-### Stage 1.5: Context Loading
+- `REQ_ID`: `REQ-123` 或 `BUG-123`
+- `TITLE`: 需求标题
+- `PLAN_URLS`: 可选，逗号分隔
 
-检查并加载 (如存在):
-- `devflow/ROADMAP.md`
-- `devflow/ARCHITECTURE.md`
+## Execution Steps
 
-### Stage 2: Directory Init
+1. 解析输入，提取 `REQ_ID`、`TITLE`、`PLAN_URLS`。
+2. 组装 goal 文本：
+   - `Deliver <REQ_ID>: <TITLE>`
+   - 若有 URL，追加 `Sources: <URLS>`。
+3. 运行初始化：
 
 ```bash
-bash scripts/create-requirement.sh "${REQ_ID}" --title "${TITLE}"
+npm run harness:init -- --change-id "${REQ_ID}" --goal "${GOAL}"
 ```
 
-生成:
-- `devflow/requirements/${REQ_ID}/README.md`
-- `devflow/requirements/${REQ_ID}/EXECUTION_LOG.md`
-- `devflow/requirements/${REQ_ID}/orchestration_status.json`
-- `devflow/requirements/${REQ_ID}/research/`
-
-### Stage 2.3: Brainstorming (MANDATORY)
-
-**Iron Law**: `NO FLOW EXECUTION WITHOUT BRAINSTORM ALIGNMENT`
-
-触发 `flow-brainstorming` skill，执行:
-
-1. **Understanding** - 一次问一个问题
-2. **Exploring** - 提出 2-3 种方案
-3. **Presenting** - 分段呈现设计
-4. **Documentation** - 输出 BRAINSTORM.md
-
-**输出**: `devflow/requirements/${REQ_ID}/BRAINSTORM.md`
-
-**验证**:
-- [ ] BRAINSTORM.md 存在
-- [ ] 包含「原始需求」章节
-- [ ] 包含「成功标准」章节
-- [ ] 包含「方案探索」章节
-- [ ] 包含「最终决策」章节
-
-### Stage 2.5: Research (Subagent)
-
-调用 `flow-researcher` subagent:
-
-```json
-{
-  "reqId": "${REQ_ID}",
-  "reqDir": "devflow/requirements/${REQ_ID}",
-  "title": "${TITLE}",
-  "planUrls": ["..."],
-  "contextFiles": {
-    "brainstorm": "devflow/requirements/${REQ_ID}/BRAINSTORM.md"
-  }
-}
-```
-
-**输出**:
-- `research/internal/codebase-overview.md`
-- `research/mcp/YYYYMMDD/**`
-- `research/research-summary.md`
-- `research/tasks.json`
-- `research/research.md`
-
-### Stage 3: README Generation
-
-生成 `devflow/requirements/${REQ_ID}/README.md`
-
-### Stage 4: Exit Gate (5-Level)
+4. 运行上下文打包：
 
 ```bash
-# Level 2: Structure validation
-bash scripts/validate-research.sh "${REQ_DIR}" --strict
-```
-
-**验证**:
-1. File Existence
-2. Research.md Structure
-3. Content Quality (无 TODO/PLACEHOLDER)
-4. Tasks.json Validation
-5. Git & Status & Constitution
-
-## Output Artifacts
-
-```
-devflow/requirements/${REQ_ID}/
-├── README.md
-├── BRAINSTORM.md           # 北极星
-├── research/
-│   ├── internal/
-│   │   └── codebase-overview.md
-│   ├── mcp/YYYYMMDD/
-│   ├── research.md
-│   ├── research-summary.md
-│   └── tasks.json
-├── EXECUTION_LOG.md
-└── orchestration_status.json
+npm run harness:pack -- --change-id "${REQ_ID}" --goal "${GOAL}"
 ```
 
-## Scripts Reference
+5. 验证输出文件：
+   - `devflow/requirements/${REQ_ID}/harness-state.json`
+   - `devflow/requirements/${REQ_ID}/context-package.md`
 
-| Script | Purpose |
-|--------|---------|
-| `scripts/check-prerequisites.sh` | 前置条件检查 |
-| `scripts/create-requirement.sh` | 创建目录结构 |
-| `scripts/generate-research-tasks.sh` | 生成研究任务 |
-| `scripts/populate-research-tasks.sh` | 填充任务内容 |
-| `scripts/consolidate-research.sh` | 整合研究结果 |
-| `scripts/validate-research.sh` | 验证研究质量 |
+## Exit Criteria
 
-## Templates Reference
-
-| Template | Purpose |
-|----------|---------|
-| `assets/INIT_FLOW_TEMPLATE.md` | 详细执行流程 |
-| `assets/RESEARCH_TEMPLATE.md` | 研究文档格式 |
-| `assets/BRAINSTORM_TEMPLATE.md` | 头脑风暴模板 |
-
-## Agent Reference
-
-| Agent | Purpose |
-|-------|---------|
-| `references/flow-researcher.md` | 研究 subagent 指令 |
-
-## Error Handling
-
-| Error | Solution |
-|-------|----------|
-| Invalid REQ_ID | 检查格式 `^(REQ\|BUG)-[0-9]+$` |
-| REQ_ID exists | 使用不同 ID 或 --force |
-| Git not clean | commit/stash changes |
-| Research validation failed | 手动补充 research.md |
+- `harness-state.json.status == "initialized"`
+- `context-package.md` 存在并包含 Next Commands 段落
 
 ## Next Step
 
+```bash
+/flow:spec "${REQ_ID}"
 ```
-/flow-prd "${REQ_ID}"
-```
-
----
-
-**Related Skills**:
-- `flow-brainstorming` - 头脑风暴
-- `flow-prd` - PRD 生成

package/.claude/skills/workflow/flow-init/assets/RESEARCH_TEMPLATE.md

@@ -145,7 +145,7 @@ Generated: {GENERATED_AT}
 2. **Direct Editing**:
    - Copy this template to `research/research.md`
    - Fill in decisions based on your research
-   - Run validation script before proceeding to /flow-prd
+   - Run validation script before proceeding to /flow:spec
 
 ---
 

package/.claude/skills/workflow/flow-init/context.jsonl

@@ -1,5 +1,5 @@
-{"file": ".claude/rules/project-constitution.md", "reason": "Quality rules and constraints"}
 {"file": "devflow/ROADMAP.md", "reason": "Project roadmap context", "optional": true}
 {"file": "devflow/ARCHITECTURE.md", "reason": "Architecture context", "optional": true}
-{"file": "devflow/spec/frontend/index.md", "reason": "Frontend conventions", "optional": true}
-{"file": "devflow/spec/backend/index.md", "reason": "Backend conventions", "optional": true}
+{"file": "devflow/requirements/{REQ}/harness-state.json", "reason": "Existing harness state", "optional": true}
+{"file": "devflow/requirements/{REQ}/context-package.md", "reason": "Existing context package", "optional": true}
+{"file": ".claude/rules/project-constitution.md", "reason": "Quality rules and constraints"}

package/.claude/skills/workflow/flow-init/scripts/check-prerequisites.sh

@@ -134,7 +134,7 @@ fi
 # Validate required directories and files
 if [[ ! -d "$REQ_DIR" ]]; then
     echo "ERROR: Requirement directory not found: $REQ_DIR" >&2
-    echo "Run /flow-new first to create the requirement structure." >&2
+    echo "Run /flow:init first to create the requirement structure." >&2
     exit 1
 fi
 

package/.claude/skills/workflow/flow-init/scripts/create-requirement.sh

@@ -12,23 +12,18 @@
 #                       Optional if --interactive mode is used
 #
 # OPTIONS:
-#   --title TITLE       Requirement title (docs; branch fallback)
-#   --branch-title TITLE Branch title used for git branch naming (optional)
+#   --title TITLE       Requirement title
+#   --branch-title TITLE Branch title (deprecated, ignored)
 #   --description DESC  Brief description (optional)
-#   --skip-git          Skip git branch/worktree creation
-#   --branch-only       Use traditional branch mode (no worktree)
-#   --worktree          Use worktree mode (default)
+#   --skip-git          Deprecated (git operations removed)
 #   --interactive, -i   Interactive mode (prompts for inputs)
 #   --json              Output in JSON format
 #   --help, -h          Show help message
 #
 # EXAMPLES:
-#   # Create requirement with worktree (default)
+#   # Create requirement
 #   ./create-requirement.sh REQ-123 --title "User authentication"
 #
-#   # Create requirement with traditional branch
-#   ./create-requirement.sh REQ-123 --title "User authentication" --branch-only
-#
 #   # Interactive mode
 #   ./create-requirement.sh --interactive
 #
@@ -66,18 +61,8 @@ while [[ $# -gt 0 ]]; do
             DESCRIPTION="$2"
             shift 2
             ;;
-        --skip-git)
-            SKIP_GIT=true
-            shift
-            ;;
-        --branch-only)
-            BRANCH_ONLY=true
-            USE_WORKTREE=false
-            shift
-            ;;
-        --worktree)
-            USE_WORKTREE=true
-            BRANCH_ONLY=false
+        --skip-git|--branch-only|--worktree)
+            # Deprecated: git operations removed from DevFlow
             shift
             ;;
         --interactive|-i)
@@ -103,12 +88,9 @@ ARGUMENTS:
                       Optional if --interactive mode is used
 
 OPTIONS:
-  --title TITLE       Requirement title (docs; branch fallback)
-  --branch-title TITLE Branch title used for git branch naming (optional)
+  --title TITLE       Requirement title
+  --branch-title TITLE Deprecated (ignored)
   --description DESC  Brief description (optional)
-  --skip-git          Skip git branch/worktree creation
-  --branch-only       Use traditional branch mode (no worktree)
-  --worktree          Use worktree mode (default)
   --interactive, -i   Interactive mode (prompts for inputs)
   --json              Output results in JSON format
   --auto-id           Auto-select next available REQ-ID when missing or duplicated
@@ -142,15 +124,9 @@ STRUCTURE CREATED:
     ├── EXECUTION_LOG.md
     └── status.json
 
-GIT MODES:
-  Worktree (default):
-    - Creates: ../repo-name-REQ-XXX/
-    - Branch: feature/REQ-XXX-title
-    - Enables parallel development
-
-  Branch (--branch-only):
-    - Creates: feature/REQ-XXX-title branch
-    - Traditional single-workspace mode
+NOTE:
+  Git branch/worktree management is handled externally by the user.
+  DevFlow only creates the requirement directory structure.
 
 EOF
             exit 0
@@ -392,98 +368,16 @@ if [[ -n "$DESCRIPTION" ]]; then
     log_event "$REQ_ID" "Description: $DESCRIPTION"
 fi
 
-# Create git branch/worktree if requested and available
-GIT_BRANCH=""
-WORKTREE_DIR=""
-if ! $SKIP_GIT && has_git; then
-    # Generate branch name from title
-    if [[ -n "$BRANCH_TITLE" ]]; then
-        BRANCH_SUFFIX=$(slugify "$BRANCH_TITLE")
-    elif [[ -n "$TITLE" ]]; then
-        BRANCH_SUFFIX=$(slugify "$TITLE")
-    else
-        BRANCH_SUFFIX="new-requirement"
-    fi
-    if [[ -z "$BRANCH_SUFFIX" ]]; then
-        BRANCH_SUFFIX="new-requirement"
-    fi
-
-    # Determine branch prefix based on type
-    if [[ "$REQ_TYPE" == "bug" ]]; then
-        GIT_BRANCH="bugfix/$REQ_ID-$BRANCH_SUFFIX"
-    else
-        GIT_BRANCH="feature/$REQ_ID-$BRANCH_SUFFIX"
-    fi
-
-    # Check if branch already exists
-    if git rev-parse --verify "$GIT_BRANCH" >/dev/null 2>&1; then
-        if ! $JSON_MODE; then
-            echo "WARNING: Git branch already exists: $GIT_BRANCH" >&2
-        fi
-        # Branch exists - check if we should use worktree mode
-        if $USE_WORKTREE && ! $BRANCH_ONLY; then
-            REPO_NAME=$(basename "$REPO_ROOT")
-            WORKTREE_DIR="$(dirname "$REPO_ROOT")/${REPO_NAME}-${REQ_ID}"
-            if [[ -d "$WORKTREE_DIR" ]]; then
-                if ! $JSON_MODE; then
-                    echo "Worktree already exists at: $WORKTREE_DIR" >&2
-                fi
-            else
-                # Create worktree with existing branch
-                git worktree add "$WORKTREE_DIR" "$GIT_BRANCH" >/dev/null 2>&1
-                log_event "$REQ_ID" "Created git worktree: $WORKTREE_DIR (existing branch: $GIT_BRANCH)"
-                if ! $JSON_MODE; then
-                    echo "Created worktree at: $WORKTREE_DIR" >&2
-                fi
-            fi
-        fi
-    else
-        # Branch doesn't exist - create it
-        if $USE_WORKTREE && ! $BRANCH_ONLY; then
-            # Worktree mode (default)
-            REPO_NAME=$(basename "$REPO_ROOT")
-            WORKTREE_DIR="$(dirname "$REPO_ROOT")/${REPO_NAME}-${REQ_ID}"
-
-            if [[ -d "$WORKTREE_DIR" ]]; then
-                if ! $JSON_MODE; then
-                    echo "WARNING: Worktree directory already exists: $WORKTREE_DIR" >&2
-                    echo "Skipping worktree creation." >&2
-                fi
-            else
-                # Create worktree with new branch
-                git worktree add -b "$GIT_BRANCH" "$WORKTREE_DIR" >/dev/null 2>&1
-                log_event "$REQ_ID" "Created git worktree: $WORKTREE_DIR (branch: $GIT_BRANCH)"
-
-                if ! $JSON_MODE; then
-                    echo "Created worktree at: $WORKTREE_DIR" >&2
-                    echo "Branch: $GIT_BRANCH" >&2
-                fi
-            fi
-        else
-            # Traditional branch mode
-            git checkout -b "$GIT_BRANCH" >/dev/null 2>&1
-            log_event "$REQ_ID" "Created git branch: $GIT_BRANCH"
-
-            if ! $JSON_MODE; then
-                echo "Created and checked out branch: $GIT_BRANCH" >&2
-            fi
-        fi
-    fi
-
-    # Set environment variable for non-branch-based workflows
-    export DEVFLOW_REQ_ID="$REQ_ID"
-fi
+# Set environment variable for REQ identification
+export DEVFLOW_REQ_ID="$REQ_ID"
 
 # Output results
 if $JSON_MODE; then
-    printf '{"req_id":"%s","req_type":"%s","req_dir":"%s","title":"%s","git_branch":"%s","worktree_dir":"%s","mode":"%s","created_at":"%s"}\n' \
+    printf '{"req_id":"%s","req_type":"%s","req_dir":"%s","title":"%s","created_at":"%s"}\n' \
         "$REQ_ID" \
         "$REQ_TYPE" \
         "$REQ_DIR" \
         "${TITLE:-""}" \
-        "${GIT_BRANCH:-""}" \
-        "${WORKTREE_DIR:-""}" \
-        "$( $USE_WORKTREE && echo "worktree" || echo "branch" )" \
         "$(get_beijing_time_iso)"
 else
     echo ""
@@ -495,22 +389,9 @@ else
     if [[ -n "$TITLE" ]]; then
         echo "Title:             $TITLE"
     fi
-    if [[ -n "$GIT_BRANCH" ]]; then
-        echo "Git Branch:        $GIT_BRANCH"
-    fi
-    if [[ -n "$WORKTREE_DIR" ]]; then
-        echo "Worktree:          $WORKTREE_DIR"
-        echo "Mode:              worktree (parallel development enabled)"
-    elif [[ -n "$GIT_BRANCH" ]]; then
-        echo "Mode:              branch (traditional)"
-    fi
     echo ""
     echo "Next Steps:"
-    if [[ -n "$WORKTREE_DIR" && -d "$WORKTREE_DIR" ]]; then
-        echo "  1. cd $WORKTREE_DIR"
-        echo "  2. claude  # Start new Claude Code session"
-        echo "  3. Continue with /flow-prd or /flow-spec"
-    elif [[ "$REQ_TYPE" == "bug" ]]; then
+    if [[ "$REQ_TYPE" == "bug" ]]; then
         echo "  1. Run bug-analyzer agent to analyze the BUG"
         echo "  2. Run /flow-fix to start BUG fix workflow"
         echo "  3. Keep EXECUTION_LOG.md updated during fixes"

package/.claude/skills/workflow/flow-init/scripts/validate-research.sh

@@ -311,7 +311,7 @@ main() {
   echo "════════════════════════════════════════════════════════════════════════"
   if [[ $total_errors -eq 0 ]]; then
     echo "✅ ALL VALIDATIONS PASSED"
-    echo "research.md is ready for /flow-prd"
+    echo "research.md is ready for /flow:spec"
     echo "════════════════════════════════════════════════════════════════════════"
     return 0
   else

package/.claude/skills/workflow/flow-release/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: flow-release
-description: 'Create PR and manage release. Usage: /flow-release "REQ-123" or /flow-release'
+description: 'Release a verified requirement and run runtime cleanup. Use only after flow-verify has passed.'
 ---
 
 # Flow-Release Skill
@@ -9,131 +9,41 @@ description: 'Create PR and manage release. Usage: /flow-release "REQ-123" or /f
 
 ## Purpose
 
-创建 PR 并管理发布流程，包括 worktree 清理。
+在验证通过后生成发布说明并标记需求为 released，同时执行 runtime 清理。
 
 ## Input Format
 
-```
-/flow-release "REQ_ID"
-/flow-release             # Auto-detect
-```
-
-## Branch Completion Decision
-
-参考 `flow-finishing-branch` Skill:
-
-| 选项 | 适用场景 | 命令 |
-|-----|---------|------|
-| A) Fast-forward | 小改动，单人开发 | `git merge --ff-only` |
-| B) Create PR | 需要记录，团队审查 | `gh pr create` |
-| C) Squash merge | 多提交合并为一 | `gh pr merge --squash` |
-| D) Cleanup only | 工作被废弃 | `git branch -D` |
-
-## Merge Semantics
-
-- A) Fast-forward: 直接合并到 `main`
-- B) Create PR: 仅创建/更新 PR，不自动合并
-- C) Squash merge: 通过 PR squash 合并到 `main`
-- D) Cleanup only: 不合并，仅清理
-
-## Entry Gate
-
-1. **PRD.md, TECH_DESIGN.md, EPIC.md, TASKS.md** 存在
-2. **TEST_REPORT.md, SECURITY_REPORT.md** Gate 均为 PASS
-3. **Status**: `quality_complete`（兼容 `qa_complete`）或 `release_failed`
-4. **Git**: 当前在 feature/bugfix 分支；若工作区不干净，必须先按 `.claude/commands/util/git-commit.md` 完成提交（Conventional Commits + 按同类变更拆分）再继续
-
-## Execution Flow
-
-### Stage 1: Context Preparation
-
-收集元数据:
-- TITLE, branch, commits, changed files
-- coverage, security 状态
-- **Worktree 检测**: 判断是否在 worktree 中
-
-### Stage 2: Release Manager Agent
-
-调用 `release-manager` agent:
-- 生成 RELEASE_PLAN.md
-- 生成 PR 描述草稿
-
-### Stage 3: Commit Gate (MANDATORY)
-
-- 检查 `git status --porcelain`
-- 若存在未提交变更，必须先执行 `/util/git-commit`（规则文件 `.claude/commands/util/git-commit.md`）
-- 提交完成后再次确认工作区干净，再进入 PR 创建
-
-### Stage 4: PR Creation
-
-使用 `gh` CLI:
-- 标题: `${REQ_ID}: ${TITLE}`
-- 正文: agent 输出
-
-### Stage 5: Worktree/Branch Cleanup
-
-**Worktree 模式**:
 ```bash
-# 获取当前 worktree 信息
-CURRENT_WORKTREE=$(git rev-parse --show-toplevel)
-MAIN_REPO=$(get_main_repo_path)
-BRANCH_NAME=$(git rev-parse --abbrev-ref HEAD)
-
-# 切换到主仓库
-cd "$MAIN_REPO"
+/flow:release "REQ_ID" [--janitor-hours N]
+```
 
-# 合并 (PR 或 fast-forward)
-# ...
+- `janitor-hours` 默认 `72`
 
-# 删除 worktree
-git worktree remove "$CURRENT_WORKTREE"
+## Execution Steps
 
-# 删除分支
-git branch -d "$BRANCH_NAME"
-```
+1. 检查 `report-card.json`：
+   - `overall` 必须为 `pass`
+2. 运行发布：
 
-**分支模式**:
 ```bash
-# 切换到 main
-git checkout main
-
-# 合并
-git merge --ff-only "$BRANCH_NAME"
-
-# 删除分支
-git branch -d "$BRANCH_NAME"
+npm run harness:release -- --change-id "${REQ_ID}"
 ```
 
-### Stage 6: Exit Gate
-
-1. RELEASE_PLAN.md 存在
-2. PR 创建成功
-3. Status: `release_complete`
-4. Worktree 已清理 (如适用)
-
-## Output
+3. 运行熵清理：
 
+```bash
+npm run harness:janitor -- --hours ${HOURS}
 ```
-devflow/requirements/${REQ_ID}/
-├── RELEASE_PLAN.md
-└── orchestration_status.json (release_complete)
-
-GitHub:
-└── PR created with link
 
-Cleanup:
-└── Worktree removed (if applicable)
-```
+4. 验证输出：
+   - `devflow/requirements/${REQ_ID}/RELEASE_NOTE.md`
+   - `devflow/requirements/${REQ_ID}/harness-state.json` 中 `status == "released"`
 
-## Worktree Cleanup Notes
+## Exit Criteria
 
-- 清理前确保所有更改已提交并推送
-- 如果 PR 未合并，worktree 保留
-- 使用 `--keep-worktree` 标志可跳过清理
-- 清理失败不阻塞发布流程
+- 发布文件存在且状态为 released
+- janitor 执行成功
 
 ## Next Step
 
-1. 等待代码评审与 CI 通过
-2. 合并后更新主分支标签
-3. 可选: `/flow-verify` 复检
+- 进入 PR / merge 流程（仓库策略处理）

package/.claude/skills/workflow/flow-release/context.jsonl

@@ -1,7 +1,5 @@
-{"file": "devflow/requirements/{REQ}/PRD.md", "reason": "Product requirements"}
-{"file": "devflow/requirements/{REQ}/EPIC.md", "reason": "Epic overview"}
-{"file": "devflow/requirements/{REQ}/TASKS.md", "reason": "Task completion"}
-{"file": "devflow/requirements/{REQ}/TEST_REPORT.md", "reason": "Test results", "optional": true}
-{"file": "devflow/requirements/{REQ}/SECURITY_REPORT.md", "reason": "Security results", "optional": true}
-{"file": "devflow/requirements/{REQ}/quickstart.md", "reason": "Verification commands", "optional": true}
-{"file": ".claude/rules/project-constitution.md", "reason": "Quality rules"}
+{"file": "devflow/requirements/{REQ}/report-card.json", "reason": "Gate results before release"}
+{"file": "devflow/requirements/{REQ}/task-manifest.json", "reason": "Task completion summary"}
+{"file": "devflow/requirements/{REQ}/harness-state.json", "reason": "Lifecycle status", "optional": true}
+{"file": "devflow/requirements/{REQ}/RELEASE_NOTE.md", "reason": "Previous release note", "optional": true}
+{"file": ".claude/rules/project-constitution.md", "reason": "Quality rules and constraints"}