ContextQMD
Back to Superclaude Framework

SuperClaude Plugin Re-organization Plan

docs/plugin-reorg.md

4.3.02.6 KB
Original Source

SuperClaude Plugin Re-organization Plan

Source of Truth

AreaCurrent RepoTarget 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 configSuperClaude_Plugin/hooks/hooks.jsonplugins/superclaude/hooks/hooks.jsonSessionStart automation.
Skill source (skills/confidence-check/)Divergent copies in both reposSingle canonical copy in Framework under plugins/superclaude/skills/confidence-check/Replace plugin repo copy with build artefact.
Session init scriptsSuperClaude_Plugin/scripts/*.shplugins/superclaude/scripts/Executed via Claude Code hooks.
Plugin manifest (.claude-plugin/plugin.json, marketplace.json)SuperClaude_Plugin/.claude-plugin/Generated from plugins/superclaude/manifest/ templatesManifest 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).