superclaude-org--superclaude_framework
wehub-resource-sync
54 行
2.6 KiB
Markdown
54 行
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).
|