@haus-tech/haus-workflow 0.30.0 → 0.31.1

package/library/catalog/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.12.2",
+  "version": "3.0.0",
   "items": [
     {
       "id": "haus.agentic-workflow-standard",
@@ -619,6 +619,8 @@
       "originUrl": "https://github.com/affaan-m/ECC/blob/ec92b528471df708c2384ebbcc82b390b60f535a/skills/laravel-plugin-discovery/SKILL.md",
       "pinnedRef": "ec92b528471df708c2384ebbcc82b390b60f535a",
       "ecosystem": "laravel",
+      "optInTier": "ops",
+      "optInGroup": "Laravel plugin discovery",
       "requiresAny": [
         {
           "role": "laravel-plugins"
@@ -753,6 +755,8 @@
       "originUrl": "https://github.com/affaan-m/ECC/blob/5b173d2e6c11b976a0f13b2f59125e08956c1d47/agents/performance-optimizer.md",
       "pinnedRef": "5b173d2e6c11b976a0f13b2f59125e08956c1d47",
       "ecosystem": "ecc",
+      "optInTier": "review",
+      "optInGroup": "Performance review",
       "default": false,
       "requiresAny": [
         {
@@ -986,6 +990,8 @@
       "originUrl": "https://github.com/affaan-m/ECC/blob/5b173d2e6c11b976a0f13b2f59125e08956c1d47/.kiro/agents/refactor-cleaner.md",
       "pinnedRef": "5b173d2e6c11b976a0f13b2f59125e08956c1d47",
       "ecosystem": "ecc",
+      "optInTier": "review",
+      "optInGroup": "Refactor cleanup",
       "default": false,
       "requiresAny": [
         {
@@ -1015,6 +1021,8 @@
       "tags": ["agent", "review", "security"],
       "tokenEstimate": 1369,
       "ecosystem": "security",
+      "optInTier": "review",
+      "optInGroup": "Security review",
       "originUrl": "https://github.com/affaan-m/ECC/blob/ec92b528471df708c2384ebbcc82b390b60f535a/agents/security-reviewer.md",
       "requiresAny": [
         {
@@ -1042,7 +1050,7 @@
       "title": "TypeScript Reviewer",
       "purpose": "Expert TypeScript/JavaScript code reviewer specializing in type safety, async correctness, Node/web security, and idiomatic patterns. Use for all TypeScript and JavaScript code changes. MUST BE USED for TypeScript/JavaScript projects.",
       "whenToUse": "Expert TypeScript/JavaScript code reviewer specializing in type safety, async correctness, Node/web security, and idiomatic patterns. Use for all TypeScript and JavaScript code changes. MUST BE USED for TypeScript/JavaScript projects.",
-      "tags": ["agent", "review", "typescript5"],
+      "tags": ["agent", "review", "typescript"],
       "tokenEstimate": 2270,
       "ecosystem": "typescript",
       "originUrl": "https://github.com/affaan-m/ECC/blob/ec92b528471df708c2384ebbcc82b390b60f535a/agents/typescript-reviewer.md",
@@ -1324,18 +1332,18 @@
       "riskLevel": "medium"
     },
     {
-      "id": "haus.nx21-monorepo-patterns",
-      "version": "1.0.1",
+      "id": "haus.nx-monorepo-patterns",
+      "version": "1.1.0",
       "source": "haus",
       "type": "skill",
-      "path": "skills/haus-owned/stack-patterns/nx21-monorepo-patterns",
-      "title": "Haus Nx 21 monorepo patterns",
+      "path": "skills/haus-owned/stack-patterns/nx-monorepo-patterns",
+      "title": "Haus Nx monorepo patterns",
       "purpose": "Guide Nx project graph, target pipeline, and workspace boundaries.",
       "whenToUse": "Use for Nx workspace graph, target, and generator configuration updates.",
       "whenNotToUse": "Do not use for app-only feature edits without workspace impact.",
       "references": ["https://nx.dev/llms.txt"],
       "tokenBudget": 1200,
-      "tags": ["nx21", "yarn4"],
+      "tags": ["nx", "yarn4"],
       "repoRoles": ["nx-monorepo"],
       "requiresAny": [
         {
@@ -1374,6 +1382,8 @@
       "originUrl": "https://github.com/yeachan-heo/oh-my-claudecode/blob/50f6ff05eb5d9ebed66f05d8c4580c0b119f37af/agents/designer.md",
       "pinnedRef": "50f6ff05eb5d9ebed66f05d8c4580c0b119f37af",
       "ecosystem": "oh-my-claudecode",
+      "optInTier": "design",
+      "optInGroup": "UI design",
       "default": false,
       "requiresAny": [
         {
@@ -1437,6 +1447,8 @@
       "originUrl": "https://github.com/yeachan-heo/oh-my-claudecode/blob/50f6ff05eb5d9ebed66f05d8c4580c0b119f37af/agents/tracer.md",
       "pinnedRef": "50f6ff05eb5d9ebed66f05d8c4580c0b119f37af",
       "ecosystem": "oh-my-claudecode",
+      "optInTier": "review",
+      "optInGroup": "Incident tracing",
       "default": false,
       "requiresAny": [
         {
@@ -1609,6 +1621,8 @@
       "originUrl": "https://github.com/redis/agent-skills/blob/5ca2e1a2d82a768221e8f71a02e3ca095a37d38e/skills/redis-observability/SKILL.md",
       "pinnedRef": "5ca2e1a2d82a768221e8f71a02e3ca095a37d38e",
       "ecosystem": "redis",
+      "optInTier": "ops",
+      "optInGroup": "Redis security & observability",
       "requiresAny": [
         {
           "role": "redis-ops"
@@ -1639,6 +1653,8 @@
       "originUrl": "https://github.com/redis/agent-skills/blob/5ca2e1a2d82a768221e8f71a02e3ca095a37d38e/skills/redis-security/SKILL.md",
       "pinnedRef": "5ca2e1a2d82a768221e8f71a02e3ca095a37d38e",
       "ecosystem": "redis",
+      "optInTier": "ops",
+      "optInGroup": "Redis security & observability",
       "requiresAny": [
         {
           "role": "redis-ops"
@@ -1714,7 +1730,7 @@
     },
     {
       "id": "haus.sentry-sentry-nextjs-sdk",
-      "version": "1.0.0",
+      "version": "1.0.1",
       "source": "curated",
       "type": "skill",
       "path": "skills/sentry/sentry-nextjs-sdk",
@@ -1724,7 +1740,7 @@
       "whenNotToUse": "Do not use when a more specific skill or command applies.",
       "tags": ["workflow", "sentry", "nextjs", "observability"],
       "repoRoles": [],
-      "tokenEstimate": 4542,
+      "tokenEstimate": 4544,
       "installMode": "copy-selected",
       "default": false,
       "reviewStatus": "approved",
@@ -1733,8 +1749,8 @@
       "license": "MIT",
       "licenseConfidence": "high",
       "originSourceId": "getsentry-sentry-for-ai",
-      "originUrl": "https://github.com/getsentry/sentry-for-ai/blob/9ab3551758913a4144517d4fafb71476a48c64f8/skills/sentry-nextjs-sdk/SKILL.md",
-      "pinnedRef": "9ab3551758913a4144517d4fafb71476a48c64f8",
+      "originUrl": "https://github.com/getsentry/sentry-for-ai/blob/bd84576db74e3e1d13361c7eda3bb303ae017b90/skills/sentry-nextjs-sdk/SKILL.md",
+      "pinnedRef": "bd84576db74e3e1d13361c7eda3bb303ae017b90",
       "ecosystem": "sentry",
       "requiresAny": [
         {
@@ -1747,7 +1763,7 @@
     },
     {
       "id": "haus.sentry-sentry-node-sdk",
-      "version": "1.0.0",
+      "version": "1.0.1",
       "source": "curated",
       "type": "skill",
       "path": "skills/sentry/sentry-node-sdk",
@@ -1757,7 +1773,7 @@
       "whenNotToUse": "Prefer sentry-nestjs-sdk for NestJS apps using @sentry/nestjs.",
       "tags": ["workflow", "sentry", "backend", "observability"],
       "repoRoles": [],
-      "tokenEstimate": 8085,
+      "tokenEstimate": 8087,
       "installMode": "copy-selected",
       "default": false,
       "reviewStatus": "approved",
@@ -1766,8 +1782,8 @@
       "license": "MIT",
       "licenseConfidence": "high",
       "originSourceId": "getsentry-sentry-for-ai",
-      "originUrl": "https://github.com/getsentry/sentry-for-ai/blob/9ab3551758913a4144517d4fafb71476a48c64f8/skills/sentry-node-sdk/SKILL.md",
-      "pinnedRef": "9ab3551758913a4144517d4fafb71476a48c64f8",
+      "originUrl": "https://github.com/getsentry/sentry-for-ai/blob/bd84576db74e3e1d13361c7eda3bb303ae017b90/skills/sentry-node-sdk/SKILL.md",
+      "pinnedRef": "bd84576db74e3e1d13361c7eda3bb303ae017b90",
       "ecosystem": "sentry",
       "requiresAny": [
         {
@@ -2124,6 +2140,8 @@
       "originSourceId": "superpowers-pcvelz",
       "originUrl": "https://github.com/pcvelz/superpowers/tree/bd000c6ec1df53449a74397f55305b22802b9a2b/skills/finishing-a-development-branch",
       "ecosystem": "superpowers",
+      "optInTier": "workflow",
+      "optInGroup": "Git worktrees & branch finishing",
       "requiresAny": [
         {
           "role": "branch-completion"
@@ -2153,6 +2171,8 @@
       "originSourceId": "superpowers-pcvelz",
       "originUrl": "https://github.com/pcvelz/superpowers/tree/bd000c6ec1df53449a74397f55305b22802b9a2b/skills/receiving-code-review",
       "ecosystem": "superpowers",
+      "optInTier": "workflow",
+      "optInGroup": "Code review workflow",
       "requiresAny": [
         {
           "role": "code-review"
@@ -2182,6 +2202,8 @@
       "originSourceId": "superpowers-pcvelz",
       "originUrl": "https://github.com/pcvelz/superpowers/tree/bd000c6ec1df53449a74397f55305b22802b9a2b/skills/requesting-code-review",
       "ecosystem": "superpowers",
+      "optInTier": "workflow",
+      "optInGroup": "Code review workflow",
       "requiresAny": [
         {
           "role": "code-review"
@@ -2211,6 +2233,8 @@
       "originSourceId": "superpowers-pcvelz",
       "originUrl": "https://github.com/pcvelz/superpowers/tree/bd000c6ec1df53449a74397f55305b22802b9a2b/skills/specifying-gates",
       "ecosystem": "superpowers",
+      "optInTier": "workflow",
+      "optInGroup": "Quality gates",
       "requiresAny": [
         {
           "role": "user-gate"
@@ -2240,6 +2264,8 @@
       "originSourceId": "superpowers-pcvelz",
       "originUrl": "https://github.com/pcvelz/superpowers/tree/48f5123e18a1a92dfba962da8dc2509391c821ee/skills/subagent-driven-development",
       "ecosystem": "superpowers",
+      "optInTier": "workflow",
+      "optInGroup": "Subagent-driven development",
       "pinnedRef": "48f5123e18a1a92dfba962da8dc2509391c821ee",
       "requiresAny": [
         {
@@ -2294,6 +2320,8 @@
       "originSourceId": "superpowers-pcvelz",
       "originUrl": "https://github.com/pcvelz/superpowers/tree/bd000c6ec1df53449a74397f55305b22802b9a2b/skills/test-driven-development",
       "ecosystem": "superpowers",
+      "optInTier": "workflow",
+      "optInGroup": "TDD workflow",
       "requiresAny": [
         {
           "role": "tdd-workflow"
@@ -2323,6 +2351,8 @@
       "originSourceId": "superpowers-pcvelz",
       "originUrl": "https://github.com/pcvelz/superpowers/tree/20c0b1ed71cb073c847432fe01379f48c5278a5f/skills/using-git-worktrees",
       "ecosystem": "superpowers",
+      "optInTier": "workflow",
+      "optInGroup": "Git worktrees & branch finishing",
       "pinnedRef": "20c0b1ed71cb073c847432fe01379f48c5278a5f",
       "requiresAny": [
         {
@@ -2427,6 +2457,8 @@
       "originSourceId": "superpowers-pcvelz",
       "originUrl": "https://github.com/pcvelz/superpowers/tree/bd000c6ec1df53449a74397f55305b22802b9a2b/skills/writing-skills",
       "ecosystem": "superpowers",
+      "optInTier": "workflow",
+      "optInGroup": "Skill authoring",
       "requiresAny": [
         {
           "role": "skill-authoring"
@@ -2466,7 +2498,7 @@
     },
     {
       "id": "haus.turbo-monorepo-patterns",
-      "version": "1.0.0",
+      "version": "1.0.1",
       "source": "haus",
       "type": "skill",
       "path": "skills/haus-owned/stack-patterns/turbo-monorepo-patterns",
@@ -2493,12 +2525,12 @@
       "riskLevel": "low"
     },
     {
-      "id": "haus.typescript5-patterns",
-      "version": "1.1.0",
+      "id": "haus.typescript-patterns",
+      "version": "1.2.0",
       "source": "haus",
       "type": "skill",
-      "path": "skills/haus-owned/stack-patterns/typescript5-patterns",
-      "title": "Haus TypeScript 5 patterns",
+      "path": "skills/haus-owned/stack-patterns/typescript-patterns",
+      "title": "Haus TypeScript patterns",
       "purpose": "Guide TypeScript contract and migration-safe typing changes.",
       "whenToUse": "Use for shared types, DTOs, interface boundaries, and type-safe refactors.",
       "whenNotToUse": "Do not use for runtime-only changes without type-contract impact.",
@@ -2804,7 +2836,7 @@
       "title": "Wshobson Typescript Advanced Types",
       "purpose": "Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications. Use when implementing complex type logic, creating reusable type utilities, or ensuring compile-time type safety in TypeScript projects.",
       "whenToUse": "Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications. Use when implementing complex type logic, creating reusable type utilities, or ensuring compile-time type safety in TypeScript projects.",
-      "whenNotToUse": "Use haus.typescript5-patterns for contract boundaries and migration-safe typing.",
+      "whenNotToUse": "Use haus.typescript-patterns for contract boundaries and migration-safe typing.",
       "tags": ["workflow", "typescript", "frontend", "backend"],
       "repoRoles": [
         "next-app",

package/library/catalog/validation-rules.json

@@ -53,7 +53,7 @@
     "vendure3",
     "nestjs",
     "graphql",
-    "nx21",
+    "nx",
     "turbo",
     "nextjs",
     "react19",

package/library/global/commands/haus-clone.md

@@ -1,3 +1,7 @@
+---
+description: Clone this project's repositories onto disk (per-repo setup is separate).
+---
+
 Clone repositories for this project. Per-repo setup (install, Docker, `.env`) is a separate step that isn't wired yet — this command only gets repos onto disk.
 
 Cloning a single repo is always `haus clone <url> [dir]`. This command picks _which_ repos to clone and runs that primitive for each. There are two modes, chosen by whether a name was given.

package/library/global/commands/haus-cloneandsetup.md

@@ -1,3 +1,7 @@
+---
+description: Clone a project's repos and set each one up for local development.
+---
+
 Clone a project's repos **and** set each one up for local development — node version, dependencies, databases, cross-repo links, and env. This is `project:clone` followed by a per-repo setup pass and a localdev orchestration pass.
 
 **Always ask before doing work — never assume.** Cloning and setup hit the network, need auth, and can touch databases; confirm before each phase, and respect repos the user already has.

package/library/global/commands/haus-doctor.md

@@ -1,3 +1,7 @@
+---
+description: Check this project's haus setup health and explain it in plain language.
+---
+
 Check the health of this project's haus setup and explain it in plain language.
 
 1. Run `haus doctor`.

package/library/global/commands/haus-fix.md

@@ -1,3 +1,7 @@
+---
+description: Diagnose and fix this project's haus setup.
+---
+
 Diagnose and fix this project's haus setup.
 
 1. Run `haus doctor` and read the verdict.

package/library/global/commands/haus-setup.md

@@ -1,3 +1,7 @@
+---
+description: Set up this project with haus, conversationally — no terminal needed.
+---
+
 Set up this project with haus, conversationally. The person you're helping may
 not be a developer — never make them open a terminal or read JSON. You run the
 commands; they read plain language and approve.
@@ -31,13 +35,37 @@ Do this in order:
    deep read discovered. You MUST run this before the next apply — `haus apply`
    does not re-calculate recommendations on its own.
 
-5. **Apply the rest.** Run `haus apply --write` again. It only writes what changed,
-   so this just adds the newly-matched helpers from step 4.
+5. **Offer optional helpers.** Read `.haus-workflow/recommendation.json` yourself
+   (never show the JSON). Two kinds of optional extras may be listed; offer only
+   the ones present, all **unchecked** by default — these are opt-in:
+   - **Optional skills & agents** (`optInEligible[]`): workflow/ops/review/design
+     helpers that don't auto-install for this stack. Group them by their
+     `optInGroup` label and present one `AskUserQuestion` option per group
+     (use each item's `purpose` and `tokenEstimate` to describe it in plain
+     language, e.g. "Code review workflow — request/receive structured reviews").
+     Collect the item ids from **all** the groups the user picked into one list
+     and run a **single** `haus recommend --include <id> <id> …` (one command with
+     every chosen id). Don't run it once per group — each run rewrites
+     `recommendation.json`, so repeated calls would drop the earlier includes.
+   - **Project config** (entries in `recommended[]` with `install: false`, e.g.
+     Haus ESLint / Prettier baselines): offer each as a plain choice ("Add the
+     Haus ESLint baseline"). On confirm, run `haus scaffold <id>`. `haus scaffold`
+     **preserves existing config files by default** and tells you when a file
+     already exists — only re-run with `haus scaffold <id> --force` if the user
+     explicitly chooses to **replace** their current config.
+
+   If neither list has anything, skip this step silently — don't ask an empty
+   question.
+
+6. **Apply the rest.** Run `haus apply --write` again. It only writes what changed,
+   so this adds the newly-matched helpers from step 4 plus any opt-ins from step 5.
 
-6. **Confirm.** End with one plain-language line, for example:
+7. **Confirm.** End with one plain-language line, for example:
    "✅ Your project is configured — I wrote your project docs, added N guardrails
-   and M coding helpers (K matched after reading your code in depth). Run
-   `/haus-doctor` any time to re-check." Fill the numbers from the apply output.
+   and M coding helpers (K matched after reading your code in depth), plus the J
+   optional helpers you chose: <name them>. Run `/haus-doctor` any time to
+   re-check." Fill the numbers from the apply output, and name the opt-ins the
+   user picked in step 5 (omit that clause if they chose none).
 
 If anything fails, explain what happened in plain language and what you'll try
 next — don't dump raw errors.

package/library/global/skills/haus-workflow/SKILL.md

@@ -26,6 +26,7 @@ The short legacy aliases still work but the names below are canonical.
 | `project:init` (`setup`, `init`)                                  | _Setup procedure below_         | project | First-time setup of an **existing** repo: adds AI skills, commands, workflow + project docs                                                                                               |
 | `project:clone [name]` (`clone`)                                  | _Clone procedure below_         | project | No name: clone a **workspace**'s repos from `repos.manifest.json`. With a `name`: find & clone one repo by name from GitHub                                                               |
 | `project:cloneandsetup [name]` (`cloneandsetup`)                  | _Clone & setup procedure below_ | project | Run `project:clone`, then set up each repo for local dev — deps, databases, cross-repo links, and env — via each repo's `.haus-workflow/localdev.yml` (+ the workspace's order/links/env) |
+| `project:add-skills` (`add-skills`, `opt-in`)                     | _Add-skills procedure below_    | project | Add optional skills, agents, or config (ESLint/Prettier) to an already-set-up project without re-running full setup                                                                       |
 | `project:refresh` (`apply`, `refresh`, `claude-md`, `regenerate`) | `haus apply --write`            | project | Re-run setup / refresh `.claude/` context + regenerate root `CLAUDE.md` import block                                                                                                      |
 | `project:doctor` (`doctor`, `check`)                              | `haus doctor`                   | project | Check for install drift                                                                                                                                                                   |
 | `update` (`upgrade`)                                              | `haus update`                   | global  | Update npm package + catalog + `~/.claude/` (also refreshes this project)                                                                                                                 |
@@ -51,6 +52,8 @@ Options:
      (no name: clone a workspace from repos.manifest.json; with a name: find & clone one repo by name from GitHub)
   5. [project] project:cloneandsetup [name] — clone repos, then set them up for local dev
      (project:clone, then per-repo deps + databases + cross-repo links + env from localdev.yml)
+  6. [project] project:add-skills — add optional skills, agents, or config to this project
+     (offers opt-in helpers matching your stack that aren't installed yet — no full re-setup)
 ```
 
 Map the user's selection to the command from the alias table, then continue to Step 2.
@@ -65,6 +68,8 @@ Run the mapped command via Bash. Quote the exact command you are running before
 
 **Exception — `project:cloneandsetup` (`cloneandsetup`):** clone followed by a per-repo setup pass, with confirmations. Skip to **Clone & setup (`project:cloneandsetup`)** under Step 3 and follow it.
 
+**Exception — `project:add-skills` (`add-skills` / `opt-in`):** a short scan → recommend → choose → apply procedure. Skip to **Add optional skills (`project:add-skills`)** under Step 3 and follow it.
+
 ## Step 3 — Post-run steps
 
 After the command completes, follow the relevant post-run steps below.
@@ -82,6 +87,31 @@ After the command completes, follow the relevant post-run steps below.
 
 1. Open and follow `~/.claude/commands/haus-cloneandsetup.md` — it runs the full `project:clone` flow, then sets up each cloned repo locally: selects the node version (`nvm install` from `.nvmrc`), enables corepack, installs JS/PHP dependencies, and seeds `.env`, confirming before each phase. It does not start servers.
 
+### Add optional skills (`project:add-skills`)
+
+For a project that's already set up but where the user wants more helpers later —
+without re-running the full `project:init` flow. Never show raw JSON; offer plain
+choices.
+
+1. Refresh the picture: run `haus scan --json` then `haus recommend` (it re-reads
+   `.haus-workflow/deep-context.json` if present).
+2. Read `.haus-workflow/recommendation.json` and `.haus-workflow/haus.lock.json`
+   yourself. Build the choices from items **not already installed** (lock ids):
+   - **Optional skills & agents** — `optInEligible[]`, grouped by `optInGroup`
+     (each carries `purpose` + `tokenEstimate` for a plain-language label).
+   - **Project config** — `recommended[]` entries with `install: false` (Haus
+     ESLint / Prettier) whose files aren't already present.
+3. If nothing is eligible, say so plainly and stop — e.g. "Everything matching
+   your stack is already installed" or "No optional helpers for this stack."
+4. Otherwise present a single `AskUserQuestion` (multi-select, all unchecked)
+   with one option per group / config item. Then:
+   - Skills/agents → `haus recommend --include <id> <id> …`, then
+     `haus apply --write`.
+   - Config → `haus scaffold <id>` (add `--force` only if the user chose to
+     replace an existing file; scaffold preserves files by default).
+5. Confirm with the names added and their combined token estimate, e.g.
+   "Added 2 optional helpers: Code review workflow, TDD workflow (~3k tokens)."
+
 ### After `haus apply --write`
 
 Verify that the root `CLAUDE.md` imports all three haus files:

package/package.json

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