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
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>
Copy file name to clipboardExpand all lines: README.md
+30-29Lines changed: 30 additions & 29 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 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`.
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 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 |
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 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 |
517
517
|`TODO.md`| Execution and progress tracking | Work starts/completes or task state changes |
518
518
519
519
### Startup Artifact Gate
@@ -545,59 +545,60 @@ Change request received
545
545
546
546
### Optional plugin companion
547
547
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:
- 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:
553
555
- expose one operator-facing support skill for session-coordination workflow
554
556
- remain subordinate to root RULES authority
555
557
- avoid creating a second governance stack under `plugin/`
558
+
- leave compact/post-compact helper ownership to `rules-compact-extension`
556
559
557
-
Run package-local plugin install from `./plugin` when you want the plugin companion:
560
+
Public install goes through the shared `darkwingtm` marketplace:
558
561
559
562
```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
563
565
```
564
566
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:
572
568
573
569
```bash
574
-
claude plugins uninstall rules-compact-extension@darkwingtm --scope local
570
+
cd plugin
571
+
claude plugins marketplace add ./ --scope local
575
572
claude plugins install claude-code-rules@claude-code-rules --scope local
576
573
```
577
574
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
+
578
581
Recommended checks after install:
579
582
580
583
```bash
581
-
claude plugins list
584
+
claude plugins list --json
582
585
```
583
586
584
587
Optional interactive checks:
585
588
-`/reload-plugins`
586
-
-`/hooks`
587
589
-`/claude-code-rules:session-coordination-bridge`
590
+
-`/hooks` to confirm compact hooks still come from `rules-compact-extension`
588
591
589
592
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
593
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
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`
595
596
596
597
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
599
601
- 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
601
602
602
603
### Verification Checklist
603
604
@@ -1160,7 +1161,7 @@ Personal rule set and configuration framework for Claude Code CLI.
1160
1161
---
1161
1162
1162
1163
<p>
1163
-
<b>Version</b>: 9.27 |
1164
+
<b>Version</b>: 9.28 |
1164
1165
<b>Last Updated</b>: 2026-04-13 |
1165
1166
<b>Framework</b>: Sophisticated AI Framework with Constitutional Governance
Copy file name to clipboardExpand all lines: TODO.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,8 @@
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
+
-[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.
10
11
-[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.
11
12
-[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.
12
13
-[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 @@
97
98
98
99
| Date | Changes |
99
100
|------|---------|
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. |
100
102
| 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. |
101
103
| 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. |
102
104
| 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. |
| 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 |
13
14
| 9.27 | 2026-04-13 |**[Added the session coordination bridge skill to the optional plugin companion](#version-927)**| 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
## 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
+
70
88
## Version 9.27: Added the session coordination bridge skill to the optional plugin companion
| 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 |
13
14
| 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 |
| 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 @@
24
25
25
26
---
26
27
27
-
<aid="version-110"></a>
28
+
<aid="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
+
28
46
## Version 1.10: Added the session coordination bridge skill and renamed the plugin package to claude-code-rules
@@ -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 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 |
0 commit comments