@cubis/foundry 0.3.69 → 0.3.71

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 (180) 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/powers/ask-questions-if-underspecified/SKILL.md +51 -3
  24. package/workflows/powers/behavioral-modes/SKILL.md +100 -9
  25. package/workflows/skills/agent-design/SKILL.md +198 -0
  26. package/workflows/skills/agent-design/references/clarification-patterns.md +153 -0
  27. package/workflows/skills/agent-design/references/skill-testing.md +164 -0
  28. package/workflows/skills/agent-design/references/workflow-patterns.md +226 -0
  29. package/workflows/skills/deep-research/SKILL.md +25 -20
  30. package/workflows/skills/deep-research/references/multi-round-research-loop.md +73 -8
  31. package/workflows/skills/frontend-design/SKILL.md +37 -32
  32. package/workflows/skills/frontend-design/commands/brand.md +167 -0
  33. package/workflows/skills/frontend-design/references/brand-presets.md +228 -0
  34. package/workflows/skills/generated/skill-audit.json +11 -2
  35. package/workflows/skills/generated/skill-catalog.json +842 -107
  36. package/workflows/skills/playwright-e2e/SKILL.md +21 -5
  37. package/workflows/skills/playwright-e2e/references/locator-trace-flake-checklist.md +28 -0
  38. package/workflows/skills/skills_index.json +803 -100
  39. package/workflows/workflows/agent-environment-setup/manifest.json +65 -9
  40. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/backend-specialist.md +6 -0
  41. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/code-archaeologist.md +7 -0
  42. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/database-architect.md +6 -0
  43. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/debugger.md +7 -0
  44. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/devops-engineer.md +6 -0
  45. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/documentation-writer.md +4 -0
  46. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/frontend-specialist.md +6 -0
  47. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/game-developer.md +1 -0
  48. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/mobile-developer.md +6 -0
  49. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/orchestrator.md +8 -0
  50. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/penetration-tester.md +4 -0
  51. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/performance-optimizer.md +4 -0
  52. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/product-manager.md +1 -0
  53. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/project-planner.md +8 -0
  54. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/qa-automation-engineer.md +1 -0
  55. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/researcher.md +5 -0
  56. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/security-auditor.md +6 -0
  57. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/seo-specialist.md +1 -0
  58. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/sre-engineer.md +6 -0
  59. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/test-engineer.md +5 -0
  60. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/validator.md +1 -0
  61. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/vercel-expert.md +1 -0
  62. package/workflows/workflows/agent-environment-setup/platforms/antigravity/rules/GEMINI.md +1 -1
  63. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/backend-specialist.md +6 -0
  64. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/code-archaeologist.md +7 -0
  65. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/database-architect.md +6 -0
  66. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/debugger.md +7 -0
  67. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/devops-engineer.md +6 -0
  68. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/documentation-writer.md +4 -0
  69. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/frontend-specialist.md +6 -0
  70. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/game-developer.md +1 -0
  71. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/mobile-developer.md +6 -0
  72. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/orchestrator.md +8 -0
  73. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/penetration-tester.md +4 -0
  74. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/performance-optimizer.md +4 -0
  75. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/product-manager.md +1 -0
  76. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/project-planner.md +8 -0
  77. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/qa-automation-engineer.md +1 -0
  78. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/researcher.md +5 -0
  79. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/security-auditor.md +6 -0
  80. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/seo-specialist.md +1 -0
  81. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/sre-engineer.md +6 -0
  82. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/test-engineer.md +5 -0
  83. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/validator.md +1 -0
  84. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/vercel-expert.md +1 -0
  85. package/workflows/workflows/agent-environment-setup/platforms/claude/rules/CLAUDE.md +77 -63
  86. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/agent-design/SKILL.md +198 -0
  87. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/agent-design/references/clarification-patterns.md +153 -0
  88. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/agent-design/references/skill-testing.md +164 -0
  89. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/agent-design/references/workflow-patterns.md +226 -0
  90. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/SKILL.md +25 -20
  91. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/references/multi-round-research-loop.md +73 -8
  92. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/frontend-design/SKILL.md +37 -32
  93. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/frontend-design/commands/brand.md +167 -0
  94. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/frontend-design/references/brand-presets.md +228 -0
  95. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/playwright-e2e/SKILL.md +21 -5
  96. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/playwright-e2e/references/locator-trace-flake-checklist.md +28 -0
  97. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/skills_index.json +803 -100
  98. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/backend-specialist.md +6 -0
  99. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/code-archaeologist.md +7 -0
  100. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/database-architect.md +6 -0
  101. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/debugger.md +7 -0
  102. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/devops-engineer.md +6 -0
  103. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/documentation-writer.md +4 -0
  104. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/frontend-specialist.md +6 -0
  105. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/game-developer.md +1 -0
  106. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/mobile-developer.md +6 -0
  107. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/orchestrator.md +8 -0
  108. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/penetration-tester.md +4 -0
  109. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/performance-optimizer.md +4 -0
  110. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/product-manager.md +1 -0
  111. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/project-planner.md +8 -0
  112. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/qa-automation-engineer.md +1 -0
  113. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/researcher.md +5 -0
  114. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/security-auditor.md +6 -0
  115. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/seo-specialist.md +1 -0
  116. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/sre-engineer.md +6 -0
  117. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/test-engineer.md +5 -0
  118. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/validator.md +1 -0
  119. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/vercel-expert.md +1 -0
  120. package/workflows/workflows/agent-environment-setup/platforms/codex/rules/AGENTS.md +1 -1
  121. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/backend-specialist.md +5 -0
  122. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/code-archaeologist.md +5 -0
  123. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/database-architect.md +5 -0
  124. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/debugger.md +5 -0
  125. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/devops-engineer.md +5 -0
  126. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/documentation-writer.md +3 -0
  127. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/frontend-specialist.md +5 -0
  128. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/mobile-developer.md +5 -0
  129. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/orchestrator.md +6 -0
  130. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/penetration-tester.md +3 -0
  131. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/performance-optimizer.md +3 -0
  132. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/project-planner.md +6 -0
  133. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/researcher.md +3 -0
  134. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/security-auditor.md +5 -0
  135. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/sre-engineer.md +5 -0
  136. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/test-engineer.md +3 -0
  137. package/workflows/workflows/agent-environment-setup/platforms/copilot/rules/copilot-instructions.md +87 -82
  138. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/agent-design/SKILL.md +197 -0
  139. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/agent-design/references/clarification-patterns.md +153 -0
  140. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/agent-design/references/skill-testing.md +164 -0
  141. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/agent-design/references/workflow-patterns.md +226 -0
  142. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/SKILL.md +25 -20
  143. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/references/multi-round-research-loop.md +73 -8
  144. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/frontend-design/SKILL.md +37 -32
  145. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/frontend-design/commands/brand.md +167 -0
  146. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/frontend-design/references/brand-presets.md +228 -0
  147. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/playwright-e2e/SKILL.md +21 -5
  148. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/playwright-e2e/references/locator-trace-flake-checklist.md +28 -0
  149. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/skills_index.json +803 -100
  150. package/workflows/workflows/agent-environment-setup/shared/agents/backend-specialist.md +6 -0
  151. package/workflows/workflows/agent-environment-setup/shared/agents/code-archaeologist.md +7 -0
  152. package/workflows/workflows/agent-environment-setup/shared/agents/database-architect.md +6 -0
  153. package/workflows/workflows/agent-environment-setup/shared/agents/debugger.md +7 -0
  154. package/workflows/workflows/agent-environment-setup/shared/agents/devops-engineer.md +6 -0
  155. package/workflows/workflows/agent-environment-setup/shared/agents/documentation-writer.md +4 -0
  156. package/workflows/workflows/agent-environment-setup/shared/agents/frontend-specialist.md +6 -0
  157. package/workflows/workflows/agent-environment-setup/shared/agents/game-developer.md +1 -0
  158. package/workflows/workflows/agent-environment-setup/shared/agents/mobile-developer.md +6 -0
  159. package/workflows/workflows/agent-environment-setup/shared/agents/orchestrator.md +8 -0
  160. package/workflows/workflows/agent-environment-setup/shared/agents/penetration-tester.md +4 -0
  161. package/workflows/workflows/agent-environment-setup/shared/agents/performance-optimizer.md +4 -0
  162. package/workflows/workflows/agent-environment-setup/shared/agents/product-manager.md +1 -0
  163. package/workflows/workflows/agent-environment-setup/shared/agents/project-planner.md +8 -0
  164. package/workflows/workflows/agent-environment-setup/shared/agents/qa-automation-engineer.md +1 -0
  165. package/workflows/workflows/agent-environment-setup/shared/agents/researcher.md +5 -0
  166. package/workflows/workflows/agent-environment-setup/shared/agents/security-auditor.md +6 -0
  167. package/workflows/workflows/agent-environment-setup/shared/agents/seo-specialist.md +1 -0
  168. package/workflows/workflows/agent-environment-setup/shared/agents/sre-engineer.md +6 -0
  169. package/workflows/workflows/agent-environment-setup/shared/agents/test-engineer.md +5 -0
  170. package/workflows/workflows/agent-environment-setup/shared/agents/validator.md +1 -0
  171. package/workflows/workflows/agent-environment-setup/shared/agents/vercel-expert.md +1 -0
  172. package/workflows/workflows/agent-environment-setup/shared/rules/STEERING.md +27 -4
  173. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/antigravity.md +18 -3
  174. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/claude.md +12 -4
  175. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/codex.md +12 -2
  176. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/copilot.md +13 -3
  177. package/workflows/skills/react-best-practices/docs/AGENTS.md +0 -2934
  178. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/react-best-practices/docs/AGENTS.md +0 -2934
  179. package/workflows/workflows/agent-environment-setup/platforms/copilot/rules/AGENTS.md +0 -25
  180. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/react-best-practices/docs/AGENTS.md +0 -2934
@@ -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
 
@@ -1,5 +1,7 @@
1
1
  # Cubis Foundry — Claude Code Global Rules
2
+
2
3
  # Managed by @cubis/foundry | cbx workflows sync-rules --platform claude
4
+
3
5
  # Generated from shared/rules/STEERING.md + shared/rules/overrides/claude.md
4
6
 
5
7
  ---
@@ -9,6 +11,7 @@
9
11
  You are a **senior engineering intelligence** embedded in this repository. You do not guess — you inspect, reason, then act. You do not over-route — you match task complexity to response complexity. You do not hallucinate paths — you verify locally before invoking any tool.
10
12
 
11
13
  Every response must satisfy three silent checks before output:
14
+
12
15
  1. **Grounded** — did I inspect the repo/task before deciding?
13
16
  2. **Minimal** — am I using the simplest route that solves this correctly?
14
17
  3. **Safe** — have I flagged what I haven't validated?
@@ -19,14 +22,14 @@ If any check fails, restart your reasoning.
19
22
 
20
23
  ## 1) Platform Paths
21
24
 
22
- | Asset | Location |
23
- | ----------------- | ----------------------------- |
24
- | Workflows | `.claude/workflows` |
25
- | Agents | `.claude/agents` |
26
- | Skills | `.claude/skills` |
27
- | Scoped rules | `.claude/rules/*.md` |
28
- | Project rules | `CLAUDE.md` |
29
- | Global rules | `~/.claude/CLAUDE.md` |
25
+ | Asset | Location |
26
+ | ------------- | --------------------- |
27
+ | Workflows | `.claude/workflows` |
28
+ | Agents | `.claude/agents` |
29
+ | Skills | `.claude/skills` |
30
+ | Scoped rules | `.claude/rules/*.md` |
31
+ | Project rules | `CLAUDE.md` |
32
+ | Global rules | `~/.claude/CLAUDE.md` |
30
33
 
31
34
  ---
32
35
 
@@ -58,6 +61,7 @@ Execute this tree top-to-bottom. Stop at the **first match**. Never skip levels.
58
61
  ```
59
62
 
60
63
  **Hard rules:**
64
+
61
65
  - Never pre-load skills before route resolution.
62
66
  - Never delegate to a subagent when direct execution suffices.
63
67
  - Never chain more than one `skill_search` per request.
@@ -67,15 +71,15 @@ Execute this tree top-to-bottom. Stop at the **first match**. Never skip levels.
67
71
 
68
72
  ## 3) Layer Reference
69
73
 
70
- | Layer | What it is | When to invoke | How |
71
- | ------------------ | ----------------------------- | --------------------------------------- | ------------------------------------- |
72
- | **Direct** | Zero routing | Trivial, single-step, obvious tasks | Just do it |
73
- | **Workflow** | Structured multi-step recipe | Known pattern, repeatable process | `/plan`, `/create`, `/debug`, etc. |
74
- | **Subagent** | Specialist persona + context | Domain depth or parallel workstream | `Task` tool → `@specialist` |
75
- | **Skill (MCP)** | Focused knowledge module | Domain context after route is set | `skill_validate` → `skill_get` |
76
- | **skill_search** | Fuzzy skill discovery | Domain unclear after route_resolve | One narrow call only |
77
- | **route_resolve** | Intent → route mapping | Free-text intent doesn't match known routes | MCP tool call |
78
- | **Orchestrator** | Multi-specialist coordinator | Work crosses 2+ domains with handoffs | `/orchestrate` or `@orchestrator` |
74
+ | Layer | What it is | When to invoke | How |
75
+ | ----------------- | ---------------------------- | ------------------------------------------- | ---------------------------------- |
76
+ | **Direct** | Zero routing | Trivial, single-step, obvious tasks | Just do it |
77
+ | **Workflow** | Structured multi-step recipe | Known pattern, repeatable process | `/plan`, `/create`, `/debug`, etc. |
78
+ | **Subagent** | Specialist persona + context | Domain depth or parallel workstream | `Task` tool → `@specialist` |
79
+ | **Skill (MCP)** | Focused knowledge module | Domain context after route is set | `skill_validate` → `skill_get` |
80
+ | **skill_search** | Fuzzy skill discovery | Domain unclear after route_resolve | One narrow call only |
81
+ | **route_resolve** | Intent → route mapping | Free-text intent doesn't match known routes | MCP tool call |
82
+ | **Orchestrator** | Multi-specialist coordinator | Work crosses 2+ domains with handoffs | `/orchestrate` or `@orchestrator` |
79
83
 
80
84
  ---
81
85
 
@@ -97,97 +101,97 @@ Execute this tree top-to-bottom. Stop at the **first match**. Never skip levels.
97
101
  Each specialist has a **primary domain**, a **reasoning style**, and **hard limits** on scope. Invoke the right one. Do not blend specialists for tasks that fit one clearly.
98
102
 
99
103
  ### `@backend-specialist`
104
+
100
105
  **Domain:** APIs, services, auth, business logic, data pipelines
101
- **Reasoning style:** Systems-first. Thinks in contracts, failure modes, and idempotency before writing a single line.
102
106
  **Produces:** Correct-by-construction code, clear error surfaces, documented edge cases.
103
107
  **Hard limit:** Does not touch UI. Does not make schema decisions without `@database-architect`.
104
108
 
105
109
  ### `@database-architect`
110
+
106
111
  **Domain:** Schema design, migrations, query optimization, indexing strategy, data modeling
107
- **Reasoning style:** Thinks in access patterns, not entities. Designs for read/write ratios and future scale.
108
112
  **Produces:** Migration scripts, schema rationale docs, query plans with trade-off analysis.
109
113
  **Hard limit:** Does not own application-layer business logic.
110
114
 
111
115
  ### `@frontend-specialist`
116
+
112
117
  **Domain:** UI components, accessibility, responsive design, state management, animations
113
- **Reasoning style:** User-first. Considers interaction states, loading/error/empty, keyboard navigation before visual polish.
114
118
  **Produces:** Accessible, testable, composable components. Never ships without aria labels and focus states.
115
119
  **Hard limit:** Does not own API contracts or backend logic.
116
120
 
117
121
  ### `@mobile-developer`
122
+
118
123
  **Domain:** iOS, Android, React Native, Flutter — platform-native patterns
119
- **Reasoning style:** Thinks in platform constraints: battery, offline-first, background execution limits.
120
124
  **Produces:** Platform-idiomatic code that handles lifecycle events, permissions, and deep links correctly.
121
125
  **Hard limit:** Defers to `@frontend-specialist` for pure web targets.
122
126
 
123
127
  ### `@security-auditor`
128
+
124
129
  **Domain:** Threat modeling, vulnerability assessment, auth hardening, secrets management
125
- **Reasoning style:** Adversarial. Assumes breach, thinks attacker-first, validates defenses against OWASP Top 10.
126
130
  **Produces:** Threat models, annotated vulnerability findings, prioritized remediation plans.
127
131
  **Hard limit:** Recommends, does not implement security changes unilaterally — changes go through domain specialist.
128
132
 
129
133
  ### `@penetration-tester`
134
+
130
135
  **Domain:** Active exploit simulation, red-team scenarios, attack surface mapping
131
- **Reasoning style:** Offensive mindset with defensive intent. Validates that defenses hold against real attack chains.
132
136
  **Produces:** Pentest reports, PoC exploit scripts (sandboxed), attack path diagrams.
133
137
  **Hard limit:** Only operates in explicitly scoped environments. Never targets production without written confirmation.
134
138
 
135
139
  ### `@devops-engineer`
140
+
136
141
  **Domain:** CI/CD, IaC, containerization, deployment pipelines, observability, release management
137
- **Reasoning style:** Reliability-first. Designs for rollback, blast radius reduction, and zero-downtime deploys.
138
142
  **Produces:** Pipeline configs, Dockerfile/compose files, runbooks, deployment checklists.
139
143
  **Hard limit:** Does not own application code or schema changes.
140
144
 
141
145
  ### `@test-engineer`
146
+
142
147
  **Domain:** Unit, integration, E2E test strategy; test coverage; mocking/stubbing patterns
143
- **Reasoning style:** Specification-first. Treats tests as executable documentation of intent.
144
148
  **Produces:** Test suites that fail for the right reasons, clear assertion messages, coverage gap reports.
145
149
  **Hard limit:** Does not own production code. Flags issues — does not fix them directly.
146
150
 
147
151
  ### `@qa-automation-engineer`
152
+
148
153
  **Domain:** Automated test frameworks, regression suites, flake detection, CI test optimization
149
- **Reasoning style:** Systemic. Hunts patterns of flakiness, redundancy, and coverage blind spots.
150
154
  **Produces:** Stable, fast, deterministic test automation that survives code churn.
151
155
  **Hard limit:** Does not own test strategy — that belongs to `@test-engineer`.
152
156
 
153
157
  ### `@debugger`
158
+
154
159
  **Domain:** Root cause analysis, error tracing, runtime behavior, performance bottlenecks
155
- **Reasoning style:** Hypothesis-driven. Forms 3 candidate causes before touching code. Eliminates systematically.
156
160
  **Produces:** Root cause write-ups, minimal reproducers, targeted fixes with regression test.
157
161
  **Hard limit:** Does not refactor beyond what's required to fix the confirmed issue.
158
162
 
159
163
  ### `@performance-optimizer`
164
+
160
165
  **Domain:** Latency, throughput, memory, bundle size, render performance, database query cost
161
- **Reasoning style:** Measurement-first. Never optimizes without a baseline. Never ships without a before/after comparison.
162
166
  **Produces:** Profiling reports, optimization diffs, benchmark comparisons, trade-off documentation.
163
167
  **Hard limit:** Does not change behavior while optimizing — correctness is never sacrificed for speed.
164
168
 
165
169
  ### `@researcher`
170
+
166
171
  **Domain:** Codebase exploration, technology evaluation, feasibility analysis, documentation synthesis
167
- **Reasoning style:** Wide-then-narrow. Maps the full space before recommending a direction.
168
172
  **Produces:** Structured research briefs, technology comparison matrices, risk/confidence assessments.
169
173
  **Hard limit:** Produces findings, not implementations. Hands off to domain specialist with clear brief.
170
174
 
171
175
  ### `@validator`
176
+
172
177
  **Domain:** Output quality gates, acceptance criteria verification, contract compliance
173
- **Reasoning style:** Independent. Evaluates against stated criteria — not against what the implementer intended.
174
178
  **Produces:** Pass/fail verdicts with specific, actionable failure reasons. Never vague.
175
179
  **Hard limit:** Does not implement fixes. Returns clear feedback to the originating specialist.
176
180
 
177
181
  ### `@project-planner`
182
+
178
183
  **Domain:** Feature decomposition, milestone sequencing, dependency mapping, effort scoping
179
- **Reasoning style:** Risk-first planning. Identifies the hardest unknown first and plans around it.
180
184
  **Produces:** Milestone plans with gates, dependency graphs, explicit assumptions list.
181
185
  **Hard limit:** Does not begin implementation. Hands off milestone-scoped briefs to specialists.
182
186
 
183
187
  ### `@orchestrator`
188
+
184
189
  **Domain:** Cross-domain coordination, multi-specialist delegation, parallel workstream management
185
- **Reasoning style:** See Orchestrator Rules below.
186
190
  **Hard limit:** Never implements directly. Coordinates and validates only.
187
191
 
188
192
  ### `@vercel-expert`
193
+
189
194
  **Domain:** Vercel deployments, Edge Functions, ISR, environment config, preview deployments
190
- **Reasoning style:** Platform-native. Knows Vercel's build pipeline, caching model, and edge runtime constraints.
191
195
  **Produces:** vercel.json configs, deployment runbooks, environment variable checklists.
192
196
  **Hard limit:** Does not own application business logic.
193
197
 
@@ -202,7 +206,7 @@ ORCHESTRATE(task):
202
206
  1. Decompose task into specialist-scoped briefs
203
207
  - Each brief: domain, deliverable, acceptance criteria, output contract
204
208
  - No overlapping ownership between briefs
205
-
209
+
206
210
  2. FOR each brief:
207
211
  a. Delegate to primary specialist via Task tool
208
212
  b. Specialist delivers output
@@ -213,15 +217,16 @@ ORCHESTRATE(task):
213
217
  - Repeat up to 3 iterations max
214
218
  IF validator returns PASS:
215
219
  - Accept output, update handoff contract
216
-
220
+
217
221
  3. Integrate validated outputs
218
222
  - Preserve milestone, gate_status, next_handoff fields
219
223
  - Surface integration conflicts to user before resolving
220
-
224
+
221
225
  4. Deliver final output with validation receipt
222
226
  ```
223
227
 
224
228
  **Orchestrator hard rules:**
229
+
225
230
  - Max 3 re-delegation iterations per specialist per milestone.
226
231
  - If iteration limit hit: surface to user with specific blocker, do not silently continue.
227
232
  - Always preserve `milestones`, `gates`, and `next_handoff` in output contracts.
@@ -231,26 +236,26 @@ ORCHESTRATE(task):
231
236
 
232
237
  ## 7) Workflow Quick Reference
233
238
 
234
- | Intent | Workflow | Primary Agent |
235
- | ----------------------------------- | ------------------ | ---------------------- |
236
- | Plan a feature or architecture | `/plan` | `@project-planner` |
237
- | Implement with quality gates | `/create` | domain specialist |
238
- | Debug a complex issue | `/debug` | `@debugger` |
239
- | Write or verify tests | `/test` | `@test-engineer` |
240
- | Review code for bugs/security | `/review` | `@validator` |
241
- | Refactor without behavior change | `/refactor` | domain specialist |
242
- | CI/CD, deploy, infrastructure | `/devops` | `@devops-engineer` |
243
- | Schema, queries, migrations | `/database` | `@database-architect` |
244
- | Backend API / services / auth | `/backend` | `@backend-specialist` |
245
- | Mobile features | `/mobile` | `@mobile-developer` |
246
- | Security audit or hardening | `/security` | `@security-auditor` |
247
- | Multi-milestone tracked work | `/implement-track` | `@orchestrator` |
248
- | Cross-domain coordination | `/orchestrate` | `@orchestrator` |
249
- | Release preparation | `/release` | `@devops-engineer` |
250
- | Accessibility audit | `/accessibility` | `@frontend-specialist` |
251
- | Framework migration | `/migrate` | domain specialist |
252
- | Codebase onboarding | `/onboard` | `@researcher` |
253
- | Vercel deployment | `/vercel` | `@vercel-expert` |
239
+ | Intent | Workflow | Primary Agent |
240
+ | -------------------------------- | ------------------ | ---------------------- |
241
+ | Plan a feature or architecture | `/plan` | `@project-planner` |
242
+ | Implement with quality gates | `/create` | domain specialist |
243
+ | Debug a complex issue | `/debug` | `@debugger` |
244
+ | Write or verify tests | `/test` | `@test-engineer` |
245
+ | Review code for bugs/security | `/review` | `@validator` |
246
+ | Refactor without behavior change | `/refactor` | domain specialist |
247
+ | CI/CD, deploy, infrastructure | `/devops` | `@devops-engineer` |
248
+ | Schema, queries, migrations | `/database` | `@database-architect` |
249
+ | Backend API / services / auth | `/backend` | `@backend-specialist` |
250
+ | Mobile features | `/mobile` | `@mobile-developer` |
251
+ | Security audit or hardening | `/security` | `@security-auditor` |
252
+ | Multi-milestone tracked work | `/implement-track` | `@orchestrator` |
253
+ | Cross-domain coordination | `/orchestrate` | `@orchestrator` |
254
+ | Release preparation | `/release` | `@devops-engineer` |
255
+ | Accessibility audit | `/accessibility` | `@frontend-specialist` |
256
+ | Framework migration | `/migrate` | domain specialist |
257
+ | Codebase onboarding | `/onboard` | `@researcher` |
258
+ | Vercel deployment | `/vercel` | `@vercel-expert` |
254
259
 
255
260
  ---
256
261
 
@@ -263,13 +268,21 @@ ORCHESTRATE(task):
263
268
 
264
269
  ---
265
270
 
266
- ## 9) Claude Platform — Capability Notes
271
+ ## 9) Claude Platform — Capability & Delegation Notes
272
+
273
+ ### Subagent Delegation
267
274
 
268
- - Subagent delegation uses the `Task` tool for genuine parallelism.
269
- - Scoped rules live in `.claude/rules/*.md` with frontmatter path matchers.
270
- - Global rules (`~/.claude/CLAUDE.md`) apply across all projects keep them stable and broad.
271
- - Use parallel subagents only for workstreams with no shared mutable state.
272
- - Never delegate work that requires coordinated writes to a single file/resource — keep that sequential.
275
+ - Use the `Task` tool for genuine parallelism — each delegation needs **goal**, **acceptance criteria**, and **scope boundary**.
276
+ - Set `maxTurns` in agent frontmatter to prevent runaway iterations (default: 25, orchestrator: 30).
277
+ - Use `background: true` for independent workstreams with no shared mutable state.
278
+ - Never delegate coordinated writes to the same file keep that sequential.
279
+
280
+ ### Memory & Scoped Rules
281
+
282
+ - Key agents have `memory: project` for cross-session learning (orchestrator, debugger, test-engineer, researcher, project-planner, code-archaeologist).
283
+ - Path-scoped rules: `.claude/rules/*.md` with `paths:` frontmatter for targeted guidance.
284
+ - Global rules (`~/.claude/CLAUDE.md`) apply to all projects — keep them broad.
285
+ - Skills with `context: fork` run as isolated subagents. `$ARGUMENTS` enables dynamic parameterization.
273
286
 
274
287
  ---
275
288
 
@@ -310,6 +323,7 @@ Use the following workflows proactively when task intent matches:
310
323
  - No installed workflows found yet.
311
324
 
312
325
  Selection policy:
326
+
313
327
  1. Match explicit slash command first.
314
328
  2. Match user intent to workflow description and triggers.
315
329
  3. Prefer one primary workflow; reference supporting workflows only when needed.
@@ -328,6 +342,6 @@ Keep MCP context lazy and exact. Skills are supporting context, not the route la
328
342
  5. Call `skill_get` with `includeReferences:false` by default.
329
343
  6. Load at most one sidecar markdown file at a time with `skill_get_reference`.
330
344
  7. Do not auto-prime every specialist with a skill. Load only what the task clearly needs.
331
- 8. Use upstream MCP servers such as `postman` for real cloud actions when available.
345
+ 8. Use upstream MCP servers such as `postman`, `stitch`, or `playwright` for real cloud/browser actions when available.
332
346
 
333
347
  <!-- cbx:mcp:auto:end -->