chore: integrate the bugs-2026-09-28 coordinator branch (claude harness 1.1.18, promoted potentials, consolidated agent memory)

[drmoisan]

Suggested title

chore: integrate the bugs-2026-09-28 coordinator branch (claude harness 1.1.18, promoted potential entries, consolidated agent memory)

Summary

• Brings the maintainer's claude harness 1.1.18 push-down (commit 83fb045dd) into main. Main currently carries harness 1.1.12. This is the bulk of the diff: hooks, agents, skills, rules, .claude/lib/**, and config/blast-radius.json / config/orchestration-routing.json.
• Adds the potential-entry records promoted during the bugs-2026-09-28 bug triage and parallel run (docs/features/potential/**).
• Consolidates agent memory written during the run onto one branch before the run's worktrees and branches are deleted:
  • memory from this coordinator branch;
  • memory from eight item branches whose code had already merged but that carried one trailing memory-only commit each (cherry-picked with -x provenance);
  • memory from two preparation backup branches (cherry-picked with -x provenance).
• This branch is used for consolidation in place of a dedicated documentationandmemories branch. The pre-implementation gate admits commits only in a worktree whose checkpoint names an active feature folder, and this coordinator branch already held most of the content.
• No product code (C#, tests, project files) changes.

Why

The bugs-2026-09-28 parallel run is closed and its run records are already on main. The coordinator branch and the item branches still hold the run's lasting outputs: the harness update the run executed under, the promoted potential entries, and the agent-memory lessons. Merging them preserves that content, and the worktree cleanup can then delete the remaining branches without losing anything.

What Changed

• Harness (.claude/**, config/**): the 1.1.18 push-down, unchanged from the maintainer's commit. It adds:
  • worktree-resolution, merge-gate and removal-gate resolution hooks;
  • the cleanup-merged-worktrees scripts;
  • the blast-radius scheduling and parallel-drift libraries;
  • the CI-gate parser;
  • agent and skill updates.
• Potential entries (docs/features/potential/**): promoted records from the triage.
• Agent memory (.claude/agent-memory/**): new lesson files plus updated MEMORY.md indexes for the atomic-executor, atomic-planner, orchestrator, parallel-orchestrator, feature-review, prd-feature and task-researcher agents.

Architecture / How It Fits Together

• Harness files: consumed by Claude Code sessions in this repository; nothing in the product build references them.
• Agent memory: loaded by the respective agents at session start.
• Potential entries: inputs to the promotion lifecycle.

Verification

Completed:

• origin/main was merged into the branch, so the branch is current with main (merge base a52f3c692).
• Memory index conflicts were resolved by keeping this branch's reorganized index and appending every main-only entry whose target file is not already indexed. No conflict markers remain under .claude/agent-memory.
• A conflicting numbered lesson file was deduplicated and renumbered.

Not verified in this PR: no local build or test run. The repository CI checks on this pull request are the verification for the harness changes.

Recommended:

• git diff --stat origin/main...HEAD -- .claude/hooks .claude/lib config

Backward Compatibility / Migration Notes

The harness update changes hook behavior for every agent session in this repository once merged, including new resolution logic in the merge and worktree-removal gates. config/blast-radius.json and config/orchestration-routing.json change with it.

Risks and Mitigations

• Risk: a harness hook regression affects agent sessions.
  • Mitigation: the content is the maintainer's own push-down, unchanged.
  • Rollback: revert the merge commit.
• Risk: large MEMORY.md indexes. The orchestrator index already exceeds the agent memory read limit and carries duplicate entries inherited from this branch.
  • Mitigation: none in this PR; recorded as a follow-up.

Review Guide

1. .claude/hooks/** and .claude/lib/**: behavioral harness changes.
2. config/blast-radius.json and config/orchestration-routing.json.
3. docs/features/potential/**.
4. .claude/agent-memory/**: mechanical, high volume; skim.

Follow-ups

• Trim and deduplicate .claude/agent-memory/orchestrator/MEMORY.md.
• After merge, rerun the worktree cleanup to delete the eight item branches, the backup branches and their worktrees.

GitHub Auto-close

• None

🤖 Generated with Claude Code

https://claude.ai/code/session_01XYKFZYM6SyG8iN7ChTM6dd