Kjell Tore Guttormsen 9ecd225018 feat(ultraplan-local): Spor 3 — semantic plan-critic, examples, CC features, security docs

- agents/plan-critic.md: rule #7 split into literal blockers (TBD/TODO/FIXME)
  + semantic rubric with 8 deferred-decision tests; calibrated against the
  5-phrase corpus from the v3.1.0 quality brief
- hooks/hooks.json: rebuilt from corrupted state; valid JSON, registers
  PreToolUse(Bash,Write), UserPromptSubmit, PostToolUse(Bash), PreCompact
- hooks/scripts/session-title.mjs: NEW — sets ultra:<cmd>:<slug> session
  title for ultra commands (CC v2.1.94+)
- hooks/scripts/post-bash-stats.mjs: NEW — appends duration_ms per Bash
  call to ultraexecute-stats.jsonl (CC v2.1.97+)
- SECURITY.md: NEW — Forgejo private-issue reporting, supported = current
  minor only, scope = 4 hooks + denylist, hardening recommendations
- docs/architect-bridge-test.md: NEW — manual smoke checklist for the
  ultraplan ↔ ultra-cc-architect bridge
- examples/01-add-verbose-flag/: NEW — calibrated end-to-end (brief +
  research + plan + progress.json) for fork-er onramp; all four artifacts
  pass their validators
- README.md: + Extending the plugin, + Headless multi-session tuning
  (MCP_CONNECTION_NONBLOCKING), + Session titles, + Per-step timing,
  + disableSkillShellExecution recommendation
- CLAUDE.md: documents session-title.mjs and post-bash-stats.mjs
- root README.md: v3.1.0 entry expanded with Spor 2+3 deliverables

CC features adopted: F8, F9, F12 implemented; F3 implemented as Bash
PostToolUse logger; F2 (hook 'if'-field scoping) deferred — universal
protection beats reduced-scope protection for blocked commands.

Tests: 109/109 green.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-01 06:28:44 +02:00

2 KiB

Raw Blame History

Architect-bridge smoke test

ultra-cc-architect is a separate plugin (extracted in v3.0.0). This plugin auto-discovers architecture/overview.md if produced. This checklist verifies the bridge still works after either plugin changes.

Manual checklist

Install both plugins from the marketplace.
Create a project: /ultrabrief-local → produce brief.md for a small task ("add --verbose flag to a CLI").
Run /ultra-cc-architect-local --project <project-dir>. Verify architecture/overview.md and architecture/gaps.md appear.
Run /ultraplan-local --project <project-dir>. Verify the planner's Phase 1 output mentions architecture-discovery as one of the inputs (look for architecture/overview.md in the validator log).
Open the resulting plan.md. The plan should reference cc_features_proposed from the architecture note when it picks features. The plan does not have to adopt them — they are priors, not requirements.

What "works" means

Discovery finds architecture/overview.md (or any of the tolerated loose names: architecture-overview.md, etc.) and surfaces drift as warnings only.
Plan synthesis cross-references the architecture note without hard-failing if it is missing.
No CI test enforces the bridge; that is intentional. The two plugins are filesystem-coupled, not code-coupled.

When to re-run

After bumping either plugin's minor or major version.
After changing lib/validators/architecture-discovery.mjs in this plugin.
After changing the architecture-note schema in ultra-cc-architect.

Known tolerances

Drift	Behavior
Missing `architecture/` directory	Discovery returns absent; plan proceeds without architecture input
Loose name (e.g., `architecture-overview.md` at project root)	WARN; discovery still finds it
Body schema changed	WARN; discovery only reads the first heading
`cc_features_proposed` missing	Plan ignores priors silently; no error

2 KiB Raw Blame History