@oevery/rsp 2.0.0 → 2.0.2

package/README.md

@@ -55,11 +55,12 @@ npx -y @oevery/rsp doctor
 ## File ownership
 
 - `AGENTS.md`: only the `<!-- rsp:begin --> ... <!-- rsp:end -->` block is managed by RSP.
-- `.rsp/specs/INDEX.md`: auto-generated. Rebuild with `rsp update`.
+- `.rsp/specs/INDEX.md`: auto-generated index of additional spec files beyond `design.md`. Rebuild with `rsp update`.
 - `.rsp/archives/INDEX.md`: auto-generated. Rebuild with `rsp update`.
 - `.rsp/specs/design.md`: created by `rsp init`, then owned by the project.
 - `.rsp/rules/project-rules.md`: optional; create only when the project has durable local rules.
 - Keep durable architecture, boundaries, and cross-cutting technical constraints in `.rsp/specs/design.md`.
+- Treat `.rsp/specs/INDEX.md` as a directory for additional spec files; it does not list `design.md`.
 - Keep stable workflow rules, validation expectations, and local operating constraints in `.rsp/rules/project-rules.md`.
 
 ## AGENTS integration
@@ -111,11 +112,17 @@ When this README shows `rsp <command>`, it assumes the command is already availa
 Example optional installation flow:
 
 ```bash
-npx skills add oevery/rsp --skill rsp
+npx skills add oevery/rsp
 ```
 
 This repository publishes a skill named `rsp` under `skills/rsp/`.
 
+`rsp update` refreshes project-local RSP files only. If you use the published RSP skill, refresh it separately after upgrading:
+
+```bash
+npx skills add oevery/rsp
+```
+
 ## Work Model
 
 ```text

package/README.zh-CN.md

@@ -55,11 +55,12 @@ npx -y @oevery/rsp doctor
 ## 文件所有权
 
 - `AGENTS.md`：只有 `<!-- rsp:begin --> ... <!-- rsp:end -->` 受管块由 RSP 维护。
-- `.rsp/specs/INDEX.md`：自动生成，使用 `rsp update` 重建。
+- `.rsp/specs/INDEX.md`：自动生成，用于索引 `design.md` 之外的附加 spec 文件；使用 `rsp update` 重建。
 - `.rsp/archives/INDEX.md`：自动生成，使用 `rsp update` 重建。
 - `.rsp/specs/design.md`：由 `rsp init` 创建，之后由项目维护。
 - `.rsp/rules/project-rules.md`：可选，仅在项目确有长期本地规则时创建。
 - 将长期架构、边界和跨模块技术约束放在 `.rsp/specs/design.md`。
+- 将 `.rsp/specs/INDEX.md` 视为附加 spec 的目录；它不列出 `design.md`。
 - 将稳定的工作流规则、验证要求和本地运行约束放在 `.rsp/rules/project-rules.md`。
 
 ## AGENTS 接入
@@ -105,11 +106,17 @@ Read in order:
 可选安装示例：
 
 ```bash
-npx skills add oevery/rsp --skill rsp
+npx skills add oevery/rsp
 ```
 
 本仓库发布了一个名为 `rsp` 的 skill，位于 `skills/rsp/`。
 
+`rsp update` 只会刷新项目内的 RSP 文件。如果你在使用发布出来的 RSP skill，升级后还需要单独刷新一次：
+
+```bash
+npx skills add oevery/rsp
+```
+
 ## 工作模型
 
 ```text

package/dist/cli.mjs

@@ -632,14 +632,17 @@ async function buildSpecsIndex({ acquireLock = true } = {}) {
 `);
     return;
   }
-  const specFiles = (await walkMarkdownFiles(specsDir)).filter((fp) => basename2(fp) !== "INDEX.md").sort();
+  const specFiles = (await walkMarkdownFiles(specsDir)).filter((fp) => {
+    const name = basename2(fp);
+    return name !== "INDEX.md" && name !== "design.md";
+  }).sort();
   const lines = [];
   lines.push("# Specs Index");
   lines.push("");
-  lines.push("_Project-level specs and design notes._");
+  lines.push("_Additional project-level specs beyond `design.md`._");
   lines.push("");
   if (specFiles.length === 0) {
-    lines.push("_No project-level specs yet._");
+    lines.push("_No additional project-level specs yet._");
   } else {
     lines.push("| File | Title | Summary |");
     lines.push("|------|-------|---------|");
@@ -1515,7 +1518,7 @@ async function initProject(args = {}) {
     const bundledRules = await readFile9(join12(PKG_ROOT, "rules", "rsp-rules.md"), "utf-8");
     created = await ensureFile(join12(RSP_DIR, "rules", "rsp-rules.md"), bundledRules) || created;
     created = await ensureFile(join12(RSP_DIR, "config.yaml"), generateConfigTemplate()) || created;
-    const createdSpecsIndex = await ensureFile(join12(RSP_DIR, "specs", "INDEX.md"), "# Specs Index\n\n_Project-level specs and design notes._\n");
+    const createdSpecsIndex = await ensureFile(join12(RSP_DIR, "specs", "INDEX.md"), "# Specs Index\n\n_Additional project-level specs beyond `design.md`._\n");
     created = createdSpecsIndex || created;
     const createdDesign = await ensureFile(join12(RSP_DIR, "specs", "design.md"), generateDesignContent(projectName));
     created = createdDesign || created;
@@ -1816,6 +1819,7 @@ function printArchiveTrend(trend) {
 import { existsSync as existsSync14 } from "fs";
 import { mkdir as mkdir8, readFile as readFile11, writeFile as writeFile9 } from "fs/promises";
 import { join as join14 } from "path";
+var SKILL_REFRESH_HINT = "  Note: if you use the published RSP skill, refresh it too:\n    npx skills add oevery/rsp\n";
 async function updateProject() {
   if (!existsSync14(RSP_DIR)) {
     console.log(`  ${pc.red("Error:")} RSP is not initialized. Run: rsp init`);
@@ -1845,12 +1849,15 @@ async function updateProject() {
     }
     await buildSpecsIndex({ acquireLock: false });
     await buildArchiveIndex({ acquireLock: false });
-    if (!updated)
+    if (!updated) {
       console.log(`  ${pc.dim("Already up to date.")}
 `);
-    else
+      console.log(SKILL_REFRESH_HINT);
+    } else {
       console.log(`  ${pc.green("Update complete.")}
 `);
+      console.log(SKILL_REFRESH_HINT);
+    }
   });
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oevery/rsp",
   "type": "module",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "RSP (Rules, Specs, Plans) workflow for lightweight AI-assisted change management",
   "author": "oevery",
   "license": "MIT",

package/rules/rsp-rules.md

@@ -15,6 +15,7 @@ This file is the canonical RSP rules source.
 4. If `focus.d/` is empty, ask the user what to work on or suggest `npx -y @oevery/rsp create <name>`.
 5. Read each `changes/<name>.md` file marked in `focus.d/`.
 6. Read `specs/design.md` and `specs/INDEX.md`.
+   `specs/INDEX.md` lists only additional spec files beyond `specs/design.md`.
 7. Read only the relevant additional `rules/` and `specs/` files.
 
 ## Core rules

package/skills/rsp/SKILL.md

@@ -40,6 +40,7 @@ Prefer exact file paths, exact commands, and exact durable facts over vague summ
 2. Check that `AGENTS.md` contains the managed RSP block.
 3. Check that `specs/design.md` exists.
 4. Check that `specs/INDEX.md` and `archives/INDEX.md` are still generated files.
+   `specs/INDEX.md` should list only additional spec files beyond `specs/design.md`.
 5. Check that `focus.d/` markers and `changes/` files are in sync.
 6. If generated indices or the managed AGENTS block drift, run `npx -y @oevery/rsp update`.