You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
Copy file name to clipboardExpand all lines: README.md
+23-13Lines changed: 23 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -401,7 +401,7 @@ Please:
401
401
402
402
**📊 Active Runtime Rules: 40**
403
403
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.
405
405
406
406
</div>
407
407
@@ -487,7 +487,7 @@ ls ./.claude/rules/artifact-initiation-control.md
487
487
|`./phase/phase-NNN-NN-<subphase-name>.md`| Governed subphase execution detail with design extraction, optional patch extraction, and review state | Subphase docs |
488
488
|`./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 |
489
489
|`./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 |
491
491
492
492
> **💡 Single Source of Truth Principle:**
493
493
> - Design files (`.design.md`) define active target state
@@ -513,7 +513,7 @@ This section defines how `design`, `changelog`, `runtime rules`, `TODO`, and gov
513
513
|`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 |
514
514
|`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 |
515
515
|`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 |
517
517
|`TODO.md`| Execution and progress tracking | Work starts/completes or task state changes |
518
518
519
519
### Startup Artifact Gate
@@ -543,29 +543,37 @@ Change request received
543
543
→ Verify links, versions, and consistency
544
544
```
545
545
546
-
### Optional compact hook companion
546
+
### Optional plugin companion
547
547
548
548
The repository can now also carry an optional plugin companion under:
549
549
-`./plugin/`
550
550
551
-
Its role is narrow:
551
+
Its role is still bounded:
552
552
- reinforce compact/post-compact behavior through supported Claude Code hooks
553
+
- expose one operator-facing support skill for session-coordination workflow
553
554
- remain subordinate to root RULES authority
554
555
- avoid creating a second governance stack under `plugin/`
555
556
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:
557
558
558
559
```bash
559
560
cd plugin
560
561
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
562
563
```
563
564
564
565
Detailed meaning:
565
566
1.`cd plugin` moves into the package root so the package-local marketplace manifest is the active source.
566
567
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
+
```
569
577
570
578
Recommended checks after install:
571
579
@@ -576,16 +584,18 @@ claude plugins list
576
584
Optional interactive checks:
577
585
-`/reload-plugins`
578
586
-`/hooks`
587
+
-`/claude-code-rules:session-coordination-bridge`
579
588
580
-
Current hook behavior in this package:
589
+
Current package behavior:
581
590
-`PreCompact` creates or refreshes session-scoped compact state under `${CLAUDE_PLUGIN_DATA}/compact/sessions/<source-session-id>/`
582
591
-`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
583
592
-`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
584
594
- the package no longer treats singleton files like `active-handoff.json` or `last-sessionstart-consumed.json` as the active contract
585
595
586
596
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
589
599
- plugin installation does not replace the normal `~/.claude/rules/` install path
590
600
- 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
591
601
@@ -1150,7 +1160,7 @@ Personal rule set and configuration framework for Claude Code CLI.
1150
1160
---
1151
1161
1152
1162
<p>
1153
-
<b>Version</b>: 9.26 |
1163
+
<b>Version</b>: 9.27 |
1154
1164
<b>Last Updated</b>: 2026-04-13 |
1155
1165
<b>Framework</b>: Sophisticated AI Framework with Constitutional Governance
Copy file name to clipboardExpand all lines: TODO.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,6 +6,7 @@
6
6
7
7
## ✅ Completed
8
8
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.
9
10
-[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.
10
11
-[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.
11
12
-[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 @@
96
97
97
98
| Date | Changes |
98
99
|------|---------|
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. |
99
101
| 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. |
100
102
| 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. |
101
103
| 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. |
## 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
+
69
89
## Version 9.26: Added memsearch availability detection and fallback intake guidance
| 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 |
## 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
+
27
46
## Version 1.9: Tightened compact review to reference-first directive form
@@ -30,7 +30,7 @@ This active-state model must preserve UDVC-1 while supporting first-class phased
30
30
| Patch |`patch/<context>.patch.md` or root `<context>.patch.md`| Governed patch/review artifacts outside live phase planning |
31
31
| History |`changelog/*.changelog.md`| Authoritative chain history and latest chain version state |
32
32
| 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 |
0 commit comments