create-hq 5.0.0

package/template/workers/content-shared/test/sample-page.json

@@ -0,0 +1,115 @@
+{
+  "url": "/enterprise-platform",
+  "title": "Enterprise Document Management Platform",
+  "meta": {
+    "description": "Secure, compliant document management for enterprises. SOC 2 certified with HIPAA-ready infrastructure.",
+    "keywords": ["document management", "enterprise", "SOC 2", "compliance"],
+    "ogTitle": "Enterprise Document Management | ExampleCo",
+    "ogDescription": "Join 10,000+ companies using our leading document platform"
+  },
+  "sections": [
+    {
+      "id": "hero",
+      "type": "hero",
+      "heading": "The Leading Document Management Platform",
+      "subheading": "Trusted by enterprise teams worldwide",
+      "paragraphs": [
+        "Streamline your document workflows with our industry-leading platform. Save up to 40% on document processing time and reduce errors by 85%.",
+        "Our platform is SOC 2 Type II certified and HIPAA compliant, ensuring your sensitive data is always protected."
+      ]
+    },
+    {
+      "id": "features",
+      "type": "features",
+      "heading": "Enterprise-Grade Features",
+      "paragraphs": [
+        "Built for teams that need powerful, secure document management.",
+        "Integrates with Salesforce, HubSpot, and 100+ other tools."
+      ],
+      "bulletPoints": [
+        "Advanced version control",
+        "Real-time collaboration",
+        "Automated workflows",
+        "Custom approval chains",
+        "AI-powered search"
+      ]
+    },
+    {
+      "id": "testimonials",
+      "type": "testimonials",
+      "heading": "Trusted by Industry Leaders",
+      "paragraphs": [
+        "Over 10,000 companies trust our platform for their document needs.",
+        "See how leading enterprises transformed their workflows."
+      ]
+    },
+    {
+      "id": "stats",
+      "type": "content",
+      "heading": "Results That Speak for Themselves",
+      "paragraphs": [
+        "Our customers see an average 40% reduction in document processing time.",
+        "99.9% uptime guaranteed with our enterprise SLA.",
+        "Join the 500+ Fortune 500 companies using our platform."
+      ]
+    },
+    {
+      "id": "security",
+      "type": "content",
+      "heading": "Enterprise Security You Can Trust",
+      "paragraphs": [
+        "Bank-level encryption protects your data at rest and in transit.",
+        "Our platform is the only document solution with both SOC 2 and HIPAA certifications.",
+        "Zero downtime deployments ensure your team is never interrupted."
+      ]
+    },
+    {
+      "id": "cta-section",
+      "type": "cta",
+      "heading": "Ready to Transform Your Workflows?",
+      "paragraphs": [
+        "Get started today and see results in just 15 minutes.",
+        "No credit card required for your free trial."
+      ]
+    }
+  ],
+  "ctas": [
+    {
+      "text": "Start Free Trial",
+      "href": "/signup",
+      "type": "primary",
+      "location": "hero"
+    },
+    {
+      "text": "Request Demo",
+      "href": "/demo",
+      "type": "primary",
+      "location": "hero"
+    },
+    {
+      "text": "Learn More",
+      "href": "/features",
+      "type": "secondary",
+      "location": "features"
+    },
+    {
+      "text": "Contact Sales",
+      "href": "/contact",
+      "type": "primary",
+      "location": "cta-section"
+    }
+  ],
+  "images": [
+    {
+      "src": "/images/hero-dashboard.png",
+      "alt": "Example dashboard showing document workflows",
+      "context": "hero"
+    },
+    {
+      "src": "/images/security-badges.png",
+      "alt": "SOC 2 and HIPAA certification badges",
+      "context": "security"
+    }
+  ],
+  "extractedAt": "2026-01-25T12:00:00Z"
+}

package/template/workers/content-shared/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "dist",
+    "rootDir": ".",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["lib/**/*", "index.ts", "cli.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/template/workers/dev-team/README.md

@@ -0,0 +1,166 @@
+# Dev Team Worker System
+
+Multi-worker system for software development with intelligent task routing, sub-agent spawning, and learning loops.
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    PROJECT MANAGER                          │
+│  • Owns PRD lifecycle                                       │
+│  • Selects next issue from project                          │
+│  • Spawns Task Executor per issue                           │
+│  • Aggregates learnings → knowledge base                    │
+└─────────────────────┬───────────────────────────────────────┘
+                      │ spawns per issue
+                      ▼
+┌─────────────────────────────────────────────────────────────┐
+│                    TASK EXECUTOR                            │
+│  • Analyzes issue requirements                              │
+│  • Determines worker sequence                               │
+│  • Spawns workers as Task subagents                         │
+│  • Validates completion, retries on failure                 │
+│  • Reports learnings back to Project Manager                │
+└─────────────────────┬───────────────────────────────────────┘
+                      │ spawns per phase
+                      ▼
+┌─────────────────────────────────────────────────────────────┐
+│                  SPECIALIZED WORKERS                        │
+│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐       │
+│  │ Architect│ │ Backend  │ │ Frontend │ │    QA    │       │
+│  └──────────┘ └──────────┘ └──────────┘ └──────────┘       │
+│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐       │
+│  │ Database │ │  Infra   │ │  Motion  │ │Code Review│      │
+│  └──────────┘ └──────────┘ └──────────┘ └──────────┘       │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Workers
+
+| Worker | Purpose | Key Skills |
+|--------|---------|------------|
+| **project-manager** | PRD lifecycle, issue selection | next-issue, create-prd, update-learnings |
+| **task-executor** | Route to workers, validate | execute, analyze-issue, validate-completion |
+| **architect** | System design, planning | system-design, api-design, refactor-plan |
+| **backend-dev** | API, business logic | implement-endpoint, implement-service |
+| **database-dev** | Schema, migrations | create-schema, create-migration, optimize-query |
+| **qa-tester** | Testing, automation | run-tests, write-test, create-demo-account |
+| **frontend-dev** | React/Next components | create-component, create-page, add-form |
+| **motion-designer** | Animations, polish | add-animation, generate-image (via gnb) |
+| **infra-dev** | CI/CD, deployment | setup-cicd, create-dockerfile, add-monitoring |
+| **code-reviewer** | PR review, merge | review-pr, merge-to-staging, merge-to-production |
+| **knowledge-curator** | Learnings, docs | process-learnings, update-patterns |
+
+## Usage
+
+### Start a Project
+```bash
+# Create PRD
+/run project-manager create-prd --name "my-feature"
+
+# Get next issue
+/run project-manager next-issue --project "my-feature"
+```
+
+### Execute a Task
+```bash
+# Execute specific issue
+/run task-executor execute --issue "US-001" --project "my-feature"
+```
+
+### Individual Workers
+```bash
+# Design system
+/run architect system-design --spec "User authentication system"
+
+# Create API endpoint
+/run backend-dev implement-endpoint --name "login" --repo ~/repos/my-app
+
+# Review PR
+/run code-reviewer review-pr --pr 123 --repo ~/repos/my-app
+```
+
+## Task Format
+
+**PRD** (project level):
+```json
+{
+  "project": "feature-x",
+  "epics": [{
+    "id": "E1",
+    "title": "User Authentication",
+    "stories": [{
+      "id": "US-001",
+      "title": "Login flow",
+      "acceptance_criteria": [...],
+      "priority": 1,
+      "passes": false,
+      "worker_hints": ["architect", "backend-dev", "frontend-dev", "qa-tester"]
+    }]
+  }]
+}
+```
+
+**Beads**: Stories → beads epics, acceptance criteria → child beads (via `bd` CLI)
+
+## Human-in-the-Loop
+
+Every phase surfaces decisions:
+- Approve worker sequence before execution
+- Inject context at any phase
+- Approve changes before commit
+- Confirm production deployments
+- On ambiguity: escalate, never auto-decide
+
+## Learning Loop
+
+```
+Task Executor completes issue
+        ↓
+Extract learnings (what worked, what failed, patterns)
+        ↓
+knowledge-curator routes to:
+  - projects/{name}/learnings/
+  - knowledge/public/dev-team/patterns/
+  - workers/{worker}/knowledge/
+```
+
+## Directory Structure
+
+```
+workers/public/dev-team/
+├── README.md
+├── project-manager/
+├── task-executor/
+├── architect/
+├── backend-dev/
+├── database-dev/
+├── qa-tester/
+├── frontend-dev/
+├── motion-designer/
+├── infra-dev/
+├── code-reviewer/
+└── knowledge-curator/
+
+knowledge/public/dev-team/
+├── patterns/
+├── workflows/
+└── troubleshooting/
+```
+
+## Building Workers
+
+```bash
+cd workers/public/dev-team/<worker>
+npm install
+npm run build
+npm run typecheck
+```
+
+## Integrated Tools
+
+- **beads** (`bd` CLI) - Task tracking
+- **gnb** (gemini-nano-banana) - Image generation
+- **Playwright** - Browser automation for QA
+- **GitHub CLI** (`gh`) - PR/issue management
+- **skills.sh** - Reusable development skills

package/template/workers/dev-team/_template.yaml

@@ -0,0 +1,70 @@
+# Dev Team Worker Template
+# Copy and customize for each new worker
+
+worker:
+  id: worker-id
+  name: "Worker Name"
+  type: CodeWorker  # CodeWorker for dev, OpsWorker for orchestration
+  version: "1.0"
+
+execution:
+  mode: on_demand
+  max_runtime: 15m
+  retry_attempts: 2
+
+context:
+  base:
+    - workers/public/dev-team/{worker-id}/
+    - workers/public/dev-team/{worker-id}/skills/
+    - knowledge/public/dev-team/patterns/{category}/
+  dynamic:
+    - pattern: "{target_repo}/"
+      when: "task.type == 'implementation'"
+  exclude:
+    - node_modules/
+    - dist/
+    - "*.log"
+    - ".git/"
+
+verification:
+  post_execute:
+    - check: typescript
+      command: npm run typecheck
+    - check: lint
+      command: npm run lint
+  approval_required: true  # Human-in-the-loop
+
+output:
+  destination: workspace/reports/dev-team/
+  format: both
+  naming: "{date}-{worker-id}-{task}.{ext}"
+
+mcp:
+  server:
+    command: node
+    args:
+      - dist/mcp-server.js
+    cwd: workers/public/dev-team/{worker-id}
+  tools: []  # Add worker-specific tools
+
+instructions: |
+  # {Worker Name}
+
+  ## Purpose
+  {Description of what this worker does}
+
+  ## Skills
+  | Skill | Description |
+  |-------|-------------|
+
+  ## CLI Usage
+  ```bash
+  cd workers/public/dev-team/{worker-id}
+  node dist/index.js <skill> [options]
+  ```
+
+  ## Human-in-the-loop
+  This worker surfaces decisions to human before proceeding.
+  - Before: Show planned actions
+  - After: Show changes made, request approval
+  - On ambiguity: Escalate, never auto-decide

package/template/workers/dev-team/architect/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@hq/architect",
+  "version": "1.0.0",
+  "description": "System design, planning, and technical decision-making",
+  "main": "dist/index.js",
+  "bin": {
+    "architect": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "dev": "ts-node src/index.ts",
+    "mcp": "node dist/mcp-server.js"
+  },
+  "keywords": ["hq", "worker", "architect", "design", "planning"],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.2",
+    "ts-node": "^10.9.2"
+  }
+}

package/template/workers/dev-team/architect/skills/api-design.md

@@ -0,0 +1,89 @@
+# api-design
+
+Design API contracts and interfaces.
+
+## Arguments
+
+`$ARGUMENTS` = `--endpoint <path>` or `--feature <name>` (required)
+
+Optional:
+- `--repo <path>` - Target repository
+- `--format <openapi|typescript>` - Output format
+
+## Process
+
+1. **Analyze Existing APIs**
+   - Read current route structure
+   - Identify naming conventions
+   - Check authentication patterns
+
+2. **Define Contract**
+   - Request/response schemas
+   - Error handling patterns
+   - Authentication requirements
+
+3. **Generate Interfaces**
+   - TypeScript types
+   - OpenAPI spec (if requested)
+   - Validation schemas
+
+4. **Present for Review**
+   - Show proposed contract
+   - Highlight breaking changes
+   - Get approval
+
+## Output
+
+TypeScript interface:
+```typescript
+// API Contract: POST /api/auth/login
+export interface LoginRequest {
+  email: string;
+  password: string;
+  rememberMe?: boolean;
+}
+
+export interface LoginResponse {
+  user: {
+    id: string;
+    email: string;
+    name: string;
+  };
+  token: string;
+  expiresAt: string;
+}
+
+export interface LoginError {
+  code: 'INVALID_CREDENTIALS' | 'ACCOUNT_LOCKED' | 'RATE_LIMITED';
+  message: string;
+}
+```
+
+## Example
+
+```bash
+node dist/index.js api-design --feature "user authentication" --repo repos/my-app
+
+# Output:
+# === API Design: User Authentication ===
+#
+# Proposed endpoints:
+#
+# POST /api/auth/login
+#   Request: { email, password, rememberMe? }
+#   Response: { user, token, expiresAt }
+#   Errors: INVALID_CREDENTIALS, ACCOUNT_LOCKED, RATE_LIMITED
+#
+# POST /api/auth/logout
+#   Request: {} (auth header required)
+#   Response: { success: true }
+#
+# GET /api/auth/me
+#   Request: {} (auth header required)
+#   Response: { user }
+#
+# Generated types:
+#   src/types/auth.ts
+#
+# [Approve contract? y/n/modify]
+```

package/template/workers/dev-team/architect/skills/refactor-plan.md

@@ -0,0 +1,96 @@
+# refactor-plan
+
+Plan a refactoring approach for existing code.
+
+## Arguments
+
+`$ARGUMENTS` = `--target <file|directory|pattern>` (required)
+
+Optional:
+- `--repo <path>` - Target repository
+- `--goal <description>` - Refactoring goal
+
+## Process
+
+1. **Analyze Current State**
+   - Read target code
+   - Identify code smells
+   - Map dependencies
+
+2. **Define Goal State**
+   - Desired patterns
+   - Performance targets
+   - Maintainability improvements
+
+3. **Plan Incremental Steps**
+   - Break into safe, atomic changes
+   - Order by dependency
+   - Identify test points
+
+4. **Risk Assessment**
+   - Breaking changes
+   - Rollback strategy
+   - Test coverage gaps
+
+5. **Present Plan**
+   - Show step-by-step approach
+   - Estimate effort
+   - Get approval
+
+## Output
+
+Refactoring plan:
+```markdown
+# Refactoring Plan: {Target}
+
+## Current State
+{Description of current code}
+
+## Goal
+{What we want to achieve}
+
+## Steps
+1. [ ] Step 1: {Description}
+   Files: {files}
+   Risk: Low/Medium/High
+
+2. [ ] Step 2: {Description}
+   ...
+
+## Test Strategy
+- Run existing tests after each step
+- Add tests for: {gaps}
+
+## Rollback
+If issues arise at step N:
+1. Revert commits N through current
+2. {Additional steps}
+
+## Estimated Effort
+{N} phases, {complexity}
+```
+
+## Example
+
+```bash
+node dist/index.js refactor-plan --target "src/api" --goal "convert to TypeScript strict mode"
+
+# Output:
+# === Refactor Plan: src/api → TypeScript Strict ===
+#
+# Current state:
+#   - 12 files with 'any' types
+#   - 3 files with @ts-ignore
+#   - 0 strict mode enabled
+#
+# Steps:
+# 1. Add proper types to utility functions (Low risk)
+# 2. Type API request/response objects (Medium risk)
+# 3. Fix nullable checks (Medium risk)
+# 4. Remove @ts-ignore comments (Low risk)
+# 5. Enable strict mode (Low risk, after above)
+#
+# Estimated: 5 phases, medium complexity
+#
+# [Approve plan? y/n/modify]
+```

package/template/workers/dev-team/architect/skills/system-design.md

@@ -0,0 +1,100 @@
+# system-design
+
+Design system architecture for a feature or component.
+
+## Arguments
+
+`$ARGUMENTS` = `--feature <description>` (required)
+
+Optional:
+- `--repo <path>` - Target repository
+- `--scope <small|medium|large>` - Scope of design
+
+## Process
+
+1. **Analyze Existing Architecture**
+   - Read project structure
+   - Identify patterns in use
+   - Map dependencies
+
+2. **Understand Requirements**
+   - Parse feature description
+   - Identify components affected
+   - List integration points
+
+3. **Design Options**
+   - Generate 2-3 approaches
+   - Evaluate trade-offs
+   - Consider future extensibility
+
+4. **Present for Approval**
+   - Show options with pros/cons
+   - Recommend preferred approach
+   - Wait for human decision
+
+5. **Document Decision**
+   - Create ADR (Architecture Decision Record)
+   - Define interfaces
+   - Outline implementation steps
+
+## Output
+
+Architecture decision record:
+```markdown
+# ADR: {Feature Name}
+
+## Status
+Proposed
+
+## Context
+{Why this decision is needed}
+
+## Options Considered
+1. Option A: {Description}
+   - Pro: ...
+   - Con: ...
+
+2. Option B: {Description}
+   - Pro: ...
+   - Con: ...
+
+## Decision
+{Chosen approach and why}
+
+## Consequences
+- {Impact 1}
+- {Impact 2}
+
+## Implementation Guide
+{Steps for other workers}
+```
+
+## Example
+
+```bash
+node dist/index.js system-design --feature "user authentication with OAuth" --repo repos/my-app
+
+# Output:
+# === System Design: User Authentication with OAuth ===
+#
+# Existing patterns:
+#   - Next.js App Router
+#   - Prisma ORM
+#   - No current auth system
+#
+# Options:
+#
+# 1. NextAuth.js (Recommended)
+#    Pro: Battle-tested, supports many providers
+#    Con: Opinionated, some flexibility limits
+#
+# 2. Custom OAuth implementation
+#    Pro: Full control
+#    Con: More work, security risks
+#
+# 3. Clerk/Auth0 (managed service)
+#    Pro: Zero maintenance
+#    Con: Vendor lock-in, cost
+#
+# [Select approach: 1/2/3]
+```