architext 0.0.2 → 0.0.4

package/CHANGELOG.md

@@ -6,7 +6,47 @@ All notable changes are documented here, following [Keep a Changelog](https://ke
 
 ---
 
-## [Unreleased](https://github.com/JiuNian3219/architext/compare/v0.0.2...HEAD) / 待发布
+## [Unreleased](https://github.com/JiuNian3219/architext/compare/v0.0.4...HEAD) / 待发布
+
+---
+
+## [0.0.4](https://github.com/JiuNian3219/architext/releases/tag/v0.0.4) - 2026-03-01
+
+### Added / 新增
+
+- `archi pack` + `/archi.recover` — 用户数据备份与恢复流程 / User data backup and restore flow
+- `/archi.ref` — 外部知识引用管理命令 / External knowledge reference management command
+- `design.md` 技术方案设计模板与 `archi-design-patterns` Skill / Design template and archi-design-patterns Skill
+- 项目初始化流程支持可选生成 `project-brief.md` / Init flow supports optional `project-brief.md` generation
+- 子代理审查层与内容切片机制 / Sub-agent review layer and content slicing mechanism
+- 维度积木 spec 骨架、WBS 分解与任务类型体系 / Spec skeleton, WBS decomposition and task type system
+- OpenCode、Claude Code 作为目标 IDE 支持 / OpenCode and Claude Code as target IDE options
+- 网站 Iterate 区块，Workflow 简化为 start → plan → code → audit 四阶段 / Website Iterate section, simplified Workflow to four stages
+
+### Changed / 变更
+
+- 移除 zh-Hant 支持，简化为 zh + en 双语 / Removed zh-Hant, simplified to zh + en
+- 项目类型重构为特征标签体系 / Project type refactored to feature tag system
+- 移除 terminal-gate-base、status-gate 共享片段，内联至各协议 / Inlined shared gate snippets into protocols
+
+### Fixed / 修复
+
+- 更新 prompts 时解析 `[[SKILL:...]]` / `[[NO-SKILL:...]]` 能力标记 / Parse capability refs when updating prompts
+- 统一 templates 中 Skill 调用格式 / Unified Skill invocation format in templates
+- 在 `02_tech_stack` 中为 ITP 固定协议添加分区标记 / Added section markers for ITP fixed protocols
+- 明确协议可覆盖 `00_system` 的范围 / Clarified protocol override scope for `00_system`
+- 在 `00_system` 中定义跨文件规则优先级链 / Defined cross-file rule priority chain
+
+---
+
+## [0.0.3](https://github.com/JiuNian3219/architext/releases/tag/v0.0.3) - 2026-02-27
+
+### Fixed / 修复
+
+- `archi init` 冲突检测现在展示全部冲突文件，移除之前的 5 条显示上限 / `archi init` conflict detection now shows all conflicting files, removing the previous 5-item display limit
+- `archi uninstall` 补全 Skills 文件（`.cursor/skills/archi-*/` 等）的删除逻辑，之前这些文件不会被清理 / `archi uninstall` now correctly removes Skills directories (e.g. `.cursor/skills/archi-*/`), which were previously left behind
+- `archi uninstall` 删除文件后自动清理空目录（rules、commands、skills 及编辑器根目录），解决目录残留问题 / `archi uninstall` now removes empty directories (rules, commands, skills, and editor root dirs) after file deletion
+- 官网落地页版本号改为构建时从 npm 注册表拉取，始终显示已发布版本，不再依赖本地 package.json / Website landing page version is now fetched from npm registry at build time, always showing the published version instead of local package.json
 
 ---
 

package/README.md

@@ -10,7 +10,7 @@
 [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
 
-**Supported IDEs:** Cursor *(recommended)* · Windsurf · Trae · VS Code
+**Supported IDEs:** Cursor *(recommended)* · Windsurf · Trae · VS Code · Claude Code · OpenCode
 
 </div>
 
@@ -28,6 +28,8 @@ Before a single line of code is written, Architext forces you and your AI to ali
 
 > **No Docs, No Code.** Code is just a downstream artifact of documents.
 
+Architext targets **small-to-medium applications**, designed for **solo developers** or **solo + AI assistant** workflows. Whether you use chat-based AI today or a future JARVIS-like persistent assistant, the document-driven approach gives AI stable context, clear execution boundaries, and keeps you in control of every decision.
+
 Architext operates in two layers:
 
 | Layer | How to trigger | Responsibility |
@@ -64,8 +66,9 @@ npx archi init
 
 ```
 ✔ Select language    › English
-✔ Select IDE(s)      › Cursor   (multiselect — Cursor / Windsurf / Trae / VS Code)
+✔ Select IDE(s)      › Cursor   (multiselect — Cursor / Windsurf / Trae / VS Code / Claude Code / OpenCode)
 ✔ Select project type › Web SPA / PWA
+✔ Generate project-brief.md? › Yes (fill in project requirements for /archi.start or /archi.inherit)
 
 ● Deploying Architext...
 ✔ Docs deployed      → .architext/
@@ -84,7 +87,7 @@ npx archi init
 
 **Step 2 — AI chat: initialize your project**
 
-`archi init` generates a tailored `project-brief.md` at your project root. Fill it in, then run:
+When you choose to generate it, `archi init` creates a tailored `project-brief.md` at your project root. Fill it in, then run:
 
 ```
 /archi.start project-brief.md
@@ -92,7 +95,7 @@ npx archi init
 
 The AI reads the brief, interviews you on key decisions, and generates the project's foundation documents (`vision.md`, `roadmap.json`, `tech_stack`, etc.).
 
-> **Existing codebase?** Skip `/archi.start` and use `/archi.inherit` instead — it reverse-engineers your project and registers existing features as `LEG-xx` tasks.
+> **Existing codebase?** Skip `/archi.start` and use `/archi.inherit` instead — it reverse-engineers your project and registers existing features as `LEG-xx` tasks. Optional: pass `project-brief.md` when the codebase is minimal (skeleton repo) to supplement vision and roadmap.
 
 ---
 
@@ -215,7 +218,7 @@ AI:   [Reading code + spec + plan + vision + tech_stack...]
 | Command | Description |
 |:---|:---|
 | `/archi.start [brief]` | Read a project brief and generate foundation docs (vision / roadmap / tech_stack etc.) |
-| `/archi.inherit` | Reverse-engineer an existing codebase; register features as `LEG-xx` tasks |
+| `/archi.inherit [brief]` | Reverse-engineer existing codebase; optionally pass project-brief.md to supplement vision/roadmap (skeleton repos) |
 | `/archi.scope [file_path]` | Decompose extra requirements into roadmap tasks; omit file to trigger an interview |
 | `/archi.plan <ID> [context]` | Deep architecture interview → spec / plan ([?UI] also ui.md + ui_concept.html); supply context to reduce questions |
 | `/archi.code <ID>` | Implement from plan phase by phase; only `active` tasks are allowed |
@@ -294,6 +297,8 @@ Four IDEs are currently supported. During `archi init` you manually select which
 | Windsurf | `.windsurf/rules/` | `.md` | Supported |
 | Trae | `.trae/rules/` | `.md` | Supported |
 | VS Code | `.github/instructions/` | `.instructions.md` | Supported |
+| Claude Code | `.claude/rules/` | `.md` | Supported |
+| OpenCode | `.opencode/rules/` | `.md` | Supported |
 
 Support for additional editors is planned.
 

package/README.zh-CN.md

@@ -10,7 +10,7 @@
 [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
 
-**支持的 IDE：** Cursor *(推荐)* · Windsurf · Trae · VS Code
+**支持的 IDE：** Cursor *(推荐)* · Windsurf · Trae · VS Code · Claude Code · OpenCode
 
 </div>
 
@@ -28,6 +28,8 @@ Architext 是一套**文档驱动 AI 开发 (DDAD)** 协议，将你的 AI 编
 
 > **无文档，不代码。** 代码只是文档的下游产物。
 
+Architext 面向**中小型应用**，为 **1 人团队** 或 **1 人 + AI 助手** 的协作模式设计。无论你用的是对话式 AI 还是未来的「贾维斯式」持续助手，文档驱动的工作流都能让 AI 有稳定的上下文、清晰的执行边界，而你始终掌握决策权。
+
 Architext 以两个层次协同运作：
 
 | 层次 | 触发方式 | 职责 |
@@ -64,8 +66,9 @@ npx archi init
 
 ```
 ✔ 选择语言      › 简体中文
-✔ 选择 IDE      › Cursor   (多选 — Cursor / Windsurf / Trae / VS Code)
+✔ 选择 IDE      › Cursor   (多选 — Cursor / Windsurf / Trae / VS Code / Claude Code / OpenCode)
 ✔ 选择项目类型  › Web SPA / PWA
+✔ 是否生成 project-brief.md？ › 是（生成后填写项目需求，供 /archi.start 或 /archi.inherit 使用）
 
 ● 正在部署 Architext...
 ✔ 文档已部署       → .architext/
@@ -84,7 +87,7 @@ npx archi init
 
 **第二步 · AI 对话：初始化项目**
 
-`archi init` 会在项目根目录自动生成一份 `project-brief.md`。填写完毕后，在 AI 编辑器中运行：
+选择生成时，`archi init` 会在项目根目录生成 `project-brief.md`。填写完毕后，在 AI 编辑器中运行：
 
 ```
 /archi.start project-brief.md
@@ -92,7 +95,7 @@ npx archi init
 
 AI 读取 Brief，就关键决策向你提问，生成项目的基础文档（`vision.md`、`roadmap.json`、`tech_stack` 等）。
 
-> **已有代码？** 跳过 `/archi.start`，改用 `/archi.inherit` —— 逆向分析项目，将已有功能注册为 `LEG-xx` 任务，同时生成 `map.json`。
+> **已有代码？** 跳过 `/archi.start`，改用 `/archi.inherit` —— 逆向分析项目，将已有功能注册为 `LEG-xx` 任务，同时生成 `map.json`。可选：代码库尚空时传 `project-brief.md` 补充愿景与路线图。
 
 ---
 
@@ -215,7 +218,7 @@ AI:   [正在读取 代码 + spec + plan + vision + tech_stack...]
 | 命令 | 说明 |
 |:---|:---|
 | `/archi.start [brief]` | 读取需求 Brief，生成项目基础文档（vision / roadmap / tech_stack 等） |
-| `/archi.inherit` | 逆向分析已有代码库，生成文档骨架并注册为 `LEG-xx` 任务 |
+| `/archi.inherit [brief]` | 逆向分析已有代码库；可选传 project-brief.md 补充愿景/路线图（骨架仓库） |
 | `/archi.scope [file_path]` | 将额外需求拆解为 Roadmap 任务；无文件则自动发起访谈 |
 | `/archi.plan <ID> [context]` | 深度架构访谈 → 生成 spec / plan（[?UI] 附 ui.md + ui_concept.html）；可附加已知上下文减少提问 |
 | `/archi.code <ID>` | 按 plan 分阶段实现代码；仅 `active` 任务可进入 |
@@ -294,6 +297,8 @@ Agent 模式适合单次会话。Architext 提供跨会话、跨成员、跨 AI
 | Windsurf | `.windsurf/rules/` | `.md` | 支持 |
 | Trae | `.trae/rules/` | `.md` | 支持 |
 | VS Code | `.github/instructions/` | `.instructions.md` | 支持 |
+| Claude Code | `.claude/rules/` | `.md` | 支持 |
+| OpenCode | `.opencode/rules/` | `.md` | 支持 |
 
 后续计划扩展更多编辑器支持。