create-hq 5.0.0

package/template/workers/dev-team/knowledge-curator/src/index.ts

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+
+const program = new Command();
+
+program
+  .name('knowledge-curator')
+  .description('Process learnings, update knowledge bases, maintain documentation')
+  .version('1.0.0');
+
+program
+  .command('process-learnings')
+  .description('Process learnings from completed tasks')
+  .requiredOption('--learnings <json>', 'Learnings JSON')
+  .option('--project <name>', 'Source project')
+  .option('--worker <id>', 'Source worker')
+  .option('--task <id>', 'Source task ID')
+  .action(async (options) => {
+    console.log('process-learnings:', options);
+  });
+
+program
+  .command('update-patterns')
+  .description('Update or create reusable patterns')
+  .requiredOption('--category <category>', 'Category: backend|frontend|database|infra|testing|security')
+  .option('--pattern <name>', 'Specific pattern to update')
+  .option('--content <markdown>', 'Pattern content')
+  .action(async (options) => {
+    console.log('update-patterns:', options);
+  });
+
+program
+  .command('curate-troubleshooting')
+  .description('Add or update troubleshooting entries')
+  .requiredOption('--issue <description>', 'Issue description')
+  .option('--solution <description>', 'Solution that worked')
+  .option('--category <category>', 'Issue category')
+  .option('--tags <tags>', 'Comma-separated tags')
+  .action(async (options) => {
+    console.log('curate-troubleshooting:', options);
+  });
+
+program
+  .command('sync-documentation')
+  .description('Sync and update documentation')
+  .requiredOption('--scope <scope>', 'Scope: worker|project|knowledge|all')
+  .option('--target <path>', 'Specific file to update')
+  .option('--dry-run', 'Preview changes without writing')
+  .action(async (options) => {
+    console.log('sync-documentation:', options);
+  });
+
+program.parse();

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

@@ -0,0 +1,92 @@
+#!/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: 'knowledge-curator', version: '1.0.0' },
+  { capabilities: { tools: {} } }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: 'process_learnings',
+      description: 'Process learnings from completed tasks and route to appropriate locations',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          learnings: { type: 'object', description: 'Learnings JSON object' },
+          project: { type: 'string', description: 'Source project name' },
+          worker: { type: 'string', description: 'Source worker ID' },
+          task: { type: 'string', description: 'Source task ID' },
+        },
+        required: ['learnings'],
+      },
+    },
+    {
+      name: 'update_patterns',
+      description: 'Update or create reusable patterns in the knowledge base',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          category: { type: 'string', enum: ['backend', 'frontend', 'database', 'infra', 'testing', 'security'], description: 'Pattern category' },
+          pattern: { type: 'string', description: 'Specific pattern name' },
+          content: { type: 'string', description: 'Pattern content in markdown' },
+        },
+        required: ['category'],
+      },
+    },
+    {
+      name: 'curate_troubleshooting',
+      description: 'Add or update troubleshooting entries for common issues',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          issue: { type: 'string', description: 'Issue description' },
+          solution: { type: 'string', description: 'Solution that worked' },
+          category: { type: 'string', enum: ['build', 'runtime', 'database', 'network', 'auth', 'deploy', 'performance'], description: 'Issue category' },
+          tags: { type: 'array', items: { type: 'string' }, description: 'Tags for searchability' },
+        },
+        required: ['issue'],
+      },
+    },
+    {
+      name: 'sync_documentation',
+      description: 'Sync and update documentation across the HQ system',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          scope: { type: 'string', enum: ['worker', 'project', 'knowledge', 'all'], description: 'Documentation scope' },
+          target: { type: 'string', description: 'Specific file to update' },
+          dry_run: { type: 'boolean', description: 'Preview changes without writing' },
+        },
+        required: ['scope'],
+      },
+    },
+    {
+      name: 'search_knowledge',
+      description: 'Search the knowledge base for relevant information',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          query: { type: 'string', description: 'Search query' },
+          scope: { type: 'string', enum: ['patterns', 'troubleshooting', 'workflows', 'all'], description: 'Search scope' },
+        },
+        required: ['query'],
+      },
+    },
+  ],
+}));
+
+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/knowledge-curator/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "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/knowledge-curator/worker.yaml

@@ -0,0 +1,80 @@
+worker:
+  id: knowledge-curator
+  name: "Knowledge Curator"
+  description: "Process learnings, update knowledge bases, maintain documentation"
+  type: CodeWorker
+  version: "1.0"
+  team: dev-team
+
+execution:
+  mode: on_demand
+  max_runtime: 10m
+  retry_attempts: 1
+  spawn_method: task_tool
+
+context:
+  base:
+    - workers/public/dev-team/knowledge-curator/skills/
+    - knowledge/public/dev-team/
+    - knowledge/public/workers/
+  dynamic:
+    - pattern: "projects/{project}/learnings/"
+      when: "task.has_project"
+    - pattern: "workers/{worker}/knowledge/"
+      when: "task.has_worker"
+    - pattern: "companies/{company}/knowledge/"
+      when: "task.has_company"
+  exclude:
+    - node_modules/
+    - dist/
+    - "*.log"
+    - repos/
+
+skills:
+  - id: process-learnings
+    file: skills/process-learnings.md
+  - id: update-patterns
+    file: skills/update-patterns.md
+  - id: curate-troubleshooting
+    file: skills/curate-troubleshooting.md
+  - id: sync-documentation
+    file: skills/sync-documentation.md
+
+verification:
+  post_execute:
+    - check: markdown_lint
+      command: npx markdownlint-cli2 "**/*.md"
+  approval_required: true
+
+external_skills:
+  - vercel/writing-clearly-and-concisely
+
+mcp:
+  server:
+    command: node
+    args: [dist/mcp-server.js]
+  tools:
+    - process_learnings
+    - update_patterns
+    - curate_troubleshooting
+    - sync_documentation
+    - search_knowledge
+
+# 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
+
+reporting:
+  on_complete:
+    - log_updates
+  metrics:
+    - patterns_added
+    - docs_updated

package/template/workers/dev-team/motion-designer/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@hq/motion-designer",
+  "version": "1.0.0",
+  "description": "Animations, transitions, and visual polish",
+  "main": "dist/index.js",
+  "bin": { "motion-designer": "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/motion-designer/skills/add-animation.md

@@ -0,0 +1,25 @@
+# add-animation
+
+Add animation to a component.
+
+## Arguments
+
+`$ARGUMENTS` = `--component <name>` (required)
+
+Optional:
+- `--repo <path>` - Target repository
+- `--type <entrance|exit|hover|loop>` - Animation type
+- `--library <framer|gsap|css>` - Animation library
+
+## Process
+
+1. Analyze component structure
+2. Design animation approach
+3. Implement animation
+4. Test performance
+5. Present for approval
+
+## Output
+
+- Updated component with animation
+- Animation configuration file (if needed)

package/template/workers/dev-team/motion-designer/skills/generate-image.md

@@ -0,0 +1,36 @@
+# generate-image
+
+Generate image using gnb (gemini-nano-banana).
+
+## Arguments
+
+`$ARGUMENTS` = `--prompt <description>` (required)
+
+Optional:
+- `--aspect <ratio>` - Aspect ratio: 1:1, 16:9, 9:16, 4:3
+- `--variants <n>` - Number of variants (max 10)
+- `--output <dir>` - Output directory
+- `--type <logo|social|thumbnail>` - Preset type
+
+## Process
+
+1. Prepare prompt
+2. Get human approval for prompt
+3. Run gnb generate
+4. Review generated images
+5. Select best variant
+
+## gnb Commands
+
+```bash
+gnb generate "prompt" --aspect 16:9 --variants 3
+gnb logo "Brand Name" --style modern
+gnb social "Post text" --platform instagram
+gnb thumbnail "Video title"
+```
+
+## Human-in-the-loop
+
+- Approve prompt before generation
+- Select from generated variants
+- Confirm final image

package/template/workers/dev-team/motion-designer/src/index.ts

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { execSync } from 'child_process';
+
+const program = new Command();
+
+program
+  .name('motion-designer')
+  .description('Animations, transitions, and visual polish')
+  .version('1.0.0');
+
+program
+  .command('add-animation')
+  .description('Add animation to component')
+  .requiredOption('--component <name>', 'Component name')
+  .option('--repo <path>', 'Target repository')
+  .option('--type <type>', 'Animation type: entrance|exit|hover|loop')
+  .option('--library <lib>', 'Animation library: framer|gsap|css')
+  .action(async (options) => {
+    console.log('add-animation:', options);
+  });
+
+program
+  .command('add-transition')
+  .description('Add page/element transition')
+  .requiredOption('--target <element>', 'Target element or page')
+  .option('--repo <path>', 'Target repository')
+  .action(async (options) => {
+    console.log('add-transition:', options);
+  });
+
+program
+  .command('polish-component')
+  .description('Polish visual design of component')
+  .requiredOption('--component <name>', 'Component name')
+  .option('--repo <path>', 'Target repository')
+  .action(async (options) => {
+    console.log('polish-component:', options);
+  });
+
+program
+  .command('generate-image')
+  .description('Generate image via gnb')
+  .requiredOption('--prompt <text>', 'Image prompt')
+  .option('--aspect <ratio>', 'Aspect ratio: 1:1, 16:9, 9:16, 4:3')
+  .option('--variants <n>', 'Number of variants (max 10)')
+  .option('--output <dir>', 'Output directory')
+  .option('--type <preset>', 'Preset type: logo|social|thumbnail')
+  .action(async (options) => {
+    console.log('generate-image via gnb:');
+    console.log(`Prompt: "${options.prompt}"`);
+    console.log(`Aspect: ${options.aspect || '1:1'}`);
+    console.log(`Variants: ${options.variants || 1}`);
+
+    // Build gnb command
+    const cmd = `gnb generate "${options.prompt}"${options.aspect ? ` --aspect ${options.aspect}` : ''}${options.variants ? ` --variants ${options.variants}` : ''}${options.output ? ` --output ${options.output}` : ''}`;
+
+    console.log(`\nCommand: ${cmd}`);
+    console.log('\n[Human approval required]');
+    console.log('Approve image generation? [y/n/modify]');
+  });
+
+program.parse();

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

@@ -0,0 +1,79 @@
+#!/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: 'motion-designer', version: '1.0.0' },
+  { capabilities: { tools: {} } }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: 'add_animation',
+      description: 'Add animation to component',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          component: { type: 'string', description: 'Component name' },
+          repo: { type: 'string', description: 'Target repository' },
+          type: { type: 'string', enum: ['entrance', 'exit', 'hover', 'loop'], description: 'Animation type' },
+          library: { type: 'string', enum: ['framer', 'gsap', 'css'], description: 'Animation library' },
+        },
+        required: ['component'],
+      },
+    },
+    {
+      name: 'add_transition',
+      description: 'Add page/element transition',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          target: { type: 'string', description: 'Target element or page' },
+          repo: { type: 'string', description: 'Target repository' },
+        },
+        required: ['target'],
+      },
+    },
+    {
+      name: 'polish_component',
+      description: 'Polish visual design of component',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          component: { type: 'string', description: 'Component name' },
+          repo: { type: 'string', description: 'Target repository' },
+        },
+        required: ['component'],
+      },
+    },
+    {
+      name: 'generate_image',
+      description: 'Generate image via gnb (gemini-nano-banana)',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          prompt: { type: 'string', description: 'Image prompt' },
+          aspect: { type: 'string', enum: ['1:1', '16:9', '9:16', '4:3'], description: 'Aspect ratio' },
+          variants: { type: 'number', description: 'Number of variants (max 10)' },
+          output: { type: 'string', description: 'Output directory' },
+          type: { type: 'string', enum: ['logo', 'social', 'thumbnail'], description: 'Preset type' },
+        },
+        required: ['prompt'],
+      },
+    },
+  ],
+}));
+
+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/motion-designer/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/motion-designer/worker.yaml

@@ -0,0 +1,84 @@
+worker:
+  id: motion-designer
+  name: "Motion Designer"
+  type: CodeWorker
+  version: "1.0"
+
+execution:
+  mode: on_demand
+  max_runtime: 20m
+  retry_attempts: 1
+
+context:
+  base:
+    - workers/public/dev-team/motion-designer/
+    - workers/public/dev-team/motion-designer/skills/
+    - knowledge/public/dev-team/patterns/motion/
+  dynamic:
+    - pattern: "{target_repo}/src/components/"
+      when: always
+  exclude:
+    - node_modules/
+    - dist/
+
+verification:
+  post_execute:
+    - check: typescript
+      command: npm run typecheck
+  approval_required: true
+
+output:
+  destination: workspace/reports/dev-team/
+  format: both
+  naming: "{date}-motion-designer-{task}.{ext}"
+
+mcp:
+  server:
+    command: node
+    args:
+      - dist/mcp-server.js
+    cwd: workers/public/dev-team/motion-designer
+  tools:
+    - add_animation
+    - add_transition
+    - polish_component
+    - generate_image
+
+# 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: |
+  # Motion Designer
+
+  Animations, transitions, visual polish, and image generation.
+
+  ## Skills
+
+  | Skill | Description |
+  |-------|-------------|
+  | add-animation | Add animation to component |
+  | add-transition | Add page/element transition |
+  | polish-component | Polish visual design |
+  | generate-image | Generate image via gnb |
+
+  ## Tools
+
+  - Framer Motion
+  - Three.js
+  - GSAP
+  - gnb (gemini-nano-banana) for image generation
+
+  ## Human-in-the-loop
+
+  - Approve animation design
+  - Review performance impact
+  - Confirm image generation prompts

package/template/workers/dev-team/product-planner/queue.json

@@ -0,0 +1,4 @@
+{
+  "worker": "product-planner",
+  "tasks": []
+}