Skip to content

Commit a94ff61

Browse files
DarKWinGTMclaude
andcommitted
Re-unify Rules plugin under one package.
Merge compact helper behavior and the session-coordination skill back into RULES/plugin, update wave 043 governance surfaces, and keep the public install target as claude-code-rules@darkwingtm. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 93bf240 commit a94ff61

19 files changed

Lines changed: 1372 additions & 125 deletions

README.md

Lines changed: 19 additions & 22 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 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`.
404+
Latest refinement: the Rules plugin is unified again under `claude-code-rules@darkwingtm`, so compact helper behavior and the session-coordination skill now ship from the same Rules-owned package.
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 operator-facing support skills that remains subordinate to root RULES authority, while compact helper runtime reinforcement remains separate | Support / extension package |
490+
| `./plugin/**` | Optional unified Rules-owned plugin companion package that remains subordinate to root RULES authority while combining compact helper runtime reinforcement and operator-facing support skills | Support / extension package |
491491

492492
> **💡 Single Source of Truth Principle:**
493493
> - Design files (`.design.md`) define active target state
@@ -545,17 +545,15 @@ Change request received
545545

546546
### Optional plugin companion
547547

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
548+
The repository now treats the optional plugin layer as one unified Rules-owned package:
549+
- `claude-code-rules@darkwingtm` = unified Rules plugin
551550

552-
The RULES repo package under `./plugin/` is now the skill plugin source.
551+
This unified package includes both:
552+
- compact/context helper behavior
553+
- `session-coordination-bridge` support skill behavior
553554

554-
Its role is bounded:
555-
- expose one operator-facing support skill for session-coordination workflow
556-
- remain subordinate to root RULES authority
557-
- avoid creating a second governance stack under `plugin/`
558-
- leave compact/post-compact helper ownership to `rules-compact-extension`
555+
The canonical source is:
556+
- `<rules-root>/plugin`
559557

560558
Public install goes through the shared `darkwingtm` marketplace:
561559

@@ -573,10 +571,10 @@ claude plugins install claude-code-rules@claude-code-rules --scope local
573571
```
574572

575573
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.
574+
1. the shared `darkwingtm` marketplace is the intended user-facing install surface.
575+
2. `claude-code-rules@darkwingtm` is the real install target for the unified Rules plugin.
578576
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.
577+
4. duplicate maintained package copies are no longer the intended model.
580578

581579
Recommended checks after install:
582580

@@ -587,17 +585,16 @@ claude plugins list --json
587585
Optional interactive checks:
588586
- `/reload-plugins`
589587
- `/claude-code-rules:session-coordination-bridge`
590-
- `/hooks` to confirm compact hooks still come from `rules-compact-extension`
588+
- `/hooks`
591589

592590
Current package behavior:
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-
- this package does not own compact lifecycle hooks or compact persistence state
595-
- compact helper behavior remains in `rules-compact-extension@darkwingtm`
591+
- compact helper hooks and session-scoped compact state live in the same package
592+
- `skills/session-coordination-bridge/` provides the operator-facing coordination support surface
593+
- the plugin remains subordinate to root RULES authority
596594

597595
Boundary reminder:
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
596+
- root runtime rules still define compact/post-compact semantics and shared execution coordination semantics
597+
- this plugin reinforces those semantics through compact hooks plus one support skill front door
601598
- plugin installation does not replace the normal `~/.claude/rules/` install path
602599

603600
### Verification Checklist
@@ -1161,7 +1158,7 @@ Personal rule set and configuration framework for Claude Code CLI.
11611158
---
11621159

11631160
<p>
1164-
<b>Version</b>: 9.29 |
1161+
<b>Version</b>: 9.30 |
11651162
<b>Last Updated</b>: 2026-04-13 |
11661163
<b>Framework</b>: Sophisticated AI Framework with Constitutional Governance
11671164
</p>

TODO.md

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

99
- [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.
1010
- [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.
11+
- [x] Re-unify the Rules plugin under `RULES/plugin` so compact helper behavior and the session-coordination skill ship from the same Rules-owned package again; add bounded `phase-043` / `patch/unified-rules-plugin-rollout.patch.md` artifacts; update master surfaces; remove duplicate maintained package copies; and keep the public install target as `claude-code-rules@darkwingtm`.
1112
- [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.
1213
- [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.
1314
- [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.
@@ -98,6 +99,7 @@
9899

99100
| Date | Changes |
100101
|------|---------|
102+
| 2026-04-13 | Re-unified the Rules plugin under `RULES/plugin`: restored compact helper hooks/scripts into the Rules-owned package, removed duplicate maintained package copies from the shared marketplace topology, updated the shared `darkwingtm` marketplace to expose the unified package, and kept the public install target as `claude-code-rules@darkwingtm`. |
101103
| 2026-04-13 | Finalized topology-correction docs and install guidance: tightened the skill-only package docs, removed remaining compact-helper drift from the RULES plugin package, refreshed mirrored shared-marketplace skill files, and completed the remaining wave `042` sync details. |
102104
| 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. |
103105
| 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. |

changelog/changelog.md

Lines changed: 19 additions & 1 deletion
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.29
4+
> **Current Version:** 9.30
55
> **Session:** 11c4bd2f-216e-4779-81bf-26d34a4fcaeb
66
77
---
@@ -10,6 +10,7 @@
1010

1111
| Version | Date | Changes | Session ID |
1212
|---------|------|---------|------------|
13+
| 9.30 | 2026-04-13 | **[Re-unified the Rules plugin under RULES/plugin](#version-930)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
1314
| 9.29 | 2026-04-13 | **[Finalized topology-correction docs and install guidance](#version-929)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
1415
| 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 |
1516
| 9.27 | 2026-04-13 | **[Added the session coordination bridge skill to the optional plugin companion](#version-927)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
@@ -68,6 +69,23 @@
6869

6970
---
7071

72+
<a id="version-930"></a>
73+
## Version 9.30: Re-unified the Rules plugin under RULES/plugin
74+
75+
**Date:** 2026-04-13
76+
**Session:** 11c4bd2f-216e-4779-81bf-26d34a4fcaeb
77+
78+
### Changes
79+
- Re-unified the Rules plugin under `RULES/plugin` so compact helper hooks/scripts and the `session-coordination-bridge` skill ship from the same Rules-owned package again.
80+
- Updated the shared `darkwingtm` marketplace to expose the unified Rules plugin and removed duplicate maintained package copies from the shared plugin workspace.
81+
- Updated the RULES-side package metadata to `1.5.0` and synchronized README/design/TODO/changelog/phase surfaces to the unified package model.
82+
- Kept the public install target as `claude-code-rules@darkwingtm` while leaving package-local `@claude-code-rules` for local development/testing only.
83+
84+
### Summary
85+
The Rules plugin is unified again at the source and install topology layers, while the public install path remains stable through `@darkwingtm`.
86+
87+
---
88+
7189
<a id="version-929"></a>
7290
## Version 9.29: Finalized topology-correction docs and install guidance
7391

changelog/rules-plugin-extension.changelog.md

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

1111
| Version | Date | Changes | Session ID |
1212
|---------|------|---------|------------|
13+
| 1.13 | 2026-04-13 | **[Re-unified the Rules plugin under RULES/plugin](#version-113)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
1314
| 1.12 | 2026-04-13 | **[Finalized topology-correction docs and portable install wording](#version-112)** | 11c4bd2f-216e-4779-81bf-26d34a4fcaeb |
1415
| 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 |
1516
| 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 |
@@ -26,6 +27,24 @@
2627

2728
---
2829

30+
<a id="version-113"></a>
31+
## Version 1.13: Re-unified the Rules plugin under RULES/plugin
32+
33+
**Date:** 2026-04-13
34+
**Session:** 11c4bd2f-216e-4779-81bf-26d34a4fcaeb
35+
36+
### Changes
37+
- Re-unified the Rules plugin so compact helper hooks/scripts and the `session-coordination-bridge` skill now ship again from `<rules-root>/plugin`.
38+
- Updated the RULES-side package metadata and local development marketplace metadata to `1.5.0`.
39+
- Rewrote `plugin/README.md` to describe the unified package model instead of the split skill-only model.
40+
- Updated the shared `darkwingtm` marketplace so `claude-code-rules` points at the unified Rules-owned package again.
41+
- Removed duplicate maintained package copies from the shared marketplace workspace.
42+
43+
### Summary
44+
The Rules plugin is unified again under `<rules-root>/plugin`, while the public install target remains `claude-code-rules@darkwingtm`.
45+
46+
---
47+
2948
<a id="version-112"></a>
3049
## Version 1.12: Finalized topology-correction docs and portable install wording
3150

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.29
6+
> **Current Version:** 9.30
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 operator-facing support skills, while active compact-helper runtime reinforcement may remain in separate plugin packages outside governed chain authority |
33+
| Support | `phase-implementation-template.md`, `support/**/*.md`, `plugin/**` | Root-level helper templates, reference-only/support materials, and an optional unified Rules-owned plugin companion that may include compact-helper runtime reinforcement plus operator-facing support skills outside governed chain authority |
3434

3535
### 2.2 Governance Principle
3636

0 commit comments

Comments
 (0)