ace-handbook 0.35.1 → 0.36.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 (94) hide show
  1. checksums.yaml +4 -4
  2. data/.ace-defaults/handbook/config.yml +0 -0
  3. data/.ace-defaults/handbook/providers/agents.yml +0 -0
  4. data/.ace-defaults/nav/protocols/cookbook-sources/ace-handbook.yml +0 -0
  5. data/.ace-defaults/nav/protocols/guide-sources/ace-handbook.yml +0 -0
  6. data/.ace-defaults/nav/protocols/skill-sources/ace-handbook.yml +0 -0
  7. data/.ace-defaults/nav/protocols/tmpl-sources/ace-handbook.yml +0 -0
  8. data/.ace-defaults/nav/protocols/wfi-sources/ace-handbook.yml +0 -0
  9. data/CHANGELOG.md +2 -695
  10. data/LICENSE +0 -0
  11. data/Rakefile +0 -0
  12. data/handbook/cookbooks/setup-starting-a-multi-ruby-gem-monorepo-with-ace.cookbook.md +0 -0
  13. data/handbook/cookbooks/setup-starting-an-astro-project-with-ace.cookbook.md +0 -0
  14. data/handbook/guides/ai-agent-integration.g.md +0 -0
  15. data/handbook/guides/atom-pattern.g.md +0 -0
  16. data/handbook/guides/changelog.g.md +0 -0
  17. data/handbook/guides/cli-dry-cli.g.md +0 -0
  18. data/handbook/guides/cli-support-cli.g.md +0 -0
  19. data/handbook/guides/coding-standards/ruby.md +0 -0
  20. data/handbook/guides/coding-standards/rust.md +0 -0
  21. data/handbook/guides/coding-standards/typescript.md +0 -0
  22. data/handbook/guides/coding-standards.g.md +0 -0
  23. data/handbook/guides/debug-troubleshooting.g.md +0 -0
  24. data/handbook/guides/error-handling/ruby.md +0 -0
  25. data/handbook/guides/error-handling/rust.md +0 -0
  26. data/handbook/guides/error-handling/typescript.md +0 -0
  27. data/handbook/guides/error-handling.g.md +0 -0
  28. data/handbook/guides/meta/agents-definition.g.md +0 -0
  29. data/handbook/guides/meta/guides-definition.g.md +0 -0
  30. data/handbook/guides/meta/markdown-definition.g.md +0 -0
  31. data/handbook/guides/meta/tools-definition.g.md +0 -0
  32. data/handbook/guides/meta/workflow-instructions-definition.g.md +0 -0
  33. data/handbook/guides/mono-repo-patterns.g.md +0 -0
  34. data/handbook/guides/multi-agent-research.g.md +0 -0
  35. data/handbook/guides/performance/ruby.md +0 -0
  36. data/handbook/guides/performance/rust.md +0 -0
  37. data/handbook/guides/performance/typescript.md +0 -0
  38. data/handbook/guides/performance.g.md +0 -0
  39. data/handbook/guides/prompt-caching.g.md +0 -0
  40. data/handbook/guides/quality-assurance/ruby.md +0 -0
  41. data/handbook/guides/quality-assurance/rust.md +0 -0
  42. data/handbook/guides/quality-assurance/typescript.md +0 -0
  43. data/handbook/guides/quality-assurance.g.md +0 -0
  44. data/handbook/guides/strategic-planning.g.md +0 -0
  45. data/handbook/guides/troubleshooting/ruby.md +0 -0
  46. data/handbook/guides/troubleshooting/rust.md +0 -0
  47. data/handbook/guides/troubleshooting/typescript.md +0 -0
  48. data/handbook/guides/workflow-context-embedding.g.md +0 -0
  49. data/handbook/skills/as-handbook-init-project/SKILL.md +0 -0
  50. data/handbook/skills/as-handbook-manage-agents/SKILL.md +0 -0
  51. data/handbook/skills/as-handbook-manage-cookbooks/SKILL.md +0 -0
  52. data/handbook/skills/as-handbook-manage-guides/SKILL.md +0 -0
  53. data/handbook/skills/as-handbook-manage-overrides/SKILL.md +0 -0
  54. data/handbook/skills/as-handbook-manage-workflows/SKILL.md +0 -0
  55. data/handbook/skills/as-handbook-parallel-research/SKILL.md +0 -0
  56. data/handbook/skills/as-handbook-perform-delivery/SKILL.md +0 -0
  57. data/handbook/skills/as-handbook-review-cookbooks/SKILL.md +0 -0
  58. data/handbook/skills/as-handbook-review-guides/SKILL.md +0 -0
  59. data/handbook/skills/as-handbook-review-workflows/SKILL.md +0 -0
  60. data/handbook/skills/as-handbook-synthesize-research/SKILL.md +0 -0
  61. data/handbook/skills/as-handbook-update-docs/SKILL.md +0 -0
  62. data/handbook/skills/as-release/SKILL.md +0 -0
  63. data/handbook/skills/as-release-bump-version/SKILL.md +0 -0
  64. data/handbook/skills/as-release-rubygems-publish/SKILL.md +4 -2
  65. data/handbook/skills/as-release-update-changelog/SKILL.md +0 -0
  66. data/handbook/templates/completed-work-documentation.md +0 -0
  67. data/handbook/templates/cookbooks/cookbook.template.md +0 -0
  68. data/handbook/templates/research-comparison.template.md +0 -0
  69. data/handbook/workflow-instructions/handbook/init-project.wf.md +0 -0
  70. data/handbook/workflow-instructions/handbook/manage-agents.wf.md +0 -0
  71. data/handbook/workflow-instructions/handbook/manage-cookbooks.wf.md +0 -0
  72. data/handbook/workflow-instructions/handbook/manage-guides.wf.md +0 -0
  73. data/handbook/workflow-instructions/handbook/manage-workflows.wf.md +0 -0
  74. data/handbook/workflow-instructions/handbook/parallel-research.wf.md +0 -0
  75. data/handbook/workflow-instructions/handbook/perform-delivery.wf.md +40 -210
  76. data/handbook/workflow-instructions/handbook/research.wf.md +0 -0
  77. data/handbook/workflow-instructions/handbook/review-cookbooks.wf.md +0 -0
  78. data/handbook/workflow-instructions/handbook/review-guides.wf.md +0 -0
  79. data/handbook/workflow-instructions/handbook/review-workflows.wf.md +0 -0
  80. data/handbook/workflow-instructions/handbook/synthesize-research.wf.md +0 -0
  81. data/handbook/workflow-instructions/handbook/update-docs.wf.md +0 -0
  82. data/handbook/workflow-instructions/release/bump-version.wf.md +0 -0
  83. data/handbook/workflow-instructions/release/local.wf.md +0 -0
  84. data/handbook/workflow-instructions/release/publish.wf.md +0 -0
  85. data/handbook/workflow-instructions/release/rubygems-publish.wf.md +0 -0
  86. data/handbook/workflow-instructions/release/update-changelog.wf.md +0 -0
  87. data/lib/ace/handbook/cli/commands/status.rb +0 -0
  88. data/lib/ace/handbook/cli.rb +0 -0
  89. data/lib/ace/handbook/models/skill_document.rb +0 -0
  90. data/lib/ace/handbook/molecules/skill_projection.rb +0 -0
  91. data/lib/ace/handbook/organisms/skill_inventory.rb +0 -0
  92. data/lib/ace/handbook/organisms/status_collector.rb +0 -0
  93. data/lib/ace/handbook/version.rb +1 -1
  94. metadata +2 -2
data/CHANGELOG.md CHANGED
@@ -7,703 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
- ## [0.35.1] - 2026-10-10
11
10
 
12
- ### Technical
13
-
14
- - Clarify guide candidate discovery and the scope of this monorepo's checked-in priority-5 workflow source in `wfi://handbook/manage-overrides`.
15
-
16
- ## [0.35.0] - 2026-10-08
17
-
18
- ### Changed
19
-
20
- - Document standalone and protected delivery, current canonical campaign round/result handoff and scoped publication prerequisites. Keep source verification separate from installed Lab acceptance.
21
-
22
- - Route unavailable publication prerequisites through the original assignment failure/status owners without claiming protected publication or retry authority.
23
-
24
- - Route protected delivery through original worker merge request, canonical status and exact result consumption while preserving ordinary delivery and unresolved protected PR policy.
25
-
26
- ## [0.34.0] - 2026-10-05
27
-
28
- ### Changed
29
-
30
- - Canonical delivery consumes neutral attempt-bound PR operations, current executed test/independent review receipts and exact authorized merge evidence; optional release preparation remains separate from publication.
31
-
32
- ## [0.33.0] - 2026-09-28
33
-
34
- ### Added
35
- - Provider manifests may declare an optional `extensions_dir`; `ace-handbook sync` now projects extension assets from `ace-handbook-integration-*` packages (`handbook/extensions/**`) into that directory (idempotent copies; prunes only stale paths recorded in the `.ace-handbook-projection.json` receipt, leaving user-authored extensions untouched). Destinations are validated before anything is written; a failed projection rolls back overwritten **and** pruned assets so the previous installation stays complete and loadable, and the retry needs no manual cleanup. Sync summary output gains a `; extensions <dir> (N files, U updated, R removed)` segment when a provider projects extensions. `ProviderRegistry` exposes `extensions_dir(provider)` and `package_root(provider)`.
36
-
37
- ## [0.32.0] - 2026-09-27
38
-
39
- ### Added
40
- - Provider manifests may declare an optional `prompts_dir`; `ace-handbook sync` now projects canonical prompt templates from `ace-handbook-integration-*` packages (`handbook/prompts/*.md`) into that directory (idempotent writes; prunes only stale files carrying an `ace-handbook-integration-*` provenance marker, leaving user-authored templates untouched). Sync summary output gains a `; prompts <dir> (N prompts, U updated, R removed)` segment when a provider projects prompts.
41
- - Shipped `wfi://handbook/manage-overrides` (with paired skill `as-handbook-manage-overrides`): canonical override documentation covering all overridable surfaces (workflows, cookbooks, guides), the source-priority resolution rule, skills' non-overridability ("override the workflow the skill calls"), the `.agents/` sync-projection status, and planted-competitor verification probes.
42
-
43
- ### Changed
44
- - Tightened `wfi://release/rubygems-publish` baseline guidance with an OTP-burst publication contract (build all artifacts before OTP; push in ≤5 concurrent waves; defer metadata verification) for project overlays.
45
-
46
-
47
- ## [0.31.1] - 2026-09-02
48
-
49
- ### Technical
50
- - Included in the coordinated all-package patch release preparation for ACE monorepo review.
51
- ## [0.31.0] - 2026-08-12
52
-
53
- ### Added
54
- - Shipped generic baseline `wfi://release/*` workflows (`local`, `bump-version`, `update-changelog`, `publish`, `rubygems-publish`) under `handbook/workflow-instructions/release/` so plain installs resolve release skills without monorepo overlays; defaults stay non-publishing until a project publication contract exists.
55
-
56
- ## [0.30.3] - 2026-08-12
57
-
58
- ### Technical
59
- - Raised the `ace-support-core` dependency floor to `~> 0.31` after the principles-first bootstrap guidance release.
60
- ## [0.30.2] - 2026-08-12
61
-
62
- ### Technical
63
- - Aligned gemspec dependency floors with current ACE package minor release lines and safe external minor dependency bumps (no major version jumps).
64
-
65
- ## [0.30.1] - 2026-07-15
66
-
67
- ### Fixed
68
- - Made the neutral `agents` projection recognize canonical skills targeting the full legacy provider set before
69
- filtering unavailable provider manifests, so agents-only projects receive common workflows such as `as-git-commit`.
70
-
71
- ## [0.30.0] - 2026-07-15
72
-
73
- ### Added
74
- - Added agents projection coverage fields to `ace-handbook status` JSON and table output, including projection policy,
75
- excluded skill count, and the reason for curated projections.
76
-
77
- ### Technical
78
- - Added fast and E2E regression coverage for the neutral agents projection status contract.
79
-
80
- ## [0.29.1] - 2026-06-30
81
-
82
- ### Fixed
83
- - Treated skills targeting the legacy full provider set (`claude`, `codex`, `gemini`, `opencode`, `pi`) as compatible
84
- with the default `agents` projection, so installed common ACE workflow skills such as `as-git-commit` are written to
85
- `.agents/skills/` by plain `ace-handbook sync`.
86
-
87
- ## [0.29.0] - 2026-06-30
88
-
89
- ### Added
90
- - Added the built-in `agents` skill projection target, generating `.agents/skills/` for default handbook sync.
91
-
92
- ### Changed
93
- - Changed plain `ace-handbook sync` and `ace-handbook status` to use the default/enabled projection set, with `agents` as the default when no providers are configured.
94
- - Allowed explicit provider sync, such as `ace-handbook sync --provider codex`, even when the provider is not part of the default enabled set unless it is explicitly disabled.
95
-
96
- ### Technical
97
- - Added regression coverage for default `.agents/skills` projection, explicit Codex projection, disabled-provider blocking, and default status filtering.
98
-
99
- ## [0.28.1] - 2026-04-23
100
-
101
- ### Changed
102
- - Updated the monorepo setup cookbook to use `ace-config sync ace-llm-providers-cli` before handbook sync.
103
-
104
- ## [0.28.0] - 2026-04-22
105
-
106
- ### Changed
107
- - **ace-handbook v0.28.0**: Added the local release workflow (`release/local`) and switched the package release workflow to a local-only preparation flow.
108
-
109
- ### Technical
110
- - **ace-handbook v0.28.0**: Kept `as-release` behavior focused on local release prep without publishing to RubyGems.
111
-
112
- ## [0.27.4] - 2026-04-16
113
-
114
- ### Technical
115
- - Updated `TS-HANDBOOK-001` sandbox setup to source `mise.toml` from `${ACE_E2E_SOURCE_ROOT:-$PROJECT_ROOT_PATH}` so handbook smoke flows stay aligned with the shared read-only source-root contract.
116
-
117
- ## [0.27.3] - 2026-04-15
118
-
119
- ### Fixed
120
- - Corrected `TS-HANDBOOK-002` setup to copy `mise.toml` from `${ACE_E2E_SOURCE_ROOT:-$PROJECT_ROOT_PATH}` so sandboxed E2E runs load source-root tooling consistently.
121
-
122
- ### Changed
123
- - Corrected release-proof command references to use positional `ace-test-e2e ace-monorepo-e2e TS-MONO-001` invocation.
124
-
125
- ## [0.27.2] - 2026-04-15
126
-
127
- ### Changed
128
- - Updated RubyGems propagation proof docs to use the supported positional `ace-test-e2e ace-monorepo-e2e TS-MONO-001` invocation and current scenario path.
129
-
130
- ## [0.27.0] - 2026-04-14
131
-
132
- ### Changed
133
- - Rewrote `ace-handbook` E2E coverage to public-surface goal style by retaining the CLI smoke flow and adding `TS-HANDBOOK-002` sync/provider-error behavior scenarios.
134
- - Tightened `TS-HANDBOOK-001` verifier contracts to prioritize user-visible output and enforce stronger status JSON shape expectations.
135
-
136
- ### Technical
137
- - Updated usage guidance with explicit `sync --provider` and unknown-provider error-path examples aligned to the E2E public contract.
138
-
139
- ## [0.26.2] - 2026-04-13
140
-
141
- ### Changed
142
- - Documented `cookbook://` wildcard deduplication semantics in usage guidance, including canonical-path behavior and priority-preserving source selection notes.
143
-
144
- ## [0.26.1] - 2026-04-13
145
-
146
- ### Changed
147
- - Completed the batch i05 migration follow-through for this package and aligned it with the restarted `fast` / `feat` / `e2e` verification model.
148
-
149
- ### Technical
150
- - Included in the coordinated assignment-driven patch release for batch i05 package updates.
151
-
152
-
153
- ## [0.26.0] - 2026-04-12
154
-
155
- ### Changed
156
- - Migrated `ace-handbook` package tests to the `fast` / `feat` / `e2e` contract by moving deterministic suites under `test/fast`, retaining workflow-value CLI smoke E2E coverage, and aligning scenario metadata with the new deterministic paths.
157
- - Updated package docs (`README`, getting-started, usage) to teach the `ace-test ace-handbook`, optional `ace-test ace-handbook feat`, `ace-test ace-handbook all`, and `ace-test-e2e ace-handbook` verification contract.
158
-
159
- ## [0.25.4] - 2026-04-10
160
-
161
- ### Technical
162
- - Updated handbook docs and cookbook guidance to point at the restarted E2E testing flows and current release-proof references.
163
-
164
- ## [0.25.3] - 2026-04-05
165
-
166
- ### Fixed
167
- - Scoped canonical skill inventory discovery to in-project defaults and explicitly registered external sources so status and sync no longer pick up ambient installed gems.
168
-
169
- ## [0.25.2] - 2026-04-01
170
-
171
- ### Changed
172
- - Updated cookbook management/review workflows to embed canonical cookbook standards and storage-path guidance directly, keeping the workflows self-contained.
173
- - Clarified cookbook path standards by explicitly distinguishing package-owned cookbooks (`ace-handbook/handbook/cookbooks/`) from project-local overlays (`.ace-handbook/cookbooks/`) in workflow/docs references.
174
-
175
- ## [0.25.1] - 2026-04-01
176
-
177
- ### Fixed
178
- - Corrected Astro cookbook setup commands to reference supported `ace-handbook` CLI behavior (`sync` / `status` flow), removing obsolete `ace-handbook init` guidance.
179
-
180
- ### Changed
181
- - Added `.ace-handbook/cookbooks` to usage docs and standardized cookbook-review skill `argument-hint` metadata formatting.
182
-
183
- ## [0.25.0] - 2026-04-01
184
-
185
- ### Added
186
- - Added cookbook-first handbook surface with `wfi://handbook/manage-cookbooks` and `wfi://handbook/review-cookbooks` workflows plus canonical cookbook skills (`as-handbook-manage-cookbooks`, `as-handbook-review-cookbooks`) and provider projections.
187
- - Added canonical handbook-owned cookbook examples for Astro project setup and multi-ruby-gem monorepo setup, including explicit provenance and downstream propagation guidance.
188
-
189
- ### Changed
190
- - Updated README, handbook/usage references, and cookbook template standards to treat `.cookbook.md` as a first-class handbook asset with explicit provenance and concise propagation guidance.
191
-
192
- ## [0.23.5] - 2026-03-31
193
-
194
- ### Changed
195
- - Replaced `wfi://release/rubygems-verify-install` workflow with E2E scenario `TS-MONO-001-rubygems-install` in `ace-monorepo-e2e/`. Updated all skill and doc references to use `ace-test-e2e ace-monorepo-e2e TS-MONO-001`.
196
-
197
- ## [0.23.4] - 2026-03-31
198
-
199
- ### Changed
200
- - Shipped default sync config with no providers pre-enabled so users choose their own agent integrations.
201
- - Reorganized install instructions across README, quick-start, and DEVELOPMENT docs by toolkit building blocks (Plan, Build, Context, QA, Git) with all gems in `development, test` group.
202
-
203
- ## [0.23.3] - 2026-03-31
204
-
205
- ### Changed
206
- - Extracted RubyGems installation verification into standalone `wfi://release/rubygems-verify-install` workflow with mise-based sandbox isolation.
207
- - Updated `as-release-rubygems-publish` skill to recommend the standalone verification workflow instead of requiring inline proof classification.
208
-
209
- ## [0.23.2] - 2026-03-30
210
-
211
- ### Technical
212
- - Added edge-case regression coverage for `ProviderSyncer#summarize_sources`, including empty inventory handling and nil/blank source normalization.
213
-
214
- ## [0.23.1] - 2026-03-30
215
-
216
- ### Fixed
217
- - Restored `Bash(gem:*)` permissions in the canonical `as-release-rubygems-publish` skill so release workflows can invoke gem commands directly.
218
-
219
- ### Technical
220
- - Added regression coverage for projected release skill permissions to prevent permission drift.
221
-
222
- ## [0.23.0] - 2026-03-30
223
-
224
- ### Changed
225
- - Clarified `ace-handbook sync` output by adding inventory source counts and explicit rerun guidance when only one source is discovered.
226
- - Expanded `ace-handbook` docs to define `.ace-handbook/` as the canonical project-level handbook root for workflows, guides, templates, and skills in normal projects.
227
-
228
- ### Technical
229
- - Added CLI sync command regression coverage for inventory-source summary and single-source guidance output.
230
-
231
- ## [0.22.0] - 2026-03-29
232
-
233
- ### Changed
234
- - Added a deterministic RubyGems propagation proof gate to coordinated release workflows with explicit `SAFE`, `LAG_DETECTED`, and `METADATA_BROKEN` classification outcomes.
235
-
236
- ### Technical
237
- - Added operator-facing proof contract documentation and synchronized `as-release-rubygems-publish` skill guidance with the updated release workflow expectations.
238
-
239
- ## [0.21.4] - 2026-03-29
240
-
241
- ### Technical
242
- - Normalized published gem metadata so RubyGems and Ruby Toolbox use current release information instead of the 1980 fallback date.
243
-
244
- ## [0.21.3] - 2026-03-29
245
-
246
- ### Changed
247
-
248
- - Updated the coordinated release workflow so packages pulled in only by internal dependency constraint bumps are auto-added as follower releases and default to a patch bump with full version/changelog metadata.
249
- - Updated projected `as-release` skill guidance to make the new follower-package patch-release policy explicit across provider integrations.
250
-
251
- ## [0.21.2] - 2026-03-29
252
-
253
- ### Technical
254
- - Register package-level `.ace-defaults` skill-sources for ace-handbook to enable canonical skill discovery in fresh installs.
255
-
256
-
257
- ## [0.21.1] - 2026-03-29
258
-
259
- ### Fixed
260
- - **ace-handbook v0.21.1**: Bumped dependency constraints to currently available `~>` ranges on RubyGems and updated release metadata after dependency synchronization.
261
-
262
- ## [0.21.0] - 2026-03-28
263
-
264
- ### Changed
265
-
266
- - Migrated most RubyGems publish decision logic into `wfi://release/rubygems-publish`, keeping `as-release-rubygems-publish` as a thin workflow wrapper.
267
-
268
- ### Technical
269
-
270
- - Removed skill-local pending-release-discovery preference logic and aligned the workflow with build-first + single-OTP publish behavior.
271
-
272
- ## [0.20.0] - 2026-03-28
273
-
274
- ### Added
275
-
276
- - Added `bin/ace-rubygems-needs-release` to derive pending ACE RubyGems releases from a single remote snapshot instead of querying each gem individually.
277
-
278
- ### Changed
279
-
280
- - Updated the RubyGems publish workflow to prefer the helper script when available and corrected the fallback `gem search --exact` guidance.
281
- - Updated `as-release-rubygems-publish` skill instructions to prefer the helper script for pending-release discovery.
282
-
283
- ## [0.19.0] - 2026-03-23
284
-
285
- ### Added
286
-
287
- - New use case in README documenting `ace-handbook sync` and `ace-handbook status` CLI commands.
288
- - Added `as-release`, `as-release-bump-version`, `as-release-rubygems-publish`, and `as-release-update-changelog` to the handbook skills reference table.
289
- - Re-recorded getting-started demo GIF showcasing provider status and sync workflows.
290
-
291
- ### Fixed
292
-
293
- - Fixed broken `[ace-nav](../ace-nav)` cross-link in README -- corrected to `[ace-nav](../ace-support-nav)`.
294
- - Fixed incorrect `ace-integration-*` package reference in README -- corrected to `ace-handbook-integration-*`.
295
-
296
- ### Changed
297
-
298
- - Aligned gemspec description wording with summary for consistency.
299
- - Removed stale `mise` prerequisite from `docs/getting-started.md`.
300
- - Rewrote demo tape to focus on `ace-handbook status` and `ace-handbook sync --provider pi`.
301
-
302
- ## [0.18.3] - 2026-03-23
303
-
304
- ### Changed
305
-
306
- - Refreshed `README.md` to the current package layout pattern with quick-link navigation, use-case framing, and normalized section order.
307
-
308
- ## [0.18.2] - 2026-03-22
309
-
310
- ### Changed
311
-
312
- - Updated `docs/getting-started.md` to remove contradictory `mise exec --` prose and align onboarding guidance with direct `ace-*` command usage.
313
- - Documented intentional retirement of projected provider `as-idea-capture` and `as-idea-capture-features` skill files after canonical source removal.
314
-
315
- ## [0.18.1] - 2026-03-22
316
-
317
- ### Changed
318
-
319
- - Remove `mise exec --` wrapper from test fixture strings and canonical skill docs.
320
- - Document intentional retirement of projected provider `as-idea-capture` and `as-idea-capture-features` skill files after canonical source removal.
321
-
322
- ## [0.18.0] - 2026-03-22
323
-
324
- ### Changed
325
-
326
- - Reworked `ace-handbook` documentation into a landing-page README with package-focused messaging and links to dedicated docs.
327
- - Added `docs/getting-started.md`, `docs/usage.md`, and `docs/handbook.md` with tutorial and workflow/skill reference coverage.
328
- - Added demo assets under `docs/demo/` and aligned examples to the current `ace-nav resolve/list` command pattern.
329
- - Updated gem metadata summary/description to match the new README tagline and documentation positioning.
330
-
331
- ## [0.17.1] - 2026-03-21
332
-
333
- ### Added
334
-
335
- - Add RubyGems publish workflow (`wfi://release/rubygems-publish`) for publishing ACE gems in dependency order with credential verification, conflict detection, and dry-run support.
336
- - Add `as-release-rubygems-publish` skill for invoking the RubyGems publish workflow.
337
-
338
- ## [0.17.0] - 2026-03-21
339
-
340
- ### Changed
341
-
342
- - Added initial `TS-HANDBOOK-001` value-gated smoke E2E coverage for `ace-handbook` CLI help and status command contracts.
343
-
344
- ## [0.16.1] - 2026-03-18
345
-
346
- ### Changed
347
-
348
- - Migrated CLI namespace from `Ace::Core::CLI::*` to `Ace::Support::Cli::*` (ace-support-cli is now the canonical home for CLI infrastructure).
349
-
350
-
351
- ## [0.16.0] - 2026-03-18
352
-
353
- ### Changed
354
-
355
- - Removed legacy backward-compatibility behavior as part of the 0.10 cleanup release.
356
-
357
-
358
- ## [0.15.9] - 2026-03-18
359
-
360
- ### Fixed
361
-
362
- - Updated `cli-support-cli.g.md` guide to remove stale `DryCli::` namespace prefix from `VersionCommand` and `HelpCommand` class references.
363
-
364
- ## [0.15.8] - 2026-03-17
365
-
366
- ### Changed
367
-
368
- - Updated `cli-support-cli.g.md` examples to the current `ace-support-cli` API (`RegistryDsl`, `Runner`, and `coerce_types`).
369
- - Updated review workflow docs to reflect 15-minute timeout guidance for long PR review runs.
370
-
371
- ## [0.15.7] - 2026-03-15
372
-
373
- ### Changed
374
-
375
- - Migrated CLI framework from dry-cli to ace-support-cli
376
-
377
- ## [0.15.6] - 2026-03-13
378
-
379
- ### Changed
380
-
381
- - Updated handbook-owned canonical skills to explicitly run bundled workflows in the current project and execute them end-to-end.
382
-
383
- ### Technical
384
-
385
- - Refreshed provider sync and status collector regression coverage for the new compact canonical skill execution template.
386
-
387
- ## [0.15.5] - 2026-03-13
388
-
389
- ### Changed
390
-
391
- - Removed provider-specific skill body rendering so projected provider skills once again apply frontmatter overrides while preserving the canonical skill body unchanged.
392
- - Updated the canonical `as-release` skill to use the unified arguments / variables / execution structure with explicit workflow-execution guidance.
393
- - Limited provider-specific forking for `as-release` to Claude frontmatter only.
394
-
395
- ### Technical
396
-
397
- - Simplified handbook projection coverage to validate frontmatter override projection and canonical body preservation instead of provider-specific body rendering.
398
-
399
- ## [0.15.4] - 2026-03-13
400
-
401
- ### Changed
402
-
403
- - Strengthened projected workflow skill instructions for Codex delegated execution and forked provider contexts so generated provider skills explicitly load and execute workflows in the current project instead of only reading or summarizing them.
404
-
405
- ### Technical
406
-
407
- - Added projection regression coverage for strong workflow-execution rendering in both Codex `context: ace-llm` mode and provider `context: fork` mode.
408
-
409
- ## [0.15.3] - 2026-03-13
410
-
411
- ### Changed
412
-
413
- - Render Codex `ace-llm` skills from canonical frontmatter by deriving uppercase variables from `argument-hint` and generating `## Variables` / `## Instructions` sections for projected Codex skills.
414
-
415
- ### Technical
416
-
417
- - Added projection regression coverage for `context: ace-llm` rendering and argument-hint-derived Codex variable generation.
418
-
419
- ## [0.15.2] - 2026-03-12
420
-
421
- ### Fixed
422
-
423
- - Preserved conditional `--sandbox` workflow routing in provider-synced skill projections so generated Claude and Codex skills keep the canonical E2E execute path.
424
-
425
- ### Technical
426
-
427
- - Added provider-sync regression coverage for conditional workflow bodies in projected skills.
428
-
429
- ## [0.15.1] - 2026-03-12
430
-
431
- ### Changed
432
-
433
- - Updated handbook README, workflow docs, and guidance to document bundle-first workflow usage and the current handbook structure.
434
-
435
- ## [0.15.0] - 2026-03-12
436
-
437
- ### Added
438
-
439
- - Added Codex-specific delegated execution metadata to the canonical `as-release-bump-version` and `as-release-update-changelog` skills so the generated Codex skills run in fork context on `gpt-5.3-codex-spark`.
440
-
441
- ## [0.14.1] - 2026-03-12
442
-
443
- ### Technical
444
-
445
- - Updated provider sync regression coverage to verify provider-specific `context` and `model` overrides on projected git-commit skills and to keep generated provider output free of canonical `integration` metadata.
446
-
447
- ## [0.14.0] - 2026-03-12
448
-
449
- ### Changed
450
-
451
- - Changed canonical handbook skill inventory to load from registered `skill://` sources via `ace-support-nav` instead of scanning monorepo package directories directly.
452
-
453
- ### Technical
454
-
455
- - Added nav-backed inventory regression coverage and explicit skill-source registration fixtures for handbook sync/status tests.
456
-
457
- ## [0.13.1] - 2026-03-12
458
-
459
- ### Technical
460
-
461
- - Added regression coverage for the `.agent/skills` retirement so handbook sync/status changes are exercised against provider-native skill trees only.
462
-
463
- ## [0.13.0] - 2026-03-12
464
-
465
- ### Added
466
-
467
- - Added canonical skill inventory counts by `source` to `ace-handbook status` output and JSON responses.
468
-
469
- ### Changed
470
-
471
- - Expanded provider status reporting to show expected, installed, in-sync, outdated, missing, and extra skill counts, including comparisons through symlinked provider directories.
472
-
473
- ## [0.12.0] - 2026-03-10
474
-
475
- ### Added
476
-
477
- - Added a public `ace-handbook` CLI with `sync` and `status` commands for projecting canonical package skills into provider-native folders.
478
- - Added provider manifest discovery and sync/status coverage for handbook integrations, including replacement of legacy provider skill symlinks with real provider directories.
479
-
480
- ### Changed
481
-
482
- - Moved handbook integration execution to `ace-handbook` while provider packages now supply thin provider manifests for projection targets.
483
-
484
- ## [0.11.0] - 2026-03-10
485
-
486
- ### Added
487
-
488
- - Added canonical handbook-owned skills for handbook management, release workflows, and research/delivery orchestration.
489
-
490
-
491
- ## [0.10.0] - 2026-03-08
492
-
493
- ### Added
494
-
495
- - New `release/publish` workflow for coordinated multi-package releases that auto-detect modified packages, update package and root changelogs, and finish with one release commit.
496
-
497
- ### Changed
498
-
499
- - `/as-release` now loads `wfi://release/publish`, and release documentation now points to the canonical workflow path.
500
-
501
- ## [0.9.9] - 2026-03-04
502
-
503
- ### Changed
504
-
505
- - Update `perform-delivery` workflow PR skill references from `/ace-git-create-pr` to `/ace-github-pr-create`
506
-
507
- ## [0.9.8] - 2026-02-25
508
-
509
- ### Changed
510
-
511
- - Update `perform-delivery` workflow task lookup guidance to use `ace-task show <ref>` for explicit task selection.
512
-
513
- ## [0.9.7] - 2026-02-22
514
-
515
- ### Technical
516
-
517
- - Update `ace-bundle project` → `ace-bundle load project` in update-docs workflow
518
-
519
- ## [0.9.6] - 2026-02-22
11
+ ## [0.36.0] - 2026-10-20
520
12
 
521
13
  ### Changed
522
14
 
523
- - Migrate skill naming and invocation references to hyphenated `ace-*` format (no underscores).
524
-
525
- ## [0.9.5] - 2026-02-21
526
-
527
- ### Added
528
-
529
- - "Redundant computation" root cause category in selfimprove workflow with fix template showing compute-once-pass-explicitly pattern
530
-
531
- ## [0.9.4] - 2026-02-20
532
-
533
- ### Technical
534
-
535
- - Update /ace:create-pr to /ace:git-create-pr in perform-delivery workflow
536
-
537
- ## [0.9.3] - 2026-02-20
538
-
539
- ### Technical
540
-
541
- - Update stale wfi:// references in workflow definition guide
542
-
543
- ## [0.9.2] - 2026-02-19
544
-
545
- ### Technical
546
-
547
- - Namespace workflow instructions into handbook/ subdirectory with updated wfi:// URIs
548
- - Update skill name references to use namespaced ace:handbook-action format
549
-
550
- ## [0.9.1] - 2026-02-04
551
-
552
- ### Added
553
-
554
- - Preference hierarchy for search targets in selfimprove workflow (workflows/guides preferred over skills)
555
-
556
- ## [0.9.0] - 2026-02-03
557
-
558
- ### Added
559
-
560
- - Self-improve workflow (`selfimprove.wf.md`) for transforming agent mistakes into system improvements
561
-
562
- ## [0.8.0] - 2026-01-31
563
-
564
- ### Added
565
-
566
- - Multi-agent research synthesis capabilities (Task 254):
567
-
568
- - `multi-agent-research.g.md` guide explaining when/how to use parallel agents
569
- - `research-comparison.template.md` for structured synthesis comparison
570
- - `parallel-research.wf.md` workflow for setting up parallel agent research
571
- - `synthesize-research.wf.md` workflow for combining agent outputs
572
- - `research.wf.md` with single/multi-agent decision criteria
573
-
574
- - Template protocol source configuration for ace-handbook templates
575
-
576
- ## [0.7.1] - 2026-01-29
577
-
578
- ### Fixed
579
-
580
- - Refine exit code handling documentation for dry-cli framework with exception-based pattern
581
-
582
- ## [0.7.0] - 2026-01-22
583
-
584
- ### Added
585
-
586
- - New guides extracted from ace-gems.g.md for better discoverability:
587
-
588
- - `prompt-caching.g.md` - PromptCacheManager patterns for LLM prompt generation
589
- - `cli-dry-cli.g.md` - Complete dry-cli framework reference
590
- - `mono-repo-patterns.g.md` - Mono-repo development patterns and binstubs
591
-
592
- - Document IO isolation and testing pyramid patterns
593
-
594
- ### Technical
595
-
596
- - Lower Ruby version requirement to >= 3.2.0
597
-
598
- ## [0.6.0] - 2026-01-18
599
-
600
- ### Added
601
-
602
- - Add perform-delivery workflow for multi-step delivery tracking with automatic TodoWrite externalization
603
-
604
- ### Technical
605
-
606
- - Update guides for bundle terminology
607
-
608
- ## [0.5.2] - 2026-01-16
609
-
610
- ### Changed
611
-
612
- - Rename context: to bundle: keys in configuration files
613
-
614
- ## [0.5.1] - 2026-01-08
615
-
616
- ### Fixed
617
-
618
- - Fixed `guide://` protocol links in ace-test-runner guides (added `.g` suffix for `.g.md` files)
619
- - Cross-gem guide:// links now properly resolve to resources with `.g` extension
620
-
621
- ## [0.5.0] - 2026-01-08
622
-
623
- ### Added
624
-
625
- - Migrated 10 generic guides from dev-handbook to handbook/guides/
626
-
627
- - ai-agent-integration.g.md, atom-pattern.g.md, changelog.g.md
628
- - coding-standards.g.md, debug-troubleshooting.g.md, error-handling.g.md
629
- - performance.g.md, quality-assurance.g.md, strategic-planning.g.md
630
-
631
- - Migrated 5 meta-guides to handbook/guides/meta/
632
-
633
- - agents-definition.g.md, guides-definition.g.md, markdown-definition.g.md
634
- - tools-definition.g.md, workflow-instructions-definition.g.md
635
-
636
- - Guide subdirectories with language-specific content (ruby, rust, typescript)
637
- - initialize-project-structure.wf.md workflow for project setup
638
- - Templates: cookbooks/cookbook.template.md, completed-work-documentation.md
639
- - Template discovery protocol (.ace-defaults/nav/protocols/tmpl-sources/)
640
-
641
- ### Changed
642
-
643
- - Consolidates dev-handbook content into ace-handbook gem
644
- - All development guides now distributed with gem installation
645
-
646
- ## [0.4.0] - 2026-01-03
647
-
648
- ### Added
649
-
650
- - Guides support with handbook/guides/ directory
651
- - workflow-context-embedding.g.md guide for embed_document_source pattern
652
- - Guide discovery protocol (.ace-defaults/nav/protocols/guide-sources/ace-handbook.yml)
653
-
654
- ## [0.3.0] - 2026-01-03
655
-
656
- ### Changed
657
-
658
- - **BREAKING**: Minimum Ruby version raised to 3.3.0 (was 3.1.0)
659
- - Standardized gemspec file patterns with deterministic Dir.glob
660
- - Added MIT LICENSE file
661
-
662
- ## [0.2.0] - 2025-12-30
663
-
664
- ### Changed
665
-
666
- * Rename `.ace.example/` to `.ace-defaults/` for gem defaults directory
667
-
668
- ## [0.1.0] - 2025-11-05
669
-
670
- ### Added
671
-
672
- - Initial release of ace-handbook gem as pure workflow package
673
- - 6 handbook management workflows accessible via wfi:// protocol:
674
-
675
- - `wfi://manage-guides` - Create and update development guides
676
- - `wfi://review-guides` - Review guides for quality and consistency
677
- - `wfi://manage-workflow-instructions` - Create and validate workflow files
678
- - `wfi://review-workflows` - Review workflow instructions
679
- - `wfi://manage-agents` - Create and update agent definitions
680
- - `wfi://update-handbook-docs` - Update handbook README and structure
681
-
682
- - Path references updated for project-relative usage
683
- - Complete gem structure following ACE patterns
684
- - Comprehensive documentation and usage examples
685
- - Auto-discovery support through ace-nav gem
686
-
687
- ### Changed
688
-
689
- - Migrated workflows from dev-handbook/.meta/wfi/ to installable gem
690
- - Updated path references to be project-root relative
691
- - Removed dev-handbook specific dependencies
692
-
693
- ### Removed
694
-
695
- - Moved `update-tools-docs.wf.md` to ace-docs package (tools documentation management)
696
- - Moved `update-integration-claude.wf.md` to ace-integration-claude package (Claude Code integration)
697
-
698
- ### Fixed
699
-
700
- - Added ace-nav protocol registration (.ace.example/nav/protocols/wfi-sources/ace-handbook.yml)
701
- - Updated gemspec to include protocol registration files for proper discovery
702
-
703
- ### Technical Details
15
+ - Remove the attempt/authority requirement from `wfi://handbook/perform-delivery`: record actual artifacts, executed checks and the independent reviewer verdict in the assignment report instead of attempt receipts; managed delivery remains planned for L5.5.
704
16
 
705
- - Pure workflow package with no Ruby runtime dependencies
706
- - Auto-discovery via ace-nav through handbook/workflow-instructions/ directory
707
- - Protocol registration enables ace-nav to discover workflows from installed gem
708
- - Template embedding framework ready for ADR-002 compliance
709
- - Standard ACE gem structure with lib/, handbook/, gemspec, README, CHANGELOG