How cameronsjo/spec-compare works
This repository is an independent research comparison of spec-driven development tools, presented through an interactive site. The user-facing path starts at the site shell, which selects a workflow comparison, individual tool profile, feature matrix, scoring heatmap, or decision guide; these views derive their content from tool JSON and research-derived types and scoring logic. README documents the broader research capabilities, including worktree analysis and orchestration landscape, but those live in documentation rather than sampled runtime modules. Edges below follow explicit imports and calls; documentation-only branches are linked only where the README names the capability.
Main entry points: App.tsx Application shell · data.ts Tool specifications · WorkflowCompare.tsx Workflow comparison · WorkflowPlayer.tsx Workflow player
Components 21
Interactive site
- Application shell
site/src/App.tsx - Workflow comparison
site/src/WorkflowCompare.tsx - Workflow player
site/src/WorkflowPlayer.tsx - Workflow graph
site/src/LoopGraph.tsx - Playback controls
site/src/controls.tsx - Playback state
site/src/player.ts - Feature matrix
site/src/FeatureMatrix.tsx - Scoring heatmap
site/src/ScoringHeatmap.tsx - Tool profiles
site/src/ToolProfile.tsx - Decision guide
site/src/DecisionGuide.tsx - About and disclosure
site/src/About.tsx - Score indicator
site/src/ScorePip.tsx - Emphasized text
site/src/Anchored.tsx
Comparison data
- Tool specifications
site/src/data.ts - Tool data files
site/src/data/tools - Comparison model
site/src/types.ts - Score formatting
site/src/score.ts
Research library
- Research and analysis
docs - Worktree analysis
docs/git-worktree-support.md - Orchestration landscape
docs/landscape.md
Other components
- Site visitor
Connections 34
- Site visitor → Application shell: opens
README.md - Application shell → Workflow comparison: routes to
site/src/App.tsx - Application shell → Workflow player: routes to
site/src/App.tsx - Application shell → Feature matrix: routes to
site/src/App.tsx - Application shell → Scoring heatmap: routes to
site/src/App.tsx - Application shell → Tool profiles: routes to
site/src/App.tsx - Application shell → Decision guide: routes to
site/src/App.tsx - Application shell → About and disclosure: routes to
site/src/App.tsx - Tool specifications → Tool data files: loads
site/src/data.ts - Tool specifications → Comparison model: uses
site/src/data.ts - Application shell → Tool specifications: reads
site/src/App.tsx - Workflow comparison → Tool specifications: reads
site/src/WorkflowCompare.tsx - Workflow comparison → Playback state: advances steps
site/src/WorkflowCompare.tsx - Workflow comparison → Workflow graph: renders
site/src/WorkflowCompare.tsx - Workflow comparison → Playback controls: renders
site/src/WorkflowCompare.tsx - Workflow player → Tool specifications: reads
site/src/WorkflowPlayer.tsx - Workflow player → Playback state: advances steps
site/src/WorkflowPlayer.tsx - Workflow player → Workflow graph: renders
site/src/WorkflowPlayer.tsx - Workflow player → Playback controls: renders
site/src/WorkflowPlayer.tsx - Workflow graph → Comparison model: uses
site/src/LoopGraph.tsx - Playback controls → Playback state: controls
site/src/controls.tsx - Feature matrix → Tool specifications: reads
site/src/FeatureMatrix.tsx - Scoring heatmap → Tool specifications: reads
site/src/ScoringHeatmap.tsx - Scoring heatmap → Score formatting: formats scores
site/src/ScoringHeatmap.tsx - Scoring heatmap → Score indicator: renders
site/src/ScoringHeatmap.tsx - Score indicator → Score formatting: formats scores
site/src/ScorePip.tsx - Tool profiles → Comparison model: uses
site/src/ToolProfile.tsx - Tool profiles → Emphasized text: renders
site/src/ToolProfile.tsx - Tool profiles → Score indicator: renders
site/src/ToolProfile.tsx - Decision guide → Tool specifications: reads
site/src/DecisionGuide.tsx - About and disclosure → Tool specifications: reads
site/src/About.tsx - Research and analysis → Worktree analysis: includes
README.md - Research and analysis → Orchestration landscape: includes
README.md - Research and analysis → Tool data files: informs
README.md