wehub-resource-sync
54 lines
2.6 KiB
Markdown
54 lines
2.6 KiB
Markdown
# SuperClaude Plugin Re-organization Plan
|
||
|
||
## Source of Truth
|
||
|
||
| Area | Current Repo | Target Location (Framework) | Notes |
|
||
|------|--------------|-----------------------------|-------|
|
||
| Agent docs (`agents/*.md`) | `SuperClaude_Plugin/agents/` | `plugins/superclaude/agents/` | Markdown instructions consumed by `/sc:*` commands. |
|
||
| Command definitions (`commands/*.md`) | `SuperClaude_Plugin/commands/` | `plugins/superclaude/commands/` | YAML frontmatter + markdown bodies. |
|
||
| Hook config | `SuperClaude_Plugin/hooks/hooks.json` | `plugins/superclaude/hooks/hooks.json` | SessionStart automation. |
|
||
| Skill source (`skills/confidence-check/`) | Divergent copies in both repos | **Single canonical copy in Framework** under `plugins/superclaude/skills/confidence-check/` | Replace plugin repo copy with build artefact. |
|
||
| Session init scripts | `SuperClaude_Plugin/scripts/*.sh` | `plugins/superclaude/scripts/` | Executed via Claude Code hooks. |
|
||
| Plugin manifest (`.claude-plugin/plugin.json`, `marketplace.json`) | `SuperClaude_Plugin/.claude-plugin/` | Generated from `plugins/superclaude/manifest/` templates | Manifest fields will be parameterised for official distribution/local builds. |
|
||
| Confidence skill tests (`.claude-plugin/tests`) | `SuperClaude_Plugin/.claude-plugin/tests/` | `plugins/superclaude/tests/` | Keep with Framework to ensure tests run before packaging. |
|
||
|
||
## Proposed Layout in `SuperClaude_Framework`
|
||
|
||
```
|
||
plugins/
|
||
superclaude/
|
||
agents/
|
||
commands/
|
||
hooks/
|
||
scripts/
|
||
skills/
|
||
confidence-check/
|
||
SKILL.md
|
||
confidence.ts
|
||
manifest/
|
||
plugin.template.json
|
||
marketplace.template.json
|
||
tests/
|
||
confidence/
|
||
test_cases.json
|
||
expected_results.json
|
||
run.py
|
||
```
|
||
|
||
## Build Workflow
|
||
|
||
1. `make build-plugin` (new target):
|
||
- Validates skill tests (`uv run` / Node unit tests).
|
||
- Copies `plugins/superclaude/*` into a fresh `dist/plugins/superclaude/.claude-plugin/…` tree.
|
||
- Renders manifest templates with version/author pulled from `pyproject.toml` / git tags.
|
||
2. `make sync-plugin-repo`:
|
||
- Rsyncs the generated artefacts into `../SuperClaude_Plugin/`.
|
||
- Cleans stale files before copy (to avoid drift).
|
||
|
||
## Next Steps
|
||
|
||
- [ ] Port existing assets from `SuperClaude_Plugin` into the Framework layout.
|
||
- [ ] Update Framework docs (CLAUDE.md, README) to reference the new build commands.
|
||
- [ ] Strip direct edits in `SuperClaude_Plugin` by adding a readme banner (“generated – do not edit”) and optional CI guard.
|
||
- [ ] Define the roadmap for expanding `/sc:*` commands (identify which legacy flows warrant reintroduction as optional modules).
|