@cubis/foundry 0.3.69 → 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 (150) 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/src/cbxConfig/index.ts +6 -1
  8. package/mcp/src/cbxConfig/serviceConfig.ts +38 -3
  9. package/mcp/src/cbxConfig/types.ts +6 -0
  10. package/mcp/src/gateway/config.ts +69 -8
  11. package/mcp/src/gateway/manager.ts +17 -6
  12. package/mcp/src/gateway/types.ts +1 -1
  13. package/mcp/src/server.ts +7 -3
  14. package/mcp/src/tools/playwrightGetStatus.ts +60 -0
  15. package/mcp/src/tools/registry.test.ts +26 -8
  16. package/mcp/src/tools/registry.ts +27 -1
  17. package/mcp/src/upstream/passthrough.ts +29 -5
  18. package/package.json +1 -1
  19. package/src/cli/core.ts +100 -5
  20. package/src/cli/init/execute.ts +14 -5
  21. package/src/cli/init/prompts.ts +5 -0
  22. package/src/cli/init/types.ts +1 -1
  23. package/workflows/skills/generated/skill-catalog.json +806 -103
  24. package/workflows/skills/playwright-e2e/SKILL.md +21 -5
  25. package/workflows/skills/playwright-e2e/references/locator-trace-flake-checklist.md +28 -0
  26. package/workflows/skills/skills_index.json +802 -99
  27. package/workflows/workflows/agent-environment-setup/manifest.json +65 -9
  28. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/backend-specialist.md +6 -0
  29. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/code-archaeologist.md +7 -0
  30. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/database-architect.md +6 -0
  31. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/debugger.md +7 -0
  32. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/devops-engineer.md +6 -0
  33. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/documentation-writer.md +4 -0
  34. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/frontend-specialist.md +6 -0
  35. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/game-developer.md +1 -0
  36. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/mobile-developer.md +6 -0
  37. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/orchestrator.md +8 -0
  38. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/penetration-tester.md +4 -0
  39. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/performance-optimizer.md +4 -0
  40. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/product-manager.md +1 -0
  41. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/project-planner.md +8 -0
  42. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/qa-automation-engineer.md +1 -0
  43. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/researcher.md +5 -0
  44. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/security-auditor.md +6 -0
  45. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/seo-specialist.md +1 -0
  46. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/sre-engineer.md +6 -0
  47. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/test-engineer.md +5 -0
  48. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/validator.md +1 -0
  49. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/vercel-expert.md +1 -0
  50. package/workflows/workflows/agent-environment-setup/platforms/antigravity/rules/GEMINI.md +1 -1
  51. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/backend-specialist.md +6 -0
  52. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/code-archaeologist.md +7 -0
  53. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/database-architect.md +6 -0
  54. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/debugger.md +7 -0
  55. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/devops-engineer.md +6 -0
  56. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/documentation-writer.md +4 -0
  57. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/frontend-specialist.md +6 -0
  58. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/game-developer.md +1 -0
  59. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/mobile-developer.md +6 -0
  60. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/orchestrator.md +8 -0
  61. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/penetration-tester.md +4 -0
  62. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/performance-optimizer.md +4 -0
  63. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/product-manager.md +1 -0
  64. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/project-planner.md +8 -0
  65. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/qa-automation-engineer.md +1 -0
  66. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/researcher.md +5 -0
  67. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/security-auditor.md +6 -0
  68. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/seo-specialist.md +1 -0
  69. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/sre-engineer.md +6 -0
  70. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/test-engineer.md +5 -0
  71. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/validator.md +1 -0
  72. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/vercel-expert.md +1 -0
  73. package/workflows/workflows/agent-environment-setup/platforms/claude/rules/CLAUDE.md +77 -63
  74. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/playwright-e2e/SKILL.md +21 -5
  75. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/playwright-e2e/references/locator-trace-flake-checklist.md +28 -0
  76. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/skills_index.json +802 -99
  77. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/backend-specialist.md +6 -0
  78. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/code-archaeologist.md +7 -0
  79. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/database-architect.md +6 -0
  80. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/debugger.md +7 -0
  81. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/devops-engineer.md +6 -0
  82. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/documentation-writer.md +4 -0
  83. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/frontend-specialist.md +6 -0
  84. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/game-developer.md +1 -0
  85. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/mobile-developer.md +6 -0
  86. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/orchestrator.md +8 -0
  87. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/penetration-tester.md +4 -0
  88. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/performance-optimizer.md +4 -0
  89. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/product-manager.md +1 -0
  90. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/project-planner.md +8 -0
  91. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/qa-automation-engineer.md +1 -0
  92. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/researcher.md +5 -0
  93. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/security-auditor.md +6 -0
  94. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/seo-specialist.md +1 -0
  95. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/sre-engineer.md +6 -0
  96. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/test-engineer.md +5 -0
  97. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/validator.md +1 -0
  98. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/vercel-expert.md +1 -0
  99. package/workflows/workflows/agent-environment-setup/platforms/codex/rules/AGENTS.md +1 -1
  100. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/backend-specialist.md +5 -0
  101. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/code-archaeologist.md +5 -0
  102. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/database-architect.md +5 -0
  103. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/debugger.md +5 -0
  104. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/devops-engineer.md +5 -0
  105. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/documentation-writer.md +3 -0
  106. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/frontend-specialist.md +5 -0
  107. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/mobile-developer.md +5 -0
  108. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/orchestrator.md +6 -0
  109. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/penetration-tester.md +3 -0
  110. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/performance-optimizer.md +3 -0
  111. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/project-planner.md +6 -0
  112. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/researcher.md +3 -0
  113. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/security-auditor.md +5 -0
  114. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/sre-engineer.md +5 -0
  115. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/test-engineer.md +3 -0
  116. package/workflows/workflows/agent-environment-setup/platforms/copilot/rules/copilot-instructions.md +87 -82
  117. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/playwright-e2e/SKILL.md +21 -5
  118. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/playwright-e2e/references/locator-trace-flake-checklist.md +28 -0
  119. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/skills_index.json +802 -99
  120. package/workflows/workflows/agent-environment-setup/shared/agents/backend-specialist.md +6 -0
  121. package/workflows/workflows/agent-environment-setup/shared/agents/code-archaeologist.md +7 -0
  122. package/workflows/workflows/agent-environment-setup/shared/agents/database-architect.md +6 -0
  123. package/workflows/workflows/agent-environment-setup/shared/agents/debugger.md +7 -0
  124. package/workflows/workflows/agent-environment-setup/shared/agents/devops-engineer.md +6 -0
  125. package/workflows/workflows/agent-environment-setup/shared/agents/documentation-writer.md +4 -0
  126. package/workflows/workflows/agent-environment-setup/shared/agents/frontend-specialist.md +6 -0
  127. package/workflows/workflows/agent-environment-setup/shared/agents/game-developer.md +1 -0
  128. package/workflows/workflows/agent-environment-setup/shared/agents/mobile-developer.md +6 -0
  129. package/workflows/workflows/agent-environment-setup/shared/agents/orchestrator.md +8 -0
  130. package/workflows/workflows/agent-environment-setup/shared/agents/penetration-tester.md +4 -0
  131. package/workflows/workflows/agent-environment-setup/shared/agents/performance-optimizer.md +4 -0
  132. package/workflows/workflows/agent-environment-setup/shared/agents/product-manager.md +1 -0
  133. package/workflows/workflows/agent-environment-setup/shared/agents/project-planner.md +8 -0
  134. package/workflows/workflows/agent-environment-setup/shared/agents/qa-automation-engineer.md +1 -0
  135. package/workflows/workflows/agent-environment-setup/shared/agents/researcher.md +5 -0
  136. package/workflows/workflows/agent-environment-setup/shared/agents/security-auditor.md +6 -0
  137. package/workflows/workflows/agent-environment-setup/shared/agents/seo-specialist.md +1 -0
  138. package/workflows/workflows/agent-environment-setup/shared/agents/sre-engineer.md +6 -0
  139. package/workflows/workflows/agent-environment-setup/shared/agents/test-engineer.md +5 -0
  140. package/workflows/workflows/agent-environment-setup/shared/agents/validator.md +1 -0
  141. package/workflows/workflows/agent-environment-setup/shared/agents/vercel-expert.md +1 -0
  142. package/workflows/workflows/agent-environment-setup/shared/rules/STEERING.md +27 -4
  143. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/antigravity.md +18 -3
  144. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/claude.md +12 -4
  145. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/codex.md +12 -2
  146. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/copilot.md +13 -3
  147. package/workflows/skills/react-best-practices/docs/AGENTS.md +0 -2934
  148. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/react-best-practices/docs/AGENTS.md +0 -2934
  149. package/workflows/workflows/agent-environment-setup/platforms/copilot/rules/AGENTS.md +0 -25
  150. 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
 
@@ -85,10 +85,33 @@ Use the best specialist first:
85
85
  - `@orchestrator` uses the **RUG (Repeat-Until-Good)** pattern: it NEVER implements directly — only delegates to specialists with acceptance criteria and validates output independently.
86
86
  - After each specialist delivers, route through `@validator` for independent quality gate before accepting.
87
87
  - If validation fails, re-delegate with specific feedback (max 3 iterations).
88
+ - Max 3 re-delegation iterations per specialist per milestone. If limit hit, surface to user.
89
+
90
+ ### Subagent Delegation
91
+
92
+ - Delegate to subagents only when work genuinely requires domain specialization or parallel execution.
93
+ - Each delegation must include: **goal**, **acceptance criteria**, **output contract**, **scope boundary**.
94
+ - Use background/parallel agents only for independent workstreams with no shared mutable state.
95
+ - Sequential work stays sequential — do not parallelize work that writes to the same files or resources.
96
+ - Set iteration limits (`maxTurns`) to prevent runaway loops.
97
+
98
+ ### Handoff Patterns
99
+
100
+ - Agents may suggest the next logical agent via handoff chains (e.g., `@debugger` → `@test-engineer`).
101
+ - Handoffs are suggestions, not mandates — the user decides when to follow them.
102
+ - Every handoff preserves the output contract: `milestones`, `gate_status`, `next_handoff`.
103
+
104
+ ---
105
+
106
+ ## 5) Memory & Cross-Session Learning
107
+
108
+ - Key agents (orchestrator, debugger, test-engineer, researcher, project-planner, code-archaeologist) support project memory.
109
+ - Project memory persists debugging patterns, architecture decisions, test strategies, and codebase insights across sessions.
110
+ - Skills loaded into agent context accumulate domain knowledge — do not reload what is already in context.
88
111
 
89
112
  ---
90
113
 
91
- ## 5) Long-Running and Handoff Work
114
+ ## 6) Long-Running and Handoff Work
92
115
 
93
116
  1. Use `/implement-track` for milestone-based work, resumable execution, or progress checkpoints.
94
117
  2. Use `/orchestrate` when multiple specialties need explicit ownership or handoff.
@@ -96,7 +119,7 @@ Use the best specialist first:
96
119
 
97
120
  ---
98
121
 
99
- ## 6) Workflow Quick Reference
122
+ ## 7) Workflow Quick Reference
100
123
 
101
124
  | Intent Pattern | Workflow | Primary Agent |
102
125
  | --------------------------------------- | ------------------ | ---------------------- |
@@ -121,7 +144,7 @@ Use the best specialist first:
121
144
 
122
145
  ---
123
146
 
124
- ## 7) Safety and Verification
147
+ ## 8) Safety and Verification
125
148
 
126
149
  1. Do not run destructive actions without explicit user confirmation.
127
150
  2. Keep diffs small and reversible when possible.
@@ -131,7 +154,7 @@ Use the best specialist first:
131
154
 
132
155
  ---
133
156
 
134
- ## 8) Maintenance
157
+ ## 9) Maintenance
135
158
 
136
159
  - Refresh installed rules: `cbx workflows sync-rules --platform {{PLATFORM}} --scope project`
137
160
  - Diagnose setup issues: `cbx workflows doctor {{PLATFORM}} --scope project`
@@ -5,6 +5,7 @@
5
5
  - Workflows: `.agent/workflows`
6
6
  - Agents: `.agent/agents`
7
7
  - Skills: `.agent/skills`
8
+ - Gemini commands: `.gemini/commands/*.toml`
8
9
  - Rules file: `GEMINI.md`
9
10
 
10
11
  ## Platform-Specific Routing
@@ -12,10 +13,24 @@
12
13
  Gemini recognizes these additional entry points:
13
14
 
14
15
  1. **Explicit Gemini command** (`.gemini/commands/*.toml`) — highest priority route.
15
- 2. Standard workflow/agent routing from shared steering.
16
+ 2. **Agent Manager** for multi-agent coordination Gemini's orchestration surface.
17
+ 3. Standard workflow/agent routing from shared steering.
16
18
 
17
- ## Platform Notes
19
+ ## Gemini Commands
18
20
 
19
- - Gemini native commands are `.toml` files with execution contract prompts.
21
+ - Commands are `.toml` files with execution contract prompts.
20
22
  - `trigger: always_on` frontmatter activates a command for every session.
23
+ - Commands support `description`, `steps`, and `tools` fields for structured execution.
24
+
25
+ ## Agent Manager
26
+
27
+ - Gemini's Agent Manager handles multi-specialist coordination (equivalent to `@orchestrator`).
28
+ - Agent Manager delegates to specialist agents defined in `.agent/agents/`.
29
+ - Use Agent Manager when work crosses 2+ domains with explicit handoff needs.
30
+
31
+ ## Platform Notes
32
+
21
33
  - Gemini does not support MCP tool search natively — use `route_resolve` first, then skill loading.
34
+ - Skills loaded via MCP are supported when the Cubis Foundry MCP server is configured.
35
+ - Gemini supports function calling and tool use natively for code generation and analysis.
36
+ - Keep `.toml` commands focused — one command per task pattern for clean routing.
@@ -6,16 +6,24 @@
6
6
  - Agents: `.claude/agents`
7
7
  - Skills: `.claude/skills`
8
8
  - Rules file: `CLAUDE.md`
9
+ - Scoped rules: `.claude/rules/*.md` (with `paths:` frontmatter)
9
10
 
10
11
  ## Platform-Specific Routing
11
12
 
12
13
  1. **Explicit workflow, slash command, or subagent** — highest priority route.
13
14
  2. Standard workflow/agent routing from shared steering.
14
15
 
16
+ ## Subagent Delegation
17
+
18
+ - Claude delegates via the `Task` tool — each task spawns an independent agent context.
19
+ - Set `maxTurns` in agent frontmatter to cap iteration depth (default: 25).
20
+ - Use `background: true` for parallel workstreams with no shared mutable state.
21
+ - Key agents have `memory: project` for cross-session learning (orchestrator, debugger, test-engineer, researcher, project-planner, code-archaeologist).
22
+
15
23
  ## Platform Notes
16
24
 
17
- - Claude supports **subagent delegation** via `Task` tool for parallel specialist work.
18
- - Scoped rules can be placed in `.claude/rules/*.md` with frontmatter-based path matching.
19
- - Global rules live in `~/.claude/CLAUDE.md` and apply to all projects.
20
25
  - Claude natively supports `bash`, `read`, `write`, `edit`, `multiedit`, `grep`, `glob` tools.
21
- - Use subagents for genuinely parallel workstreams; do not delegate when sequential execution suffices.
26
+ - Scoped rules in `.claude/rules/*.md` use `paths:` frontmatter for targeted file-pattern matching.
27
+ - Global rules live in `~/.claude/CLAUDE.md` and apply to all projects.
28
+ - Skills with `context: fork` spawn as isolated subagents for research-heavy or exploratory tasks.
29
+ - Use `$ARGUMENTS` in skill content for dynamic parameterization from user queries.
@@ -13,7 +13,17 @@
13
13
  2. Compatibility aliases (`$workflow-*`, `$agent-*`) may be accepted as hints but are never the primary route surface.
14
14
  3. Standard workflow/agent routing from shared steering.
15
15
 
16
+ ## Sandbox Constraints
17
+
18
+ - Codex runs in an isolated sandbox — no persistent external network access by default.
19
+ - All specialist references are **postures within the current session** — Codex does not spawn isolated subagents.
20
+ - `@specialist` means: adopt that specialist's domain, reasoning style, and scope constraints internally.
21
+ - Prefer local file inspection over external fetches. Default to repo-grounded reasoning.
22
+ - MCP tools may be available depending on sandbox configuration — verify with `route_resolve` first.
23
+
16
24
  ## Platform Notes
17
25
 
18
- - Codex does not spawn isolated Foundry agents. Agent-style references route work to the right specialist posture inside the current session.
19
- - Codex runs in a sandboxed environment — destructive operations are inherently limited.
26
+ - Codex supports three autonomy levels: `suggest` (propose only), `auto-edit` (edit with confirmation), `full-auto` (autonomous execution).
27
+ - Codex operates in a sandboxed environment — destructive operations are inherently limited.
28
+ - Orchestration in Codex is sequential (no parallel subagent spawning) — adopt specialist postures one at a time.
29
+ - Keep workflow instructions self-contained since network access for external docs may be restricted.
@@ -6,7 +6,9 @@
6
6
  - Agents: `.github/agents`
7
7
  - Skills: `.github/skills`
8
8
  - Rules file: `copilot-instructions.md`
9
- - Agent rules: `AGENTS.md`
9
+ - Path-scoped instructions: `.github/instructions/*.instructions.md`
10
+ - Prompt files: `.github/prompts/*.prompt.md`
11
+ - MCP configuration: `.vscode/mcp.json`
10
12
 
11
13
  ## Platform-Specific Routing
12
14
 
@@ -14,11 +16,19 @@
14
16
  2. Copilot prompt files (`.github/prompts/*.prompt.md`) provide structured entry points.
15
17
  3. Standard workflow/agent routing from shared steering.
16
18
 
19
+ ## Agent Handoffs
20
+
21
+ - Agents with `handoffs:` frontmatter offer guided workflow transitions (e.g., `@debugger` → `@test-engineer`).
22
+ - The `@orchestrator` has `agents: ["*"]` — it can delegate to any specialist.
23
+ - The `@project-planner` can delegate to `@researcher` and `@orchestrator`.
24
+ - Handoffs are suggestions — the user decides when to follow them.
25
+
17
26
  ## Platform Notes
18
27
 
19
- - Copilot supports path-scoped instructions (`applyTo` in `.github/*.md` frontmatter).
28
+ - Copilot supports path-scoped instructions (`applyTo` in `.github/instructions/*.instructions.md` frontmatter).
20
29
  - MCP tools are configured via `.vscode/mcp.json` or VS Code settings — not inline.
21
- - Copilot agent frontmatter supports: `name`, `description`, `tools`, `target`, `infer`, `mcp-servers`, `metadata`, `model`, `handoffs`, `argument-hint`.
30
+ - Copilot agent frontmatter supports: `name`, `description`, `tools`, `model`, `handoffs`, `agents`, `argument-hint`, `mcp-servers`, `metadata`.
31
+ - Skills support `argument-hint`, `disable-model-invocation`, and `user-invocable` frontmatter keys.
22
32
 
23
33
  ## Copilot Asset Authoring
24
34