Skip to content

Pack candidate: spectacle — IEEE/ISO spec templates #10

@arcaven

Description

@arcaven

Context

spectacle is the IEEE/ISO standards-based spec projection system in the ArcavenAE ecosystem. It is the natural second pack for sideshow after bmad — same org, similar install model, already has a manifest.

Part of: #9 (SDD system survey)
Ref: kos finding-042

System Profile

  • Repo: ArcavenAE/spectacle
  • Fingerprint: spectacle.yaml at project root (in the spectacle repo); .claude/commands/spectacle/ in consumer projects
  • Storage: YAML + Markdown (files only)
  • Standards covered: ISO/IEC/IEEE 29148, IEEE 1016, ISO/IEC/IEEE 42010, arc42, MADR

Current Install Model

just install <target-dir>           # copies commands → <target>/.claude/commands/spectacle/
just install-templates <target-dir> # copies templates → <target>/docs/spec/

This is the same pattern sideshow already implements for bmad: copy files into .claude/commands/ with rewritten paths.

What Sideshow Would Manage

  1. Commands.claude/commands/spectacle/*.md (slash commands: /spectacle.srs, /spectacle.sdd, etc.)
  2. Templatestemplates/ directory (29148, 1016, 42010, arc42, MADR)
  3. Profilesprofiles/ directory (viewpoint selection presets)

Version Detection

spectacle.yaml has a version field. Sideshow can check this for update detection.

Implementation Notes

  • The install flow is nearly identical to bmad: copy commands, rewrite relative paths to absolute
  • Templates are optional (user may want commands only, loading templates on demand)
  • Consider two install modes: sideshow install spectacle (commands only) vs sideshow install spectacle --with-templates
  • spectacle.yaml serves as both the pack manifest and the system fingerprint

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions