Skip to content

Commit 08a67e0

Browse files
DarKWinGTMclaude
andcommitted
Add session coordination bridge skill.
Rename the optional RULES plugin companion to claude-code-rules, add the session-coordination-bridge support skill, sync wave 041 governance surfaces, and align compact runtime state with the new plugin identity. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent b0eca28 commit 08a67e0

22 files changed

Lines changed: 799 additions & 67 deletions

README.md

Lines changed: 23 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -401,7 +401,7 @@ Please:
401401

402402
**📊 Active Runtime Rules: 40**
403403

404-
Latest refinement: the active runtime set now makes optional recall intake availability-first, so memsearch is checked before use and missing plugin state falls back immediately to native memory plus checked execution surfaces.
404+
Latest refinement: the optional plugin companion now adds a `claude-code-rules:session-coordination-bridge` support skill and uses one coherent `claude-code-rules` plugin identity across install flow, runtime signals, and persisted compact state.
405405

406406
</div>
407407

@@ -487,7 +487,7 @@ ls ./.claude/rules/artifact-initiation-control.md
487487
| `./phase/phase-NNN-NN-<subphase-name>.md` | Governed subphase execution detail with design extraction, optional patch extraction, and review state | Subphase docs |
488488
| `./patch/<context>.patch.md` or `./<context>.patch.md` | Governed patch/review artifacts outside live phase planning that may feed phase one-way when relevant | Patch docs |
489489
| `./phase-implementation-template.md` | Root helper for phased planning | Helper artifact |
490-
| `./plugin/**` | Optional hook-based extension package for runtime reinforcement that remains subordinate to root RULES authority | Support / extension package |
490+
| `./plugin/**` | Optional extension package for runtime reinforcement and operator-facing support skills that remains subordinate to root RULES authority | Support / extension package |
491491

492492
> **💡 Single Source of Truth Principle:**
493493
> - Design files (`.design.md`) define active target state
@@ -513,7 +513,7 @@ This section defines how `design`, `changelog`, `runtime rules`, `TODO`, and gov
513513
| `phase/phase-NNN-<phase-name>.md` and `phase/phase-NNN-NN-<subphase-name>.md` | Governed phase-detail layer | Multi-stage execution detail under `/phase`, including design references, optional patch references, design extraction, optional patch extraction, review flow, reviewer checklist, review outcome, and execution detail |
514514
| `patch/<context>.patch.md` or root `<context>.patch.md` | Governed patch/review artifact layer | Patch or review work that is separate from live phase planning but may feed the phase layer one-way when relevant |
515515
| `phase-implementation-template.md` | Root helper for phased planning readability | Reusable authoring support when staged execution matters |
516-
| `plugin/**` | Optional compact-hook companion package | Package-local implementation assets such as `README.md`, `.claude-plugin/`, `hooks/`, and scripts that reinforce root RULES behavior without becoming a second governance stack |
516+
| `plugin/**` | Optional RULES plugin companion package | Package-local implementation assets such as `README.md`, `.claude-plugin/`, `hooks/`, `skills/`, and scripts that reinforce root RULES behavior without becoming a second governance stack |
517517
| `TODO.md` | Execution and progress tracking | Work starts/completes or task state changes |
518518

519519
### Startup Artifact Gate
@@ -543,29 +543,37 @@ Change request received
543543
→ Verify links, versions, and consistency
544544
```
545545

546-
### Optional compact hook companion
546+
### Optional plugin companion
547547

548548
The repository can now also carry an optional plugin companion under:
549549
- `./plugin/`
550550

551-
Its role is narrow:
551+
Its role is still bounded:
552552
- reinforce compact/post-compact behavior through supported Claude Code hooks
553+
- expose one operator-facing support skill for session-coordination workflow
553554
- remain subordinate to root RULES authority
554555
- avoid creating a second governance stack under `plugin/`
555556

556-
Run package-local plugin install from `./plugin` when you want the compact hook companion:
557+
Run package-local plugin install from `./plugin` when you want the plugin companion:
557558

558559
```bash
559560
cd plugin
560561
claude plugins marketplace add ./ --scope local
561-
claude plugins install rules-compact-extension@darkwingtm --scope local
562+
claude plugins install claude-code-rules@claude-code-rules --scope local
562563
```
563564

564565
Detailed meaning:
565566
1. `cd plugin` moves into the package root so the package-local marketplace manifest is the active source.
566567
2. `claude plugins marketplace add ./ --scope local` adds the package-local marketplace declared by `plugin/.claude-plugin/marketplace.json`.
567-
3. `claude plugins install rules-compact-extension@darkwingtm --scope local` installs the plugin from that package-local marketplace in local scope.
568-
4. the compact companion remains an optional runtime support layer; it does not replace root RULES authority.
568+
3. `claude plugins install claude-code-rules@claude-code-rules --scope local` installs the plugin from that package-local marketplace in local scope.
569+
4. the plugin companion remains an optional runtime support layer; it does not replace root RULES authority.
570+
571+
Migration note if the older compact-only package id is still installed:
572+
573+
```bash
574+
claude plugins uninstall rules-compact-extension@darkwingtm --scope local
575+
claude plugins install claude-code-rules@claude-code-rules --scope local
576+
```
569577

570578
Recommended checks after install:
571579

@@ -576,16 +584,18 @@ claude plugins list
576584
Optional interactive checks:
577585
- `/reload-plugins`
578586
- `/hooks`
587+
- `/claude-code-rules:session-coordination-bridge`
579588

580-
Current hook behavior in this package:
589+
Current package behavior:
581590
- `PreCompact` creates or refreshes session-scoped compact state under `${CLAUDE_PLUGIN_DATA}/compact/sessions/<source-session-id>/`
582591
- `SessionStart` with matcher `compact` emits one short compact-resume signal, injects an explicit review-before-continuation directive that names the exact resolved session review files plus the re-anchor reminder, removes that session’s pending state after successful use, and writes one bounded per-session proof file
583592
- `PostCompact` is prune-only and opportunistically removes expired or legacy compact-state leftovers
593+
- `skills/session-coordination-bridge/` provides an operator-facing support surface for shared-board coordination workflow, optional recall detection, request-vs-execution remap, and sync-back discipline
584594
- the package no longer treats singleton files like `active-handoff.json` or `last-sessionstart-consumed.json` as the active contract
585595

586596
Boundary reminder:
587-
- root runtime rules still define compact/post-compact semantics
588-
- the plugin only reinforces those semantics through hook mechanics
597+
- root runtime rules still define compact/post-compact semantics and shared execution coordination semantics
598+
- the plugin only reinforces those semantics through hook mechanics plus one support skill front door
589599
- plugin installation does not replace the normal `~/.claude/rules/` install path
590600
- the standard `hooks/hooks.json` is auto-discovered, so `plugin.json` should not duplicate that same path under a `hooks` field unless extra hook files are being layered in
591601

@@ -1150,7 +1160,7 @@ Personal rule set and configuration framework for Claude Code CLI.
11501160
---
11511161

11521162
<p>
1153-
<b>Version</b>: 9.26 |
1163+
<b>Version</b>: 9.27 |
11541164
<b>Last Updated</b>: 2026-04-13 |
11551165
<b>Framework</b>: Sophisticated AI Framework with Constitutional Governance
11561166
</p>

TODO.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@
66

77
## ✅ Completed
88

9+
- [x] Add the optional `claude-code-rules:session-coordination-bridge` support skill to the RULES plugin companion, rename the plugin package identity from `rules-compact-extension` to `claude-code-rules`, add bounded `phase-041` / `patch/session-coordination-bridge-skill-rollout.patch.md` artifacts, update master surfaces, and align plugin install/update/migration guidance.
910
- [x] Add memsearch availability detection and immediate fallback intake guidance by updating `shared-execution-coordination` and `memory-governance-and-session-boundary`; add bounded `phase-040` / `patch/memsearch-availability-detection-and-fallback-intake.patch.md` artifacts; update master surfaces; and resync installed runtime copies.
1011
- [x] Raise visible session ownership into a default task-list standard for session-owned work by updating `shared-execution-coordination`, `todo-standards`, `phase-implementation`, and `project-documentation-standards`; add bounded `phase-039` / `patch/universal-session-owned-task-title-grammar.patch.md` artifacts; update master surfaces; and resync installed runtime copies.
1112
- [x] Refine shared-board visible session identity, handoff lifecycle, retention matrix behavior, and optional memsearch operating guidance by updating `shared-execution-coordination`, `todo-standards`, and `memory-governance-and-session-boundary`; add bounded `phase-038` / `patch/shared-board-visibility-retention-and-memsearch-refinement.patch.md` artifacts; update master surfaces; and resync installed runtime copies.
@@ -96,6 +97,7 @@
9697

9798
| Date | Changes |
9899
|------|---------|
100+
| 2026-04-13 | Added the optional `claude-code-rules:session-coordination-bridge` support skill to the RULES plugin companion, renamed the plugin package identity from `rules-compact-extension` to `claude-code-rules`, added bounded `phase-041` / `patch/session-coordination-bridge-skill-rollout.patch.md` artifacts, synchronized master surfaces, and aligned plugin install/update/migration guidance. |
99101
| 2026-04-13 | Refined shared-board visible session identity, handoff lifecycle, retention matrix behavior, and optional memsearch operating guidance across `shared-execution-coordination`, `todo-standards`, and `memory-governance-and-session-boundary`; added bounded `phase-038` / `patch/shared-board-visibility-retention-and-memsearch-refinement.patch.md` artifacts; synchronized master surfaces; and resynced installed runtime copies. |
100102
| 2026-04-13 | Added memsearch availability detection and immediate fallback intake guidance by refining `shared-execution-coordination` and `memory-governance-and-session-boundary`; added bounded `phase-040` / `patch/memsearch-availability-detection-and-fallback-intake.patch.md` artifacts; synchronized master surfaces; and resynced installed runtime copies. |
101103
| 2026-04-13 | Raised visible session ownership into a default task-list standard for session-owned work by refining `shared-execution-coordination`, `todo-standards`, `phase-implementation`, and `project-documentation-standards`; added bounded `phase-039` / `patch/universal-session-owned-task-title-grammar.patch.md` artifacts; synchronized master surfaces; and resynced installed runtime copies. |

changelog/changelog.md

Lines changed: 22 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Master Changelog - Claude Code Rules
22

33
> **Project:** Claude Code Rules System
4-
> **Current Version:** 9.26
4+
> **Current Version:** 9.27
55
> **Session:** 11c4bd2f-216e-4779-81bf-26d34a4fcaeb
66
77
---
@@ -10,6 +10,7 @@
1010

1111
| Version | Date | Changes | Session ID |
1212
|---------|------|---------|------------|
13+
| 9.27 | 2026-04-13 | **[Added the session coordination bridge skill to the optional plugin companion](#version-927)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
1314
| 9.26 | 2026-04-13 | **[Added memsearch availability detection and fallback intake guidance](#version-926)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
1415
| 9.25 | 2026-04-13 | **[Standardized visible session ownership for session-owned task work](#version-925)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
1516
| 9.24 | 2026-04-13 | **[Refined shared-board visibility, lifecycle, retention, and optional memsearch guidance](#version-924)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
@@ -65,7 +66,26 @@
6566

6667
---
6768

68-
<a id="version-926"></a>
69+
<a id="version-927"></a>
70+
## Version 9.27: Added the session coordination bridge skill to the optional plugin companion
71+
72+
**Date:** 2026-04-13
73+
**Session:** 11c4bd2f-216e-4779-81bf-26d34a4fcaeb
74+
75+
### Changes
76+
- Updated `design/rules-plugin-extension.design.md` from v1.8 to v1.10 so the optional plugin companion now includes one operator-facing session coordination support skill while keeping root RULES as semantic authority.
77+
- Updated `changelog/rules-plugin-extension.changelog.md` to v1.10 for the plugin companion skill rollout.
78+
- Renamed the plugin package identity from `rules-compact-extension` to `claude-code-rules` and updated `plugin/.claude-plugin/plugin.json` plus `plugin/.claude-plugin/marketplace.json` to v1.3.1.
79+
- Added `plugin/skills/session-coordination-bridge/` with `SKILL.md` plus focused support docs for overview, capability detection, coordination flow, request contract, and examples.
80+
- Updated `plugin/README.md`, `README.md`, `TODO.md`, and `phase/SUMMARY.md` so the optional extension layer now documents both compact lifecycle hooks and the new support skill, including migration guidance for older `rules-compact-extension@darkwingtm` installs.
81+
- Updated compact visible runtime signal wording and persisted compact-state schema prefixes from `rules-compact-extension/*` to `claude-code-rules/*` so runtime behavior stays aligned with the new plugin identity.
82+
- Added bounded `patch/session-coordination-bridge-skill-rollout.patch.md` plus `phase-041-01` and `phase-041-02` artifacts for the skill rollout wave.
83+
84+
### Summary
85+
The optional RULES plugin companion now exposes `claude-code-rules:session-coordination-bridge` as a bounded support skill and uses one coherent `claude-code-rules` plugin identity across install flow, runtime signals, and persisted compact state.
86+
87+
---
88+
6989
## Version 9.26: Added memsearch availability detection and fallback intake guidance
7090

7191
**Date:** 2026-04-13

changelog/rules-plugin-extension.changelog.md

Lines changed: 21 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Changelog - RULES Plugin Extension
22

33
> **Parent Document:** [../design/rules-plugin-extension.design.md](../design/rules-plugin-extension.design.md)
4-
> **Current Version:** 1.9
4+
> **Current Version:** 1.10
55
> **Session:** 11c4bd2f-216e-4779-81bf-26d34a4fcaeb
66
77
---
@@ -10,6 +10,7 @@
1010

1111
| Version | Date | Changes | Session ID |
1212
|---------|------|---------|------------|
13+
| 1.10 | 2026-04-13 | **[Added the session coordination bridge skill and renamed the plugin package to claude-code-rules](#version-110)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
1314
| 1.9 | 2026-04-08 | **[Tightened compact review to reference-first directive form](#version-19)** | 4e792d4b-8876-439b-8c07-2c5d4b04af3a |
1415
| 1.8 | 2026-04-08 | **[Turned SessionStart carry-forward into an active review trigger](#version-18)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
1516
| 1.7 | 2026-04-07 | **[Added reviewRoot pointers to compact navigator messages](#version-17)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
@@ -23,7 +24,25 @@
2324

2425
---
2526

26-
<a id="version-17"></a>
27+
<a id="version-110"></a>
28+
## Version 1.10: Added the session coordination bridge skill and renamed the plugin package to claude-code-rules
29+
30+
**Date:** 2026-04-13
31+
**Session:** 11c4bd2f-216e-4779-81bf-26d34a4fcaeb
32+
33+
### Changes
34+
- Updated `design/rules-plugin-extension.design.md` from v1.8 to v1.10 so the optional plugin companion now explicitly includes one operator-facing session coordination support skill while keeping root RULES as semantic authority.
35+
- Renamed the plugin package identity from `rules-compact-extension` to `claude-code-rules` and updated package metadata plus marketplace manifest to v1.3.1.
36+
- Added `plugin/skills/session-coordination-bridge/` with `SKILL.md` plus focused support docs for overview, capability detection, coordination flow, request contract, and examples.
37+
- Updated `plugin/README.md` so install/update flow now uses `claude-code-rules@claude-code-rules`, includes migration guidance for older `rules-compact-extension@darkwingtm` installs, and documents the new support skill.
38+
- Updated compact visible runtime signal wording from `[rules-compact-extension]` to `[claude-code-rules]`.
39+
- Updated compact session-state schema prefixes from `rules-compact-extension/*` to `claude-code-rules/*` so persisted runtime state matches the new plugin identity.
40+
41+
### Summary
42+
The RULES plugin companion now exposes an operator-facing session coordination support skill under the `claude-code-rules` namespace and uses one coherent plugin identity across install flow, runtime signals, and persisted compact state.
43+
44+
---
45+
2746
## Version 1.9: Tightened compact review to reference-first directive form
2847

2948
**Date:** 2026-04-08

design/design.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
## 0) Document Control
44

55
> **Parent Scope:** RULES System Design
6-
> **Current Version:** 9.26
6+
> **Current Version:** 9.27
77
> **Session:** 11c4bd2f-216e-4779-81bf-26d34a4fcaeb (2026-04-13)
88
> **Full history:** [../changelog/changelog.md](../changelog/changelog.md)
99
@@ -30,7 +30,7 @@ This active-state model must preserve UDVC-1 while supporting first-class phased
3030
| Patch | `patch/<context>.patch.md` or root `<context>.patch.md` | Governed patch/review artifacts outside live phase planning |
3131
| History | `changelog/*.changelog.md` | Authoritative chain history and latest chain version state |
3232
| Execution | `TODO.md` | Execution tracking only |
33-
| Support | `phase-implementation-template.md`, `support/**/*.md`, `plugin/**` | Root-level helper templates, reference-only/support materials, and optional extension-package assets such as compact-handoff reinforcement outside governed chain authority |
33+
| Support | `phase-implementation-template.md`, `support/**/*.md`, `plugin/**` | Root-level helper templates, reference-only/support materials, and optional extension-package assets such as compact-handoff reinforcement plus operator-facing support skills outside governed chain authority |
3434

3535
### 2.2 Governance Principle
3636

0 commit comments

Comments
 (0)