Skip to content

Commit 8e785af

Browse files
DarKWinGTMclaude
andcommitted
Correct plugin topology for coordination skill.
Keep rules-compact-extension as the active compact helper, narrow claude-code-rules to the session-coordination skill package, and sync wave 042 docs and release surfaces to the corrected two-plugin model. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 08a67e0 commit 8e785af

19 files changed

Lines changed: 451 additions & 1231 deletions

README.md

Lines changed: 30 additions & 29 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 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.
404+
Latest refinement: the plugin topology is now corrected so `rules-compact-extension` stays the compact helper while `claude-code-rules` becomes the separate session-coordination skill plugin exposed through `@darkwingtm`.
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 extension package for runtime reinforcement and operator-facing support skills that remains subordinate to root RULES authority | Support / extension package |
490+
| `./plugin/**` | Optional extension package for operator-facing support skills that remains subordinate to root RULES authority, while compact helper runtime reinforcement remains separate | 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 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 |
516+
| `plugin/**` | Optional RULES plugin companion package | Package-local implementation assets such as `README.md`, `.claude-plugin/`, `skills/`, and related support files 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
@@ -545,59 +545,60 @@ Change request received
545545

546546
### Optional plugin companion
547547

548-
The repository can now also carry an optional plugin companion under:
549-
- `./plugin/`
548+
The repository now treats the optional plugin layer as two bounded packages with different roles:
549+
- `rules-compact-extension@darkwingtm` = compact/context helper
550+
- `claude-code-rules@darkwingtm` = session-coordination skill plugin
550551

551-
Its role is still bounded:
552-
- reinforce compact/post-compact behavior through supported Claude Code hooks
552+
The RULES repo package under `./plugin/` is now the skill plugin source.
553+
554+
Its role is bounded:
553555
- expose one operator-facing support skill for session-coordination workflow
554556
- remain subordinate to root RULES authority
555557
- avoid creating a second governance stack under `plugin/`
558+
- leave compact/post-compact helper ownership to `rules-compact-extension`
556559

557-
Run package-local plugin install from `./plugin` when you want the plugin companion:
560+
Public install goes through the shared `darkwingtm` marketplace:
558561

559562
```bash
560-
cd plugin
561-
claude plugins marketplace add ./ --scope local
562-
claude plugins install claude-code-rules@claude-code-rules --scope local
563+
claude plugins marketplace add "<plugin-marketplace-root>" --scope user
564+
claude plugins install claude-code-rules@darkwingtm --scope user
563565
```
564566

565-
Detailed meaning:
566-
1. `cd plugin` moves into the package root so the package-local marketplace manifest is the active source.
567-
2. `claude plugins marketplace add ./ --scope local` adds the package-local marketplace declared by `plugin/.claude-plugin/marketplace.json`.
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:
567+
Local development from `./plugin` remains optional:
572568

573569
```bash
574-
claude plugins uninstall rules-compact-extension@darkwingtm --scope local
570+
cd plugin
571+
claude plugins marketplace add ./ --scope local
575572
claude plugins install claude-code-rules@claude-code-rules --scope local
576573
```
577574

575+
Detailed meaning:
576+
1. the shared `darkwingtm` marketplace at `<plugin-marketplace-root>` is the intended user-facing install surface.
577+
2. `claude-code-rules@darkwingtm` is the real install target for this skill package.
578+
3. the package-local `@claude-code-rules` path is only for local development/testing from the RULES repo.
579+
4. compact helper behavior remains in `rules-compact-extension@darkwingtm`, not in this skill plugin.
580+
578581
Recommended checks after install:
579582

580583
```bash
581-
claude plugins list
584+
claude plugins list --json
582585
```
583586

584587
Optional interactive checks:
585588
- `/reload-plugins`
586-
- `/hooks`
587589
- `/claude-code-rules:session-coordination-bridge`
590+
- `/hooks` to confirm compact hooks still come from `rules-compact-extension`
588591

589592
Current package behavior:
590-
- `PreCompact` creates or refreshes session-scoped compact state under `${CLAUDE_PLUGIN_DATA}/compact/sessions/<source-session-id>/`
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
592-
- `PostCompact` is prune-only and opportunistically removes expired or legacy compact-state leftovers
593593
- `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
594-
- the package no longer treats singleton files like `active-handoff.json` or `last-sessionstart-consumed.json` as the active contract
594+
- this package does not own compact lifecycle hooks or compact persistence state
595+
- compact helper behavior remains in `rules-compact-extension@darkwingtm`
595596

596597
Boundary reminder:
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
598+
- root runtime rules still define shared execution coordination semantics
599+
- this plugin provides the coordination skill front door only
600+
- compact helper behavior remains a separate plugin concern
599601
- plugin installation does not replace the normal `~/.claude/rules/` install path
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
601602

602603
### Verification Checklist
603604

@@ -1160,7 +1161,7 @@ Personal rule set and configuration framework for Claude Code CLI.
11601161
---
11611162

11621163
<p>
1163-
<b>Version</b>: 9.27 |
1164+
<b>Version</b>: 9.28 |
11641165
<b>Last Updated</b>: 2026-04-13 |
11651166
<b>Framework</b>: Sophisticated AI Framework with Constitutional Governance
11661167
</p>

TODO.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,8 @@
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.
9+
- [x] Add the optional `claude-code-rules:session-coordination-bridge` support skill to the RULES plugin companion; add bounded `phase-041` / `patch/session-coordination-bridge-skill-rollout.patch.md` artifacts; update master surfaces; and align plugin install/update/migration guidance.
10+
- [x] Correct the plugin topology so `claude-code-rules` becomes the session-coordination skill plugin while `rules-compact-extension` remains the active compact helper; add bounded `phase-042` / `patch/plugin-topology-correction.patch.md` artifacts; update master surfaces; restore shared marketplace/plugin resolution; and align public plugin install/update guidance to the shared `darkwingtm` marketplace.
1011
- [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.
1112
- [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.
1213
- [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.
@@ -97,6 +98,7 @@
9798

9899
| Date | Changes |
99100
|------|---------|
101+
| 2026-04-13 | Corrected the plugin topology so `claude-code-rules` becomes the session-coordination skill plugin while `rules-compact-extension` remains the active compact helper; added bounded `phase-042` / `patch/plugin-topology-correction.patch.md` artifacts; synchronized master surfaces; restored shared marketplace/plugin resolution; and aligned public plugin install/update guidance to the shared `darkwingtm` marketplace. |
100102
| 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. |
101103
| 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. |
102104
| 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. |

changelog/changelog.md

Lines changed: 20 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.27
4+
> **Current Version:** 9.28
55
> **Session:** 11c4bd2f-216e-4779-81bf-26d34a4fcaeb
66
77
---
@@ -10,6 +10,7 @@
1010

1111
| Version | Date | Changes | Session ID |
1212
|---------|------|---------|------------|
13+
| 9.28 | 2026-04-13 | **[Corrected plugin topology so claude-code-rules is the skill plugin and rules-compact-extension remains the compact helper](#version-928)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
1314
| 9.27 | 2026-04-13 | **[Added the session coordination bridge skill to the optional plugin companion](#version-927)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
1415
| 9.26 | 2026-04-13 | **[Added memsearch availability detection and fallback intake guidance](#version-926)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
1516
| 9.25 | 2026-04-13 | **[Standardized visible session ownership for session-owned task work](#version-925)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
@@ -66,7 +67,24 @@
6667

6768
---
6869

69-
<a id="version-927"></a>
70+
<a id="version-928"></a>
71+
## Version 9.28: Corrected plugin topology so claude-code-rules is the skill plugin and rules-compact-extension remains the compact helper
72+
73+
**Date:** 2026-04-13
74+
**Session:** 11c4bd2f-216e-4779-81bf-26d34a4fcaeb
75+
76+
### Changes
77+
- Corrected the plugin topology so `rules-compact-extension@darkwingtm` remains the active compact/context helper while `claude-code-rules` becomes the session-coordination skill plugin only.
78+
- Updated `design/rules-plugin-extension.design.md`, `README.md`, `TODO.md`, and `phase/SUMMARY.md` so they no longer describe `claude-code-rules` as the compact helper.
79+
- Updated the RULES-side package metadata to v1.4.0 with skill-only wording.
80+
- Restored the shared `darkwingtm` marketplace and reinstalled the plugin family so `frontend-design-pattern-navigator`, `general-expert`, `multi-hat-system`, `supervisor-audit-agent-system`, `webview-screenshort`, and `rules-compact-extension` all resolve again.
81+
- Mirrored the RULES skill plugin into the shared marketplace source so the intended user-facing install path is now `claude-code-rules@darkwingtm`.
82+
83+
### Summary
84+
The RULES plugin rollout is now topology-correct: compact helper behavior stays in `rules-compact-extension`, while `claude-code-rules` becomes the separate session-coordination skill plugin exposed through `@darkwingtm`.
85+
86+
---
87+
7088
## Version 9.27: Added the session coordination bridge skill to the optional plugin companion
7189

7290
**Date:** 2026-04-13

changelog/rules-plugin-extension.changelog.md

Lines changed: 20 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.10
4+
> **Current Version:** 1.11
55
> **Session:** 11c4bd2f-216e-4779-81bf-26d34a4fcaeb
66
77
---
@@ -10,6 +10,7 @@
1010

1111
| Version | Date | Changes | Session ID |
1212
|---------|------|---------|------------|
13+
| 1.11 | 2026-04-13 | **[Corrected plugin topology so claude-code-rules is the skill plugin and rules-compact-extension remains the compact helper](#version-111)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
1314
| 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 |
1415
| 1.9 | 2026-04-08 | **[Tightened compact review to reference-first directive form](#version-19)** | 4e792d4b-8876-439b-8c07-2c5d4b04af3a |
1516
| 1.8 | 2026-04-08 | **[Turned SessionStart carry-forward into an active review trigger](#version-18)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
@@ -24,7 +25,24 @@
2425

2526
---
2627

27-
<a id="version-110"></a>
28+
<a id="version-111"></a>
29+
## Version 1.11: Corrected plugin topology so claude-code-rules is the skill plugin and rules-compact-extension remains the compact helper
30+
31+
**Date:** 2026-04-13
32+
**Session:** 11c4bd2f-216e-4779-81bf-26d34a4fcaeb
33+
34+
### Changes
35+
- Corrected the plugin topology so `claude-code-rules` is now the session-coordination skill package only, while `rules-compact-extension` remains the active compact/context helper.
36+
- Updated `plugin/README.md` and `design/rules-plugin-extension.design.md` so they no longer claim compact lifecycle hook ownership for `claude-code-rules`.
37+
- Updated the RULES-side package metadata to v1.4.0 with skill-only wording.
38+
- Updated install guidance so the intended user-facing install target is now `claude-code-rules@darkwingtm`, with package-local `@claude-code-rules` retained only for local development/testing.
39+
- Preserved the compact-helper boundary explicitly so the new skill package does not overlap the active compact helper.
40+
41+
### Summary
42+
The RULES plugin topology is now corrected: `claude-code-rules` is the session-coordination skill plugin, and `rules-compact-extension` remains the separate active compact helper.
43+
44+
---
45+
2846
## Version 1.10: Added the session coordination bridge skill and renamed the plugin package to claude-code-rules
2947

3048
**Date:** 2026-04-13

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.27
6+
> **Current Version:** 9.28
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 plus operator-facing support skills 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 operator-facing support skills, while active compact-helper runtime reinforcement may remain in separate plugin packages outside governed chain authority |
3434

3535
### 2.2 Governance Principle
3636

0 commit comments

Comments
 (0)