ccjk 1.3.3 → 1.3.5

package/README.md

@@ -23,13 +23,15 @@
 
 <br/>
 
-## 🎉 v1.3.1 Released! (January 2025)
+## 🎉 v1.3.4 Released! (January 2025)
 
-> **Complete Rebranding: ZCF → CCJK**
-> - 🔄 All references updated from ZCF to CCJK
-> - 🚀 New brand: **CCJK - Claude Code Jailbreak Kit**
-> - ⬆️ Existing users: Run `ccjk upgrade` to update!
-> - 🔧 Fixed install script version detection
+> **🆕 Workflow System Upgrade**
+> - 🌟 **Interview-Driven Development (IDD)** - Now the recommended workflow!
+> - 📋 Streamlined workflow menu with 5 clear options
+> - 🔧 New essential workflow templates
+> - 🌐 Updated i18n support (EN/ZH-CN)
+>
+> **Previous: Complete Rebranding ZCF → CCJK**
 
 <br/>
 
@@ -116,7 +118,7 @@ When you run `ccjk`, you'll see a friendly menu:
 ║   ██████╗ ██████╗     ██╗██╗  ██╗                         ║
 ║  ██╔════╝██╔════╝     ██║██║ ██╔╝                         ║
 ║  ██║     ██║          ██║█████╔╝   Claude Code JinKu     ║
-║  ██║     ██║     ██   ██║██╔═██╗   v1.3.1                ║
+║  ██║     ██║     ██   ██║██╔═██╗   v1.3.4                ║
 ║  ╚██████╗╚██████╗╚█████╔╝██║  ██╗                         ║
 ║   ╚═════╝ ╚═════╝ ╚════╝ ╚═╝  ╚═╝                         ║
 ╚═══════════════════════════════════════════════════════════╝

package/README.zh-CN.md

@@ -22,13 +22,15 @@
 
 <br/>
 
-## 🎉 v1.3.1 发布！(2025年1月)
+## 🎉 v1.3.4 发布！(2025年1月)
 
-> **品牌全面升级：ZCF → CCJK**
-> - 🔄 所有 ZCF 引用已更新为 CCJK
-> - 🚀 新品牌：**CCJK - Claude Code 锦库**
-> - ⬆️ 已安装用户：运行 `ccjk upgrade` 即可升级！
-> - 🔧 修复安装脚本版本检测问题
+> **🆕 工作流系统升级**
+> - 🌟 **访谈驱动开发 (IDD)** - 现已成为推荐首选工作流！
+> - 📋 精简工作流菜单，5个清晰选项
+> - 🔧 新增必备工作流模板
+> - 🌐 更新国际化支持 (中/英)
+>
+> **上一版本: 品牌全面升级 ZCF → CCJK**
 
 <br/>
 
@@ -110,7 +112,7 @@ npx ccjk
 ║   ██████╗ ██████╗     ██╗██╗  ██╗                         ║
 ║  ██╔════╝██╔════╝     ██║██║ ██╔╝                         ║
 ║  ██║     ██║          ██║█████╔╝   Claude Code 锦库      ║
-║  ██║     ██║     ██   ██║██╔═██╗   v1.3.2                ║
+║  ██║     ██║     ██   ██║██╔═██╗   v1.3.4                ║
 ║  ╚██████╗╚██████╗╚█████╔╝██║  ██╗                         ║
 ║   ╚═════╝ ╚═════╝ ╚════╝ ╚═╝  ╚═╝                         ║
 ╚═══════════════════════════════════════════════════════════╝

package/dist/chunks/simple-config.mjs

@@ -20,7 +20,7 @@ import trash from 'trash';
 import i18next from 'i18next';
 import Backend from 'i18next-fs-backend';
 
-const version = "1.3.3";
+const version = "1.3.5";
 const homepage = "https://github.com/miounet11/ccjk";
 
 const i18n = i18next.createInstance();
@@ -285,45 +285,34 @@ async function getMcpServices() {
 
 const WORKFLOW_CONFIG_BASE = [
   {
-    id: "commonTools",
+    id: "interviewWorkflow",
     defaultSelected: true,
     order: 1,
-    commands: ["init-project.md"],
-    agents: [
-      { id: "init-architect", filename: "init-architect.md", required: true },
-      { id: "get-current-datetime", filename: "get-current-datetime.md", required: true }
-    ],
-    autoInstallAgents: true,
-    category: "common",
-    outputDir: "common"
-  },
-  {
-    id: "sixStepsWorkflow",
-    defaultSelected: true,
-    order: 2,
-    commands: ["workflow.md"],
+    commands: ["interview.md"],
     agents: [],
     autoInstallAgents: false,
-    category: "sixStep",
-    outputDir: "workflow"
+    category: "interview",
+    outputDir: "interview"
   },
   {
-    id: "featPlanUx",
+    id: "essentialTools",
     defaultSelected: true,
-    order: 3,
-    commands: ["feat.md"],
+    order: 2,
+    commands: ["init-project.md", "feat.md"],
     agents: [
+      { id: "init-architect", filename: "init-architect.md", required: true },
+      { id: "get-current-datetime", filename: "get-current-datetime.md", required: true },
       { id: "planner", filename: "planner.md", required: true },
       { id: "ui-ux-designer", filename: "ui-ux-designer.md", required: true }
     ],
     autoInstallAgents: true,
-    category: "plan",
-    outputDir: "feat"
+    category: "essential",
+    outputDir: "essential"
   },
   {
     id: "gitWorkflow",
     defaultSelected: true,
-    order: 4,
+    order: 3,
     commands: ["git-commit.md", "git-rollback.md", "git-cleanBranches.md", "git-worktree.md"],
     agents: [],
     autoInstallAgents: false,
@@ -331,43 +320,28 @@ const WORKFLOW_CONFIG_BASE = [
     outputDir: "git"
   },
   {
-    id: "bmadWorkflow",
-    defaultSelected: true,
-    order: 5,
-    commands: ["bmad-init.md"],
-    agents: [],
-    autoInstallAgents: false,
-    category: "bmad",
-    outputDir: "bmad"
-  },
-  {
-    id: "interviewWorkflow",
-    defaultSelected: true,
-    order: 6,
-    commands: ["interview.md"],
+    id: "sixStepsWorkflow",
+    defaultSelected: false,
+    order: 4,
+    commands: ["workflow.md"],
     agents: [],
     autoInstallAgents: false,
-    category: "interview",
-    outputDir: "interview"
+    category: "sixStep",
+    outputDir: "workflow"
   }
 ];
 function getWorkflowConfigs() {
   ensureI18nInitialized();
   const workflowTranslations = [
     {
-      id: "commonTools",
-      name: i18n.t("workflow:workflowOption.commonTools"),
-      description: i18n.t("workflow:workflowDescription.commonTools")
-    },
-    {
-      id: "sixStepsWorkflow",
-      name: i18n.t("workflow:workflowOption.sixStepsWorkflow"),
-      description: i18n.t("workflow:workflowDescription.sixStepsWorkflow")
+      id: "interviewWorkflow",
+      name: i18n.t("workflow:workflowOption.interviewWorkflow"),
+      description: i18n.t("workflow:workflowDescription.interviewWorkflow")
     },
     {
-      id: "featPlanUx",
-      name: i18n.t("workflow:workflowOption.featPlanUx"),
-      description: i18n.t("workflow:workflowDescription.featPlanUx")
+      id: "essentialTools",
+      name: i18n.t("workflow:workflowOption.essentialTools"),
+      description: i18n.t("workflow:workflowDescription.essentialTools")
     },
     {
       id: "gitWorkflow",
@@ -375,14 +349,9 @@ function getWorkflowConfigs() {
       description: i18n.t("workflow:workflowDescription.gitWorkflow")
     },
     {
-      id: "bmadWorkflow",
-      name: i18n.t("workflow:workflowOption.bmadWorkflow"),
-      description: i18n.t("workflow:workflowDescription.bmadWorkflow")
-    },
-    {
-      id: "interviewWorkflow",
-      name: i18n.t("workflow:workflowOption.interviewWorkflow"),
-      description: i18n.t("workflow:workflowDescription.interviewWorkflow")
+      id: "sixStepsWorkflow",
+      name: i18n.t("workflow:workflowOption.sixStepsWorkflow"),
+      description: i18n.t("workflow:workflowDescription.sixStepsWorkflow")
     }
   ];
   return WORKFLOW_CONFIG_BASE.map((baseConfig) => {
@@ -6661,11 +6630,10 @@ async function installWorkflowWithDependencies(config, configLang) {
     errors: []
   };
   const WORKFLOW_OPTION_KEYS = {
-    commonTools: i18n.t("workflow:workflowOption.commonTools"),
+    essentialTools: i18n.t("workflow:workflowOption.essentialTools"),
     sixStepsWorkflow: i18n.t("workflow:workflowOption.sixStepsWorkflow"),
-    featPlanUx: i18n.t("workflow:workflowOption.featPlanUx"),
     gitWorkflow: i18n.t("workflow:workflowOption.gitWorkflow"),
-    bmadWorkflow: i18n.t("workflow:workflowOption.bmadWorkflow")
+    interviewWorkflow: i18n.t("workflow:workflowOption.interviewWorkflow")
   };
   const workflowName = WORKFLOW_OPTION_KEYS[config.id] || config.id;
   console.log(ansis.cyan(`
@@ -6744,10 +6712,6 @@ async function installWorkflowWithDependencies(config, configLang) {
   }
   if (result.success) {
     console.log(ansis.green(`\u2714 ${workflowName} ${i18n.t("workflow:workflowInstallSuccess")}`));
-    if (config.id === "bmadWorkflow") {
-      console.log(ansis.cyan(`
-${i18n.t("workflow:bmadInitPrompt")}`));
-    }
   } else {
     console.log(ansis.red(`\u2717 ${workflowName} ${i18n.t("workflow:workflowInstallError")}`));
   }

package/dist/i18n/locales/en/workflow.json

@@ -1,5 +1,4 @@
 {
-  "bmadInitPrompt": "✨ Please run /bmad-init command in your project to initialize or update BMAD-Method extension",
   "cleaningOldFiles": "Cleaning up old version files",
   "failedToInstallAgent": "Failed to install agent",
   "failedToInstallCommand": "Failed to install command",
@@ -8,18 +7,14 @@
   "installingWorkflow": "Installing workflow",
   "removedOldFile": "Removed old file",
   "selectWorkflowType": "Select workflow type to install",
-  "workflowDescription.bmadWorkflow": "BMAD-Method enterprise-grade agile development workflow extension",
-  "workflowDescription.commonTools": "Provides project initialization and architecture analysis tools, including hierarchical directory initialization commands and intelligent architecture analysis agents",
-  "workflowDescription.featPlanUx": "Feature planning and user experience design workflow with planning and UX design agents",
-  "workflowDescription.gitWorkflow": "Git version control related commands collection",
-  "workflowDescription.interviewWorkflow": "Interview-Driven Development - Surface hidden assumptions before coding by asking 40+ deep questions",
-  "workflowDescription.sixStepsWorkflow": "Professional development assistant structured six-step workflow",
+  "workflowDescription.essentialTools": "Complete toolchain for project initialization, architecture analysis, feature planning and UX design with multiple intelligent agents",
+  "workflowDescription.gitWorkflow": "Git version control commands collection supporting conventional commits, rollback, branch cleanup and worktree management",
+  "workflowDescription.interviewWorkflow": "Surface hidden assumptions before coding with 40+ deep questions, generate complete specifications to ensure project direction",
+  "workflowDescription.sixStepsWorkflow": "Professional development assistant structured six-step workflow, suitable for projects requiring strict process control",
   "workflowInstallError": "workflow installation had errors",
   "workflowInstallSuccess": "workflow installed successfully",
-  "workflowOption.bmadWorkflow": "BMAD-Method Extension Installer (Agile Development Workflow)",
-  "workflowOption.commonTools": "Common Tools (Hierarchical Directory Initialization + General-purpose agents)",
-  "workflowOption.featPlanUx": "Feature Planning and UX Design (feat + planner + ui-ux-designer)",
-  "workflowOption.gitWorkflow": "Git Commands (commit + rollback + cleanBranches + worktree)",
-  "workflowOption.interviewWorkflow": "Interview-Driven Development (Based on Anthropic Thariq's Workflow)",
-  "workflowOption.sixStepsWorkflow": "Six Steps Workflow (workflow)"
+  "workflowOption.essentialTools": "Essential Tools (Project Init + Feature Planning + UX Design)",
+  "workflowOption.gitWorkflow": "Git Workflow (commit + rollback + cleanBranches + worktree)",
+  "workflowOption.interviewWorkflow": "🌟 Interview-Driven Development (Recommended - Based on Anthropic Thariq's Workflow)",
+  "workflowOption.sixStepsWorkflow": "Six-Step Workflow (Structured Development Process)"
 }

package/dist/i18n/locales/zh-CN/workflow.json

@@ -1,5 +1,4 @@
 {
-  "bmadInitPrompt": "✨ 请在项目中运行 /bmad-init 命令来初始化或更新 BMAD-Method 扩展",
   "cleaningOldFiles": "清理旧版本文件",
   "failedToInstallAgent": "安装代理失败",
   "failedToInstallCommand": "安装命令失败",
@@ -8,18 +7,14 @@
   "installingWorkflow": "正在安装工作流",
   "removedOldFile": "已删除旧文件",
   "selectWorkflowType": "选择要安装的工作流类型",
-  "workflowDescription.bmadWorkflow": "BMAD-Method 企业级敏捷开发工作流扩展",
-  "workflowDescription.commonTools": "提供项目初始化和架构分析工具，包含层级目录初始化命令和智能架构分析代理",
-  "workflowDescription.featPlanUx": "功能规划和用户体验设计工作流，包含规划代理和 UX 设计代理",
-  "workflowDescription.gitWorkflow": "Git 版本控制相关命令集合",
-  "workflowDescription.interviewWorkflow": "访谈驱动开发 - 通过40+深度问题在编码前发现隐藏假设",
-  "workflowDescription.sixStepsWorkflow": "专业开发助手的结构化六步工作流程",
+  "workflowDescription.essentialTools": "提供项目初始化、架构分析、功能规划和UX设计的完整工具链，包含多个智能代理",
+  "workflowDescription.gitWorkflow": "Git 版本控制命令集合，支持规范化提交、回滚、分支清理和工作树管理",
+  "workflowDescription.interviewWorkflow": "通过40+深度问题在编码前发现隐藏假设，生成完整规格说明书，确保项目方向正确",
+  "workflowDescription.sixStepsWorkflow": "专业开发助手的结构化六步工作流程，适合需要严格流程控制的项目",
   "workflowInstallError": "工作流安装出错",
   "workflowInstallSuccess": "工作流安装成功",
-  "workflowOption.bmadWorkflow": "BMAD-Method 扩展安装器 (支持敏捷开发工作流)",
-  "workflowOption.commonTools": "通用工具 (层级目录初始化 + 通用agents)",
-  "workflowOption.featPlanUx": "功能规划和 UX 设计 (feat + planner + ui-ux-designer)",
-  "workflowOption.gitWorkflow": "Git 指令 (commit + rollback + cleanBranches + worktree)",
-  "workflowOption.interviewWorkflow": "访谈驱动开发 (基于 Anthropic Thariq 的工作流)",
-  "workflowOption.sixStepsWorkflow": "六步工作流 (workflow)"
+  "workflowOption.essentialTools": "必备工具集 (项目初始化 + 功能规划 + UX设计)",
+  "workflowOption.gitWorkflow": "Git 工作流 (commit + rollback + cleanBranches + worktree)",
+  "workflowOption.interviewWorkflow": "🌟 访谈驱动开发 (推荐 - 基于 Anthropic Thariq 的创新工作流)",
+  "workflowOption.sixStepsWorkflow": "六步工作流 (结构化开发流程)"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ccjk",
   "type": "module",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "packageManager": "pnpm@10.17.1",
   "description": "Claude Code JinKu - Advanced AI-powered development assistant with skills, agents, and LLM-driven audit",
   "author": {
@@ -120,47 +120,47 @@
     "docs:preview": "pnpm -F @ccjk/docs preview"
   },
   "dependencies": {
-    "@types/semver": "catalog:types",
-    "ansis": "catalog:cli",
-    "cac": "catalog:cli",
-    "dayjs": "catalog:runtime",
-    "find-up-simple": "catalog:runtime",
-    "fs-extra": "catalog:runtime",
-    "i18next": "catalog:runtime",
-    "i18next-fs-backend": "catalog:runtime",
-    "inquirer": "catalog:cli",
-    "inquirer-toggle": "catalog:cli",
-    "ora": "catalog:cli",
-    "pathe": "catalog:runtime",
-    "semver": "catalog:runtime",
-    "smol-toml": "catalog:runtime",
-    "tinyexec": "catalog:runtime",
-    "trash": "catalog:runtime"
+    "@types/semver": "^7.7.1",
+    "ansis": "^4.1.0",
+    "cac": "^6.7.14",
+    "dayjs": "^1.11.18",
+    "find-up-simple": "^1.0.1",
+    "fs-extra": "^11.3.2",
+    "i18next": "^25.5.2",
+    "i18next-fs-backend": "^2.6.0",
+    "inquirer": "^12.9.6",
+    "inquirer-toggle": "^1.0.1",
+    "ora": "^9.0.0",
+    "pathe": "^2.0.3",
+    "semver": "^7.7.2",
+    "smol-toml": "^1.4.2",
+    "tinyexec": "^1.0.1",
+    "trash": "^10.0.0"
   },
   "devDependencies": {
-    "@antfu/eslint-config": "catalog:build",
-    "@changesets/cli": "catalog:tooling",
-    "@commitlint/cli": "catalog:tooling",
-    "@commitlint/config-conventional": "catalog:tooling",
-    "@commitlint/types": "catalog:tooling",
-    "@types/fs-extra": "catalog:types",
-    "@types/inquirer": "catalog:types",
-    "@types/node": "catalog:types",
-    "@vitest/coverage-v8": "catalog:testing",
-    "@vitest/ui": "catalog:testing",
-    "eslint": "catalog:build",
-    "eslint-plugin-format": "catalog:build",
-    "glob": "catalog:testing",
-    "husky": "catalog:tooling",
-    "lint-staged": "catalog:tooling",
-    "tsx": "catalog:build",
-    "typescript": "catalog:build",
-    "unbuild": "catalog:build",
-    "vitest": "catalog:testing"
+    "@antfu/eslint-config": "^5.4.1",
+    "@changesets/cli": "^2.29.7",
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@commitlint/types": "^19.8.1",
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^22.18.6",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
+    "eslint": "^9.36.0",
+    "eslint-plugin-format": "^1.0.2",
+    "glob": "^11.0.3",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.0",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2",
+    "unbuild": "^3.6.1",
+    "vitest": "^3.2.4"
   },
   "lint-staged": {
     "*": [
       "pnpm lint"
     ]
   }
-}
+}

package/templates/claude-code/en/workflow/essential/agents/get-current-datetime.md

@@ -0,0 +1,29 @@
+---
+name: get-current-datetime
+description: Execute date command and return ONLY the raw output. No formatting, headers, explanations, or parallel agents.
+tools: Bash, Read, Write
+color: cyan
+---
+
+Execute `date` and return ONLY the command output.
+
+```bash
+date +'%Y-%m-%d %H:%M:%S'
+```
+
+DO NOT add any text, headers, formatting, or explanations.
+DO NOT add markdown formatting or code blocks.
+DO NOT add "Current date and time is:" or similar phrases.
+DO NOT use parallel agents.
+
+Just return the raw bash command output exactly as it appears.
+
+Example response: `2025-07-28 23:59:42`
+
+Format options if requested:
+
+- Filename: Add `+"%Y-%m-%d_%H%M%S"`
+- Readable: Add `+"%Y-%m-%d %H:%M:%S %Z"`
+- ISO: Add `+"%Y-%m-%dT%H:%M:%S%z"`
+
+Use the get-current-datetime agent to get accurate timestamps instead of manually writing time information.

package/templates/claude-code/en/workflow/essential/agents/init-architect.md

@@ -0,0 +1,114 @@
+---
+name: init-architect
+description: Adaptive initialization: concise at root + detailed at module level; staged traversal with coverage reporting
+tools: Read, Write, Glob, Grep
+color: orange
+---
+
+# Initialization Architect (Adaptive Version)
+
+> No exposed parameters; internal adaptive three levels: quick summary / module scanning / deep supplementation. Ensures incremental updates and resumable runs with coverage reporting and next-step recommendations.
+
+## I. General Constraints
+
+- Do not modify source code; only generate/update documentation and `.claude/index.json`.
+- **Ignore Rules Retrieval Strategy**:
+  1. Prioritize reading the `.gitignore` file from the project root directory
+  2. If `.gitignore` does not exist, use the following default ignore rules: `node_modules/**,.git/**,.github/**,dist/**,build/**,.next/**,__pycache__/**,*.lock,*.log,*.bin,*.pdf,*.png,*.jpg,*.jpeg,*.gif,*.mp4,*.zip,*.tar,*.gz`
+  3. Merge ignore patterns from `.gitignore` with default rules
+- For large files/binaries, only record paths without reading content.
+
+## II. Staged Strategy (Automatic Intensity Selection)
+
+1. **Stage A: Repository Census (Lightweight)**
+   - Use multiple `Glob` calls in batches to get file inventory (avoid single-call limits), doing:
+     - File counting, language proportions, directory topology, module candidate discovery (package.json, pyproject.toml, go.mod, Cargo.toml, apps/_, packages/_, services/_, cmd/_, etc.).
+   - Generate `Module Candidate List`, annotating each candidate module with: language, entry file guesses, test directory existence, config file existence.
+2. **Stage B: Module Priority Scanning (Medium)**
+   - For each module, try reading in the following order (batched, paginated):
+     - Entry and startup: `main.ts`/`index.ts`/`cmd/*/main.go`/`app.py`/`src/main.rs`, etc.
+     - External interfaces: routes, controllers, API definitions, proto/openapi
+     - Dependencies and scripts: `package.json scripts`, `pyproject.toml`, `go.mod`, `Cargo.toml`, config directories
+     - Data layer: `schema.sql`, `prisma/schema.prisma`, ORM models, migration directories
+     - Testing: `tests/**`, `__tests__/**`, `*_test.go`, `*.spec.ts`, etc.
+     - Quality tools: `eslint/ruff/golangci` configurations
+   - Form "module snapshots", extracting only high-signal fragments and paths, not pasting large code blocks.
+3. **Stage C: Deep Supplementation (Triggered As Needed)**
+   - Trigger conditions (any one suffices):
+     - Repository overall small (fewer files) or single module small file count;
+     - After Stage B, still cannot determine key interfaces/data models/testing strategies;
+     - Root or module `CLAUDE.md` missing information items.
+   - Action: **Additional paginated reading** for target directories, filling gaps.
+
+> Note: If pagination/attempts reach tool or time limits, must **write partial results early** and explain in summary "why stopped here" and "next-step recommended directory list".
+
+## III. Artifacts and Incremental Updates
+
+1.  **Write Root-level `CLAUDE.md`**
+    - If exists, insert/update `Change Log (Changelog)` at the top.
+    - Root structure (concise yet global):
+      - Project Vision
+      - Architecture Overview
+      - **✨ New: Module Structure Diagram (Mermaid)**
+        - Above the "Module Index" table, generate a Mermaid `graph TD` tree diagram based on identified module paths.
+        - Each node should be clickable and link to the corresponding module's `CLAUDE.md` file.
+        - Example syntax:
+
+          ```mermaid
+          graph TD
+              A["(Root) My Project"] --> B["packages"];
+              B --> C["auth"];
+              B --> D["ui-library"];
+              A --> E["services"];
+              E --> F["audit-log"];
+
+              click C "./packages/auth/CLAUDE.md" "View auth module docs"
+              click D "./packages/ui-library/CLAUDE.md" "View ui-library module docs"
+              click F "./services/audit-log/CLAUDE.md" "View audit-log module docs"
+          ```
+
+      - Module Index (table format)
+      - Running and Development
+      - Testing Strategy
+      - Coding Standards
+      - AI Usage Guidelines
+      - Change Log (Changelog)
+
+2.  **Write Module-level `CLAUDE.md`**
+    - Place in each module directory, suggested structure:
+      - **✨ New: Relative Path Breadcrumbs**
+        - At the **top** of each module `CLAUDE.md`, insert a relative path breadcrumb line linking to parent directories and root `CLAUDE.md`.
+        - Example (located at `packages/auth/CLAUDE.md`):
+          `[Root Directory](../../CLAUDE.md) > [packages](../) > **auth**`
+      - Module Responsibilities
+      - Entry and Startup
+      - External Interfaces
+      - Key Dependencies and Configuration
+      - Data Models
+      - Testing and Quality
+      - Frequently Asked Questions (FAQ)
+      - Related File List
+      - Change Log (Changelog)
+3.  **`.claude/index.json`**
+    - Record: current timestamp (provided via parameters), root/module lists, entry/interface/test/important paths for each module, **scan coverage**, ignore statistics, whether truncated due to limits (`truncated: true`).
+
+## IV. Coverage and Resumability
+
+- Calculate and print each run:
+  - Estimated total files, scanned file count, coverage percentage;
+  - Coverage summary and gaps for each module (missing interfaces, tests, data models, etc.);
+  - Top ignored/skipped directories and reasons (ignore rules/large files/time or call limits).
+- Write "gap list" to `index.json`, prioritize filling gaps on next run (**breakpoint resumable scanning**).
+
+## V. Result Summary (Print to Main Dialog)
+
+- Root/module `CLAUDE.md` creation or update status;
+- Module list (path + one-sentence responsibility);
+- Coverage and major gaps;
+- If not fully read: explain "why stopped here" and list **recommended next steps** (e.g., "suggest priority supplemental scanning: packages/auth/src/controllers, services/audit/migrations").
+
+## VI. Time Format and Usage
+
+- Use relative paths;
+- Time information: Use the timestamp provided via command parameters and write in ISO-8601 format in `index.json`.
+- Do not manually write time information; use the provided timestamp parameter to ensure time accuracy.