create-hq 5.0.0

package/template/workers/dev-team/database-dev/src/mcp-server.ts

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+
+const server = new Server(
+  { name: 'database-dev', version: '1.0.0' },
+  { capabilities: { tools: {} } }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: 'create_schema',
+      description: 'Design database schema for feature',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          entity: { type: 'string', description: 'Entity name' },
+          feature: { type: 'string', description: 'Feature description' },
+          repo: { type: 'string', description: 'Target repository' },
+          orm: { type: 'string', enum: ['prisma', 'drizzle'], description: 'ORM type' },
+        },
+      },
+    },
+    {
+      name: 'create_migration',
+      description: 'Create database migration',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          name: { type: 'string', description: 'Migration name' },
+          repo: { type: 'string', description: 'Target repository' },
+        },
+        required: ['name'],
+      },
+    },
+    {
+      name: 'optimize_query',
+      description: 'Optimize slow query',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          query: { type: 'string', description: 'Query to optimize' },
+          repo: { type: 'string', description: 'Target repository' },
+        },
+        required: ['query'],
+      },
+    },
+    {
+      name: 'add_indexes',
+      description: 'Add database indexes',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          table: { type: 'string', description: 'Table name' },
+          columns: { type: 'string', description: 'Comma-separated columns' },
+          repo: { type: 'string', description: 'Target repository' },
+        },
+        required: ['table'],
+      },
+    },
+  ],
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  return { content: [{ type: 'text', text: `Tool ${name} called with: ${JSON.stringify(args)}` }] };
+});
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch(console.error);

package/template/workers/dev-team/database-dev/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "commonjs",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/template/workers/dev-team/database-dev/worker.yaml

@@ -0,0 +1,90 @@
+worker:
+  id: database-dev
+  name: "Database Developer"
+  type: CodeWorker
+  version: "1.0"
+
+execution:
+  mode: on_demand
+  max_runtime: 15m
+  retry_attempts: 1
+
+context:
+  base:
+    - workers/public/dev-team/database-dev/
+    - workers/public/dev-team/database-dev/skills/
+    - knowledge/public/dev-team/patterns/database/
+  dynamic:
+    - pattern: "{target_repo}/prisma/"
+      when: "db.type == 'prisma'"
+    - pattern: "{target_repo}/drizzle/"
+      when: "db.type == 'drizzle'"
+    - pattern: "{target_repo}/migrations/"
+      when: always
+  exclude:
+    - node_modules/
+    - dist/
+    - "*.log"
+
+verification:
+  post_execute:
+    - check: typescript
+      command: npm run typecheck
+    - check: migration
+      command: npm run db:generate
+  approval_required: true
+
+output:
+  destination: workspace/reports/dev-team/
+  format: both
+  naming: "{date}-database-dev-{task}.{ext}"
+
+mcp:
+  server:
+    command: node
+    args:
+      - dist/mcp-server.js
+    cwd: workers/public/dev-team/database-dev
+  tools:
+    - create_schema
+    - create_migration
+    - optimize_query
+    - add_indexes
+
+# State Machine (Loom pattern)
+state_machine:
+  enabled: true
+  max_retries: 1
+  hooks:
+    post_execute:
+      - auto_checkpoint
+      - log_metrics
+    on_error:
+      - log_error
+      - checkpoint_error_state
+
+instructions: |
+  # Database Developer
+
+  Schema design, migrations, and query optimization.
+
+  ## Skills
+
+  | Skill | Description |
+  |-------|-------------|
+  | create-schema | Design database schema for feature |
+  | create-migration | Create database migration |
+  | optimize-query | Optimize slow query |
+  | add-indexes | Add database indexes |
+
+  ## Supported ORMs
+
+  - Prisma
+  - Drizzle
+  - Raw SQL
+
+  ## Human-in-the-loop
+
+  - Approve schema changes
+  - Review migration before running
+  - Confirm destructive operations

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

@@ -0,0 +1,22 @@
+{
+  "name": "@hq/frontend-dev",
+  "version": "1.0.0",
+  "description": "React/Next.js components and pages",
+  "main": "dist/index.js",
+  "bin": { "frontend-dev": "dist/index.js" },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "dev": "ts-node src/index.ts",
+    "mcp": "node dist/mcp-server.js"
+  },
+  "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/frontend-dev/skills/create-component.md

@@ -0,0 +1,26 @@
+# create-component
+
+Create a new React component.
+
+## Arguments
+
+`$ARGUMENTS` = `--name <ComponentName>` (required)
+
+Optional:
+- `--repo <path>` - Target repository
+- `--type <functional|class>` - Component type
+- `--with-test` - Include test file
+
+## Process
+
+1. Analyze existing component patterns
+2. Generate component file
+3. Add TypeScript types
+4. Include accessibility attributes
+5. Add tests if requested
+
+## Output
+
+- `src/components/{Name}/{Name}.tsx`
+- `src/components/{Name}/{Name}.test.tsx` (if --with-test)
+- `src/components/{Name}/index.ts` (barrel export)

package/template/workers/dev-team/frontend-dev/src/index.ts

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+
+const program = new Command();
+
+program
+  .name('frontend-dev')
+  .description('React/Next.js components and pages')
+  .version('1.0.0');
+
+program
+  .command('create-component')
+  .description('Create new React component')
+  .requiredOption('--name <name>', 'Component name')
+  .option('--repo <path>', 'Target repository')
+  .option('--type <type>', 'Component type: functional|class')
+  .option('--with-test', 'Include test file')
+  .action(async (options) => {
+    console.log('create-component:', options);
+  });
+
+program
+  .command('create-page')
+  .description('Create new page/route')
+  .requiredOption('--path <path>', 'Page path (e.g., /dashboard)')
+  .option('--repo <path>', 'Target repository')
+  .action(async (options) => {
+    console.log('create-page:', options);
+  });
+
+program
+  .command('fix-ui-bug')
+  .description('Fix frontend bug')
+  .requiredOption('--issue <description>', 'Bug description')
+  .option('--repo <path>', 'Target repository')
+  .action(async (options) => {
+    console.log('fix-ui-bug:', options);
+  });
+
+program
+  .command('add-form')
+  .description('Add form with validation')
+  .requiredOption('--name <name>', 'Form name')
+  .option('--fields <list>', 'Comma-separated field names')
+  .option('--repo <path>', 'Target repository')
+  .action(async (options) => {
+    console.log('add-form:', options);
+  });
+
+program.parse();

package/template/workers/dev-team/frontend-dev/src/mcp-server.ts

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+
+const server = new Server(
+  { name: 'frontend-dev', version: '1.0.0' },
+  { capabilities: { tools: {} } }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: 'create_component',
+      description: 'Create new React component',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          name: { type: 'string', description: 'Component name' },
+          repo: { type: 'string', description: 'Target repository' },
+          type: { type: 'string', enum: ['functional', 'class'], description: 'Component type' },
+          withTest: { type: 'boolean', description: 'Include test file' },
+        },
+        required: ['name'],
+      },
+    },
+    {
+      name: 'create_page',
+      description: 'Create new page/route',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          path: { type: 'string', description: 'Page path' },
+          repo: { type: 'string', description: 'Target repository' },
+        },
+        required: ['path'],
+      },
+    },
+    {
+      name: 'fix_ui_bug',
+      description: 'Fix frontend bug',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          issue: { type: 'string', description: 'Bug description' },
+          repo: { type: 'string', description: 'Target repository' },
+        },
+        required: ['issue'],
+      },
+    },
+    {
+      name: 'add_form',
+      description: 'Add form with validation',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          name: { type: 'string', description: 'Form name' },
+          fields: { type: 'string', description: 'Comma-separated field names' },
+          repo: { type: 'string', description: 'Target repository' },
+        },
+        required: ['name'],
+      },
+    },
+  ],
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  return { content: [{ type: 'text', text: `Tool ${name} called with: ${JSON.stringify(args)}` }] };
+});
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch(console.error);

package/template/workers/dev-team/frontend-dev/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "commonjs",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/template/workers/dev-team/frontend-dev/worker.yaml

@@ -0,0 +1,132 @@
+worker:
+  id: frontend-dev
+  name: "Frontend Developer"
+  type: CodeWorker
+  version: "1.0"
+
+execution:
+  mode: on_demand
+  max_runtime: 20m
+  retry_attempts: 2
+
+context:
+  base:
+    - workers/dev-team/frontend-dev/
+    - workers/dev-team/frontend-dev/skills/
+    - knowledge/dev-team/patterns/frontend/
+  dynamic:
+    - pattern: "{target_repo}/src/components/"
+      when: always
+    - pattern: "{target_repo}/src/app/"
+      when: always
+  exclude:
+    - node_modules/
+    - dist/
+    - api/
+    - server/
+
+verification:
+  post_execute:
+    - check: typescript
+      command: npm run typecheck
+    - check: lint
+      command: npm run lint
+  approval_required: true
+
+external_skills:
+  # Vercel React Best Practices (https://github.com/vercel-labs/agent-skills)
+  - vercel/react-best-practices  # Full skill set
+  # Key areas:
+  # - Eliminating waterfalls (defer await, parallel fetching, Suspense)
+  # - Bundle optimization (dynamic imports, avoid barrel files)
+  # - Server-side performance (RSC serialization, React.cache)
+  # - Re-render optimization (useMemo patterns, state management)
+  # - Rendering performance (hydration, CSS content-visibility)
+
+output:
+  destination: workspace/reports/dev-team/
+  format: both
+  naming: "{date}-frontend-dev-{task}.{ext}"
+
+mcp:
+  server:
+    command: node
+    args:
+      - dist/mcp-server.js
+    cwd: workers/dev-team/frontend-dev
+  tools:
+    - create_component
+    - create_page
+    - fix_ui_bug
+    - add_form
+
+# State Machine (Loom pattern)
+state_machine:
+  enabled: true
+  max_retries: 1
+  hooks:
+    post_execute:
+      - auto_checkpoint
+      - log_metrics
+    on_error:
+      - log_error
+      - checkpoint_error_state
+
+instructions: |
+  # Frontend Developer
+
+  React/Next.js components and pages.
+
+  ## Skills
+
+  | Skill | Description |
+  |-------|-------------|
+  | create-component | Create new React component |
+  | create-page | Create new page/route |
+  | fix-ui-bug | Fix frontend bug |
+  | add-form | Add form with validation |
+
+  ## Patterns
+
+  - Follow existing component structure
+  - Use TypeScript strict mode
+  - Include accessibility attributes
+  - Add responsive styles
+
+  ## React Best Practices (Vercel)
+
+  CRITICAL - Eliminating Waterfalls:
+  - Defer await until needed (don't await at top of function)
+  - Use Promise.all() for independent operations
+  - Strategic Suspense boundaries
+
+  CRITICAL - Bundle Optimization:
+  - Avoid barrel file imports (import from specific files)
+  - Dynamic imports for heavy components
+  - Preload based on user intent
+
+  HIGH - Server Components:
+  - Minimize serialization at RSC boundaries
+  - Use React.cache() for per-request deduplication
+  - Parallel data fetching with component composition
+
+  MEDIUM - Re-render Optimization:
+  - Don't wrap simple expressions in useMemo
+  - Extract to memoized components for isolation
+  - Use functional setState updates
+  - Use Transitions for non-urgent updates
+
+  ## E2E Requirements
+
+  When working in a project with E2E tests:
+  - Every new or modified page MUST have a corresponding E2E spec in `tests/e2e/pages/`
+  - After adding or modifying specs, run: `npm run generate-manifest`
+  - Commit the updated `tests/e2e/manifest.json` alongside your changes
+  - Run `npm run check-coverage` to verify no routes are uncovered
+  - Test categories: page-load, navigation, forms, components, accessibility, responsive, performance, visual
+
+  ## Human-in-the-loop
+
+  - Approve component design
+  - Review styling approach
+  - Confirm accessibility compliance

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

@@ -0,0 +1,24 @@
+{
+  "name": "@hq/infra-dev",
+  "version": "1.0.0",
+  "description": "Infrastructure developer worker - CI/CD, deployment, monitoring",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "infra-dev": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/index.js",
+    "mcp": "node dist/mcp-server.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "commander": "^12.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/template/workers/dev-team/infra-dev/skills/add-monitoring.md

@@ -0,0 +1,73 @@
+# add-monitoring
+
+Add monitoring and observability to application.
+
+## Arguments
+
+`$ARGUMENTS` = `--repo <path>` (required)
+
+Optional:
+- `--type <metrics|logs|traces|all>` - Monitoring type
+- `--provider <datadog|newrelic|prometheus|otel>` - Monitoring provider
+- `--alerts` - Include alerting rules
+
+## Process
+
+1. Analyze application architecture
+2. Identify key metrics:
+   - Request latency
+   - Error rates
+   - Resource usage
+   - Business metrics
+3. Design instrumentation:
+   - HTTP middleware
+   - Database queries
+   - External API calls
+4. Configure logging:
+   - Structured JSON logs
+   - Log levels
+   - Correlation IDs
+5. Add health checks:
+   - Liveness probe
+   - Readiness probe
+6. Create alerting rules (if --alerts)
+7. Present for human approval
+
+## Output
+
+- Instrumentation code
+- Health check endpoints
+- Alert configuration
+- Dashboard templates (if available)
+
+## OpenTelemetry Setup
+
+```typescript
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
+
+const sdk = new NodeSDK({
+  serviceName: 'my-service',
+  instrumentations: [getNodeAutoInstrumentations()],
+});
+
+sdk.start();
+```
+
+## Health Check Pattern
+
+```typescript
+app.get('/health/live', (req, res) => {
+  res.json({ status: 'ok' });
+});
+
+app.get('/health/ready', async (req, res) => {
+  const dbOk = await checkDatabase();
+  const cacheOk = await checkCache();
+  if (dbOk && cacheOk) {
+    res.json({ status: 'ready' });
+  } else {
+    res.status(503).json({ status: 'not ready' });
+  }
+});
+```

package/template/workers/dev-team/infra-dev/skills/configure-deployment.md

@@ -0,0 +1,80 @@
+# configure-deployment
+
+Configure deployment for application.
+
+## Arguments
+
+`$ARGUMENTS` = `--repo <path>` (required)
+
+Optional:
+- `--platform <vercel|railway|fly|aws|gcp>` - Deployment platform
+- `--env <staging|production>` - Target environment
+- `--preview` - Enable preview deployments
+
+## Process
+
+1. Analyze project requirements:
+   - Runtime (Node, Python, Go, etc.)
+   - Environment variables needed
+   - External services (DB, cache, etc.)
+2. Choose deployment strategy:
+   - Blue-green
+   - Rolling
+   - Canary
+3. Configure platform:
+   - vercel.json / fly.toml / railway.json
+   - Environment variable templates
+   - Domain configuration
+4. Set up preview deployments (if --preview)
+5. Configure rollback strategy
+6. Present for human approval
+
+## Output
+
+- Platform configuration file
+- Environment variable template
+- Deployment documentation
+
+## Vercel Config
+
+```json
+{
+  "buildCommand": "npm run build",
+  "outputDirectory": "dist",
+  "framework": null,
+  "regions": ["iad1"],
+  "env": {
+    "DATABASE_URL": "@database-url"
+  }
+}
+```
+
+## Fly.io Config
+
+```toml
+app = "my-app"
+primary_region = "iad"
+
+[build]
+  dockerfile = "Dockerfile"
+
+[http_service]
+  internal_port = 3000
+  force_https = true
+  auto_stop_machines = true
+  auto_start_machines = true
+
+[[services.ports]]
+  handlers = ["http"]
+  port = 80
+
+[[services.ports]]
+  handlers = ["tls", "http"]
+  port = 443
+```
+
+## Human Checkpoints
+
+- Approve deployment configuration
+- Approve environment variables
+- Approve production deployments (always)