@cubis/foundry 0.3.68 → 0.3.70

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (152) hide show
  1. package/dist/cli/core.js +95 -2
  2. package/dist/cli/core.js.map +1 -1
  3. package/dist/cli/init/execute.js +6 -4
  4. package/dist/cli/init/execute.js.map +1 -1
  5. package/dist/cli/init/prompts.js +5 -0
  6. package/dist/cli/init/prompts.js.map +1 -1
  7. package/mcp/dist/index.js +37 -8
  8. package/mcp/src/cbxConfig/index.ts +6 -1
  9. package/mcp/src/cbxConfig/serviceConfig.ts +38 -3
  10. package/mcp/src/cbxConfig/types.ts +6 -0
  11. package/mcp/src/gateway/config.ts +69 -8
  12. package/mcp/src/gateway/manager.ts +17 -6
  13. package/mcp/src/gateway/types.ts +1 -1
  14. package/mcp/src/server.ts +18 -13
  15. package/mcp/src/tools/playwrightGetStatus.ts +60 -0
  16. package/mcp/src/tools/registry.test.ts +26 -8
  17. package/mcp/src/tools/registry.ts +29 -2
  18. package/mcp/src/tools/routeResolve.ts +1 -1
  19. package/mcp/src/upstream/passthrough.ts +69 -8
  20. package/package.json +1 -1
  21. package/src/cli/core.ts +100 -5
  22. package/src/cli/init/execute.ts +14 -5
  23. package/src/cli/init/prompts.ts +5 -0
  24. package/src/cli/init/types.ts +1 -1
  25. package/workflows/skills/generated/skill-catalog.json +806 -103
  26. package/workflows/skills/playwright-e2e/SKILL.md +21 -5
  27. package/workflows/skills/playwright-e2e/references/locator-trace-flake-checklist.md +28 -0
  28. package/workflows/skills/skills_index.json +802 -99
  29. package/workflows/workflows/agent-environment-setup/manifest.json +65 -9
  30. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/backend-specialist.md +6 -0
  31. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/code-archaeologist.md +7 -0
  32. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/database-architect.md +6 -0
  33. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/debugger.md +7 -0
  34. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/devops-engineer.md +6 -0
  35. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/documentation-writer.md +4 -0
  36. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/frontend-specialist.md +6 -0
  37. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/game-developer.md +1 -0
  38. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/mobile-developer.md +6 -0
  39. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/orchestrator.md +8 -0
  40. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/penetration-tester.md +4 -0
  41. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/performance-optimizer.md +4 -0
  42. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/product-manager.md +1 -0
  43. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/project-planner.md +8 -0
  44. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/qa-automation-engineer.md +1 -0
  45. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/researcher.md +5 -0
  46. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/security-auditor.md +6 -0
  47. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/seo-specialist.md +1 -0
  48. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/sre-engineer.md +6 -0
  49. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/test-engineer.md +5 -0
  50. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/validator.md +1 -0
  51. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/vercel-expert.md +1 -0
  52. package/workflows/workflows/agent-environment-setup/platforms/antigravity/rules/GEMINI.md +1 -1
  53. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/backend-specialist.md +6 -0
  54. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/code-archaeologist.md +7 -0
  55. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/database-architect.md +6 -0
  56. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/debugger.md +7 -0
  57. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/devops-engineer.md +6 -0
  58. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/documentation-writer.md +4 -0
  59. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/frontend-specialist.md +6 -0
  60. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/game-developer.md +1 -0
  61. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/mobile-developer.md +6 -0
  62. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/orchestrator.md +8 -0
  63. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/penetration-tester.md +4 -0
  64. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/performance-optimizer.md +4 -0
  65. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/product-manager.md +1 -0
  66. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/project-planner.md +8 -0
  67. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/qa-automation-engineer.md +1 -0
  68. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/researcher.md +5 -0
  69. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/security-auditor.md +6 -0
  70. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/seo-specialist.md +1 -0
  71. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/sre-engineer.md +6 -0
  72. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/test-engineer.md +5 -0
  73. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/validator.md +1 -0
  74. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/vercel-expert.md +1 -0
  75. package/workflows/workflows/agent-environment-setup/platforms/claude/rules/CLAUDE.md +77 -63
  76. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/playwright-e2e/SKILL.md +21 -5
  77. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/playwright-e2e/references/locator-trace-flake-checklist.md +28 -0
  78. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/skills_index.json +802 -99
  79. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/backend-specialist.md +6 -0
  80. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/code-archaeologist.md +7 -0
  81. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/database-architect.md +6 -0
  82. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/debugger.md +7 -0
  83. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/devops-engineer.md +6 -0
  84. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/documentation-writer.md +4 -0
  85. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/frontend-specialist.md +6 -0
  86. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/game-developer.md +1 -0
  87. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/mobile-developer.md +6 -0
  88. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/orchestrator.md +8 -0
  89. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/penetration-tester.md +4 -0
  90. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/performance-optimizer.md +4 -0
  91. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/product-manager.md +1 -0
  92. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/project-planner.md +8 -0
  93. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/qa-automation-engineer.md +1 -0
  94. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/researcher.md +5 -0
  95. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/security-auditor.md +6 -0
  96. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/seo-specialist.md +1 -0
  97. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/sre-engineer.md +6 -0
  98. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/test-engineer.md +5 -0
  99. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/validator.md +1 -0
  100. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/vercel-expert.md +1 -0
  101. package/workflows/workflows/agent-environment-setup/platforms/codex/rules/AGENTS.md +1 -1
  102. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/backend-specialist.md +5 -0
  103. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/code-archaeologist.md +5 -0
  104. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/database-architect.md +5 -0
  105. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/debugger.md +5 -0
  106. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/devops-engineer.md +5 -0
  107. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/documentation-writer.md +3 -0
  108. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/frontend-specialist.md +5 -0
  109. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/mobile-developer.md +5 -0
  110. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/orchestrator.md +6 -0
  111. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/penetration-tester.md +3 -0
  112. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/performance-optimizer.md +3 -0
  113. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/project-planner.md +6 -0
  114. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/researcher.md +3 -0
  115. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/security-auditor.md +5 -0
  116. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/sre-engineer.md +5 -0
  117. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/test-engineer.md +3 -0
  118. package/workflows/workflows/agent-environment-setup/platforms/copilot/rules/copilot-instructions.md +87 -82
  119. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/playwright-e2e/SKILL.md +21 -5
  120. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/playwright-e2e/references/locator-trace-flake-checklist.md +28 -0
  121. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/skills_index.json +802 -99
  122. package/workflows/workflows/agent-environment-setup/shared/agents/backend-specialist.md +6 -0
  123. package/workflows/workflows/agent-environment-setup/shared/agents/code-archaeologist.md +7 -0
  124. package/workflows/workflows/agent-environment-setup/shared/agents/database-architect.md +6 -0
  125. package/workflows/workflows/agent-environment-setup/shared/agents/debugger.md +7 -0
  126. package/workflows/workflows/agent-environment-setup/shared/agents/devops-engineer.md +6 -0
  127. package/workflows/workflows/agent-environment-setup/shared/agents/documentation-writer.md +4 -0
  128. package/workflows/workflows/agent-environment-setup/shared/agents/frontend-specialist.md +6 -0
  129. package/workflows/workflows/agent-environment-setup/shared/agents/game-developer.md +1 -0
  130. package/workflows/workflows/agent-environment-setup/shared/agents/mobile-developer.md +6 -0
  131. package/workflows/workflows/agent-environment-setup/shared/agents/orchestrator.md +8 -0
  132. package/workflows/workflows/agent-environment-setup/shared/agents/penetration-tester.md +4 -0
  133. package/workflows/workflows/agent-environment-setup/shared/agents/performance-optimizer.md +4 -0
  134. package/workflows/workflows/agent-environment-setup/shared/agents/product-manager.md +1 -0
  135. package/workflows/workflows/agent-environment-setup/shared/agents/project-planner.md +8 -0
  136. package/workflows/workflows/agent-environment-setup/shared/agents/qa-automation-engineer.md +1 -0
  137. package/workflows/workflows/agent-environment-setup/shared/agents/researcher.md +5 -0
  138. package/workflows/workflows/agent-environment-setup/shared/agents/security-auditor.md +6 -0
  139. package/workflows/workflows/agent-environment-setup/shared/agents/seo-specialist.md +1 -0
  140. package/workflows/workflows/agent-environment-setup/shared/agents/sre-engineer.md +6 -0
  141. package/workflows/workflows/agent-environment-setup/shared/agents/test-engineer.md +5 -0
  142. package/workflows/workflows/agent-environment-setup/shared/agents/validator.md +1 -0
  143. package/workflows/workflows/agent-environment-setup/shared/agents/vercel-expert.md +1 -0
  144. package/workflows/workflows/agent-environment-setup/shared/rules/STEERING.md +27 -4
  145. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/antigravity.md +18 -3
  146. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/claude.md +12 -4
  147. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/codex.md +12 -2
  148. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/copilot.md +13 -3
  149. package/workflows/skills/react-best-practices/docs/AGENTS.md +0 -2934
  150. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/react-best-practices/docs/AGENTS.md +0 -2934
  151. package/workflows/workflows/agent-environment-setup/platforms/copilot/rules/AGENTS.md +0 -25
  152. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/react-best-practices/docs/AGENTS.md +0 -2934
@@ -3,7 +3,13 @@ name: backend-specialist
3
3
  description: Backend specialist for API contracts, service logic, schema-aware backend changes, auth-sensitive implementation, payment integrations, and serverless architecture. Triggers on backend, api, endpoint, route, middleware, database, migration, auth, jwt, oauth, oidc, passkey, rbac, session, tenant, secrets, payments, stripe, serverless.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ maxTurns: 25
6
7
  skills: api-designer, api-patterns, architecture-designer, auth-architect, database-skills, database-design, database-optimizer, drizzle-expert, firebase, microservices-architect, nodejs-best-practices, nestjs-expert, fastapi-expert, graphql-architect, stripe-best-practices, serverless-patterns, i18n-localization, typescript-pro, javascript-pro, python-pro, golang-pro, java-pro, csharp-pro, kotlin-pro, rust-pro, php-pro, ruby-pro
8
+ handoffs:
9
+ - agent: "test-engineer"
10
+ title: "Test Backend"
11
+ - agent: "database-architect"
12
+ title: "Review Schema"
7
13
  ---
8
14
 
9
15
  # Backend Specialist
@@ -17,7 +17,14 @@ triggers:
17
17
  ]
18
18
  tools: Read, Grep, Glob, Edit, Write
19
19
  model: inherit
20
+ maxTurns: 25
21
+ memory: project
20
22
  skills: skill-creator, spec-miner, legacy-modernizer, static-analysis, typescript-pro, javascript-pro, python-pro
23
+ handoffs:
24
+ - agent: "researcher"
25
+ title: "Deep Research"
26
+ - agent: "project-planner"
27
+ title: "Plan Modernization"
21
28
  ---
22
29
 
23
30
  # Code Archaeologist
@@ -3,7 +3,13 @@ name: database-architect
3
3
  description: Expert database architect for schema design, query optimization, migrations, and modern serverless databases. Use for database operations, schema changes, indexing, and data modeling. Triggers on database, sql, schema, migration, query, postgres, index, table.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ maxTurns: 25
6
7
  skills: architecture-designer, database-skills, database-design, database-optimizer, drizzle-expert, postgres, mysql, sqlite, mongodb, redis, supabase, firebase, vitess, neki, typescript-pro, javascript-pro, python-pro, golang-pro, java-pro, php-pro, ruby-pro
8
+ handoffs:
9
+ - agent: "backend-specialist"
10
+ title: "Implement Schema Changes"
11
+ - agent: "validator"
12
+ title: "Validate Migrations"
7
13
  ---
8
14
 
9
15
  # Database Architect
@@ -3,7 +3,14 @@ name: debugger
3
3
  description: Expert in evidence-first debugging, root-cause isolation, regression triage, flaky failure investigation, and structured error observability across browser, backend, and data paths.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ maxTurns: 25
7
+ memory: project
6
8
  skills: debugging-strategies, error-ux-observability, testing-patterns, webapp-testing, playwright-e2e, typescript-pro, javascript-pro, python-pro, golang-pro, java-pro, csharp-pro, kotlin-pro, rust-pro
9
+ handoffs:
10
+ - agent: "test-engineer"
11
+ title: "Add Regression Tests"
12
+ - agent: "validator"
13
+ title: "Validate Fix"
7
14
  ---
8
15
 
9
16
  # Debugger
@@ -3,7 +3,13 @@ name: devops-engineer
3
3
  description: Expert in deployment, server management, CI/CD, production operations, infrastructure-as-code, and serverless architecture. CRITICAL — Use for deployment, server access, rollback, and production changes. HIGH RISK operations. Triggers on deploy, production, server, pm2, ssh, release, rollback, ci/cd, infrastructure, serverless.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ maxTurns: 25
6
7
  skills: devops-engineer, sre-engineer, ci-cd-pipelines, docker-kubernetes, observability, serverless-patterns, git-workflow, debugging-strategies, nodejs-best-practices, typescript-pro, javascript-pro, python-pro, golang-pro
8
+ handoffs:
9
+ - agent: "sre-engineer"
10
+ title: "Review Reliability"
11
+ - agent: "validator"
12
+ title: "Validate Pipeline"
7
13
  ---
8
14
 
9
15
  # DevOps Engineer
@@ -3,7 +3,11 @@ name: documentation-writer
3
3
  description: Expert in technical documentation. Use ONLY when user explicitly requests documentation such as README files, API docs, changelogs, tutorials, or docstrings. DO NOT auto-invoke during normal development. Triggers on README, API docs, changelog, tutorial, docstring, documentation.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ maxTurns: 25
6
7
  skills: documentation-templates, changelog-generator, typescript-pro, javascript-pro, python-pro
8
+ handoffs:
9
+ - agent: "validator"
10
+ title: "Validate Documentation"
7
11
  ---
8
12
 
9
13
  # Documentation Writer
@@ -17,7 +17,13 @@ triggers:
17
17
  ]
18
18
  tools: Read, Grep, Glob, Bash, Edit, Write
19
19
  model: inherit
20
+ maxTurns: 25
20
21
  skills: react-expert, nextjs-developer, frontend-design, tailwind-patterns, design-system-builder, web-perf, frontend-code-review, react-best-practices, i18n-localization, error-ux-observability, typescript-pro, javascript-pro
22
+ handoffs:
23
+ - agent: "test-engineer"
24
+ title: "Test UI Components"
25
+ - agent: "validator"
26
+ title: "Validate Frontend"
21
27
  ---
22
28
 
23
29
  # Frontend Specialist
@@ -3,6 +3,7 @@ name: game-developer
3
3
  description: Game development across all platforms (PC, Web, Mobile, VR/AR). Use when building games with Unity, Godot, Unreal, Phaser, Three.js, or similar engines. Covers game mechanics, multiplayer, optimization, 2D/3D graphics, and game design patterns. Triggers on game, gameplay, unity, godot, unreal, phaser, multiplayer, rendering, shader.
4
4
  tools: Read, Write, Edit, Bash, Grep, Glob
5
5
  model: inherit
6
+ maxTurns: 25
6
7
  skills: game-development, typescript-pro, javascript-pro, cpp-pro, c-pro, csharp-pro
7
8
  ---
8
9
 
@@ -3,7 +3,13 @@ name: mobile-developer
3
3
  description: Expert in Flutter delivery and mobile product design for cross-platform apps. Use for Flutter architecture, native integrations, mobile UX, platform behavior, and release readiness. Triggers on mobile, flutter, ios, android, app store, play store, touch UX.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ maxTurns: 25
6
7
  skills: mobile-design, i18n-localization, dart-pro, swift-pro, kotlin-pro, react-expert, debugging-strategies, webapp-testing, typescript-pro, javascript-pro, flutter-design-system, flutter-drift, flutter-feature, flutter-go-router, flutter-offline-sync, flutter-repository, flutter-riverpod, flutter-state-machine, flutter-testing
8
+ handoffs:
9
+ - agent: "test-engineer"
10
+ title: "Test Mobile"
11
+ - agent: "validator"
12
+ title: "Validate Mobile App"
7
13
  ---
8
14
 
9
15
  # Mobile Developer
@@ -3,7 +3,15 @@ name: orchestrator
3
3
  description: Pure orchestration agent using Repeat-Until-Good (RUG) pattern. NEVER does implementation work directly — EVERY piece of work MUST be delegated to a specialist subagent with explicit acceptance criteria. Use when a task requires multiple perspectives, parallel analysis, or coordinated execution across different domains. Triggers on orchestrate, coordinate agents, parallel workstreams, cross-domain task, handoff, multi-step execution.
4
4
  tools: Read, Grep, Glob, Bash, Write, Edit
5
5
  model: inherit
6
+ maxTurns: 30
7
+ memory: project
6
8
  skills: architecture-designer, api-designer, database-skills, deep-research, mcp-builder, openai-docs, prompt-engineer, skill-creator, typescript-pro, javascript-pro, python-pro
9
+ handoffs:
10
+ - agent: "validator"
11
+ title: "Validate Results"
12
+ - agent: "project-planner"
13
+ title: "Revise Plan"
14
+ agents: ["*"]
7
15
  ---
8
16
 
9
17
  # Orchestrator — Repeat-Until-Good (RUG) Pattern
@@ -21,7 +21,11 @@ triggers:
21
21
  ]
22
22
  tools: Read, Grep, Glob, Bash
23
23
  model: inherit
24
+ maxTurns: 25
24
25
  skills: security-engineer, vulnerability-scanner, auth-architect, api-designer, typescript-pro, javascript-pro, python-pro, golang-pro, rust-pro
26
+ handoffs:
27
+ - agent: "security-auditor"
28
+ title: "Review Findings"
25
29
  ---
26
30
 
27
31
  # Penetration Tester
@@ -3,7 +3,11 @@ name: performance-optimizer
3
3
  description: Expert in performance optimization, profiling, Core Web Vitals, bundle optimization, and static analysis. Use for improving speed, reducing bundle size, and optimizing runtime performance. Triggers on performance, optimize, speed, slow, memory, cpu, benchmark, lighthouse.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ maxTurns: 25
6
7
  skills: performance-profiling, web-perf, static-analysis, typescript-pro, javascript-pro, python-pro, golang-pro, rust-pro, cpp-pro
8
+ handoffs:
9
+ - agent: "validator"
10
+ title: "Validate Performance Gains"
7
11
  ---
8
12
 
9
13
  # Performance Optimizer
@@ -18,6 +18,7 @@ triggers:
18
18
  ]
19
19
  tools: Read, Grep, Glob, Bash
20
20
  model: inherit
21
+ maxTurns: 25
21
22
  skills: architecture-designer, api-designer, skill-creator, typescript-pro, javascript-pro
22
23
  ---
23
24
 
@@ -3,7 +3,15 @@ name: project-planner
3
3
  description: Smart project planning agent. Breaks down user requests into tasks, plans file structure, determines which agent does what, and creates dependency graphs. Use when starting new projects or planning major features. Triggers on plan project, implementation plan, task breakdown, milestone plan, dependency graph, file structure.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ maxTurns: 30
7
+ memory: project
6
8
  skills: architecture-designer, api-designer, database-skills, deep-research, mcp-builder, openai-docs, prompt-engineer, skill-creator, typescript-pro, javascript-pro, python-pro
9
+ handoffs:
10
+ - agent: "orchestrator"
11
+ title: "Start Implementation"
12
+ - agent: "researcher"
13
+ title: "Research First"
14
+ agents: ["researcher", "orchestrator"]
7
15
  ---
8
16
 
9
17
  # Project Planner
@@ -18,6 +18,7 @@ triggers:
18
18
  ]
19
19
  tools: Read, Grep, Glob, Bash, Edit, Write
20
20
  model: inherit
21
+ maxTurns: 25
21
22
  skills: webapp-testing, playwright-e2e, testing-patterns, static-analysis, agentic-eval, debugging-strategies, typescript-pro, javascript-pro, python-pro
22
23
  ---
23
24
 
@@ -16,7 +16,12 @@ triggers:
16
16
  ]
17
17
  tools: Read, Grep, Glob, Bash
18
18
  model: inherit
19
+ maxTurns: 30
20
+ memory: project
19
21
  skills: deep-research, architecture-designer, database-skills, openai-docs, prompt-engineer
22
+ handoffs:
23
+ - agent: "project-planner"
24
+ title: "Plan Implementation"
20
25
  ---
21
26
 
22
27
  # Researcher
@@ -29,7 +29,13 @@ triggers:
29
29
  ]
30
30
  tools: Read, Grep, Glob, Bash, Edit, Write
31
31
  model: inherit
32
+ maxTurns: 25
32
33
  skills: security-engineer, auth-architect, vulnerability-scanner, static-analysis, api-designer, graphql-architect, nodejs-best-practices, nestjs-expert, fastapi-expert, typescript-pro, javascript-pro, python-pro, golang-pro, rust-pro
34
+ handoffs:
35
+ - agent: "penetration-tester"
36
+ title: "Run Exploit Simulation"
37
+ - agent: "validator"
38
+ title: "Validate Remediation"
33
39
  ---
34
40
 
35
41
  # Security Auditor
@@ -3,6 +3,7 @@ name: seo-specialist
3
3
  description: SEO and GEO (Generative Engine Optimization) expert. Handles SEO audits, Core Web Vitals, E-E-A-T optimization, and AI search visibility. Use for SEO improvements, content optimization, or AI citation strategies. Triggers on SEO audit, Core Web Vitals, metadata, schema markup, GEO, AI search, citation strategy.
4
4
  tools: Read, Grep, Glob, Bash, Write
5
5
  model: inherit
6
+ maxTurns: 25
6
7
  skills: seo-fundamentals, geo-fundamentals, typescript-pro, javascript-pro, python-pro
7
8
  ---
8
9
 
@@ -22,7 +22,13 @@ triggers:
22
22
  ]
23
23
  tools: Read, Grep, Glob, Bash, Edit, Write
24
24
  model: inherit
25
+ maxTurns: 25
25
26
  skills: sre-engineer, devops-engineer, error-ux-observability, observability, serverless-patterns, docker-kubernetes, ci-cd-pipelines, debugging-strategies, python-pro, golang-pro, typescript-pro
27
+ handoffs:
28
+ - agent: "devops-engineer"
29
+ title: "Implement Changes"
30
+ - agent: "validator"
31
+ title: "Validate Reliability"
26
32
  ---
27
33
 
28
34
  # SRE Engineer
@@ -18,7 +18,12 @@ triggers:
18
18
  ]
19
19
  tools: Read, Grep, Glob, Bash, Edit, Write
20
20
  model: inherit
21
+ maxTurns: 25
22
+ memory: project
21
23
  skills: webapp-testing, playwright-e2e, testing-patterns, error-ux-observability, debugging-strategies, frontend-code-review, typescript-pro, javascript-pro, python-pro, golang-pro, java-pro
24
+ handoffs:
25
+ - agent: "validator"
26
+ title: "Validate Test Quality"
22
27
  ---
23
28
 
24
29
  # Test Engineer
@@ -14,6 +14,7 @@ triggers:
14
14
  ]
15
15
  tools: Read, Grep, Glob, Bash
16
16
  model: inherit
17
+ maxTurns: 25
17
18
  skills: debugging-strategies, testing-patterns, static-analysis, webapp-testing, playwright-e2e, agentic-eval, typescript-pro, javascript-pro, python-pro
18
19
  ---
19
20
 
@@ -3,6 +3,7 @@ name: vercel-expert
3
3
  description: Expert in Vercel platform delivery, runtime behavior, security controls, observability, and automation. Use for deployments, project configuration, middleware/routing, domains, flags, AI Gateway, and incident-ready operations. Triggers on vercel, deployment, domain, edge function, middleware, runtime, cache, AI Gateway, rollout.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ maxTurns: 25
6
7
  skills: nextjs-developer, react-expert, tailwind-patterns, web-perf, serverless-patterns, nodejs-best-practices, typescript-pro, javascript-pro
7
8
  ---
8
9
 
@@ -320,6 +320,6 @@ Keep MCP context lazy and exact. Skills are supporting context, not the route la
320
320
  5. Call `skill_get` with `includeReferences:false` by default.
321
321
  6. Load at most one sidecar markdown file at a time with `skill_get_reference`.
322
322
  7. Do not auto-prime every specialist with a skill. Load only what the task clearly needs.
323
- 8. Use upstream MCP servers such as `postman` for real cloud actions when available.
323
+ 8. Use upstream MCP servers such as `postman`, `stitch`, or `playwright` for real cloud/browser actions when available.
324
324
 
325
325
  <!-- cbx:mcp:auto:end -->
@@ -3,6 +3,11 @@ name: backend-specialist
3
3
  description: Backend specialist for API contracts, service logic, schema-aware backend changes, auth-sensitive implementation, payment integrations, and serverless architecture. Triggers on backend, api, endpoint, route, middleware, database, migration, auth, jwt, oauth, oidc, passkey, rbac, session, tenant, secrets, payments, stripe, serverless.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ handoffs:
7
+ - agent: "test-engineer"
8
+ title: "Test Backend"
9
+ - agent: "database-architect"
10
+ title: "Review Schema"
6
11
  ---
7
12
 
8
13
  # Backend Specialist
@@ -3,6 +3,11 @@ name: code-archaeologist
3
3
  description: Expert in legacy code, refactoring, and understanding undocumented systems. Use for reading messy code, reverse engineering, modernization planning, and static code analysis. Triggers on legacy, refactor, spaghetti code, analyze repo, explain codebase.
4
4
  tools: Read, Grep, Glob, Edit, Write
5
5
  model: inherit
6
+ handoffs:
7
+ - agent: "researcher"
8
+ title: "Deep Research"
9
+ - agent: "project-planner"
10
+ title: "Plan Modernization"
6
11
  ---
7
12
 
8
13
  # Code Archaeologist
@@ -3,6 +3,11 @@ name: database-architect
3
3
  description: Expert database architect for schema design, query optimization, migrations, and modern serverless databases. Use for database operations, schema changes, indexing, and data modeling. Triggers on database, sql, schema, migration, query, postgres, index, table.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ handoffs:
7
+ - agent: "backend-specialist"
8
+ title: "Implement Schema Changes"
9
+ - agent: "validator"
10
+ title: "Validate Migrations"
6
11
  ---
7
12
 
8
13
  # Database Architect
@@ -3,6 +3,11 @@ name: debugger
3
3
  description: Expert in evidence-first debugging, root-cause isolation, regression triage, flaky failure investigation, and structured error observability across browser, backend, and data paths.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ handoffs:
7
+ - agent: "test-engineer"
8
+ title: "Add Regression Tests"
9
+ - agent: "validator"
10
+ title: "Validate Fix"
6
11
  ---
7
12
 
8
13
  # Debugger
@@ -3,6 +3,11 @@ name: devops-engineer
3
3
  description: Expert in deployment, server management, CI/CD, production operations, infrastructure-as-code, and serverless architecture. CRITICAL — Use for deployment, server access, rollback, and production changes. HIGH RISK operations. Triggers on deploy, production, server, pm2, ssh, release, rollback, ci/cd, infrastructure, serverless.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ handoffs:
7
+ - agent: "sre-engineer"
8
+ title: "Review Reliability"
9
+ - agent: "validator"
10
+ title: "Validate Pipeline"
6
11
  ---
7
12
 
8
13
  # DevOps Engineer
@@ -3,6 +3,9 @@ name: documentation-writer
3
3
  description: Expert in technical documentation. Use ONLY when user explicitly requests documentation such as README files, API docs, changelogs, tutorials, or docstrings. DO NOT auto-invoke during normal development. Triggers on README, API docs, changelog, tutorial, docstring, documentation.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ handoffs:
7
+ - agent: "validator"
8
+ title: "Validate Documentation"
6
9
  ---
7
10
 
8
11
  # Documentation Writer
@@ -3,6 +3,11 @@ name: frontend-specialist
3
3
  description: Senior frontend specialist for React, Next.js, UI architecture, interaction quality, accessibility, rendering performance, design-system consistency, and internationalization.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ handoffs:
7
+ - agent: "test-engineer"
8
+ title: "Test UI Components"
9
+ - agent: "validator"
10
+ title: "Validate Frontend"
6
11
  ---
7
12
 
8
13
  # Frontend Specialist
@@ -3,6 +3,11 @@ name: mobile-developer
3
3
  description: Expert in Flutter delivery and mobile product design for cross-platform apps. Use for Flutter architecture, native integrations, mobile UX, platform behavior, and release readiness. Triggers on mobile, flutter, ios, android, app store, play store, touch UX.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ handoffs:
7
+ - agent: "test-engineer"
8
+ title: "Test Mobile"
9
+ - agent: "validator"
10
+ title: "Validate Mobile App"
6
11
  ---
7
12
 
8
13
  # Mobile Developer
@@ -3,6 +3,12 @@ name: orchestrator
3
3
  description: Pure orchestration agent using Repeat-Until-Good (RUG) pattern. NEVER does implementation work directly — EVERY piece of work MUST be delegated to a specialist subagent with explicit acceptance criteria. Use when a task requires multiple perspectives, parallel analysis, or coordinated execution across different domains. Triggers on orchestrate, coordinate agents, parallel workstreams, cross-domain task, handoff, multi-step execution.
4
4
  tools: Read, Grep, Glob, Bash, Write, Edit
5
5
  model: inherit
6
+ handoffs:
7
+ - agent: "validator"
8
+ title: "Validate Results"
9
+ - agent: "project-planner"
10
+ title: "Revise Plan"
11
+ agents: ["*"]
6
12
  ---
7
13
 
8
14
  # Orchestrator — Repeat-Until-Good (RUG) Pattern
@@ -3,6 +3,9 @@ name: penetration-tester
3
3
  description: Offensive security specialist for attack-surface mapping, exploitation validation, DAST/SAST analysis, vulnerability scanning, and red-team exercises. Use for penetration testing, exploit validation, attack simulation, and offensive security assessments. Triggers on pentest, exploit, redteam, offensive, attack surface, DAST, SAST, bug bounty.
4
4
  tools: Read, Grep, Glob, Bash
5
5
  model: inherit
6
+ handoffs:
7
+ - agent: "security-auditor"
8
+ title: "Review Findings"
6
9
  ---
7
10
 
8
11
  # Penetration Tester
@@ -3,6 +3,9 @@ name: performance-optimizer
3
3
  description: Expert in performance optimization, profiling, Core Web Vitals, bundle optimization, and static analysis. Use for improving speed, reducing bundle size, and optimizing runtime performance. Triggers on performance, optimize, speed, slow, memory, cpu, benchmark, lighthouse.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ handoffs:
7
+ - agent: "validator"
8
+ title: "Validate Performance Gains"
6
9
  ---
7
10
 
8
11
  # Performance Optimizer
@@ -3,6 +3,12 @@ name: project-planner
3
3
  description: Smart project planning agent. Breaks down user requests into tasks, plans file structure, determines which agent does what, and creates dependency graphs. Use when starting new projects or planning major features. Triggers on plan project, implementation plan, task breakdown, milestone plan, dependency graph, file structure.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ handoffs:
7
+ - agent: "orchestrator"
8
+ title: "Start Implementation"
9
+ - agent: "researcher"
10
+ title: "Research First"
11
+ agents: ["researcher", "orchestrator"]
6
12
  ---
7
13
 
8
14
  # Project Planner
@@ -3,6 +3,9 @@ name: researcher
3
3
  description: Deep research and codebase exploration agent. Systematically investigates codebases, documentation, and external sources to produce structured findings before implementation begins. Use when a task needs understanding before action, or when external knowledge must be verified. Triggers on research, investigate, explore codebase, find patterns, understand system, analyze dependencies, compare approaches.
4
4
  tools: Read, Grep, Glob, Bash
5
5
  model: inherit
6
+ handoffs:
7
+ - agent: "project-planner"
8
+ title: "Plan Implementation"
6
9
  ---
7
10
 
8
11
  # Researcher
@@ -3,6 +3,11 @@ name: security-auditor
3
3
  description: Security auditor for exploitability-first review, auth and policy design, secret handling, code-path hardening, vulnerability scanning, and static analysis. Triggers on security, vulnerability, owasp, xss, injection, auth, jwt, oauth, oidc, rbac, session, passkey, secrets, supply chain, pentest.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ handoffs:
7
+ - agent: "penetration-tester"
8
+ title: "Run Exploit Simulation"
9
+ - agent: "validator"
10
+ title: "Validate Remediation"
6
11
  ---
7
12
 
8
13
  # Security Auditor
@@ -3,6 +3,11 @@ name: sre-engineer
3
3
  description: Site reliability engineer for SLO-driven operations, incident management, toil reduction, production reliability, and structured error observability. Use for reliability engineering, SLO/SLA design, incident response, capacity planning, and operational toil reduction. Triggers on SRE, reliability, SLO, SLA, incident, on-call, toil, error budget, uptime, latency.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ handoffs:
7
+ - agent: "devops-engineer"
8
+ title: "Implement Changes"
9
+ - agent: "validator"
10
+ title: "Validate Reliability"
6
11
  ---
7
12
 
8
13
  # SRE Engineer
@@ -3,6 +3,9 @@ name: test-engineer
3
3
  description: Expert in test strategy, browser verification, coverage triage, regression-proof automation, and structured testing patterns. Use for writing tests, improving coverage, debugging test failures, or deciding the right verification layer.
4
4
  tools: Read, Grep, Glob, Bash, Edit, Write
5
5
  model: inherit
6
+ handoffs:
7
+ - agent: "validator"
8
+ title: "Validate Test Quality"
6
9
  ---
7
10
 
8
11
  # Test Engineer