@forwardimpact/libcoaligned 0.1.5 → 0.1.6

package/README.md

@@ -11,7 +11,7 @@ invariants across the repo.
 
 ```sh
 npx coaligned                   # run every check (instructions + jtbd)
-npx coaligned instructions      # enforce L1–L6 length and checklist caps
+npx coaligned instructions      # enforce L1–L7 length and checklist caps
 npx coaligned jtbd              # validate JTBD entries against package.json
 npx coaligned jtbd --fix        # regenerate catalog and job blocks in place
 ```
@@ -20,8 +20,9 @@ The two subcommands implement the contract described in
 [COALIGNED.md](https://github.com/forwardimpact/monorepo/blob/main/COALIGNED.md):
 
 - `instructions` — every layer (L1 CLAUDE.md, L2 CONTRIBUTING.md / JTBD.md,
-  L3 agent profile, L4 SKILL.md, L5 reference, L6 checklist block) is gated by
-  a line cap **and** a word cap. Either breach fails.
+  L3 agent profile, L4 agent reference, L5 SKILL.md, L6 skill reference,
+  L7 checklist block) is gated by a line cap **and** a word cap. Either breach
+  fails.
 - `jtbd` — each `package.json .jobs` entry is validated against the JTBD
   schema; with `--fix`, marker-delimited blocks in `<dir>/README.md`,
   `<dir>/<pkg>/README.md`, and root `JTBD.md` are regenerated.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/libcoaligned",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Co-Aligned architecture checks — enforce instruction-layer length caps and JTBD invariants across the repo.",
   "keywords": [
     "coaligned",

package/src/instructions.js

@@ -14,8 +14,8 @@ const SKIP_DIRS = new Set([
   "worktrees",
 ]);
 
-const L6_MAX_ITEMS = 9;
-const L6_MAX_WORDS_PER_ITEM = 32;
+const L7_MAX_ITEMS = 9;
+const L7_MAX_WORDS_PER_ITEM = 32;
 
 const CHECKLIST_RE =
   /<(read_do_checklist|do_confirm_checklist)\b[^>]*>([\s\S]*?)<\/\1>/g;
@@ -78,6 +78,19 @@ async function findAgentProfiles(root, claudeDirs) {
   return out;
 }
 
+async function findAgentReferences(root, claudeDirs) {
+  const out = [];
+  for (const d of claudeDirs) {
+    const files = await listFiles(
+      root,
+      `${d}/agents/references`,
+      (e) => e.isFile() && e.name.endsWith(".md"),
+    );
+    out.push(...files);
+  }
+  return out;
+}
+
 async function findSkillDirs(root, claudeDirs) {
   const out = [];
   for (const d of claudeDirs) {
@@ -147,13 +160,20 @@ async function buildLayers(root) {
       },
       {
         id: "L4",
+        name: "agent reference",
+        maxLines: 192,
+        maxWords: 1280,
+        files: await findAgentReferences(root, claudeDirs),
+      },
+      {
+        id: "L5",
         name: "skill procedure",
         maxLines: 192,
         maxWords: 1280,
         files: skillDirs.map((d) => `${d}/SKILL.md`),
       },
       {
-        id: "L5",
+        id: "L6",
         name: "skill reference",
         maxLines: 128,
         maxWords: 768,
@@ -241,29 +261,29 @@ export const INSTRUCTION_RULES = [
     hint: HINT_LAYER_BUDGET,
   },
   {
-    id: "L6.too-many-items",
+    id: "L7.too-many-items",
     scope: "checklist-block",
     severity: "fail",
     check: (s) =>
-      s.items.length > L6_MAX_ITEMS
-        ? { count: s.items.length, max: L6_MAX_ITEMS }
+      s.items.length > L7_MAX_ITEMS
+        ? { count: s.items.length, max: L7_MAX_ITEMS }
         : null,
     message: (s, r) =>
       `checklist #${s.blockIndex} (${s.type}) has ${r.count} items (max ${r.max})`,
     hint: "split the checklist into multiple sections, or remove items not load-bearing for the goal",
   },
   {
-    id: "L6.item-too-many-words",
+    id: "L7.item-too-many-words",
     scope: "checklist-block",
     severity: "fail",
     check: (s) => {
       const offenders = [];
       s.items.forEach((item, i) => {
-        if (item.words > L6_MAX_WORDS_PER_ITEM) {
+        if (item.words > L7_MAX_WORDS_PER_ITEM) {
           offenders.push({
             itemIndex: i + 1,
             words: item.words,
-            max: L6_MAX_WORDS_PER_ITEM,
+            max: L7_MAX_WORDS_PER_ITEM,
           });
         }
       });
@@ -278,7 +298,7 @@ export const INSTRUCTION_RULES = [
 // -- Public entry --------------------------------------------------------
 
 /**
- * Walk the repo rooted at `root`, applying the L1–L6 caps from COALIGNED.md.
+ * Walk the repo rooted at `root`, applying the L1–L7 caps from COALIGNED.md.
  * Each layer is gated by a line cap AND a word cap; either breach fails.
  *
  * @param {{ root: string }} options