baldart 4.86.0 → 4.87.0

package/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to BALDART will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.87.0] - 2026-07-01
+
+**Plan-review gate promoted to the cross-tool SSOT (AGENTS.md primitive `1.3.0`).** The "have the plan reviewed by `plan-auditor` + `doc-reviewer` before presenting it" rule lived only in the `CLAUDE.md` stub's Plan Mode — so Codex never ran it. Now that both agents exist on Codex (transpiled to `.codex/agents/`), the tool-agnostic principle is promoted into `AGENTS.md`: **MUST have any non-trivial plan reviewed by `plan-auditor` + `doc-reviewer` (in parallel), fold in their feedback, note the review gate in the plan, and present the ALREADY-reviewed plan — never a raw one.** The Claude-only `EnterPlanMode`/`ExitPlanMode` mechanics stay in `CLAUDE.md`; `AGENTS.md` carries the principle so both tools honor it.
+
+**MINOR** — cross-tool enrichment of the shipped skeleton; no config key, no CLI/layout change, contamination-clean. Consumers pick it up on the next `npx baldart update`. `primitive_version` (AGENTS) 1.2.0 → 1.3.0; CLAUDE stub unchanged (1.1.0).
+
+### Changed
+
+- **`framework/templates/primitives/AGENTS.md`** — added the plan-review MUST after the `codebase-architect` MUST. `primitive_version` → 1.3.0.
+- **`framework/templates/primitives/AGENTS.CHANGELOG.md`** — `1.3.0` entry.
+
 ## [4.86.0] - 2026-07-01
 
 **AGENTS.md primitive regains the universal working-discipline rules (primitive `1.2.0`).** The lean v4.83.0 rewrite of the skeleton dropped a handful of everyday-habit MUSTs to stay short — but those are exactly the "conventions an agent can't infer and gets wrong" the file exists to carry. Restored as compact, stack-agnostic rules in the `AGENTS.md` skeleton (the cross-tool SSOT):

package/VERSION

@@ -1 +1 @@
-4.86.0
+4.87.0

package/framework/templates/primitives/AGENTS.CHANGELOG.md

@@ -4,6 +4,15 @@ Formato: [Keep a Changelog](https://keepachangelog.com/) · [SemVer](https://sem
 Questo è il changelog INTERNO dello skeleton spedito (`primitive_version`), separato dal
 file `AGENTS.md` generato nel consumer e indipendente dal `VERSION` del framework.
 
+## 1.3.0 — 2026-07-01
+
+- **Plan-review gate promoted to the cross-tool SSOT**: MUST have any non-trivial plan
+  reviewed by `plan-auditor` + `doc-reviewer` (in parallel) and fold in their feedback
+  BEFORE presenting it for approval — present the already-reviewed plan, never a raw one.
+  Was Claude-only (CLAUDE.md Plan Mode, before `ExitPlanMode`); now in AGENTS.md so Codex
+  runs it too (both agents exist on Codex via the transpiler). The `EnterPlanMode`/
+  `ExitPlanMode` mechanics stay in CLAUDE.md; AGENTS.md carries the tool-agnostic principle.
+
 ## 1.2.0 — 2026-07-01
 
 - Restored the universal **working-discipline** rules the lean v1.0.0 rewrite had dropped

package/framework/templates/primitives/AGENTS.md

@@ -1,4 +1,4 @@
-<!-- baldart-primitive: name=AGENTS primitive_version=1.2.0
+<!-- baldart-primitive: name=AGENTS primitive_version=1.3.0
      This is the SHIPPED SKELETON. The writer (src/utils/root-primitives.js) strips
      this banner, resolves every {{ slot }} / {{> partial }} / {{#flag}} from
      baldart.config.yml (+ package.json/README), merges .baldart/overlays/AGENTS.md,
@@ -28,6 +28,10 @@ mechanics — this file remains the single source of truth for the protocol.
   (Claude Code: Task tool `subagent_type: codebase-architect`; Codex: the custom agent by
   name at `.codex/agents/codebase-architect.toml`). Only if NEITHER mechanism exists,
   degrade explicitly to inline retrieval (code-graph → LSP → Grep) and SAY SO.
+- MUST have any non-trivial plan reviewed BEFORE presenting it for approval — run
+  `plan-auditor` + `doc-reviewer` (in parallel), incorporate their feedback, and note in the
+  plan that the review gate was honored. Present the ALREADY-reviewed plan, never a raw one.
+  (Claude Code enforces this inside plan mode, before `ExitPlanMode` — see `CLAUDE.md`.)
 - MUST delegate implementation to the domain agent — plan and delegate, do NOT write
   substantial code inline: **code / logic / tests → `coder`**; **UI (components, pages,
   styling, visual output) → `ui-expert`**. Same dual-tool invocation as `codebase-architect`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baldart",
-  "version": "4.86.0",
+  "version": "4.87.0",
   "description": "Claude Agent Framework - Reusable framework for coordinating AI agents and humans in software projects",
   "bin": {
     "baldart": "./bin/baldart.js"