v3.2.3
SylphAI-Inc/AdalFlowv3.2.3Jun 29, 2026by github-actions[bot]
AI Summary
A stabilization-and-foundations release focusing on remediation of usability issues from 3.2.0, improved branch topology support, and establishing a governed documentation foundation for the upcoming 3.3.x developer experience.
Key Highlights
- Improved branch topology support ensuring coordination-topology missions read/write artifacts from the correct surfaces.
- Usability upgrades including clearer global-install guidance, `SPEC_KITTY_HOME` isolation, and safer worktree discard.
- Doctrine additions establishing a Common Docs foundation with a 13-section Divio tree and 117 architecture decision records.
- Charter activation now gates org-pack agent availability across dispatch, context, and projection.
New Features
- Governed documentation foundation with directives, styleguides, and curation tactics.
- Charter activation gating org-pack agent availability.
- Isolation of all local state via `SPEC_KITTY_HOME`.
Full Release Notes
## Spec Kitty 3.2.3 **3.2.3 is a stabilization-and-foundations release.** It hardens behavior under non-trivial branch topologies, smooths the day-to-day planning and implementation loop, and lands a governed documentation and doctrine foundation for the upcoming 3.3.x developer-experience focus. - **Improved branch topology support** — coordination-topology missions now read and write every artifact from the correct surface (planning artifacts on the primary branch, status on the coordination worktree) through a single kind-aware resolution seam, backed by single-authority resolution gates. The orchestrator, the accept gate, merge/lane logic, and `spec-kitty next` no longer stall, mis-route, or report phantom early state on coordination missions. - **Usability upgrades** — a batch of mission-lifecycle tooling-loop friction fixes, clearer global-install guidance, `SPEC_KITTY_HOME` isolating *all* local state, `--json` output safe to capture with `2>&1`, safer worktree discard (no sibling data loss), and a stale tool environment that can no longer brick the CLI. - **Doctrine additions** — the Common Docs governed documentation foundation (a documentation directive, a styleguide, and curation / scaffold / write / find tactics wired into the doctrine graph) plus the structural move to a 13-section Divio `docs/` tree: 117 architecture decision records converted to metadata-in-file records under `docs/adr/`, redirect coverage for every moved page, and documentation rulers promoted to blocking gates. - **Doctrine/charter extension improvements** — charter activation now gates org-pack agent availability across dispatch, context, and projection; the generated charter interpolates the project documentation policy; and `spec-kitty doctor` reports unsanctioned built-in doctrine-graph overrides. We are continuing our efforts to remediate the usability issues introduced in `3.2.0`, though there is good progress, not everything was addressed yet. As mentioned in the `3.2.2` release: expect quick iterations to remediate these issues further in the coming days. We are committed to ensure your Spec Kitty experience is as fluent and enjoyable as possible. Full details in the [CHANGELOG](https://github.com/Priivacy-ai/spec-kitty/blob/main/CHANGELOG.md).