@sabaiway/agent-workflow-kit 1.19.0 → 1.20.0

package/CHANGELOG.md

@@ -4,6 +4,19 @@ Semantically versioned ([semver](https://semver.org)), newest first. The `versio
 is the current release. `upgrade` mode reads a project's `docs/ai/.workflow-version` and applies
 every `migrations/<version>-<slug>.md` newer than it, in semver order.
 
+## 1.20.0 — Fallback-template lens + the cross-package lens-mirror guard (kit)
+
+A **feature** release. The kit's fallback `agent_rules.md` template gains the **§2.5 Right-altitude &
+code-grounded** lens (byte-identical to memory's §2.6 block), and a new cross-package
+`test/lens-mirror.test.mjs` ties the shared lens vocabulary across the engine canon (`planning.md` +
+`procedures.md`) AND both `agent_rules.md` templates: each distinctive token must survive in every file's
+lens **region**, and the two template blocks must stay byte-identical apart from the heading number. The
+deployment-lineage head stays **`1.3.0`** (no `docs/ai` structural change, no migration); the kit
+**package** version is a separate axis.
+
+- **Non-vacuous guard.** Deleting the lens block (or a distinctive token) from any of the four files
+  fails the guard — proven by an injected-divergence dry-run.
+
 ## 1.19.0 — One-command freshness: `init` refreshes memory too, and a capability-adaptive `status` (kit)
 
 A **feature** release that closes the returning-user gap and modernizes the status surface. The

package/SKILL.md

@@ -3,7 +3,7 @@ name: agent-workflow-kit
 description: Deploy or upgrade a portable AI-agent memory-and-workflow system in any project. Use when the user wants to bootstrap `docs/ai/` + an entry-point `AGENTS.md` (+ `CLAUDE.md` alias) + cap/archive/index enforcement in a new or existing repo, set up the Memory Map and session protocols, install the docs-rotation pre-commit hook, or run `/agent-workflow-kit` / `/agent-workflow-kit upgrade`. Triggers on phrases like "set up the memory system", "deploy the AI workflow here", "bootstrap docs/ai", "upgrade the workflow".
 disable-model-invocation: true
 metadata:
-  version: '1.19.0'
+  version: '1.20.0'
 ---
 
 # agent-workflow-kit

package/capability.json

@@ -3,7 +3,7 @@
   "schema": 1,
   "name": "agent-workflow-kit",
   "kind": "composition-root",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "provides": [],
   "roles": {},
   "detect": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sabaiway/agent-workflow-kit",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "Portable, cross-agent memory & workflow for AI coding agents — Claude Code, Codex, Cursor, Devin Desktop. One command deploys an AGENTS.md entry point + docs/ai context with cap/archive/index enforcement into any repo.",
   "keywords": [
     "ai-agents",

package/references/templates/agent_rules.md

@@ -61,6 +61,11 @@ Before proposing changes or committing, review against:
 ### 2.4. Quality Gates
 - Always run type-checker, linter, and all tests before committing.
 
+### 2.5. Right-altitude & code-grounded (planning + review)
+- **Fold by code, not prose.** Before folding a code-touching finding into a plan or change, read the cited `file:line` and cite it — a prose fold drifts from the code and seeds the next bug.
+- **Right altitude.** Pin intent + invariants + acceptance criteria (named tests); leave fine code-mechanics to Execute, where prose cannot diverge from reality.
+- **Convergence heuristic.** When a review round keeps finding mechanism issues on a stable architecture, stop refining prose — raise the altitude or hand it to Execute. (Full canon: the project's planning methodology / workflow-methodology canon.)
+
 ---
 
 ## 3. Token & Session Optimization