workflow-ledger 0.3.5 → 0.3.8

package/docs/cli.md

@@ -1,14 +1,14 @@
 # CLI
 
-`workflow-ledger` includes a small zero-dependency Bash CLI for project-local guardrails.
+`workflow-ledger` includes a Node.js CLI for setup, initialization, ledger checks, task summaries, and optional hook installation.
 
-The installer copies it to:
+The npm package exposes it as `workflow-ledger`. `setup --tool claude-code` also copies the same executable to:
 
 ```bash
-.claude/bin/workflow-ledger
+~/.claude/bin/workflow-ledger
 ```
 
-It does not modify your shell `PATH`.
+It does not modify your shell `PATH`; use `npx workflow-ledger ...` when you do not have the package installed globally.
 
 ## Commands
 
@@ -16,9 +16,12 @@ It does not modify your shell `PATH`.
 workflow-ledger setup --tool claude-code
 workflow-ledger setup --tool codex
 workflow-ledger setup --tool all
-workflow-ledger init --tool claude-code
-workflow-ledger init --tool codex
-workflow-ledger init --tool all
+workflow-ledger init
+workflow-ledger init --lang en
+workflow-ledger init --lang zh-CN
+workflow-ledger init --tool claude-code --lang en
+workflow-ledger init --tool codex --lang en
+workflow-ledger init --tool all --lang en
 workflow-ledger doctor
 workflow-ledger list
 workflow-ledger hooks status
@@ -29,22 +32,24 @@ workflow-ledger hooks install
 
 Installs global Workflow Ledger integrations for supported AI coding tools.
 
-- `--tool claude-code` installs the global Claude Code skill to `~/.claude/skills/workflow-ledger` and copies the local CLI to `~/.claude/bin/workflow-ledger`.
+- `--tool claude-code` installs the global Claude Code skill to `~/.claude/skills/workflow-ledger` and copies the Node CLI to `~/.claude/bin/workflow-ledger`.
 - `--tool codex` installs the Codex skill to `~/.agents/skills/workflow-ledger` when `~/.codex` exists.
 - `--tool all` configures all detected adapters.
 
-`setup` is environment-level and may skip tools that are not installed.
+`setup` is environment-level and may skip tools that are not installed. It only makes Workflow Ledger available; it does not activate the workflow in every project.
 
 ## `init`
 
-Creates project-local Workflow Ledger files for selected tools.
+Creates project-local Workflow Ledger files for selected tools. This is the activation step for a repository. Bare `init` asks for a language when run in a terminal; pass `--lang en` or `--lang zh-CN` for non-interactive use.
 
 - `--tool claude-code` creates `.claude/WORKFLOW.md` and updates `CLAUDE.md`.
 - `--tool codex` creates `.workflow-ledger/WORKFLOW.md` and updates `AGENTS.md`.
 - `--tool all` initializes both project adapters.
+- `--lang en` creates English ledger templates and instruction snippets.
+- `--lang zh-CN` creates Simplified Chinese ledger templates and instruction snippets.
 - `--root PATH` targets a project root other than the current directory.
 
-`init` preserves existing ledger files and instruction sections.
+`init` preserves existing ledger files and instruction sections. Without `init`, installed skills stay dormant for ordinary development work.
 
 ## `doctor`
 
@@ -80,8 +85,8 @@ If `.claude/WORKFLOW.md` is missing, `list` prints a message and exits `0`.
 Hooks are optional and advisory.
 
 ```bash
-.claude/bin/workflow-ledger hooks status
-.claude/bin/workflow-ledger hooks install
+workflow-ledger hooks status
+workflow-ledger hooks install
 ```
 
 `hooks install` writes these project-local hook files:

package/docs/design.md

@@ -33,7 +33,7 @@ The skill teaches Claude how to:
 
 ## Task levels
 
-- Level 0: Q&A/read-only, no ledger.
+- Level 0: Q&A/read-only/tagging or release-version publishing, no ledger.
 - Level 1: lightweight edit, ledger optional.
 - Level 2: standard code work, ledger required.
 - Level 3: complex work, ledger required and optional attachments allowed.

package/docs/design.zh-CN.md

@@ -35,7 +35,7 @@ skill 指导 Claude：
 
 ## 任务级别
 
-- Level 0：问答 / 只读解释，不需要 ledger。
+- Level 0：问答 / 只读解释 / 新增 tag 或发布版本，不需要 ledger。
 - Level 1：轻量修改，ledger 可选。
 - Level 2：标准代码任务，需要 ledger。
 - Level 3：复杂任务，需要 ledger，可选附件。

package/docs/usage.md

@@ -16,18 +16,21 @@ npx workflow-ledger setup --tool codex
 npx workflow-ledger setup --tool all
 ```
 
-Then initialize the project ledger from the project root:
+`setup` only installs the integration. It does not activate Workflow Ledger in every repository.
+
+Then initialize the project ledger from the project root. Bare `init` prompts for a language in an interactive terminal; automation can pass `--lang en` or `--lang zh-CN`:
 
 ```bash
 npx workflow-ledger init
-npx workflow-ledger init --tool claude-code
-npx workflow-ledger init --tool codex
-npx workflow-ledger init --tool all
+npx workflow-ledger init --lang en
+npx workflow-ledger init --tool claude-code --lang en
+npx workflow-ledger init --tool codex --lang en
+npx workflow-ledger init --tool all --lang en
 ```
 
-The `claude-code` project adapter creates `.claude/WORKFLOW.md` and updates `CLAUDE.md`. The `codex` project adapter creates `.workflow-ledger/WORKFLOW.md` and updates `AGENTS.md`.
+The `claude-code` project adapter creates `.claude/WORKFLOW.md` and updates `CLAUDE.md`. The `codex` project adapter creates `.workflow-ledger/WORKFLOW.md` and updates `AGENTS.md`. This `init` step activates Workflow Ledger for the repository. The language option controls newly created templates and instruction snippets.
 
-The Bash installer remains available:
+The Bash installer remains available. It uses the Node.js CLI internally, so Node.js 18 or newer is required:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/MorseWayne/workflow-ledger/main/install.sh | bash
@@ -68,16 +71,16 @@ workflow-ledger list
 workflow-ledger hooks status
 ```
 
-For Claude Code project-local installs, the copied CLI is also available:
+After `setup --tool claude-code`, the same executable is also available at:
 
 ```bash
-.claude/bin/workflow-ledger doctor
+~/.claude/bin/workflow-ledger doctor
 ```
 
 Install optional advisory hooks only when you want SessionStart reminders:
 
 ```bash
-.claude/bin/workflow-ledger hooks install
+workflow-ledger hooks install
 ```
 
 The CLI is a guardrail and summary tool. Claude still uses the `workflow-ledger` skill for the actual workflow.

package/docs/usage.zh-CN.md

@@ -18,18 +18,21 @@ npx workflow-ledger setup --tool codex
 npx workflow-ledger setup --tool all
 ```
 
-然后在项目根目录初始化 ledger：
+`setup` 只安装工具接入，不会让 Workflow Ledger 在所有仓库里自动生效。
+
+然后在项目根目录初始化 ledger。裸 `init` 会在交互式终端里询问语言；自动化脚本可传 `--lang en` 或 `--lang zh-CN`：
 
 ```bash
 npx workflow-ledger init
-npx workflow-ledger init --tool claude-code
-npx workflow-ledger init --tool codex
-npx workflow-ledger init --tool all
+npx workflow-ledger init --lang zh-CN
+npx workflow-ledger init --tool claude-code --lang zh-CN
+npx workflow-ledger init --tool codex --lang zh-CN
+npx workflow-ledger init --tool all --lang zh-CN
 ```
 
-`claude-code` 项目 adapter 会创建 `.claude/WORKFLOW.md` 并更新 `CLAUDE.md`。`codex` 项目 adapter 会创建 `.workflow-ledger/WORKFLOW.md` 并更新 `AGENTS.md`。
+`claude-code` 项目 adapter 会创建 `.claude/WORKFLOW.md` 并更新 `CLAUDE.md`。`codex` 项目 adapter 会创建 `.workflow-ledger/WORKFLOW.md` 并更新 `AGENTS.md`。这一步会在当前仓库启用 Workflow Ledger。语言选项控制新建模板和工具指令片段。
 
-Bash 安装脚本仍然可用：
+Bash 安装脚本仍然可用。它内部使用 Node.js CLI，因此需要 Node.js 18 或更高版本：
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/MorseWayne/workflow-ledger/main/install.sh | bash

package/examples/claude-project/CLAUDE.md.snippet

@@ -2,7 +2,8 @@
 
 Use `workflow-ledger` for recoverable development work.
 
-- Classify tasks before executing: Level 0 Q&A, Level 1 lightweight edit, Level 2 standard code work, Level 3 complex work.
+- Workflow Ledger is active only after project initialization. If `.claude/WORKFLOW.md` is missing, do not use this workflow for ordinary development work; run `npx workflow-ledger init` first.
+- Classify tasks before executing: Level 0 Q&A/read-only/release tagging, Level 1 lightweight edit, Level 2 standard code work, Level 3 complex work.
 - Maintain `.claude/WORKFLOW.md` for Level 2/3 tasks and for any task the user wants tracked across sessions.
 - Organize tracked work as resume state: `Intent`, mutable `Current todo`, `Prerequisites`, optional `Blocked by`, and one concrete `Resume next`.
 - Before closing work, move it to `Completed` with a short `Close summary`: outcome, validation, and gaps; failed validation means the task stays In Progress or Blocked.
@@ -15,4 +16,4 @@ Do not rationalize skipping the ledger:
 - “This is small” still requires Level classification; Level 2/3 work is tracked.
 - “I will update it later” is unsafe; update at material todo/scope changes, blockers, validation results, and handoff points.
 - TodoWrite is session-local; `.claude/WORKFLOW.md` is the durable recovery state.
-- Keep core fields stable so `.claude/bin/workflow-ledger doctor` can check the ledger.
+- Keep core fields stable so `workflow-ledger doctor` can check the ledger.

package/examples/claude-project/CLAUDE.zh-CN.md.snippet

@@ -0,0 +1,19 @@
+## Workflow Ledger
+
+使用 `workflow-ledger` 跟踪可恢复的开发工作。
+
+- Workflow Ledger 只有在项目初始化后才生效。如果缺少 `.claude/WORKFLOW.md`，不要把普通开发任务套用到此工作流；先运行 `npx workflow-ledger init`。
+- 执行前先分级：Level 0 问答/只读/发布 tag，Level 1 轻量编辑，Level 2 标准代码工作，Level 3 复杂工作。
+- Level 2/3 任务，以及用户希望跨会话跟踪的任务，都维护在 `.claude/WORKFLOW.md` 中。
+- 被跟踪的工作只记录恢复状态：`Intent`、可变的 `Current todo`、`Prerequisites`、可选的 `Blocked by`，以及一个具体的 `Resume next`。
+- 关闭工作前，把任务移到 `Completed`，写简短 `Close summary`：outcome、validation、gaps；验证失败时任务保持 In Progress 或 Blocked。
+- 记录依赖和发现的未来任务；先完成阻塞当前工作的前置条件，把非阻塞发现延后到 Backlog/Future。
+- 当前会话执行用 TodoWrite；里程碑历史和恢复点用 `.claude/WORKFLOW.md`。
+- 不要创建附件或额外 spec 文件，除非 Level 3 工作确实需要，或用户明确要求。
+
+不要找理由跳过 ledger：
+
+- “这个很小”仍然需要分级；Level 2/3 工作必须跟踪。
+- “我之后再更新”不安全；在重要待办/范围变化、阻塞、验证结果和交接点更新。
+- TodoWrite 是会话本地状态；`.claude/WORKFLOW.md` 是持久恢复状态。
+- 保持核心字段稳定，让 `workflow-ledger doctor` 能检查 ledger。

package/examples/codex-project/AGENTS.md.snippet

@@ -2,6 +2,7 @@
 
 Use Workflow Ledger as shared resume state for Codex sessions.
 
+- Workflow Ledger is active only after project initialization. If `.workflow-ledger/WORKFLOW.md` is missing, do not use this workflow for ordinary development work; run `npx workflow-ledger init --tool codex` first.
 - Read `.workflow-ledger/WORKFLOW.md` before resuming tracked work.
 - Track Level 2/3 or cross-session tasks in `.workflow-ledger/WORKFLOW.md`.
 - Keep the ledger short: current work, progress, and one concrete `Resume next` action.

package/examples/codex-project/AGENTS.zh-CN.md.snippet

@@ -0,0 +1,12 @@
+# Workflow Ledger
+
+把 Workflow Ledger 作为 Codex 会话共享的恢复状态。
+
+- Workflow Ledger 只有在项目初始化后才生效。如果缺少 `.workflow-ledger/WORKFLOW.md`，不要把普通开发任务套用到此工作流；先运行 `npx workflow-ledger init --tool codex`。
+- 恢复被跟踪的工作前，先读取 `.workflow-ledger/WORKFLOW.md`。
+- Level 2/3 或跨会话任务记录在 `.workflow-ledger/WORKFLOW.md`。
+- 保持 ledger 简短：当前工作、进展，以及一个具体的 `Resume next` 动作。
+- 默认只有一个 Active 任务；不确定的后续事项放到 Backlog/Future。
+- 使用 `Intent`、可变的 `Current todo`、`Prerequisites`、可选的 `Blocked by`，以及一个具体的 `Resume next`。
+- 关闭工作前记录简短 `Close summary`：outcome、validation、gaps。
+- 不要把完整命令输出、原始工具 JSON、详细 diff 或临时推理粘进 ledger。

package/install.sh

@@ -3,7 +3,6 @@ set -euo pipefail
 
 REPO_URL="https://github.com/MorseWayne/workflow-ledger"
 ARCHIVE_URL="https://github.com/MorseWayne/workflow-ledger/archive/refs/heads/main.tar.gz"
-MARKER="## Workflow Ledger"
 TARGET_DIR="${1:-$PWD}"
 
 TARGET_DIR="$(cd "$TARGET_DIR" && pwd)"
@@ -22,7 +21,7 @@ cleanup() {
 trap cleanup EXIT
 
 SOURCE_DIR="$SCRIPT_DIR"
-if [ ! -d "$SOURCE_DIR/skills/workflow-ledger" ] || [ ! -f "$SOURCE_DIR/examples/claude-project/CLAUDE.md.snippet" ] || [ ! -f "$SOURCE_DIR/bin/workflow-ledger" ]; then
+if [ ! -d "$SOURCE_DIR/skills/workflow-ledger" ] || [ ! -f "$SOURCE_DIR/examples/claude-project/CLAUDE.md.snippet" ] || [ ! -f "$SOURCE_DIR/bin/workflow-ledger.js" ]; then
   if ! command -v curl >/dev/null 2>&1; then
     echo "error: curl is required when install.sh is run outside a workflow-ledger checkout" >&2
     exit 1
@@ -37,39 +36,13 @@ if [ ! -d "$SOURCE_DIR/skills/workflow-ledger" ] || [ ! -f "$SOURCE_DIR/examples
   SOURCE_DIR="$cleanup_dir/workflow-ledger-main"
 fi
 
-if command -v node >/dev/null 2>&1 && [ -f "$SOURCE_DIR/bin/workflow-ledger.js" ]; then
-  node "$SOURCE_DIR/bin/workflow-ledger.js" init --tool claude-code --root "$TARGET_DIR"
-else
-  mkdir -p "$TARGET_DIR/.claude/skills" "$TARGET_DIR/.claude" "$TARGET_DIR/.claude/bin"
-  rm -rf "$TARGET_DIR/.claude/skills/workflow-ledger"
-  cp -R "$SOURCE_DIR/skills/workflow-ledger" "$TARGET_DIR/.claude/skills/workflow-ledger"
-  cp "$SOURCE_DIR/bin/workflow-ledger" "$TARGET_DIR/.claude/bin/workflow-ledger"
-  chmod +x "$TARGET_DIR/.claude/bin/workflow-ledger"
-
-  if [ ! -f "$TARGET_DIR/.claude/WORKFLOW.md" ]; then
-    cp "$SOURCE_DIR/skills/workflow-ledger/templates/WORKFLOW.md" "$TARGET_DIR/.claude/WORKFLOW.md"
-    echo "created .claude/WORKFLOW.md"
-  else
-    echo "kept existing .claude/WORKFLOW.md"
-  fi
-
-  if [ ! -f "$TARGET_DIR/CLAUDE.md" ]; then
-    touch "$TARGET_DIR/CLAUDE.md"
-  fi
-
-  if grep -Fq "$MARKER" "$TARGET_DIR/CLAUDE.md"; then
-    echo "kept existing Workflow Ledger section in CLAUDE.md"
-  else
-    if [ -s "$TARGET_DIR/CLAUDE.md" ]; then
-      printf '\n\n' >> "$TARGET_DIR/CLAUDE.md"
-    fi
-    cat "$SOURCE_DIR/examples/claude-project/CLAUDE.md.snippet" >> "$TARGET_DIR/CLAUDE.md"
-    echo "updated CLAUDE.md"
-  fi
-
-  echo "installed workflow-ledger for Claude Code"
+if ! command -v node >/dev/null 2>&1; then
+  echo "error: workflow-ledger requires Node.js 18 or newer" >&2
+  exit 1
 fi
 
+node "$SOURCE_DIR/bin/workflow-ledger.js" init --tool claude-code --root "$TARGET_DIR"
+
 echo "installed workflow-ledger into $TARGET_DIR"
 echo "next: run /workflow-ledger start \"your task\" in Claude Code"
-echo "optional: run .claude/bin/workflow-ledger doctor"
+echo "optional: run npx workflow-ledger doctor"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "workflow-ledger",
-  "version": "0.3.5",
+  "version": "0.3.8",
   "description": "Lightweight, recoverable workflow ledger for AI coding agents.",
   "license": "MIT",
   "repository": {

package/skills/workflow-ledger/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: workflow-ledger
-description: Lightweight OpenSpec-style change ledger for Claude Code. Use when starting, resuming, updating, closing, or reviewing multi-step code work; when todos may change during implementation; when the user wants traceability without heavyweight specs; or when a task may be interrupted and continued later.
-when_to_use: Use for development tasks that need mutable todo tracking, prerequisites, blockers, deferred follow-ups, or cross-session recovery. Skip for pure Q&A and trivial one-step edits unless the user requests tracking. Trigger phrases include "start task", "resume task", "update", "close", "workflow", "ledger", "recover", "continue previous task", "what is left", "review progress".
+description: Lightweight OpenSpec-style change ledger for Claude Code. Active only in projects initialized with workflow-ledger init, or when the user explicitly asks to initialize/setup/install Workflow Ledger.
+when_to_use: Use for development tasks that need mutable todo tracking, prerequisites, blockers, deferred follow-ups, or cross-session recovery only when `.claude/WORKFLOW.md` already exists. If the project is not initialized, do not manage work with this skill; only explain how to run `npx workflow-ledger init`. Skip for pure Q&A and trivial one-step edits unless the user requests tracking. Trigger phrases include "start task", "resume task", "update", "close", "workflow", "ledger", "recover", "continue previous task", "what is left", "review progress", "init workflow-ledger", "setup workflow-ledger".
 argument-hint: start|resume|update|close [task]
 ---
 
@@ -11,6 +11,12 @@ Use this skill to keep development work recoverable without turning progress not
 
 ## Core rule
 
+Activation is explicit. This skill must not manage ordinary development work until the current project has been initialized with Workflow Ledger. Before starting, resuming, updating, or closing tracked work, check for `.claude/WORKFLOW.md`.
+
+- If `.claude/WORKFLOW.md` exists, the project is initialized; follow this skill normally.
+- If `.claude/WORKFLOW.md` is missing and the user asked to initialize, install, or set up Workflow Ledger, guide them to run `npx workflow-ledger init` or the installer.
+- If `.claude/WORKFLOW.md` is missing and the user asked for unrelated development work, do not create a ledger, do not classify the task with this workflow, and do not apply this skill beyond saying the project is not initialized.
+
 Maintain one project overview file at `.claude/WORKFLOW.md` for Level 2/3 work and for any task the user wants tracked. The ledger is compressed resume state: it should answer what the active change is, what changed during execution, what is blocking or required next, and the one next action to take.
 
 Do not use the ledger for full operation logs, detailed diffs, raw GitNexus output, complete test output, temporary reasoning, or unrelated cleanup notes.
@@ -33,7 +39,7 @@ For project-local use, the installer configures all three pieces:
 
 Classify first. If uncertain, choose the lighter level unless risk appears.
 
-- **Level 0 — Q&A / read-only**: explain, answer, inspect without edits. No ledger required.
+- **Level 0 — Q&A / read-only / release bookkeeping**: explain, answer, inspect without edits, create tags, or publish release versions. No ledger required.
 - **Level 1 — lightweight edit**: typo, docs tweak, formatting, tiny config, no runtime behavior change. Ledger optional.
 - **Level 2 — standard code work**: small bugfix, single-module behavior change, tests, provider logic, repeatable multi-step work. Use ledger.
 - **Level 3 — complex work**: new feature, cross-module or cross-repo changes, public API/data model changes, auth/streaming/concurrency/metrics, unclear requirements, high-risk impact. Use ledger and add attachments only when the ledger would otherwise become too long.
@@ -48,7 +54,7 @@ Escalate when you discover cross-file behavior changes, public API changes, fail
 - Do not rewrite `Completed` history except to fix an obvious error.
 - Do not do cross-task cleanup while updating one task.
 - Keep each Active task under roughly 80 lines.
-- Move short-lived release, cleanup, and index-refresh tasks to `Completed` as soon as they finish.
+- If a short-lived release, cleanup, or index-refresh task is already tracked, move it to `Completed` as soon as it finishes.
 
 ## Ledger structure
 
@@ -116,7 +122,7 @@ Do not move non-blocking discoveries into `Current todo:` just because they were
 
 ## Start a tracked task
 
-1. Locate or create `.claude/WORKFLOW.md` using [templates/WORKFLOW.md](templates/WORKFLOW.md).
+1. Locate `.claude/WORKFLOW.md`. If it is missing, stop and ask the user to run `npx workflow-ledger init`; do not create it implicitly.
 2. Create one `Active` task entry.
 3. Classify Level 0-3.
 4. Write the smallest `Intent:`.

package/skills/workflow-ledger/templates/WORKFLOW.zh-CN.md

@@ -0,0 +1,50 @@
+# Workflow Ledger
+
+Claude Code 开发工作的轻量级可恢复台账。
+
+## Active
+
+<!-- workflow-ledger:task
+id: WF-YYYY-MM-DD-001
+level: 2
+status: In Progress
+current_phase: 当前焦点
+updated: YYYY-MM-DD
+-->
+
+### WF-YYYY-MM-DD-001 — 任务标题
+Status: In Progress
+Level: 2
+Started: YYYY-MM-DD
+Last updated: YYYY-MM-DD
+Current phase: 当前焦点
+
+Intent:
+- 一个用户可见的目标或变更意图。
+
+Current todo:
+- [ ] 可随发现调整的下一步事项。
+
+Changes:
+- 记录会影响恢复上下文的范围、待办、前置条件或阻塞变化。
+
+Prerequisites:
+- 继续当前工作前必须满足的条件，或 None。
+
+Resume next:
+- 一个具体的下一步动作。
+
+## Backlog / Future
+
+- [ ] 当前任务范围外发现的未来事项 — 因为不阻塞当前意图而延后。
+
+## Completed
+
+### WF-YYYY-MM-DD-000 — 已完成任务标题
+Completed: YYYY-MM-DD
+Level: 1
+
+Close summary:
+- Outcome: 用户可见结果。
+- Validation: 已执行的检查。
+- Gaps: 剩余后续事项或 none。

package/templates/WORKFLOW.zh-CN.md

@@ -0,0 +1,50 @@
+# Workflow Ledger
+
+AI coding agent 共享的可恢复状态台账。
+
+## Active
+
+<!-- workflow-ledger:task
+id: WF-YYYY-MM-DD-001
+level: 2
+status: In Progress
+current_phase: 当前焦点
+updated: YYYY-MM-DD
+-->
+
+### WF-YYYY-MM-DD-001 — 任务标题
+Status: In Progress
+Level: 2
+Started: YYYY-MM-DD
+Last updated: YYYY-MM-DD
+Current phase: 当前焦点
+
+Intent:
+- 一个用户可见的目标或变更意图。
+
+Current todo:
+- [ ] 可随发现调整的下一步事项。
+
+Changes:
+- 记录会影响恢复上下文的范围、待办、前置条件或阻塞变化。
+
+Prerequisites:
+- 继续当前工作前必须满足的条件，或 None。
+
+Resume next:
+- 一个具体的下一步动作。
+
+## Backlog / Future
+
+- [ ] 当前任务范围外发现的未来事项 — 因为不阻塞当前意图而延后。
+
+## Completed
+
+### WF-YYYY-MM-DD-000 — 已完成任务标题
+Completed: YYYY-MM-DD
+Level: 1
+
+Close summary:
+- Outcome: 用户可见结果。
+- Validation: 已执行的检查。
+- Gaps: 剩余后续事项或 none。