How pimzino/claude-code-spec-workflow works
Project type and purpose
• This is an open-source TypeScript‐based CLI library and dashboard tool called Claude Code Spec Workflow.
• It provides automated workflows for feature specification and bug fixing via slash commands, a pluggable agent system, and a real-time web dashboard.
File structure
• Top‐level files: configuration (tsconfig.json, eslint, jest), scripts/, package.json, README, LICENSE.
• src/cli.ts & index.ts: CLI entrypoints that wire up commands.
• src/dashboard/: a lightweight HTTP/WebSocket server (server.ts, multi-server.ts) plus public/ (HTML + JS UI).
• src/markdown/: all Markdown templates and command/agent definitions.
• src/* utility modules: get-content.ts, get-tasks.ts, git.ts, steering.ts, task-generator.ts, etc.
• Tests under tests/ mirror parser, dashboard, utils, steering, task-generator, etc.
Key insights from README
• Core components: CLI, orchestrator, 16 AI agents (optional), Markdown templates, real-time dashboard.
• Workflows: spec workflow (requirements→design→tasks→execution) and bug-fix workflow (report→analyze→fix→verify).
• External dependencies: Claude Code API, file system (.claude folder), Git integration, WebSocket for dashboard updates.