[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-73708":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":18,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":22,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":26,"readmeContent":27,"aiSummary":28,"trendingCount":16,"starSnapshotCount":16,"syncStatus":15,"lastSyncTime":29,"discoverSource":30},73708,"claude-code-spec-workflow","Pimzino\u002Fclaude-code-spec-workflow","Pimzino","Automated workflows for Claude Code. Features spec-driven development for new features (Requirements → Design → Tasks → Implementation) and streamlined bug fix workflow for quick issue resolution (Report → Analyze → Fix → Verify).","",null,"TypeScript",3763,266,37,2,0,4,12,41,77.38,"MIT License",false,"main",true,[],"2026-06-12 04:01:10","# Claude Code Spec Workflow\n\n> **⚠️ IMPORTANT NOTICE:** Development focus has shifted to the **MCP (Model Context Protocol) version** of this workflow system. The MCP version provides enhanced features, real-time dashboard, and broader AI tool compatibility.\n> \n> **🚀 [View the new Spec Workflow MCP →](https:\u002F\u002Fgithub.com\u002FPimzino\u002Fspec-workflow-mcp)**\n>\n> This Claude Code-specific version remains available for existing users but will receive limited updates.\n\n[![npm version](https:\u002F\u002Fbadge.fury.io\u002Fjs\u002F@pimzino%2Fclaude-code-spec-workflow.svg?cacheSeconds=300)](https:\u002F\u002Fbadge.fury.io\u002Fjs\u002F@pimzino%2Fclaude-code-spec-workflow)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n\n**Automated workflows for Claude Code with intelligent task execution.**\n\nTransform your development with structured workflows: **Requirements → Design → Tasks → Implementation** for new features, plus streamlined **Report → Analyze → Fix → Verify** for bug fixes.\n\n## ☕ Support This Project\n\n\u003Ca href=\"https:\u002F\u002Fbuymeacoffee.com\u002FPimzino\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Fcdn.buymeacoffee.com\u002Fbuttons\u002Fv2\u002Fdefault-yellow.png\" alt=\"Buy Me A Coffee\" style=\"height: 60px !important;width: 217px !important;\" >\u003C\u002Fa>\n\n---\n\n## 📦 Installation\n\n1. Install the workflow globally\n```bash\nnpm i -g @pimzino\u002Fclaude-code-spec-workflow\n```\n2. Run the setup command in your project directory\n```bash\nclaude-code-spec-workflow\n```\n**Thats it, you are ready to go!**\n---\n\n## ✨ What You Get\n\n- **📁 Complete .claude\u002F structure** - All files and directories\n- **📝 10 slash commands** - 5 spec workflow + 5 bug fix workflow\n- **🎯 Intelligent task execution** - Automated implementation\n- **🤖 4 specialized agents** - Enhanced automation\n- **📊 Real-time dashboard** - Monitor progress visually\n- **🔧 Auto-generated commands** - One command per task\n- **📋 Document templates** - Professional spec documents\n- **⚙️ Project steering** - Persistent context and standards\n- **⚡ Smart optimization** - Intelligent context sharing and caching\n\n---\n\n## 🔄 Workflows Overview\n\n### 📊 **Spec Workflow** (New Features)\n\n**Complete automation in one command:**\n\n```bash\n\u002Fspec-create feature-name \"Description\"\n```\n\n**What happens:**\n1. **Requirements** → User stories + acceptance criteria\n2. **Design** → Technical architecture + diagrams\n3. **Tasks** → Atomic, agent-friendly breakdown\n4. **Commands** → Auto-generated task commands (optional)\n\n**Execute tasks:**\n```bash\n# Manual control\n\u002Fspec-execute 1 feature-name\n\u002Ffeature-name-task-1        # Auto-generated\n```\n\n### 🐛 **Bug Fix Workflow** (Quick Fixes)\n\n```bash\n\u002Fbug-create issue-name \"Description\"  # Document the bug\n\u002Fbug-analyze                          # Find root cause\n\u002Fbug-fix                             # Implement solution\n\u002Fbug-verify                          # Confirm resolution\n```\n\n### 🎯 **Steering Setup** (Project Context)\n\n```bash\n\u002Fspec-steering-setup  # Creates product.md, tech.md, structure.md\n```\n\n---\n\n## 🛠️ Commands Reference\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>📊 Spec Workflow Commands\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n| Command | Purpose |\n|---------|---------|\n| `\u002Fspec-steering-setup` | Create project context documents |\n| `\u002Fspec-create \u003Cname>` | Complete spec workflow |\n| `\u002Fspec-execute \u003Ctask-id>` | Manual task execution |\n| `\u002F\u003Cname>-task-\u003Cid>` | Auto-generated task commands |\n| `\u002Fspec-status` | Show progress |\n| `\u002Fspec-list` | List all specs |\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>🐛 Bug Fix Commands\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n| Command | Purpose |\n|---------|---------|\n| `\u002Fbug-create \u003Cname>` | Document bug with structured format |\n| `\u002Fbug-analyze` | Investigate root cause |\n| `\u002Fbug-fix` | Implement targeted solution |\n| `\u002Fbug-verify` | Verify resolution |\n| `\u002Fbug-status` | Show bug fix progress |\n\n\u003C\u002Fdetails>\n\n---\n\n## 🎯 Key Features\n\n### 🤖 **Intelligent Task Execution**\n- **Streamlined** task implementation\n- **Context-aware** execution with full specification context\n- **Agent-based** implementation with spec-task-executor\n\n### 🧠 **Specialized Agents** (Optional)\n4 AI agents for enhanced automation:\n\n**Core Workflow:** `spec-task-executor`, `spec-requirements-validator`, `spec-design-validator`, `spec-task-validator`\n\n\n> **Note:** Agents are optional - everything works with built-in fallbacks.\n\n### ⚡ **Complete Context Optimization** (NEW!)\n- **Universal context sharing** - Steering, specification, AND template documents optimized\n- **60-80% token reduction** - Eliminates redundant document fetching across all document types\n- **Triple optimization commands** - `get-steering-context`, `get-spec-context`, and `get-template-context`\n- **Smart document handling** - Bug documents use direct reading (no redundancy), templates use bulk loading (high redundancy)\n- **Improved performance** - Faster agent execution with cached context across all workflows\n- **Automatic fallback** - Maintains reliability with individual `get-content` when optimization unavailable\n- **Session-based caching** - Intelligent file change detection and cache invalidation\n\n### 📊 **Real-Time Dashboard**\n```bash\nnpx -p @pimzino\u002Fclaude-code-spec-workflow claude-spec-dashboard\n```\n- Live progress tracking\n- WebSocket updates\n- Git integration\n- Modern UI with Tailwind CSS\n\n---\n\n### 🔗 Dashboard Tunnel (NEW!)\n\nShare your dashboard securely with external stakeholders through temporary HTTPS URLs:\n\n```bash\n# Start dashboard with tunnel\nnpx -p @pimzino\u002Fclaude-code-spec-workflow claude-spec-dashboard --tunnel\n\n# With password protection\nnpx -p @pimzino\u002Fclaude-code-spec-workflow claude-spec-dashboard --tunnel --tunnel-password mySecret123\n\n# Choose specific provider\nnpx -p @pimzino\u002Fclaude-code-spec-workflow claude-spec-dashboard --tunnel --tunnel-provider cloudflare\n```\n\n**Tunnel Features:**\n- **🔒 Secure HTTPS URLs** - Share dashboard with managers, clients, or remote team members\n- **👁️ Read-Only Access** - External viewers cannot modify any project data\n- **🔑 Optional Password** - Protect access with password authentication\n- **🌐 Multiple Providers** - Automatic fallback between Cloudflare and ngrok\n- **📊 Usage Analytics** - Track who accessed your dashboard and when\n- **⏰ Auto-Expiration** - Tunnels close when you stop the dashboard\n- **🚀 Zero Configuration** - Works out of the box with built-in providers\n\n## 📊 Command Line Options\n\n### Setup Commands\n```bash\n# Setup in current directory\nnpx @pimzino\u002Fclaude-code-spec-workflow\n\n# Setup in specific directory\nnpx @pimzino\u002Fclaude-code-spec-workflow --project \u002Fpath\u002Fto\u002Fproject\n\n# Force overwrite existing files\nnpx @pimzino\u002Fclaude-code-spec-workflow --force\n\n# Skip confirmation prompts\nnpx @pimzino\u002Fclaude-code-spec-workflow --yes\n\n# Test the setup\nnpx @pimzino\u002Fclaude-code-spec-workflow test\n```\n\n### Dashboard Commands\n```bash\n# Basic dashboard\nnpx -p @pimzino\u002Fclaude-code-spec-workflow claude-spec-dashboard\n\n# Dashboard with tunnel (share externally)\nnpx -p @pimzino\u002Fclaude-code-spec-workflow claude-spec-dashboard --tunnel\n\n# Full tunnel configuration\nnpx -p @pimzino\u002Fclaude-code-spec-workflow claude-spec-dashboard \\\n  --tunnel \\\n  --tunnel-password mySecret123 \\\n  --tunnel-provider cloudflare \\\n  --port 3000 \\\n  --open\n```\n\n## 🎯 Steering Documents (NEW!)\n\nSteering documents provide persistent project context that guides all spec development:\n\n### **Product Document** (`product.md`)\n- Product vision and purpose\n- Target users and their needs\n- Key features and objectives\n- Success metrics\n\n### **Technology Document** (`tech.md`)\n- Technology stack and frameworks\n- Development tools and practices\n- Technical constraints and requirements\n- Third-party integrations\n\n### **Structure Document** (`structure.md`)\n- File organization patterns\n- Naming conventions\n- Import patterns\n- Code organization principles\n\nRun `\u002Fspec-steering-setup` to create these documents. Claude will analyze your project and help you define these standards.\n\n## 🎨 Features\n\n### ✅ **Zero Configuration**\n- Works out of the box with any project\n- Auto-detects project type (Node.js, Python, Java, etc.)\n- Validates Claude Code installation\n\n### ✅ **Interactive Setup**\n- Beautiful CLI with progress indicators\n- Confirmation prompts for safety\n- Helpful error messages and guidance\n\n### ✅ **Smart File Management**\n- Complete workflow instructions in each command file\n- Creates comprehensive directory structure\n- Includes all necessary templates and configs\n\n### ✅ **Professional Quality**\n- **Full TypeScript implementation** with strict type checking\n- **Frontend converted to TypeScript** for enhanced dashboard development\n- **95%+ type coverage** with no implicit any types\n- **Modern build pipeline** with esbuild bundling and source maps\n- Comprehensive error handling\n- Follows npm best practices\n\n### ✅ **Steering Document Integration**\n- Persistent project context across all specs\n- Automatic alignment with project standards\n- Consistent code generation\n- Reduced need for repetitive explanations\n\n### ✅ **TypeScript Dashboard Frontend**\n- **Type-safe frontend code** with comprehensive interfaces\n- **Real-time WebSocket communication** with typed message handling\n- **Petite-vue integration** with custom type definitions\n- **Build pipeline** supporting development and production bundles\n- **Strict null checking** and modern TypeScript patterns\n- **JSDoc documentation** for all exported functions\n\n## 🏗️ Project Structure After Setup\n\n```\nyour-project\u002F\n├── .claude\u002F\n│   ├── commands\u002F           # 14 slash commands + auto-generated\n│   ├── steering\u002F          # product.md, tech.md, structure.md\n│   ├── templates\u002F         # Document templates\n│   ├── specs\u002F            # Generated specifications\n│   ├── bugs\u002F             # Bug fix workflows\n│   └── agents\u002F           # AI agents (enabled by default)\n```\n\n## 🧪 Testing\n\nThe package includes a built-in test command:\n\n```bash\n# Test setup in temporary directory\nnpx @pimzino\u002Fclaude-code-spec-workflow test\n```\n\n## 📋 Requirements\n\n- **Node.js** 16.0.0 or higher\n- **Claude Code** installed and configured\n- Any project directory\n\n## 🔧 Troubleshooting\n\n### Common Issues\n\n**❓ Command not found after NPX**\n```bash\n# Make sure you're using the correct package name\nnpx @pimzino\u002Fclaude-code-spec-workflow\n```\n\n**❓ Setup fails with permission errors**\n```bash\n# Try with different directory permissions\nnpx @pimzino\u002Fclaude-code-spec-workflow --project ~\u002Fmy-project\n```\n\n**❓ Claude Code not detected**\n```bash\n# Install Claude Code first\nnpm install -g @anthropic-ai\u002Fclaude-code\n```\n\n### Debug Information\n\n```bash\n# Show verbose output\nDEBUG=* npx @pimzino\u002Fclaude-code-spec-workflow\n\n# Check package version\nnpx @pimzino\u002Fclaude-code-spec-workflow --version\n```\n\n## 🌟 Examples\n\n### Basic Usage\n```bash\ncd my-awesome-project\nnpx @pimzino\u002Fclaude-code-spec-workflow\nclaude\n# Type: \u002Fspec-create user-dashboard \"User profile management\"\n```\n\n### Advanced Usage\n```bash\n# Setup multiple projects\nfor dir in project1 project2 project3; do\n  npx @pimzino\u002Fclaude-code-spec-workflow --project $dir --yes\ndone\n```\n\n## 🔧 TypeScript Development\n\n### Frontend Dashboard Development\n\nThe dashboard frontend is fully implemented in TypeScript for enhanced type safety and developer experience:\n\n#### Type Definitions\n```typescript\n\u002F\u002F Core dashboard types\ninterface Project {\n  path: string;\n  name: string;\n  level: number;\n  hasActiveSession: boolean;\n  specs: Spec[];\n  bugs: Bug[];\n  steeringStatus?: SteeringStatus;\n}\n\n\u002F\u002F WebSocket message types with discriminated unions\ntype WebSocketMessage = \n  | { type: 'initial'; data: InitialData }\n  | { type: 'update'; data: UpdateData }\n  | { type: 'error'; data: ErrorData }\n  | { type: 'tunnel-status'; data: TunnelStatusData };\n```\n\n#### Build Commands\n```bash\n# TypeScript compilation and bundling\nnpm run build:frontend:dev   # Build frontend for development\nnpm run build:frontend:prod  # Build frontend for production (minified)\nnpm run watch:frontend       # Watch mode with auto-rebuild\nnpm run typecheck:frontend   # Type checking only (no output)\nnpm run typecheck           # Check both backend and frontend types\n\n# Development workflow  \nnpm run dev:dashboard       # Start dashboard with hot reload (frontend + backend)\nnpm run dev:dashboard:backend-only  # Start only backend (for frontend debugging)\n\n# Full build process\nnpm run build              # Complete build: TypeScript + frontend + static files\nnpm run lint               # Lint TypeScript files with auto-fix\nnpm run format             # Format code with Prettier\n```\n\n#### Type Safety Features\n- **Strict TypeScript configuration** with null checks\n- **Runtime type validation** with type guards\n- **WebSocket message typing** for real-time updates  \n- **State management types** for reactive UI components\n- **Error handling types** with Result\u003CT> pattern\n- **Petite-vue integration** with custom type definitions\n\n#### Type Usage Examples\n\n```typescript\n\u002F\u002F Import dashboard types\nimport type { Project, WebSocketMessage, AppState } from '.\u002Fdashboard.types';\n\n\u002F\u002F Type-safe project handling\nfunction selectProject(project: Project): void {\n  console.log(`Selected: ${project.name} (${project.specs.length} specs)`);\n  \n  \u002F\u002F Safe property access with optional chaining\n  const steeringCount = project.steeringStatus?.totalDocs ?? 0;\n  if (steeringCount > 0) {\n    console.log(`Steering docs: ${steeringCount}`);\n  }\n}\n\n\u002F\u002F WebSocket message handling with discriminated unions\nfunction handleMessage(message: WebSocketMessage): void {\n  switch (message.type) {\n    case 'initial':\n      \u002F\u002F TypeScript knows data is InitialData\n      console.log(`Loaded ${message.data.projects.length} projects`);\n      break;\n    case 'update':\n      \u002F\u002F TypeScript knows data is UpdateData\n      console.log(`Updated project: ${message.data.projectPath}`);\n      break;\n    case 'error':\n      \u002F\u002F TypeScript knows data is ErrorData\n      console.error(`Error: ${message.data.message}`);\n      break;\n  }\n}\n\n\u002F\u002F Type guards for runtime validation\nfunction isValidProject(obj: unknown): obj is Project {\n  return (\n    typeof obj === 'object' &&\n    obj !== null &&\n    'path' in obj &&\n    'name' in obj &&\n    'specs' in obj &&\n    Array.isArray((obj as Project).specs)\n  );\n}\n\n\u002F\u002F Result type for error handling\ntype Result\u003CT, E = Error> = \n  | { success: true; data: T }\n  | { success: false; error: E };\n\nfunction parseProjectData(data: unknown): Result\u003CProject> {\n  if (isValidProject(data)) {\n    return { success: true, data };\n  }\n  return { success: false, error: new Error('Invalid project data') };\n}\n```\n\n#### Development Guidelines\n- **JSDoc documentation** on all exported functions\n- **95%+ type coverage** maintained (no implicit any types)\n- **Modern TypeScript patterns** (optional chaining, nullish coalescing)\n- **Type guards preferred** over type assertions\n- **Interfaces for object shapes**, union types for discriminated unions\n- **Result\u003CT> pattern** for error handling\n- **Runtime validation** with type guards for external data\n\n## 📚 Documentation\n\n- **[Full Documentation](https:\u002F\u002Fgithub.com\u002Fpimzino\u002Fclaude-code-spec-workflow#readme)**\n- **[Tunnel Feature Guide](.\u002Fdocs\u002Ftunnel-feature.md)** - Comprehensive tunnel documentation\n- **[Tunnel Examples](.\u002Fexamples\u002Ftunnel\u002F)** - Ready-to-use tunnel scripts\n- **[Claude Code Docs](https:\u002F\u002Fdocs.anthropic.com\u002Fclaude-code)**\n- **[TypeScript API Reference](.\u002Fdocs\u002Ftypescript-api.md)** - Generated from JSDoc comments\n\n## 🤝 Contributing\n\nContributions are welcome! Please see our [Contributing Guide](https:\u002F\u002Fgithub.com\u002Fpimzino\u002Fclaude-code-spec-workflow\u002Fblob\u002Fmain\u002FCONTRIBUTING.md).\n\n## 📄 License\n\nMIT License - see [LICENSE](https:\u002F\u002Fgithub.com\u002Fpimzino\u002Fclaude-code-spec-workflow\u002Fblob\u002Fmain\u002FLICENSE) for details.\n\n## 🏷️ Changelog\n\nSee [CHANGELOG.md](https:\u002F\u002Fgithub.com\u002Fpimzino\u002Fclaude-code-spec-workflow\u002Fblob\u002Fmain\u002FCHANGELOG.md) for version history.\n\n---\n\n## 🚦 When To Use What\n\n| Scenario | Recommended Approach |\n|----------|---------------------|\n| **New feature, well-defined** | `\u002Fspec-execute` or individual task commands |\n| **Complex\u002Fexperimental feature** | `\u002Fspec-execute` (manual control) |\n| **Bug in existing code** | Bug workflow (`\u002Fbug-create` → `\u002Fbug-verify`) |\n| **Learning the codebase** | Manual execution with individual commands |\n| **Production deployment** | Full spec workflow with completion review |\n\n---\n\n## 🚀 Installation & Setup\n\n### **Installation**\n```bash\n# Install globally (recommended)\nnpm install -g @pimzino\u002Fclaude-code-spec-workflow\n\n# Verify installation\nclaude-code-spec-workflow --version\n```\n\n### **Setup Options**\n```bash\n# Basic setup\nclaude-code-spec-workflow\n\n# Advanced options\nclaude-code-spec-workflow --project \u002Fpath --force --yes\n```\n\n**During setup you choose:**\n- ✅ **Enable agents?** Enhanced automation vs simpler setup\n- ✅ **Project analysis** Auto-detection of frameworks and patterns\n\n---\n\n## 📚 Examples\n**Recommendation: Use Claude Opus 4 to generate the spec documentation '\u002Fspec-create', then use Claude Sonnet 4 for the implementation i.e. '\u002Fspec-execute' or '\u002F{spec-name}-task-\u003Cid>'.**\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Basic Workflow Example\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```bash\n# 1. Install globally (one time)\nnpm install -g @pimzino\u002Fclaude-code-spec-workflow\n\n# 2. Setup project (one time)\ncd my-project\nclaude-code-spec-workflow\n\n# 3. Create steering documents (recommended)\nclaude\n\u002Fspec-steering-setup\n\n# 4. Create feature spec\n\u002Fspec-create user-authentication \"Secure login system\"\n\n# 5. Execute tasks\n\u002Fspec-execute 1 user-authentication\n\n# 6. Monitor progress\n\u002Fspec-status user-authentication\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Bug Fix Example\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```bash\n\u002Fbug-create login-timeout \"Users logged out too quickly\"\n\u002Fbug-analyze\n\u002Fbug-fix\n\u002Fbug-verify\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## ⚡ Context Optimization Commands\n\nThe package includes optimized commands for efficient document loading across all document types:\n\n### **get-steering-context**\nLoad all steering documents at once for context sharing:\n```bash\nclaude-code-spec-workflow get-steering-context\n```\n**Output**: Formatted markdown with all steering documents (product.md, tech.md, structure.md)\n\n### **get-spec-context**\nLoad all specification documents at once for context sharing:\n```bash\nclaude-code-spec-workflow get-spec-context feature-name\n```\n**Output**: Formatted markdown with all spec documents (requirements.md, design.md, tasks.md)\n\n### **get-template-context**\nLoad templates by category for context sharing:\n```bash\n# Load all templates\nclaude-code-spec-workflow get-template-context\n\n# Load specific template category\nclaude-code-spec-workflow get-template-context spec    # Spec templates\nclaude-code-spec-workflow get-template-context bug     # Bug templates\nclaude-code-spec-workflow get-template-context steering # Steering templates\n```\n**Output**: Formatted markdown with requested templates\n\n### **Smart Document Handling**\n- **High-redundancy documents** (steering, specs, templates): Use optimized bulk loading\n- **Low-redundancy documents** (bug reports): Use direct file reading for simplicity\n- **Selective delegation**: Main agents load full context, but pass only relevant portions to sub-agents\n- **Individual files**: Continue using `get-content` for edge cases\n\n### **Benefits**\n- **60-80% token reduction** compared to individual file loading\n- **Faster execution** with cached context across all workflows\n- **Automatic fallback** to individual `get-content` when needed\n- **Session-based caching** with intelligent file change detection\n\n### **Hierarchical Context Management**\nThe system implements a sophisticated **hierarchical context management strategy** for maximum efficiency:\n\n**Main Agents** (Commands like `\u002Fspec-execute`, `\u002Fspec-create`):\n- **Load ALL context once** at the beginning using optimized commands\n- **Store complete context** for task coordination and decision-making\n- **Distribute selective context** to sub-agents without requiring reloads\n\n**Sub-Agents** (Agents like `spec-task-executor`):\n- **Priority 1**: Use provided context from task instructions (steering, specification, task details)\n- **Priority 2**: Fallback to loading context only if not provided above\n- **Never redundantly load** context when it's already been provided by main agents\n\n**Context Distribution Pattern**:\n```\nMain Agent loads: Steering + Full Spec + Task Details\n↓ Delegates to Sub-Agent with:\n├── Complete Steering Context\n├── Selective Spec Context (Requirements + Design only)\n├── Specific Task Details\n└── Clear instruction: \"Do NOT reload context\"\n```\n\nThis approach **eliminates redundant loading** while ensuring each agent has exactly the context it needs.\n\n---\n\n## 🛟 Troubleshooting\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Common Issues\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n**❓ \"Command not found\"**\n```bash\n# Install globally first\nnpm install -g @pimzino\u002Fclaude-code-spec-workflow\n\n# Then use the command\nclaude-code-spec-workflow\n```\n\n**❓ \"Claude Code not detected\"**\n```bash\nnpm install -g @anthropic-ai\u002Fclaude-code\n```\n\n**❓ \"Permission errors\"**\n```bash\nclaude-code-spec-workflow --project ~\u002Fmy-project\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## 📋 Requirements\n\n- **Node.js** 16.0.0+\n- **Claude Code** installed\n- Any project directory\n\n---\n\n## 🔗 Links\n\n- **[Full Documentation](https:\u002F\u002Fgithub.com\u002Fpimzino\u002Fclaude-code-spec-workflow#readme)**\n- **[Claude Code Docs](https:\u002F\u002Fdocs.anthropic.com\u002Fclaude-code)**\n- **[Report Issues](https:\u002F\u002Fgithub.com\u002Fpimzino\u002Fclaude-code-spec-workflow\u002Fissues)**\n\n---\n\n## 📄 License & Credits\n\n**MIT License** - [LICENSE](LICENSE)\n\n**Made with ❤️ by [Pimzino](https:\u002F\u002Fgithub.com\u002Fpimzino)**\n\n**Special Thanks:**\n- @pimzino - Initial setup\n- @boundless-oss - Steering documents\n- @mquinnv - Dashboard feature\n\n**Powered by:** [Claude Code](https:\u002F\u002Fdocs.anthropic.com\u002Fclaude-code) • [Mermaid](https:\u002F\u002Fmermaid.js.org\u002F) • [TypeScript](https:\u002F\u002Fwww.typescriptlang.org\u002F)","Claude Code Spec Workflow 是一个为 Claude Code 设计的自动化工作流工具。它支持以规范驱动的方式开发新功能（需求→设计→任务→实现），以及简化了从报告到验证的快速修复 bug 流程。项目使用 TypeScript 编写，具有智能任务执行、实时仪表板和专业文档模板等核心功能。适用于需要提高开发效率并确保代码质量的软件开发团队，在引入新特性和处理bug时能够提供结构化的工作流程支持。","2026-06-11 03:47:02","high_star"]