agency-rules 0.4.1 → 0.6.0

package/CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0](https://github.com/deuriib/agency-rules/compare/v0.5.0...v0.6.0) (2026-10-31)
+
+
+### Features
+
+* **rules:** add Agentmemory MCP guidelines ([0d68b32](https://github.com/deuriib/agency-rules/commit/0d68b32e91b5385087b34d9dc93b45576bf88ceb))
+* **rules:** add Agentmemory MCP guidelines ([1c846f5](https://github.com/deuriib/agency-rules/commit/1c846f5715137ea0d98d5365b99e4589a129a92b)), closes [#14](https://github.com/deuriib/agency-rules/issues/14)
+* **rules:** add subagent delegation guidelines ([4527e1f](https://github.com/deuriib/agency-rules/commit/4527e1f7a16fb131a09406083562d59ff9f0eb8b))
+* **rules:** add subagent delegation guidelines ([1042370](https://github.com/deuriib/agency-rules/commit/1042370beb15a15e9f9a57831a754da4ee05edbc)), closes [#15](https://github.com/deuriib/agency-rules/issues/15)
+
+
+### Bug Fixes
+
+* unused variable via biome ([7bd25b1](https://github.com/deuriib/agency-rules/commit/7bd25b1c8c1b28521d6aaee57e1d5179e0cfafab))
+
+## [0.5.0](https://github.com/deuriib/agency-rules/compare/v0.4.1...v0.5.0) (2026-10-31)
+
+
+### Features
+
+* **cli:** add 'list' command to display available rules ([15a7302](https://github.com/deuriib/agency-rules/commit/15a73025cd8ae1f90ab4a8602ac68817306aa128))
+
 ## [0.4.1](https://github.com/deuriib/agency-rules/compare/v0.4.0...v0.4.1) (2026-10-31)
 
 

package/README.md

@@ -4,7 +4,7 @@
 
 `agency-rules` compiles a single set of generic Markdown rules into the
 native formats expected by **Google Antigravity**, **pi-agent**,
-**oh-my-pi (omp)**, and **OpenCode** (via the `opencode-rules` plugin).
+**oh-my-pi (omp)**, and **OpenCode** (via the [opencode-rules]("https://github.com/frap129/opencode-rules") plugin).
 
 The whole pipeline — toolchain, environment, and tasks — is managed by
 [mise](https://mise.jdx.dev), so every collaborator and CI runner uses the
@@ -21,7 +21,7 @@ Every coding agent has its own rule format:
 | Google Antigravity | YAML frontmatter with `trigger` | `.agents/rules/*.md` |
 | pi-agent | Per-rule directory with `RULES.md` | `.pi/rules/<slug>/RULES.md` |
 | oh-my-pi (omp) | Markdown with frontmatter | `.omp/rules/*.{md,mdc}` |
-| OpenCode | Markdown via `opencode-rules` plugin | `.opencode/rules/*.md` |
+| OpenCode | Markdown via [opencode-rules]("https://github.com/frap129/opencode-rules") plugin | `.opencode/rules/*.md` |
 
 Writing the same rule four times is a maintenance nightmare. `agency-rules`
 lets you write it **once** in a neutral format and compile it to all four

package/bin/agency-rules.mjs

@@ -29,17 +29,18 @@ Write rules once. Run them in every harness.
   $ agency-rules <command> [options]
 
 \x1b[33mCommands:\x1b[0m
-  \x1b[32mconvert\x1b[0m     Compile rules/ into each harness's native format
-  \x1b[32minstall\x1b[0m     Install compiled artifacts into detected harnesses
-  \x1b[32mvalidate\x1b[0m    Validate each rule's frontmatter against the schema
+  \x1b[32mlist\x1b[0m         List all available rules
+  \x1b[32mconvert\x1b[0m      Compile rules/ into each harness's native format
+  \x1b[32minstall\x1b[0m      Install compiled artifacts into detected harnesses
+  \x1b[32mvalidate\x1b[0m     Validate each rule's frontmatter against the schema
 
 \x1b[33mGlobal Options:\x1b[0m
   -h, --help      Show this help message
   -v, --version   Show version number
 
 \x1b[33mExamples:\x1b[0m
+  $ agency-rules list
   $ agency-rules validate
-  $ agency-rules convert
   $ agency-rules convert --dry-run
   $ agency-rules install --scope user --harness opencode
 `);
@@ -47,6 +48,17 @@ Write rules once. Run them in every harness.
 
 const showCommandHelp = (cmd) => {
     const helps = {
+        list: `
+\x1b[36magency-rules list\x1b[0m
+List all available rules and their descriptions.
+
+\x1b[33mOptions:\x1b[0m
+  --json            Output the list in JSON format (useful for scripting)
+
+\x1b[33mExamples:\x1b[0m
+  $ agency-rules list
+  $ agency-rules list --json | jq '.'
+`,
         convert: `
 \x1b[36magency-rules convert\x1b[0m
 Compile rules/ into each harness's native format.
@@ -101,7 +113,7 @@ if (!command || command === 'help' || command === '--help' || command === '-h')
     process.exit(0);
 }
 
-if (!['convert', 'install', 'validate'].includes(command)) {
+if (!['list', 'convert', 'install', 'validate'].includes(command)) {
     console.error(`\x1b[31mError:\x1b[0m Unknown command '${command}'`);
     showHelp();
     process.exit(1);
@@ -114,7 +126,6 @@ if (process.argv.includes('--help') || process.argv.includes('-h')) {
 }
 
 // ── Execute ───────────────────────────────────────────────────────────
-// Remove the command from argv so the downstream script's parseArgs works cleanly
 process.argv.splice(2, 1);
 
 const scriptPath = resolve(import.meta.dirname, '..', 'scripts', `${command}.mjs`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agency-rules",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "Write rules once. Run them in every harness.",
   "type": "module",
   "license": "MIT",

package/rules/base/agentmemory.md

@@ -0,0 +1,15 @@
+---
+name: agentmemory
+description: Guidelines and strict rules for interacting with the Agentmemory MCP server.
+alwaysApply: true
+tags: [mcp, memory, context]
+---
+
+# Agentmemory MCP Rules
+
+- **MEM-01** — Recall Before Asking. At the START of any task, call `memory_recall` (or `memory_smart_search`) with the task context before asking the user to repeat anything.
+- **MEM-02** — Save at Decision Points. When you learn something durable (a decision, a fix, a gotcha, a user preference, a project convention), call `memory_save` in the same session — do not batch it for later.
+- **MEM-03** — Lessons From Corrections. Signals this applies: explicit "always/never", "learn this", "from now on", a repeated user fix to the same behavior, "I told you before". Call `memory_save` with a confidence score; re-saving duplicate content strengthens the existing lesson instead of forking it. Before similar work, call `memory_lesson_recall` — check what was learned before deciding. One concept per lesson; state when and where it applies via context and tags.
+- **MEM-04** — Resume, Don't Restart. Resume / recap / "where were we" → `memory_sessions` plus `memory_timeline` around the anchor before doing anything else. Lead with any unanswered question from the prior session. Use `memory_timeline` for chronological context and `memory_smart_search` with `expandIds` for detail — never re-derive what history already holds.
+- **MEM-05** — Track Multi-Step Work as Actions. Work with 3+ steps → `memory_action_create` with typed dependencies; pull from `memory_frontier` / `memory_next`, not vibes. Memory lease acquire before starting an action; release or renew explicitly — leases prevent double-work across agents. Update status in real time; resolving to done unblocks dependents. Hand off via `memory_signal_send`, pick up via `memory_signal_read`.
+- **MEM-06** — Slots Are Small, Pinned State. Durable user or project state (persona, pending items) → memory slots: `memory_slot_get` / `memory_slot_list` first, then `memory_slot_replace`. Appends fail past `sizeLimit` — compact via replace first, never loop blind appends. Seeded defaults are starting values, not gospel; replace them when the user corrects them.

package/rules/base/subagent-delegation.md

@@ -0,0 +1,17 @@
+---
+name: subagent-delegation
+description: Guidelines for delegating tasks to subagents using spawn, dispatch, or invoke.
+trigger: model_decision
+tags: [workflow, subagents, context-management]
+---
+
+# Subagent Delegation Rules
+
+- **SUB-01** — Trigger Words. When the user says `spawn`, `dispatch`, or `invoke`, they are explicitly asking you to delegate the task to a subagent. Do not attempt to execute the task in the main thread.
+- **SUB-02** — When to Delegate. Use subagents for:
+  - **Context-heavy tasks:** Searching large codebases, reading multiple files, or exploring documentation.
+  - **Parallelizable work:** Multiple independent fixes or searches that can happen concurrently.
+  - **Specialized tasks:** Writing tests, refactoring specific modules, or applying strict formatting.
+- **SUB-03** — Clear Prompts. When spawning a subagent, provide a self-contained prompt. Do not assume the subagent has access to the current conversation history. Pass all necessary context, file paths, and constraints explicitly.
+- **SUB-04** — Await and Synthesize. Wait for the subagent to complete and return its result. Verify the output and synthesize it back into the main workflow before presenting the final answer to the user.
+- **SUB-05** — Fail Safely. If a subagent fails or hits a limit, do not silently retry in the main thread. Report the failure, analyze the error, and decide whether to retry the subagent with a better prompt or escalate to the user.

package/scripts/convert.mjs

@@ -1,4 +1,4 @@
-import { access, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { dirname, join, resolve } from 'node:path';
 import { parseArgs } from 'node:util';
 import { readRules } from './lib/frontmatter.mjs';

package/scripts/list.mjs

@@ -0,0 +1,48 @@
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { readRules } from './lib/frontmatter.mjs';
+
+const { values: args } = parseArgs({
+    options: {
+        json: { type: 'boolean', default: false },
+    },
+});
+
+// Resolve paths (local vs package fallback)
+const PACKAGE_ROOT = resolve(import.meta.dirname, '..');
+const localRules = resolve(process.cwd(), 'rules');
+const RULES_DIR =
+    process.env.RULES_DIR || (existsSync(localRules) ? localRules : resolve(PACKAGE_ROOT, 'rules'));
+
+const rules = await readRules(RULES_DIR);
+
+if (rules.length === 0) {
+    console.error(`❌ No rules found in ${RULES_DIR}`);
+    process.exit(1);
+}
+
+// ── JSON Output ───────────────────────────────────────────────────────
+if (args.json) {
+    const output = rules.map((r) => ({
+        name: r.slug,
+        description: r.data.description || 'No description provided',
+        source: r.source,
+    }));
+    console.log(JSON.stringify(output, null, 2));
+    process.exit(0);
+}
+
+// ── Pretty Terminal Output ────────────────────────────────────────────
+// Find the longest name to align the columns perfectly
+const maxSlugLength = Math.max(...rules.map((r) => r.slug.length));
+
+console.log(`\n📚 \x1b[1mAvailable Rules\x1b[0m (${rules.length})\n`);
+
+for (const rule of rules) {
+    const paddedSlug = rule.slug.padEnd(maxSlugLength);
+    // Using Cyan for the rule name
+    console.log(`  \x1b[36m${paddedSlug}\x1b[0m  ${rule.data.description || 'No description'}`);
+}
+
+console.log('\n');