@haus-tech/haus-workflow 6.7.1 → 7.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (127) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/README.md +41 -85
  3. package/dist/cli.js +17629 -23486
  4. package/docs/before-you-start.md +17 -22
  5. package/docs/glossary.md +10 -8
  6. package/package.json +3 -6
  7. package/packages/agents/issue-creator.md +59 -0
  8. package/packages/configs/eslint/eslint.config.mjs +90 -0
  9. package/packages/configs/lighthouse/lighthouserc.yml +35 -0
  10. package/packages/configs/prettier/.prettierignore +28 -0
  11. package/packages/configs/prettier/prettier.config.cjs +12 -0
  12. package/packages/packages.yaml +81 -0
  13. package/packages/skills/adr-decisions/SKILL.md +113 -0
  14. package/packages/skills/auth-oidc-azure-bankid-patterns/SKILL.md +46 -0
  15. package/packages/skills/auth-oidc-azure-bankid-patterns/references/conventions.md +29 -0
  16. package/packages/skills/auth-oidc-azure-bankid-patterns/references/scope.md +30 -0
  17. package/packages/skills/auth-oidc-azure-bankid-patterns/references/workflow.md +38 -0
  18. package/packages/skills/bullmq-patterns/SKILL.md +53 -0
  19. package/packages/skills/bullmq-patterns/references/conventions.md +33 -0
  20. package/packages/skills/bullmq-patterns/references/scope.md +30 -0
  21. package/packages/skills/bullmq-patterns/references/workflow.md +50 -0
  22. package/{library/global → packages}/skills/haus-workflow/SKILL.md +28 -41
  23. package/packages/skills/haus-workflow/references/init.md +57 -0
  24. package/{library/global → packages}/skills/haus-workflow/references/new.md +15 -20
  25. package/packages/skills/i18next-patterns/SKILL.md +52 -0
  26. package/packages/skills/i18next-patterns/references/conventions.md +32 -0
  27. package/packages/skills/i18next-patterns/references/scope.md +29 -0
  28. package/packages/skills/i18next-patterns/references/workflow.md +39 -0
  29. package/packages/skills/issue-authoring/SKILL.md +184 -0
  30. package/packages/skills/issue-authoring/references/issue-tracker.md +29 -0
  31. package/packages/skills/issue-authoring/references/native-metadata.md +122 -0
  32. package/packages/skills/issue-authoring/references/recording-approval.md +29 -0
  33. package/packages/skills/laravel-nova-patterns/SKILL.md +45 -0
  34. package/packages/skills/laravel-nova-patterns/references/conventions.md +26 -0
  35. package/packages/skills/laravel-nova-patterns/references/scope.md +30 -0
  36. package/packages/skills/laravel-nova-patterns/references/workflow.md +36 -0
  37. package/packages/skills/nextauth-patterns/SKILL.md +48 -0
  38. package/packages/skills/nextauth-patterns/references/conventions.md +33 -0
  39. package/packages/skills/nextauth-patterns/references/scope.md +33 -0
  40. package/packages/skills/nextauth-patterns/references/workflow.md +46 -0
  41. package/packages/skills/nx-tag-conventions/SKILL.md +32 -0
  42. package/packages/skills/package-manager-yarn4-pnpm89/SKILL.md +41 -0
  43. package/packages/skills/package-manager-yarn4-pnpm89/references/conventions.md +25 -0
  44. package/packages/skills/package-manager-yarn4-pnpm89/references/scope.md +30 -0
  45. package/packages/skills/package-manager-yarn4-pnpm89/references/workflow.md +39 -0
  46. package/packages/skills/qliro-patterns/SKILL.md +48 -0
  47. package/packages/skills/qliro-patterns/references/conventions.md +28 -0
  48. package/packages/skills/qliro-patterns/references/scope.md +30 -0
  49. package/packages/skills/qliro-patterns/references/workflow.md +46 -0
  50. package/packages/skills/react-router-v7-patterns/SKILL.md +47 -0
  51. package/packages/skills/react-router-v7-patterns/references/conventions.md +30 -0
  52. package/packages/skills/react-router-v7-patterns/references/scope.md +32 -0
  53. package/packages/skills/react-router-v7-patterns/references/workflow.md +43 -0
  54. package/{library/global → packages}/skills/request/scripts/korning.mjs +1 -1
  55. package/packages/skills/strapi-patterns/SKILL.md +53 -0
  56. package/packages/skills/strapi-patterns/references/conventions.md +33 -0
  57. package/packages/skills/strapi-patterns/references/scope.md +29 -0
  58. package/packages/skills/strapi-patterns/references/workflow.md +47 -0
  59. package/packages/skills/vendure-app-patterns/SKILL.md +34 -0
  60. package/packages/skills/vendure-app-patterns/references/conventions.md +25 -0
  61. package/packages/skills/vendure-app-patterns/references/scope.md +29 -0
  62. package/packages/skills/vendure-app-patterns/references/workflow.md +45 -0
  63. package/packages/skills/vendure-plugin-patterns/SKILL.md +45 -0
  64. package/packages/skills/vendure-plugin-patterns/references/conventions.md +27 -0
  65. package/packages/skills/vendure-plugin-patterns/references/scope.md +30 -0
  66. package/packages/skills/vendure-plugin-patterns/references/workflow.md +42 -0
  67. package/packages/skills/whats-installed/SKILL.md +55 -0
  68. package/packages/skills/wordpress-acf-elementor-jetengine-patterns/SKILL.md +41 -0
  69. package/packages/skills/wordpress-acf-elementor-jetengine-patterns/references/conventions.md +25 -0
  70. package/packages/skills/wordpress-acf-elementor-jetengine-patterns/references/scope.md +28 -0
  71. package/packages/skills/wordpress-acf-elementor-jetengine-patterns/references/workflow.md +41 -0
  72. package/packages/skills/wordpress-bedrock-patterns/SKILL.md +41 -0
  73. package/packages/skills/wordpress-bedrock-patterns/references/conventions.md +27 -0
  74. package/packages/skills/wordpress-bedrock-patterns/references/scope.md +28 -0
  75. package/packages/skills/wordpress-bedrock-patterns/references/workflow.md +42 -0
  76. package/packages/skills/writing-documentation/SKILL.md +153 -0
  77. package/packages/skills/writing-documentation/references/claude-template-workspace.md +60 -0
  78. package/packages/skills/writing-documentation/references/claude-template.md +43 -0
  79. package/packages/skills/writing-documentation/references/completeness-criteria.md +26 -0
  80. package/packages/skills/writing-documentation/references/summary-template.md +81 -0
  81. package/packages/skills/writing-documentation/references/topic-file-formats.md +125 -0
  82. package/packages/skills/writing-documentation/references/validation-checklist.md +42 -0
  83. package/packages/templates/agentic-workflow-poc.md +180 -0
  84. package/packages/templates/agentic-workflow-standard.md +170 -0
  85. package/packages/templates/decision-template.md +27 -0
  86. package/packages/templates/decisions-ci-gate.yml +32 -0
  87. package/packages/templates/lefthook-branch-guard.yml +27 -0
  88. package/packages/templates/lefthook-lighthouse.yml +28 -0
  89. package/packages/templates/lefthook-quality.yml +34 -0
  90. package/packages/templates/lefthook-security.yml +27 -0
  91. package/packages/templates/start-here.md +72 -0
  92. package/library/catalog/decisions-triggers.json +0 -26
  93. package/library/catalog/haus-lock.schema.json +0 -4
  94. package/library/catalog/manifest.json +0 -5941
  95. package/library/catalog/validation-rules.json +0 -169
  96. package/library/global/settings-fragments/hooks.json +0 -53
  97. package/library/global/skills/haus-workflow/references/init.md +0 -88
  98. package/scripts/postinstall.mjs +0 -62
  99. /package/{library/global → packages}/agents/request-assessor.md +0 -0
  100. /package/{library/global → packages}/agents/request-design-reviewer.md +0 -0
  101. /package/{library/global → packages}/agents/request-designer.md +0 -0
  102. /package/{library/global → packages}/agents/request-scorer.md +0 -0
  103. /package/{library/global → packages}/agents/request-specifier-eskalerad.md +0 -0
  104. /package/{library/global → packages}/agents/request-specifier.md +0 -0
  105. /package/{library/global → packages}/skills/haus-workflow/references/clone.md +0 -0
  106. /package/{library/global → packages}/skills/request/SKILL.md +0 -0
  107. /package/{library/global → packages}/skills/request/scripts/archive.mjs +0 -0
  108. /package/{library/global → packages}/skills/request/scripts/bedom.mjs +0 -0
  109. /package/{library/global → packages}/skills/request/scripts/check-lasta.mjs +0 -0
  110. /package/{library/global → packages}/skills/request/scripts/compare-scores.mjs +0 -0
  111. /package/{library/global → packages}/skills/request/scripts/contract-check.mjs +0 -0
  112. /package/{library/global → packages}/skills/request/scripts/kontroll.mjs +0 -0
  113. /package/{library/global → packages}/skills/request/scripts/lib.mjs +0 -0
  114. /package/{library/global → packages}/skills/request/scripts/precheck.mjs +0 -0
  115. /package/{library/global → packages}/skills/request/scripts/ref-hash.mjs +0 -0
  116. /package/{library/global → packages}/skills/request/scripts/report.mjs +0 -0
  117. /package/{library/global → packages}/skills/request/scripts/resolve-anchors.mjs +0 -0
  118. /package/{library/global → packages}/skills/request/scripts/svep.mjs +0 -0
  119. /package/{library/global → packages}/skills/request-assess-impact/SKILL.md +0 -0
  120. /package/{library/global → packages}/skills/request-score/SKILL.md +0 -0
  121. /package/{library/global → packages}/skills/request-score/references/poangskala.md +0 -0
  122. /package/{library/global → packages}/skills/request-sync/SKILL.md +0 -0
  123. /package/{library/global → packages}/skills/request-write-spec/SKILL.md +0 -0
  124. /package/{library/global → packages}/skills/request-write-spec/references/specformat.md +0 -0
  125. /package/{library/global → packages}/skills/slack-cowork/SKILL.md +0 -0
  126. /package/{library/global → packages}/skills/slack-cowork/references/canvas-markdown.md +0 -0
  127. /package/{library/global → packages}/skills/slack-cowork/references/synk.md +0 -0
package/CHANGELOG.md CHANGED
@@ -1,5 +1,38 @@
1
1
  # Changelog
2
2
 
3
+ ## [7.0.0](https://github.com/WeAreHausTech/haus-workflow/compare/v6.8.0...v7.0.0) (2026-10-26)
4
+
5
+ ### ⚠ BREAKING CHANGES
6
+
7
+ - **sync:** removes haus configs, workspace link-context, global plugins, the catalog commands and the recommender (haus recommend is a no-op stub). haus install drops --force, --check, --postinstall, --internal and --no-internal, and the npm postinstall step is gone. HAUS_INTERNAL_CHANNEL, HAUS_NO_POSTINSTALL and HAUS_DEBUG are ignored. backups restore --json drops kept and records. Templates and configs in packages/ are copied by hand.
8
+
9
+ [adr-skip] implements ADR-0190 and ADR-0191, no new decision
10
+
11
+ Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
12
+ Claude-Session: https://claude.ai/code/session_01HD37gCdJYcuy7sZdj6gnAX
13
+
14
+ ### Features
15
+
16
+ - **release:** haus release start, merge, status, ship, tag and deploy ([#926](https://github.com/WeAreHausTech/haus-workflow/issues/926)) ([63a950d](https://github.com/WeAreHausTech/haus-workflow/commit/63a950df237de6298e35af91fdb3933083536c9c))
17
+ - **release:** release init and suite commands, guard closures and docs for the release model ([#934](https://github.com/WeAreHausTech/haus-workflow/issues/934)) ([df34f82](https://github.com/WeAreHausTech/haus-workflow/commit/df34f82e88c4ece85c8a0d4d34df9e610a106d2b)), closes [#909](https://github.com/WeAreHausTech/haus-workflow/issues/909)
18
+ - **sync:** remove copy-install, catalog pipeline and machine-wide installs ([#936](https://github.com/WeAreHausTech/haus-workflow/issues/936)) ([94e104f](https://github.com/WeAreHausTech/haus-workflow/commit/94e104f1d0c4c818d288369098f9df285cc6a477))
19
+
20
+ ### Bug Fixes
21
+
22
+ - **sync:** adopt identical copies and untrack synced paths ([#930](https://github.com/WeAreHausTech/haus-workflow/issues/930)) ([e8168a6](https://github.com/WeAreHausTech/haus-workflow/commit/e8168a6d1ab80437ecd485b63b98deaa7589f96e))
23
+
24
+ ## [6.8.0](https://github.com/WeAreHausTech/haus-workflow/compare/v6.7.1...v6.8.0) (2026-10-26)
25
+
26
+ ### Features
27
+
28
+ - **guard:** release branches pass ungated, full-suite gate on main, release deploy asks ([#924](https://github.com/WeAreHausTech/haus-workflow/issues/924)) ([e89c42d](https://github.com/WeAreHausTech/haus-workflow/commit/e89c42dc13a2dd3d7c334db2f2d01ec8d6d2af0b)), closes [#909](https://github.com/WeAreHausTech/haus-workflow/issues/909)
29
+ - **packages:** move the catalog's Haus content into packages/ (haus sync phase 1) ([#913](https://github.com/WeAreHausTech/haus-workflow/issues/913)) ([97603d3](https://github.com/WeAreHausTech/haus-workflow/commit/97603d3a32b75b898c98614d0f0a18e08f9aca28))
30
+ - **sync:** haus sync writes packages from haus.json ([#916](https://github.com/WeAreHausTech/haus-workflow/issues/916)) ([4329e7b](https://github.com/WeAreHausTech/haus-workflow/commit/4329e7bf5d84bc8d7da3acd303011e5fbf58400e))
31
+ - **sync:** migrate the old lock and read haus.json in update, ci-gate and doctor ([#925](https://github.com/WeAreHausTech/haus-workflow/issues/925)) ([dce890c](https://github.com/WeAreHausTech/haus-workflow/commit/dce890c027b466103c3f9b899bd8830bbb87f4b3))
32
+ - **sync:** run haus sync from hooks and opt in with haus.json ([#917](https://github.com/WeAreHausTech/haus-workflow/issues/917)) ([0e1a6a9](https://github.com/WeAreHausTech/haus-workflow/commit/0e1a6a95ce47959e4efeb7dad8ff08e4205ba6ec))
33
+ - **sync:** sync workspace members from the root ([#918](https://github.com/WeAreHausTech/haus-workflow/issues/918)) ([5eeb007](https://github.com/WeAreHausTech/haus-workflow/commit/5eeb007707f9078b6d4c0293a4af02f20b06d151))
34
+ - **worktree:** hydrate syncs each new worktree ([#919](https://github.com/WeAreHausTech/haus-workflow/issues/919)) ([0644bfd](https://github.com/WeAreHausTech/haus-workflow/commit/0644bfdf9852ff6465ebcd825791aea5198e5e43))
35
+
3
36
  ## [6.7.1](https://github.com/WeAreHausTech/haus-workflow/compare/v6.7.0...v6.7.1) (2026-10-22)
4
37
 
5
38
  ### Bug Fixes
package/README.md CHANGED
@@ -20,11 +20,9 @@ npm install -g @haus-tech/haus-workflow
20
20
  Install the haus-workflow CLI globally by running `npm install -g @haus-tech/haus-workflow`.
21
21
  ```
22
22
 
23
- A **global** install auto-runs `haus install` via a postinstall hook — it seeds
24
- `~/.claude/` with Haus-managed skills, global slash commands, and hooks, merges
25
- security rules into `~/.claude/settings.json`, and prints a notice of what changed.
26
- It is non-fatal, idempotent, and global-only. Skip it with `HAUS_NO_POSTINSTALL=1`;
27
- re-run or repair any time with `haus install`. Undo with `haus uninstall`.
23
+ haus writes nothing to `~/.claude/` on install: skills, agents, hooks and superpowers come
24
+ from `haus sync` in each project. `haus install --session-labels` adds the one opt-in
25
+ user-level hook, and `haus uninstall` removes what an older haus put in `~/.claude/`.
28
26
 
29
27
  ---
30
28
 
@@ -34,7 +32,7 @@ Once installed, Claude Code gains a `/haus-workflow` slash command.
34
32
 
35
33
  Task names are plain verbs; each detects its own scope (a single haus-set-up repo, a
36
34
  multi-repo workspace, or neither) before acting. `refresh` also updates this machine's
37
- haus install (`~/.claude`, npm) first; `uninstall` acts ONLY on the machine, never on a
35
+ haus install (npm) first; `uninstall` acts ONLY on the machine, never on a
38
36
  repo. Every old `project:`-prefixed name (and other legacy aliases like `setup`, `fix`,
39
37
  `add-skills`) still works as an alias into the task it merged into.
40
38
 
@@ -44,7 +42,7 @@ repo. Every old `project:`-prefixed name (and other legacy aliases like `setup`,
44
42
  /haus-workflow clone [name] # clone one repo by name, or a whole workspace (repos.manifest.json); offers local-dev setup after
45
43
  /haus-workflow new [description] # create a brand-new project from a plain-language request
46
44
  /haus-workflow doctor # health check for this project or workspace; offers to apply suggested fixes
47
- /haus-workflow refresh # update haus itself (package + catalog + ~/.claude), then fully sync this project or just add optional helpers
45
+ /haus-workflow refresh # update haus itself (npm package and core files), then fully sync this project or just add packages
48
46
  /haus-workflow uninstall # remove haus global files from ~/.claude — never touches this project
49
47
  ```
50
48
 
@@ -55,23 +53,23 @@ Without an argument, the skill presents a menu so you can pick the task. With an
55
53
  ## Commands
56
54
 
57
55
  ```bash
58
- haus init # full setup: scan → recommend → apply (safe to re-run)
56
+ haus init # full setup: scan, write haus.json and the core files (safe to re-run)
59
57
  haus init --dry-run # preview the .claude/ write only; scan artifacts are still written
60
- haus clone <url> [dir] # clone a single git repo by URL (the primitive the clone/cloneandsetup tasks loop over)
58
+ haus init --packages software-engineering,web-react # set the packages haus.json names
59
+ haus sync # pull the packages haus.json names into .claude/, pinned to its release
60
+ haus clone <url> [dir] # clone a single git repo by URL (the primitive the clone task loops over)
61
61
  haus scan # scan repo and write context-map
62
- haus recommend # recommend catalog items (binary eligibility)
63
- haus apply --dry-run # preview what would be written
64
- haus apply --write # write .claude/ files (skills, agents, commands, templates)
65
- haus apply --select # interactively choose which recommended items to install
62
+ haus apply --dry-run # preview the core files apply would write
63
+ haus apply --write # write the core files (settings, hooks, CLAUDE.md and AGENTS.md blocks, WORKFLOW.md)
66
64
  haus apply --refill-config # fill still-blank workflow-config.md fields, keep edits
67
- haus update # check npm for new CLI + sync catalog + refresh ~/.claude/ and this project
68
- haus update --check # check for updates without applying
69
- haus undo # remove haus-managed project files (lock-tracked paths)
70
- haus doctor # health check: hooks, CLAUDE.md, imports, catalog cache
65
+ haus update # check npm for a new CLI and re-apply this project's core files
66
+ haus update --check # report whether the synced files follow haus.json
67
+ haus undo # remove haus-managed project files (core files; synced folders stay)
68
+ haus doctor # health check: hooks, CLAUDE.md, imports, haus sync state, CLI version
71
69
  haus guard bash|file-access # security guard hook; invoked by PreToolUse
72
70
  haus pr wait <n> # wait for a PR to merge after gh pr merge --auto; updates a branch that falls behind
73
71
  haus workspace # multi-repo ops: discover, scan, setup, doctor across a workspace
74
- haus uninstall # remove Haus-managed files from ~/.claude/
72
+ haus uninstall # remove what an older haus put in ~/.claude/
75
73
  ```
76
74
 
77
75
  > Cross-session learnings use Claude Code's **native memory** (`MEMORY.md`); haus
@@ -79,77 +77,35 @@ haus uninstall # remove Haus-managed files from ~/.claude/
79
77
 
80
78
  ---
81
79
 
82
- ## Catalog
83
-
84
- Content lives in [`haus-workflow-catalog`](https://github.com/WeAreHausTech/haus-workflow-catalog)
85
- (version pinned in `library/catalog/manifest.json`). Fetched at runtime from the latest
86
- release tag. Ref precedence: `HAUS_CATALOG_REF` env → a project's
87
- `.haus-workflow/haus.config.json#catalogRef` pin → latest release tag → bundled snapshot
88
- → `main`. **The bundled snapshot is metadata only — it has no item content to install**
89
- (see "Offline and air-gapped use" below); it exists so the CLI still has a manifest to
90
- read with no network access, not as a usable install source.
91
- Validation rules sync from catalog → `library/catalog/validation-rules.json` (ADR-0001).
92
-
93
- Items install by **flattening** (`skill`, `agent`, `template`, `command` — basename only)
94
- or by **mirroring** their upstream path under `sources/<slug>/` (`rule`, `asset` — so
95
- `.claude/rules/react/hooks.md` lands where the curated prose that references it expects).
96
- See [ADR-0046](docs/decisions/0046-manifest-format-2-install-contract.md).
97
-
98
- On `haus apply` / `haus update`, items **removed from the catalog** or marked
99
- **deprecated** are pruned from the project when their on-disk copy still matches the
100
- lock hash; user-edited copies are kept, lock entry and all. Every lock-tracked catalog item
101
- haus deletes is snapshotted under `.haus-workflow/backups/` first and can be put back with
102
- `haus backups restore` (`haus undo` also strips haus's parts of `.claude/settings.json` and
103
- the root `CLAUDE.md` and removes `.claude/rules/haus.md` when haus owns it; its `undo-`
104
- snapshot covers those too, and it keeps the lock rows of the edited items it leaves behind,
105
- see [docs/cli.md](docs/cli.md) → `haus undo`). Approved items deselected via
106
- `--select` are not pruned.
107
-
108
- > **Upgrading from a pre-`0.30.0` CLI:** deprecated-skill pruning shipped in `0.30.0`.
109
- > If an older CLI left deprecated skills on disk, upgrade first
110
- > (`npm i -g @haus-tech/haus-workflow`) then run `haus update` to prune them.
111
-
112
- > **Upgrading to `2.0.0`:** see [docs/upgrading-2.0.md](docs/upgrading-2.0.md). It carries
113
- > the rollout order (CLI first, catalog second), the two renamed skill directories, what
114
- > `.claude/rules/` now contains, and how to pin to a format-1 catalog to defer.
115
-
116
- ### Offline and air-gapped use
117
-
118
- The npm package ships catalog **metadata** only — the manifest, validation rules, ADR
119
- triggers and the lock schema. It does not contain any catalog item content. A machine with
120
- no populated cache can write core files (`CLAUDE.md`, `settings.json`, `WORKFLOW.md`) but
121
- cannot install skills, agents, or rules until it has real content — from a network sync
122
- or an imported bundle (see [ADR-0060](docs/decisions/0060-offline-catalog-honesty.md)).
123
-
124
- To set up a disconnected machine:
80
+ ## Packages
125
81
 
126
- ```bash
127
- # On a machine with network access:
128
- haus update
129
- haus catalog bundle export --out catalog.tgz
82
+ Shipped content (skills, agents, templates, configs) lives in [`packages/`](packages/) in
83
+ this repo, grouped into packages in [`packages/packages.yaml`](packages/packages.yaml)
84
+ (ADR-0191). Some packages also name upstream content by pinned commit: superpowers by tag,
85
+ a few Matt Pocock skills and ECC agents.
86
+
87
+ A project commits one file, `haus.json`, naming a haus release and its packages:
130
88
 
131
- # Move catalog.tgz across, then on the disconnected machine:
132
- haus catalog bundle import catalog.tgz
133
- haus apply --write --offline
89
+ ```json
90
+ { "release": "7.0.0", "packages": ["software-engineering", "web-react"] }
134
91
  ```
135
92
 
136
- Pass `--offline` (or set `HAUS_OFFLINE=1`) to skip the network legs up front rather than
137
- waiting on timeouts (catalog sync, npm version check, workflow-template fetch, llms.txt
138
- reference fetch, global-plugin install; the read-only local plugin probe still runs — see
139
- [docs/cli.md](docs/cli.md) → `--offline` for why). It never changes what gets installed.
140
-
141
- The honest-shortfall reporting covers `haus apply`, `haus init`, `haus new`, and
142
- `haus workspace setup` (issue #325 extended `apply`'s original ADR-0060 gate to `init`
143
- and `workspace setup`; issue #329 threaded the same `--allow-empty-cache` flag through
144
- `haus new`): a run that cannot install everything it wanted reports `K of N catalog
145
- items installed` and exits 1 if it installed none, unless `--allow-empty-cache` opts
146
- into writing core files anyway (still exits 1 having installed nothing, though in a
147
- project already set up a wanted item whose files are on disk from an earlier run counts
148
- as installed). `workspace
149
- setup` reports this per member repo — a repo that installed zero catalog items, hit
150
- the zero-signal guard, or was refused for an unsupported catalog format is recorded
151
- `failed`, not `ok` (issue #330). See [docs/cli.md](docs/cli.md) for each command's
152
- exact flags and behaviour.
93
+ `haus sync` reads it, pulls `packages.yaml` at tag `v<release>` and the content it names from
94
+ git into a mirror cache (`~/.cache/haus`, or `HAUS_CACHE_DIR`), and writes the package folders
95
+ into `.claude/skills/` and `.claude/agents/`. Those folders are listed in the git exclude
96
+ file, never committed, and recorded in `.haus-workflow/synced.json`, so the next sync replaces
97
+ or removes only what it wrote (ADR-0190, ADR-0151). Lefthook runs `haus sync` after checkout,
98
+ merge and rebase, and a SessionStart hook syncs from the cache, so `.claude/` follows
99
+ `haus.json` without a hand run. A project from before haus sync keeps its old
100
+ `haus.lock.json` until its first `haus sync`, which retires it.
101
+
102
+ ### Offline use
103
+
104
+ Pass `--offline` (or set `HAUS_OFFLINE=1`) to skip the network legs up front: `haus sync` and
105
+ the worktree hydration read the mirror cache only, and the npm version check is skipped. A
106
+ machine whose cache already holds the pinned commits syncs offline; one without them reports
107
+ the commit that is not in the local mirror and writes nothing. See [docs/cli.md](docs/cli.md) for
108
+ each command's exact flags and behaviour.
153
109
 
154
110
  ## Internal docs
155
111