@haus-tech/haus-workflow 2.0.0 → 3.1.2

package/library/catalog/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "6.0.0",
+  "version": "6.1.1",
   "manifestFormat": 2,
   "globalPlugins": [
     {
@@ -13,7 +13,7 @@
   "items": [
     {
       "id": "haus.agentic-workflow-standard",
-      "version": "1.1.0",
+      "version": "1.3.0",
       "source": "haus",
       "type": "template",
       "path": "templates/agentic-workflow-standard.md",
@@ -24,8 +24,8 @@
       "tags": ["workflow", "baseline", "project-instructions"],
       "repoRoles": [],
       "installMode": "copy-selected",
-      "tokenEstimate": 2200,
-      "tokenBudget": 2400,
+      "tokenEstimate": 3683,
+      "tokenBudget": 4790,
       "default": true,
       "reviewStatus": "approved",
       "riskLevel": "low"
@@ -231,7 +231,7 @@
         "Never commit SAML SP private keys or IDP shared secrets to the repo.",
         "Do not change redirect/callback URLs without aligning environment/config on both sides."
       ],
-      "tokenBudget": 1700,
+      "tokenBudget": 560,
       "tags": ["oidc", "azure-ad", "bankid", "saml2"],
       "repoRoles": [],
       "requiresAny": [
@@ -248,7 +248,7 @@
           "stack": "saml2"
         }
       ],
-      "tokenEstimate": 1700,
+      "tokenEstimate": 427,
       "installMode": "copy-selected",
       "ecosystem": "auth",
       "reviewStatus": "approved",
@@ -265,7 +265,7 @@
       "whenToUse": "Use for BullMQ queue definitions, processors, schedulers, and graceful shutdown.",
       "whenNotToUse": "Do not use for non-BullMQ job systems or in-process scheduling without Redis.",
       "references": ["https://docs.bullmq.io/llms.txt"],
-      "tokenBudget": 1800,
+      "tokenBudget": 790,
       "tags": ["bullmq", "queue", "backend"],
       "repoRoles": ["vendure-app", "nestjs-api"],
       "requiresAny": [
@@ -277,7 +277,7 @@
         }
       ],
       "ecosystem": "tooling",
-      "tokenEstimate": 1800,
+      "tokenEstimate": 601,
       "installMode": "copy-selected",
       "reviewStatus": "approved",
       "riskLevel": "low"
@@ -1270,8 +1270,8 @@
       "path": "configs/eslint/eslint.config.mjs",
       "title": "Haus ESLint config",
       "purpose": "ESLint 9.x flat config for Haus Tech TypeScript/React projects.",
-      "whenToUse": "Recommended when `eslint` is missing from the repo. Run `haus scaffold haus.eslint-config` to copy the config into the project root.",
-      "whenNotToUse": "Do not scaffold if the project already has a custom ESLint config that extends beyond the Haus baseline.",
+      "whenToUse": "Recommended when `eslint` is missing from the repo. Run `haus configs haus.eslint-config` to copy the config into the project root.",
+      "whenNotToUse": "Skip it if the project already has a custom ESLint config that extends beyond the Haus baseline.",
       "tags": ["eslint", "tooling", "quality"],
       "repoRoles": [],
       "requiresAny": [
@@ -1296,7 +1296,7 @@
       "whenToUse": "Use for adding/changing translations, configuring i18next, or wiring react-i18next / next-i18next.",
       "whenNotToUse": "Do not use for non-i18next translation systems or static-only content with no locale.",
       "references": ["https://www.i18next.com/llms.txt"],
-      "tokenBudget": 1800,
+      "tokenBudget": 740,
       "tags": ["i18next", "i18n", "frontend"],
       "repoRoles": ["next-app", "react-app", "vue-app", "vite-app"],
       "requiresAny": [
@@ -1311,7 +1311,7 @@
         }
       ],
       "ecosystem": "tooling",
-      "tokenEstimate": 1800,
+      "tokenEstimate": 562,
       "installMode": "copy-selected",
       "reviewStatus": "approved",
       "riskLevel": "low"
@@ -1327,7 +1327,7 @@
       "whenToUse": "Use for Laravel Nova resources, actions, filters, and admin UI behavior.",
       "whenNotToUse": "Do not use for customer-facing API/domain-only changes.",
       "references": ["https://nova.laravel.com/docs/llms.txt"],
-      "tokenBudget": 2600,
+      "tokenBudget": 490,
       "tags": ["laravel-nova", "laravel"],
       "repoRoles": ["laravel-nova-app"],
       "requiresAny": [
@@ -1336,7 +1336,7 @@
         }
       ],
       "ecosystem": "laravel",
-      "tokenEstimate": 2600,
+      "tokenEstimate": 370,
       "installMode": "copy-selected",
       "reviewStatus": "approved",
       "riskLevel": "low"
@@ -1355,8 +1355,8 @@
       "repoRoles": [],
       "ecosystem": "security",
       "installMode": "copy-selected",
-      "tokenEstimate": 220,
-      "tokenBudget": 320,
+      "tokenEstimate": 387,
+      "tokenBudget": 510,
       "default": false,
       "reviewStatus": "approved",
       "riskLevel": "low"
@@ -1375,7 +1375,7 @@
       "repoRoles": [],
       "ecosystem": "general",
       "installMode": "copy-selected",
-      "tokenEstimate": 180,
+      "tokenEstimate": 179,
       "default": false,
       "reviewStatus": "approved",
       "riskLevel": "low"
@@ -1394,7 +1394,7 @@
       "repoRoles": [],
       "ecosystem": "general",
       "installMode": "copy-selected",
-      "tokenEstimate": 120,
+      "tokenEstimate": 301,
       "default": true,
       "reviewStatus": "approved",
       "riskLevel": "low"
@@ -1413,8 +1413,48 @@
       "repoRoles": [],
       "ecosystem": "general",
       "installMode": "copy-selected",
-      "tokenEstimate": 750,
-      "tokenBudget": 900,
+      "tokenEstimate": 512,
+      "tokenBudget": 670,
+      "default": true,
+      "reviewStatus": "approved",
+      "riskLevel": "low"
+    },
+    {
+      "id": "haus.issue-authoring",
+      "version": "1.2.0",
+      "source": "haus",
+      "type": "skill",
+      "path": "skills/haus-owned/general/issue-authoring",
+      "title": "Issue authoring",
+      "purpose": "Create GitHub issues in a two-audience format: short human section for approval, deep technical section an AI can implement from. Modes: finding, deferred, idea.",
+      "whenToUse": "Filing bugs/review findings, capturing scope deferred out of a plan, recording ideas that arise during development.",
+      "whenNotToUse": "Work already approved and planned — that belongs in the plan.",
+      "tags": ["workflow", "haus", "project-instructions"],
+      "repoRoles": [],
+      "ecosystem": "general",
+      "installMode": "copy-selected",
+      "tokenEstimate": 1817,
+      "tokenBudget": 2370,
+      "default": true,
+      "reviewStatus": "approved",
+      "riskLevel": "low"
+    },
+    {
+      "id": "haus.issue-creator",
+      "version": "1.1.1",
+      "source": "haus",
+      "type": "agent",
+      "path": "agents/haus-owned/issue-creator.md",
+      "title": "Issue creator",
+      "purpose": "Background agent that files GitHub issues using the issue-authoring format, on a cheaper model and in isolated context.",
+      "whenToUse": "Spawned by the out-of-scope capture rule, or on request, to file findings, deferred scope, or ideas.",
+      "whenNotToUse": "Repos without GitHub issues enabled, or where issue hygiene is managed elsewhere.",
+      "tags": ["agent", "workflow", "haus"],
+      "repoRoles": [],
+      "ecosystem": "general",
+      "installMode": "copy-selected",
+      "tokenEstimate": 643,
+      "tokenBudget": 840,
       "default": true,
       "reviewStatus": "approved",
       "riskLevel": "low"
@@ -1430,7 +1470,7 @@
       "whenToUse": "Use for `next-auth` / `@auth/core` provider setup, session strategy, callbacks, JWT, and route protection in Next.js.",
       "whenNotToUse": "Do not use for Laravel/PHP auth, OIDC outside Next.js, or session-less API tokens.",
       "references": ["https://authjs.dev/"],
-      "tokenBudget": 2000,
+      "tokenBudget": 710,
       "tags": ["next-auth", "auth", "nextjs"],
       "repoRoles": ["next-app"],
       "requiresAny": [
@@ -1445,7 +1485,7 @@
         }
       ],
       "ecosystem": "auth",
-      "tokenEstimate": 2000,
+      "tokenEstimate": 543,
       "installMode": "copy-selected",
       "reviewStatus": "approved",
       "riskLevel": "medium"
@@ -1557,7 +1597,7 @@
       "purpose": "Guide deterministic dependency/workspace changes for Yarn4 and pnpm89.",
       "whenToUse": "Use for lockfile, workspace, and package manager configuration changes.",
       "whenNotToUse": "Do not use for feature-only code edits with no dependency/workspace impact.",
-      "tokenBudget": 1200,
+      "tokenBudget": 410,
       "tags": ["yarn4", "pnpm89"],
       "repoRoles": [],
       "requiresAny": [
@@ -1568,7 +1608,7 @@
           "stack": "pnpm89"
         }
       ],
-      "tokenEstimate": 1200,
+      "tokenEstimate": 311,
       "installMode": "copy-selected",
       "ecosystem": "packagemanager",
       "reviewStatus": "approved",
@@ -1582,8 +1622,8 @@
       "path": "configs/prettier",
       "title": "Haus Prettier config",
       "purpose": "Prettier config and .prettierignore for Haus Tech projects.",
-      "whenToUse": "Recommended when `prettier` is missing from the repo. Run `haus scaffold haus.prettier-config` to copy the config into the project root.",
-      "whenNotToUse": "Do not scaffold if the project already has a custom Prettier config.",
+      "whenToUse": "Recommended when `prettier` is missing from the repo. Run `haus configs haus.prettier-config` to copy the config into the project root.",
+      "whenNotToUse": "Skip it if the project already has a custom Prettier config.",
       "tags": ["prettier", "tooling", "quality"],
       "repoRoles": [],
       "requiresAny": [
@@ -1620,7 +1660,7 @@
         "Treat Qliro push notifications as the source of truth, not the checkout redirect; push handlers must be idempotent since Qliro retries on 5xx.",
         "Always validate the signature on incoming Qliro push payloads before trusting them."
       ],
-      "tokenBudget": 1800,
+      "tokenBudget": 650,
       "tags": ["qliro", "payments", "tooling"],
       "repoRoles": ["vendure-app", "vendure-plugin", "next-app"],
       "requiresAny": [
@@ -1632,7 +1672,7 @@
         }
       ],
       "ecosystem": "payments",
-      "tokenEstimate": 1800,
+      "tokenEstimate": 496,
       "installMode": "copy-selected",
       "reviewStatus": "approved",
       "riskLevel": "medium"
@@ -1648,7 +1688,7 @@
       "whenToUse": "Use for routes, loaders, actions, and SSR config in React Router v7 apps.",
       "whenNotToUse": "Do not use for Next.js App Router or Remix v1 codebases.",
       "references": ["https://reactrouter.com/start/framework/installation"],
-      "tokenBudget": 2000,
+      "tokenBudget": 600,
       "tags": ["frontend", "react", "typescript"],
       "repoRoles": ["react-router-app", "react-app"],
       "requiresAny": [
@@ -1663,7 +1703,7 @@
         }
       ],
       "ecosystem": "react",
-      "tokenEstimate": 2000,
+      "tokenEstimate": 456,
       "installMode": "copy-selected",
       "reviewStatus": "approved",
       "riskLevel": "low"
@@ -1680,7 +1720,7 @@
       "whenNotToUse": "Do not use when a more specific skill or command applies.",
       "tags": ["workflow", "redis", "database"],
       "repoRoles": [],
-      "tokenEstimate": 3462,
+      "tokenEstimate": 1282,
       "installMode": "copy-selected",
       "default": false,
       "reviewStatus": "approved",
@@ -1713,7 +1753,7 @@
       "whenNotToUse": "Everyday Redis usage is covered by redis-redis-connections. Install only for monitoring, triage, and observability setup (role:redis-ops).",
       "tags": ["workflow", "redis", "observability"],
       "repoRoles": [],
-      "tokenEstimate": 1546,
+      "tokenEstimate": 912,
       "installMode": "copy-selected",
       "default": false,
       "reviewStatus": "approved",
@@ -1745,7 +1785,7 @@
       "whenNotToUse": "Everyday Redis usage is covered by redis-redis-connections. Install only for production hardening / ACL / TLS workflows (role:redis-ops).",
       "tags": ["workflow", "redis", "security"],
       "repoRoles": [],
-      "tokenEstimate": 1887,
+      "tokenEstimate": 921,
       "installMode": "copy-selected",
       "default": false,
       "reviewStatus": "approved",
@@ -1778,7 +1818,7 @@
       "references": ["https://docs.sanity.io/llms.txt"],
       "tags": ["workflow", "sanity", "cms"],
       "repoRoles": [],
-      "tokenEstimate": 3195,
+      "tokenEstimate": 467,
       "installMode": "copy-selected",
       "default": false,
       "reviewStatus": "approved",
@@ -1942,7 +1982,7 @@
       "whenToUse": "Use for component stories, args/controls, and Storybook config changes.",
       "whenNotToUse": "Do not use for backend/service-only development tasks.",
       "references": ["https://storybook.js.org/llms.txt"],
-      "tokenBudget": 1500,
+      "tokenBudget": 500,
       "tags": ["storybook"],
       "repoRoles": ["react-app", "next-app", "vite-app"],
       "requiresAny": [
@@ -1957,7 +1997,7 @@
         }
       ],
       "ecosystem": "storybook",
-      "tokenEstimate": 1500,
+      "tokenEstimate": 378,
       "installMode": "copy-selected",
       "reviewStatus": "approved",
       "riskLevel": "low"
@@ -1973,7 +2013,7 @@
       "whenToUse": "Use for Strapi content type schemas, controllers, services, and policies in v5.",
       "whenNotToUse": "Do not use for Sanity, WordPress, or other CMS work.",
       "references": ["https://docs.strapi.io/llms.txt"],
-      "tokenBudget": 2000,
+      "tokenBudget": 800,
       "tags": ["strapi", "backend", "cms"],
       "repoRoles": ["strapi-app"],
       "requiresAny": [
@@ -1988,7 +2028,7 @@
         }
       ],
       "ecosystem": "cms",
-      "tokenEstimate": 2000,
+      "tokenEstimate": 608,
       "installMode": "copy-selected",
       "reviewStatus": "approved",
       "riskLevel": "low"
@@ -2123,7 +2163,7 @@
       "whenToUse": "Use for TanStack query cache behavior and TanStack router flow updates.",
       "whenNotToUse": "Do not use for styling-only component changes.",
       "references": ["https://tanstack.com/llms.txt"],
-      "tokenBudget": 2200,
+      "tokenBudget": 520,
       "tags": ["tanstack-query", "tanstack-router"],
       "repoRoles": ["next-app", "react-app"],
       "requiresAny": [
@@ -2138,7 +2178,7 @@
         }
       ],
       "ecosystem": "react",
-      "tokenEstimate": 2200,
+      "tokenEstimate": 394,
       "installMode": "copy-selected",
       "reviewStatus": "approved",
       "riskLevel": "low"
@@ -2187,7 +2227,7 @@
       "whenToUse": "Use for shared types, DTOs, interface boundaries, and type-safe refactors.",
       "whenNotToUse": "Do not use for runtime-only changes without type-contract impact.",
       "references": ["https://www.typescriptlang.org/docs/handbook/"],
-      "tokenBudget": 2200,
+      "tokenBudget": 400,
       "tags": ["typescript", "frontend", "backend"],
       "repoRoles": [
         "next-app",
@@ -2208,7 +2248,7 @@
           "dependency": "typescript"
         }
       ],
-      "tokenEstimate": 2200,
+      "tokenEstimate": 305,
       "installMode": "copy-selected",
       "ecosystem": "typescript",
       "reviewStatus": "approved",
@@ -2225,7 +2265,7 @@
       "whenToUse": "Use for Vendure app config, worker, bootstrap, and system wiring updates.",
       "whenNotToUse": "Do not use for isolated shared plugin package tasks.",
       "references": ["https://docs.vendure.io/llms.txt"],
-      "tokenBudget": 3200,
+      "tokenBudget": 390,
       "tags": ["vendure3", "nestjs", "graphql"],
       "repoRoles": ["vendure-app"],
       "requiresAny": [
@@ -2237,7 +2277,7 @@
         }
       ],
       "ecosystem": "vendure",
-      "tokenEstimate": 3200,
+      "tokenEstimate": 300,
       "installMode": "copy-selected",
       "reviewStatus": "approved",
       "riskLevel": "low"
@@ -2253,7 +2293,7 @@
       "whenToUse": "Use for Vendure plugin resolvers, services, entities, and plugin migrations.",
       "whenNotToUse": "Do not use for storefront-only UI changes or non-Vendure APIs.",
       "references": ["https://docs.vendure.io/llms.txt"],
-      "tokenBudget": 3400,
+      "tokenBudget": 510,
       "tags": ["backend", "vendure", "nestjs", "graphql", "typescript"],
       "repoRoles": ["vendure-plugin", "vendure-app"],
       "requiresAny": [
@@ -2268,7 +2308,7 @@
         }
       ],
       "ecosystem": "vendure",
-      "tokenEstimate": 3400,
+      "tokenEstimate": 388,
       "installMode": "copy-selected",
       "reviewStatus": "approved",
       "riskLevel": "low"
@@ -2284,7 +2324,7 @@
       "whenToUse": "Use for ACF field groups and Elementor/JetEngine-driven dynamic template behavior.",
       "whenNotToUse": "Do not use for generic WordPress hooks with no builder/meta impact.",
       "references": ["https://developer.wordpress.org/"],
-      "tokenBudget": 2600,
+      "tokenBudget": 420,
       "tags": ["wordpress"],
       "repoRoles": ["wordpress-bedrock-site", "wordpress-vanilla-site"],
       "requiresAny": [
@@ -2308,7 +2348,7 @@
         }
       ],
       "ecosystem": "wordpress",
-      "tokenEstimate": 2600,
+      "tokenEstimate": 320,
       "installMode": "copy-selected",
       "reviewStatus": "approved",
       "riskLevel": "low"
@@ -2324,7 +2364,7 @@
       "whenToUse": "Use for Bedrock config, env loading, and boot path behavior updates.",
       "whenNotToUse": "Do not use for hook/template-only WordPress runtime changes.",
       "references": ["https://developer.wordpress.org/"],
-      "tokenBudget": 2600,
+      "tokenBudget": 410,
       "tags": ["wordpress", "bedrock"],
       "repoRoles": ["wordpress-bedrock-site"],
       "requiresAny": [
@@ -2336,7 +2376,7 @@
         }
       ],
       "ecosystem": "wordpress",
-      "tokenEstimate": 2600,
+      "tokenEstimate": 311,
       "installMode": "copy-selected",
       "reviewStatus": "approved",
       "riskLevel": "low"
@@ -2468,11 +2508,11 @@
       "purpose": "Create or refresh agent-operable project docs (CLAUDE.md, docs/SUMMARY.md, topic files) from code.",
       "whenToUse": "Use when the user runs the docs sync or asks to init/refresh project documentation for agent context, or after setup/commands/env/deploy/integration changes.",
       "whenNotToUse": "Do not use for code changes with no documentation impact, or where facts would have to be invented.",
-      "tokenBudget": 1800,
+      "tokenBudget": 3070,
       "tags": ["workflow", "core-skill", "project-instructions"],
       "repoRoles": [],
       "requiresAny": [],
-      "tokenEstimate": 1800,
+      "tokenEstimate": 2358,
       "installMode": "copy-selected",
       "ecosystem": "workflow",
       "default": true,
@@ -2577,7 +2617,7 @@
       "whenNotToUse": "Do not use when a more specific skill or command applies.",
       "tags": ["workflow", "tailwind", "radix"],
       "repoRoles": [],
-      "tokenEstimate": 6019,
+      "tokenEstimate": 1323,
       "installMode": "copy-selected",
       "default": false,
       "reviewStatus": "approved",
@@ -3331,7 +3371,7 @@
       "whenToUse": "Use alongside haus.nx-nx-workspace / haus.nx-nx-generate when naming tags, placing generators/executors, or enforcing module boundaries.",
       "whenNotToUse": "Use haus.nx-nx-workspace or haus.nx-nx-generate for general Nx exploration/generation.",
       "references": ["https://nx.dev/llms.txt"],
-      "tokenBudget": 800,
+      "tokenBudget": 500,
       "tags": ["nx", "workflow"],
       "repoRoles": ["nx-monorepo"],
       "requiresAny": [

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

@@ -29,6 +29,7 @@ repo's files. The short legacy aliases still work but the names below are canoni
 | `project:reinit` (`reinit`, `re-init`)                            | _Reinit procedure below_        | project | **Full re-setup.** Removes all haus-managed project files (backed up first, user content preserved), then re-runs `project:init` from scratch                                                                                                                                             |
 | `project:clone [name]` (`clone`)                                  | _Clone procedure below_         | project | With a `name`: find & clone one repo by name from GitHub. No name: asks single-repo-vs-workspace first, then either mode — workspace mode clones from `repos.manifest.json`                                                                                                               |
 | `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:new [stack] [name]` (`new`, `create`)                    | _New-project procedure below_   | project | Create a **brand-new** project from an allowed stack (Next.js, Vite+React, NestJS, Expo): scaffold, haus configs, git + GitHub repo, then full init                                                                                                                                       |
 | `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`) | _Refresh procedure below_       | project | **Full non-destructive sync.** Updates the haus package + catalog first, then re-runs `project:init`'s pipeline in place — nothing is removed up front; new catalog items get added, changed ones updated, and anything removed upstream gets pruned by `apply`'s existing orphan-pruning |
 | `project:doctor` (`doctor`, `check`)                              | `haus doctor`                   | project | Check for install drift                                                                                                                                                                                                                                                                   |
@@ -43,7 +44,7 @@ repo's files. The short legacy aliases still work but the names below are canoni
 **If a task argument was passed:** look it up in the alias table above. If no match, tell the user and list valid options. If matched, skip to Step 2.
 
 **If no task was passed:** the menu has more options than one `AskUserQuestion` question can
-hold (max 4 options per question). Page through all 12 tasks in batches: each page shows the
+hold (max 4 options per question). Page through all 13 tasks in batches: each page shows the
 next 3 tasks plus a 4th "More options" choice, except the last page, which shows whatever
 tasks remain (≤4) with no continuation choice — nothing is dropped, and this pattern
 generalizes automatically if a task is ever added to or removed from the alias table above
@@ -56,39 +57,41 @@ Question 1: "What would you like to do?"
 Options:
   1. [project] project:init — add haus to an existing project for the first time
      (AI skills + commands + workflow into a repo you already have, then a deep read to write the CLAUDE.md docs body + docs/)
-  2. [project] project:refresh — full non-destructive sync with the latest haus
+  2. [project] project:new [stack] [name] — create a brand-new project from an allowed stack
+     (Next.js, Vite+React, NestJS, Expo — scaffold, haus configs, git + GitHub repo, then full init)
+  3. [project] project:refresh — full non-destructive sync with the latest haus
      (updates the haus package + catalog, then re-runs setup in place — nothing removed first)
-  3. [project] project:clone [name] — clone repos
-     (picked from here with no name yet — clone.md will ask whether it's a single repo or a whole workspace next)
-  4. [—] More options — see: project:cloneandsetup, project:add-skills, project:reinit, and 6 more
+  4. [—] More options — see: project:clone, project:cloneandsetup, project:add-skills, and 7 more
 
 Question 2: "What would you like to do?" (only shown if "More options" was picked)
 Options:
-  1. [project] project:cloneandsetup [name] — clone repos, then set them up for local dev
+  1. [project] project:clone [name] — clone repos
+     (picked from here with no name yet — clone.md will ask whether it's a single repo or a whole workspace next)
+  2. [project] project:cloneandsetup [name] — clone repos, then set them up for local dev
      (project:clone — asking single-repo-vs-workspace since no name is known yet — then per-repo deps + databases + cross-repo links + env from localdev.yml)
-  2. [project] project:add-skills — add optional skills, agents, or config to this project
+  3. [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)
-  3. [project] project:reinit — full re-setup from scratch
-     (removes all haus-managed project files, backed up first, then re-runs project:init)
-  4. [—] More options — see: update, project:doctor, project:fix, and 3 more
+  4. [—] More options — see: project:reinit, update, project:doctor, and 4 more
 
 Question 3: "What would you like to do?" (only shown if "More options" was picked again)
 Options:
-  1. [global] update — update haus package + catalog + global files
+  1. [project] project:reinit — full re-setup from scratch
+     (removes all haus-managed project files, backed up first, then re-runs project:init)
+  2. [global] update — update haus package + catalog + global files
      (haus update — checks npm for new version, fetches catalog, refreshes ~/.claude/)
-  2. [project] project:doctor — check for install drift
+  3. [project] project:doctor — check for install drift
      (haus doctor — a one-line plain-language verdict, healthy or a list of what needs attention)
-  3. [project] project:fix — diagnose and fix install drift
-     (runs doctor, applies the suggested fixes, confirms green)
-  4. [—] More options — see: install, uninstall, help
+  4. [—] More options — see: project:fix, install, uninstall, help
 
 Question 4: "What would you like to do?" (only shown if "More options" was picked a third time — last page, no further continuation)
 Options:
-  1. [global] install — seed ~/.claude/ with haus-owned files
+  1. [project] project:fix — diagnose and fix install drift
+     (runs doctor, applies the suggested fixes, confirms green)
+  2. [global] install — seed ~/.claude/ with haus-owned files
      (haus install)
-  2. [global] uninstall — remove all haus global files from ~/.claude/
+  3. [global] uninstall — remove all haus global files from ~/.claude/
      (haus uninstall)
-  3. [—] help — explain what haus-workflow is and list all available tasks
+  4. [—] help — explain what haus-workflow is and list all available tasks
      (touches no files — points to docs/cli.md and docs/runbook.md for depth)
 ```
 
@@ -98,7 +101,7 @@ Map the user's selection to the command from the alias table, then continue to S
 
 Run the mapped command via Bash. Quote the exact command you are running before executing it.
 
-**Exception — `project:init` (`setup` / `init`):** this maps to a multi-step procedure, not a single command. Do not run a bare `haus init`. Skip to **Setup (`project:init`)** under Step 3 and follow it.
+**Exception — `project:init` (`setup` / `init`):** this maps to a multi-step procedure that drives `haus init --json --dry-run` plus follow-up commands, not a single command. Skip to **Setup (`project:init`)** under Step 3 and follow it.
 
 **Exception — `project:reinit` (`reinit` / `re-init`):** removes files before re-running setup. Skip to **Reinit (`project:reinit`)** under Step 3 and follow it.
 
@@ -106,6 +109,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:new` (`new` / `create`):** collects the stack/name/org/visibility via `AskUserQuestion` and drives `haus new` non-interactively — not a single command. Skip to **New project (`project:new`)** 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.
 
 **Exception — `project:refresh` (`apply` / `refresh` / `claude-md` / `regenerate`):** updates the haus package first, then re-runs the setup pipeline — not a single command. Skip to **Refresh (`project:refresh`)** under Step 3 and follow it.
@@ -164,6 +169,10 @@ upstream gets pruned automatically by `apply`'s existing orphan-pruning.
 
 1. Open and follow `references/cloneandsetup.md` in this skill's directory — it runs the full `project:clone` flow (including clone.md's Step 0 when no name is already known), 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.
 
+### New project (`project:new`)
+
+1. Open and follow `references/new.md` in this skill's directory. It lists allowed stacks via `haus new --list --json`, collects the stack/name/org/visibility with `AskUserQuestion`, previews with `--dry-run`, confirms, then runs `haus new <stack> <name> --json --yes [flags]` for real and narrates the JSON result — including relaying any failure `detail` (resume commands) verbatim and surfacing `installHint`. Never run bare interactive `haus new`.
+
 ### Add optional skills (`project:add-skills`)
 
 For a project that's already set up but where the user wants more helpers later —
@@ -184,8 +193,8 @@ choices.
    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).
+   - Config → `haus configs <id>` (add `--force` only if the user chose to
+     replace an existing file; configs 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)."
 

package/library/global/skills/haus-workflow/references/init.md

@@ -6,7 +6,7 @@ commands; they read plain language and approve.
 
 Do this in order:
 
-1. **Detect.** Run `haus setup-project --json`. Read the JSON yourself —
+1. **Detect.** Run `haus init --json --dry-run`. Read the JSON yourself —
    do not show it. Translate what was detected into one or two plain sentences,
    e.g. "This looks like a Next.js website using Yarn. I found unit tests but no
    end-to-end tests." If the detection status is `unknown` or `partial`, say so
@@ -47,9 +47,9 @@ Do this in order:
      `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`
+     Haus ESLint baseline"). On confirm, run `haus configs <id>`. `haus configs`
      **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
+     already exists — only re-run with `haus configs <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

package/library/global/skills/haus-workflow/references/new.md

@@ -0,0 +1,24 @@
+# project:new — create a new project from an allowed stack
+
+Drives `haus new` non-interactively. NEVER run bare `haus new` without flags —
+its interactive prompts don't work through the agent; collect answers with
+AskUserQuestion and pass everything as flags.
+
+1. **List stacks.** Run `haus new --list --json`. Present the stacks via
+   AskUserQuestion (one option per stack, id + title).
+2. **Collect inputs.** Ask for: project name (free text; lowercase letters, digits,
+   `. _ -`), GitHub org (default: WeAreHausTech; "personal" = omit --org),
+   visibility (private default / public), and whether to create the GitHub
+   repo at all (default yes; no → add `--no-github`).
+3. **Preview.** Run
+   `haus new <stack> <name> --json --yes --dry-run [--org <org>] [--public] [--no-github]`
+   and show the user the planned steps in plain language. Confirm before executing.
+4. **Execute.** Re-run the same command without `--dry-run`. Parse the JSON:
+   - `ok: true` → summarize: project path, repo URL, init result, and the
+     `installHint` (dependencies are NOT installed automatically).
+   - `ok: false` → report the failed step's `detail` verbatim — it contains the
+     exact resume commands (e.g. `gh repo create … && git push -u origin main`).
+     Do NOT retry destructively; the project directory is never auto-deleted.
+5. **Hand off.** Tell the user to `cd <name>` and run the install command from
+   `installHint` — the project is fully initialized (no separate `project:init`
+   needed).

package/package.json

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