compose-agentsmd 3.2.5 → 3.2.6

package/README.md

@@ -68,7 +68,7 @@ compose-agentsmd edit-rules
 compose-agentsmd apply-rules
 ```
 
-`edit-rules` clones the GitHub source into the workspace (or reuses it). `apply-rules` pushes the workspace (if clean) and regenerates `AGENTS.md` by refreshing the cache. If your `source` is a local path, `edit-rules` will just print that path and `apply-rules` will skip the push.
+`edit-rules` clones the GitHub source into the workspace (or reuses it), then prints the workspace path, rules directory, and next steps. `apply-rules` pushes the workspace (if clean) and regenerates `AGENTS.md` by refreshing the cache. If your `source` is a local path, `edit-rules` points to the local workspace and `apply-rules` skips the push.
 
 ## Project ruleset format
 

package/dist/compose-agents.js

@@ -755,7 +755,17 @@ const main = async () => {
         if (ruleset.source.startsWith("github:")) {
             workspaceRoot = ensureWorkspaceForGithubSource(ruleset.source);
         }
-        process.stdout.write(`Rules workspace: ${workspaceRoot}\n`);
+        const rulesDirectory = ruleset.source.startsWith("github:")
+            ? path.join(workspaceRoot, "rules")
+            : resolveLocalRulesRoot(rulesetDir, ruleset.source);
+        process.stdout.write([
+            `Rules workspace: ${workspaceRoot}`,
+            `Rules directory: ${rulesDirectory}`,
+            "Next steps:",
+            `- Edit rule files under: ${rulesDirectory}`,
+            "- If this source is GitHub, commit and push the workspace changes before apply-rules.",
+            "- Run compose-agentsmd apply-rules from your project root to apply updates and regenerate AGENTS.md."
+        ].join("\n") + "\n");
         return;
     }
     if (command === "init") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "compose-agentsmd",
-  "version": "3.2.5",
+  "version": "3.2.6",
   "description": "CLI tools for composing per-project AGENTS.md files from modular rule sets",
   "license": "MIT",
   "repository": {

package/tools/tool-rules.md

@@ -3,6 +3,7 @@
 - `compose-agentsmd` intentionally regenerates `AGENTS.md`; any resulting `AGENTS.md` diff is expected and must not be treated as an unexpected external change.
 - If `compose-agentsmd` is not available, install it via npm: `npm install -g compose-agentsmd`.
 - To update shared rules, run `compose-agentsmd edit-rules`, edit the workspace rules, then run `compose-agentsmd apply-rules`.
+- `compose-agentsmd apply-rules` pushes the rules workspace when `source` is GitHub (if the workspace is clean), then regenerates `AGENTS.md` with refreshed rules.
 - Do not edit `AGENTS.md` directly; update the source rules and regenerate.
 - `tools/tool-rules.md` is the shared rule source for all repositories that use compose-agentsmd.
 - Before applying any rule updates, present the planned changes first (prefer a colorized diff-style preview), ask for explicit approval, then make the edits.