@haus-tech/haus-workflow 5.11.0 → 5.12.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [5.12.0](https://github.com/WeAreHausTech/haus-workflow/compare/v5.11.0...v5.12.0) (2026-10-08)
+
+### Bug Fixes
+
+- **doctor:** AGENT REFS skips bold terms and agent words outside the sentence (ADR-0149) ([#633](https://github.com/WeAreHausTech/haus-workflow/issues/633)) ([c67b09c](https://github.com/WeAreHausTech/haus-workflow/commit/c67b09c40341f17ccafa89ecb2515129de407827)), closes [#307](https://github.com/WeAreHausTech/haus-workflow/issues/307) [#328](https://github.com/WeAreHausTech/haus-workflow/issues/328) [#329](https://github.com/WeAreHausTech/haus-workflow/issues/329) [WeAreHausTech/haus-workflow-catalog#307](https://github.com/WeAreHausTech/haus-workflow-catalog/issues/307)
+
 ## [5.11.0](https://github.com/WeAreHausTech/haus-workflow/compare/v5.10.1...v5.11.0) (2026-10-07)
 
 ### Features

package/dist/cli.js

@@ -8910,11 +8910,13 @@ var BOLD_SPAN = /\*\*([^*\n]+)\*\*/g;
 var BARE_NAME = /^[a-z0-9][a-z0-9-]{2,}$/;
 var KEBAB_NAME = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)+$/;
 var AGENT_WORD = /\bagents?\b/i;
+var SENTENCE_END = /[.!?](?=\s|$)/g;
 var ITEMS_HEADING = /\b(?:skills?|agents?)\b/i;
 var LIST_ITEM = /^(\s*(?:[-*+]|\d+[.)])\s+)(.*)$/;
 var LIST_LABEL = /^[A-Za-z][A-Za-z /]{0,24}:\s*/;
 var KEYWORD_BEFORE = /(?:sub)?(?:skills?|agents?)\s*[:=-]*\s*$/i;
 var KEYWORD_AFTER = /^\s+(?:[A-Za-z]+\s+)?(?:sub)?(?:skills?|agents?)\b/i;
+var ARTICLE_BEFORE = /\b(?:a|an)\s+$/i;
 var ROUTER_BEFORE = /\b(?:routes?|routing|delegates?|dispatch(?:es)?|hands? off)\s*(?:to|→|->|:)?\s*$/i;
 var RUN_SEPARATOR = /^\s*(?:\([^)\n]*\))?\s*(?:,|;|\/|\band\b|\bor\b|\bplus\b)\s*(?:the\s+)?$/i;
 var INLINE_KEYWORD_NAME = /^(?:sub)?(?:skills?|agents?)\s*[:=]\s*(\S+)$/i;
@@ -8948,7 +8950,15 @@ function groupRuns(line2, spans) {
   }
   return runs;
 }
-function isAgentContext(line2, nearestHeading) {
+function sentenceAround(line2, token) {
+  let start = 0;
+  for (const end of line2.matchAll(SENTENCE_END)) {
+    if (end.index >= token.end) return [start, end.index + 1];
+    start = end.index + 1;
+  }
+  return [start, line2.length];
+}
+function isAgentContext(line2, token, nearestHeading) {
   let blanked = "";
   let cursor = 0;
   for (const span of boldNameSpans(line2)) {
@@ -8956,7 +8966,8 @@ function isAgentContext(line2, nearestHeading) {
     cursor = span.end;
   }
   blanked += line2.slice(cursor);
-  return AGENT_WORD.test(blanked) || AGENT_WORD.test(nearestHeading);
+  const [start, end] = sentenceAround(line2, token);
+  return AGENT_WORD.test(blanked.slice(start, end)) || AGENT_WORD.test(nearestHeading);
 }
 function extractNameReferences(lines, { knownNames = /* @__PURE__ */ new Set() } = {}) {
   const out = [];
@@ -8970,16 +8981,17 @@ function extractNameReferences(lines, { knownNames = /* @__PURE__ */ new Set() }
     const itemBody = listMatch?.[2]?.replace(LIST_LABEL, "");
     const itemBodyStart = itemBody === void 0 ? -1 : line2.length - itemBody.length;
     const underItemsHeading = ITEMS_HEADING.test(nearestHeading);
-    const looseContext = isAgentContext(line2, nearestHeading);
+    const looseContext = (span) => KEBAB_NAME.test(span.text) && isAgentContext(line2, span, nearestHeading);
     for (const run of groupRuns(line2, boldNameSpans(line2))) {
       const before = line2.slice(0, run[0].start);
       const after = line2.slice(run.at(-1).end);
-      const positional = KEYWORD_BEFORE.test(before) || ROUTER_BEFORE.test(before) || KEYWORD_AFTER.test(after) || // Two co-listed installed items make the run an item list. One is not enough:
+      const classifier = ARTICLE_BEFORE.test(before);
+      const positional = KEYWORD_BEFORE.test(before) || ROUTER_BEFORE.test(before) || !classifier && KEYWORD_AFTER.test(after) || // Two co-listed installed items make the run an item list. One is not enough:
       // package names share basenames with skills.
       run.filter((span) => knownNames.has(span.text)).length >= 2 || underItemsHeading && run[0].start === itemBodyStart;
       for (const span of run) {
         if (inCodeSpan(span.start)) continue;
-        if (!positional && !(KEBAB_NAME.test(span.text) && looseContext)) continue;
+        if (!positional && (classifier || !looseContext(span))) continue;
         out.push({ line: lineNumber, name: span.text, kind: "bold" });
       }
     }

package/library/catalog/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "6.9.0",
+  "version": "6.10.0",
   "manifestFormat": 2,
   "globalPlugins": [
     {
@@ -40,7 +40,9 @@
           "haus.mattpocock-domain-modeling",
           "haus.mattpocock-grill-with-docs",
           "haus.mattpocock-research",
-          "haus.mattpocock-handoff"
+          "haus.mattpocock-handoff",
+          "haus.mattpocock-retro",
+          "haus.mattpocock-writing-for-agents"
         ]
       },
       "keepIds": ["haus.currents-dev-playwright-best-practices"]
@@ -49,7 +51,7 @@
   "items": [
     {
       "id": "haus.agentic-workflow-standard",
-      "version": "2.1.0",
+      "version": "2.2.1",
       "source": "haus",
       "type": "template",
       "path": "templates/agentic-workflow-standard.md",
@@ -60,7 +62,7 @@
       "tags": ["workflow", "baseline", "project-instructions"],
       "repoRoles": [],
       "installMode": "copy-selected",
-      "tokenEstimate": 3189,
+      "tokenEstimate": 3434,
       "tokenBudget": 5131,
       "default": true,
       "reviewStatus": "approved",
@@ -1656,7 +1658,7 @@
     },
     {
       "id": "haus.adr-decisions",
-      "version": "1.1.0",
+      "version": "1.2.0",
       "source": "haus",
       "type": "skill",
       "path": "skills/haus-owned/general/adr-decisions",
@@ -1668,7 +1670,7 @@
       "repoRoles": [],
       "ecosystem": "general",
       "installMode": "copy-selected",
-      "tokenEstimate": 863,
+      "tokenEstimate": 924,
       "tokenBudget": 1122,
       "default": true,
       "reviewStatus": "approved",
@@ -1676,7 +1678,7 @@
     },
     {
       "id": "haus.issue-authoring",
-      "version": "1.3.0",
+      "version": "1.4.1",
       "source": "haus",
       "type": "skill",
       "path": "skills/haus-owned/general/issue-authoring",
@@ -1688,7 +1690,7 @@
       "repoRoles": [],
       "ecosystem": "general",
       "installMode": "copy-selected",
-      "tokenEstimate": 2284,
+      "tokenEstimate": 2590,
       "tokenBudget": 2970,
       "default": true,
       "reviewStatus": "approved",
@@ -1725,7 +1727,7 @@
     },
     {
       "id": "haus.issue-creator",
-      "version": "1.2.0",
+      "version": "1.3.0",
       "source": "haus",
       "type": "agent",
       "path": "agents/haus-owned/issue-creator.md",
@@ -1737,7 +1739,7 @@
       "repoRoles": [],
       "ecosystem": "general",
       "installMode": "copy-selected",
-      "tokenEstimate": 749,
+      "tokenEstimate": 797,
       "tokenBudget": 974,
       "default": true,
       "reviewStatus": "approved",
@@ -5564,14 +5566,14 @@
     },
     {
       "id": "haus.mattpocock-grill-with-docs",
-      "version": "1.0.0",
+      "version": "1.0.1",
       "source": "curated",
       "type": "skill",
       "path": "sources/mattpocock/skills/engineering/grill-with-docs",
       "title": "Mattpocock Grill With Docs",
       "purpose": "A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.",
       "whenToUse": "A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.",
-      "whenNotToUse": "Not for a customer request that is to be specced: the request flow never asks questions back. Run it on a branch or worktree, because it writes files. One session: split larger work first.",
+      "whenNotToUse": "Not for a customer request that is to be specced: the request flow never asks questions back. Run it on a branch (a worktree only from a clean, committed state), because it writes files. One session: split larger work first.",
       "tags": ["workflow"],
       "repoRoles": [],
       "tokenEstimate": 62,
@@ -5660,6 +5662,72 @@
           "role": "handoff-workflow"
         }
       ]
+    },
+    {
+      "id": "haus.mattpocock-retro",
+      "version": "1.0.0",
+      "source": "curated",
+      "type": "skill",
+      "path": "sources/mattpocock/skills/engineering/retro",
+      "title": "Mattpocock Retro",
+      "purpose": "Conduct a retrospective on a coding session.",
+      "whenToUse": "Conduct a retrospective on a coding session.",
+      "whenNotToUse": "Not for a verdict on the code a session produced. A candidate about haus-shipped content is filed upstream, never hand-edited. Only the candidates you pick are filed.",
+      "tags": ["workflow"],
+      "repoRoles": [],
+      "tokenEstimate": 1093,
+      "tokenBudget": 1421,
+      "installMode": "copy-selected",
+      "default": false,
+      "reviewStatus": "approved",
+      "riskLevel": "low",
+      "useMode": "copy",
+      "license": "MIT",
+      "licenseConfidence": "high",
+      "originSourceId": "mattpocock-skills",
+      "originUrl": "https://github.com/mattpocock/skills/blob/4588b32ecab9ecc9fc8cc6b6c5e7d675b6004b0d/skills/engineering/retro/SKILL.md",
+      "pinnedRef": "4588b32ecab9ecc9fc8cc6b6c5e7d675b6004b0d",
+      "ecosystem": "general",
+      "optInTier": "workflow",
+      "optInGroup": "Session retrospective",
+      "requiresAny": [
+        {
+          "role": "retro-workflow"
+        }
+      ]
+    },
+    {
+      "id": "haus.mattpocock-writing-for-agents",
+      "version": "1.0.0",
+      "source": "curated",
+      "type": "skill",
+      "path": "sources/mattpocock/skills/productivity/writing-for-agents",
+      "title": "Mattpocock Writing For Agents",
+      "purpose": "Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.",
+      "whenToUse": "Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.",
+      "whenNotToUse": "Not for generating or refreshing project docs or the CLAUDE.md body: the writing-documentation skill owns that. Not for testing a skill before shipping: the superpowers writing-skills skill does that. Never on haus-managed files and blocks, which change only through the catalog and haus apply.",
+      "tags": ["workflow"],
+      "repoRoles": [],
+      "tokenEstimate": 2722,
+      "tokenBudget": 3539,
+      "installMode": "copy-selected",
+      "default": false,
+      "reviewStatus": "approved",
+      "riskLevel": "low",
+      "useMode": "copy",
+      "license": "MIT",
+      "licenseConfidence": "high",
+      "originSourceId": "mattpocock-skills",
+      "originUrl": "https://github.com/mattpocock/skills/blob/4588b32ecab9ecc9fc8cc6b6c5e7d675b6004b0d/skills/productivity/writing-for-agents/SKILL.md",
+      "pinnedRef": "4588b32ecab9ecc9fc8cc6b6c5e7d675b6004b0d",
+      "ecosystem": "general",
+      "optInTier": "workflow",
+      "optInGroup": "Session retrospective",
+      "requiresAny": [
+        {
+          "role": "retro-workflow"
+        }
+      ]
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haus-tech/haus-workflow",
-  "version": "5.11.0",
+  "version": "5.12.0",
   "description": "Haus AI workflow CLI for Claude Code.",
   "type": "module",
   "bin": {