Skip to content

improvement: add plugin adoption guide #454

@Luis85

Description

@Luis85

Context

Part of the plugin audit in #444 (§8 Quick Wins). There is no guide for adopters who want to install Specorator as a Claude Code plugin. Standalone mode (clone the repo) and plugin mode (install from package) have different setup steps, namespace behaviors, and hook activation paths.

Work

Create docs/plugin-adoption.md covering:

  1. Standalone vs. plugin mode — what differs (file layout, CLAUDE.md loading, context budget)
  2. Install command — how to install Specorator as a plugin
  3. Namespace change — commands are prefixed in plugin mode: /spec:start/specorator:spec:start
  4. Hook activation — hooks in hooks/hooks.json activate automatically; hooks in .claude/settings.json do not
  5. Scripts — how to invoke bin/ scripts in plugin mode
  6. First-run experience — the orchestrator agent activates by default; what to expect

Definition of Done

  • docs/plugin-adoption.md exists and covers all 6 sections above
  • Linked from README.md install section
  • Verify gate green

References

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2High / next-up, important but not blockingdocumentationImprovements or additions to documentationroadmap:automation-hardeningv0.7 automation contract — registry, verify tiers, agent checks, Zod runtime validationtrack:specorator-improvementImprovement to the Specorator template itself

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions