arkaos 4.7.0 → 4.8.0

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 (388) hide show
  1. package/VERSION +1 -1
  2. package/arka/SKILL.md +2 -2
  3. package/arka/skills/bootstrap-agent/SKILL.md +11 -7
  4. package/arka/skills/checkpoint/SKILL.md +10 -4
  5. package/arka/skills/comfyui/SKILL.md +11 -8
  6. package/arka/skills/conclave/SKILL.md +11 -3
  7. package/arka/skills/costs/SKILL.md +2 -3
  8. package/arka/skills/design-ops/SKILL.md +11 -5
  9. package/arka/skills/dreams/SKILL.md +10 -4
  10. package/arka/skills/flow/SKILL.md +1 -1
  11. package/arka/skills/forge/SKILL.md +6 -8
  12. package/arka/skills/fusion/SKILL.md +11 -7
  13. package/arka/skills/human-writing/SKILL.md +11 -13
  14. package/arka/skills/research/SKILL.md +8 -10
  15. package/bin/arka-py.ps1 +9 -2
  16. package/config/claude-agents/affiliate-manager.md +50 -0
  17. package/config/claude-agents/ai-engineering-lead.md +52 -0
  18. package/config/claude-agents/architect.md +1 -1
  19. package/config/claude-agents/automation-engineer.md +50 -0
  20. package/config/claude-agents/brand-director.md +51 -0
  21. package/config/claude-agents/brand-strategist.md +50 -0
  22. package/config/claude-agents/business-model-designer.md +50 -0
  23. package/config/claude-agents/cfo.md +50 -0
  24. package/config/claude-agents/chief-of-staff.md +51 -0
  25. package/config/claude-agents/commerce-engineer.md +50 -0
  26. package/config/claude-agents/community-manager.md +50 -0
  27. package/config/claude-agents/community-strategist.md +50 -0
  28. package/config/claude-agents/content-marketer.md +50 -0
  29. package/config/claude-agents/content-strategist.md +50 -0
  30. package/config/claude-agents/conversion-strategist.md +50 -0
  31. package/config/claude-agents/coo.md +50 -0
  32. package/config/claude-agents/cs-manager.md +50 -0
  33. package/config/claude-agents/cto.md +51 -0
  34. package/config/claude-agents/culture-coach.md +50 -0
  35. package/config/claude-agents/data-collector.md +50 -0
  36. package/config/claude-agents/decision-quality.md +51 -0
  37. package/config/claude-agents/design-ops-lead.md +51 -0
  38. package/config/claude-agents/devops-eng.md +1 -1
  39. package/config/claude-agents/doc-writer.md +50 -0
  40. package/config/claude-agents/ecom-cro-specialist.md +50 -0
  41. package/config/claude-agents/ecom-director.md +50 -0
  42. package/config/claude-agents/engagement-designer.md +50 -0
  43. package/config/claude-agents/etl-eng.md +52 -0
  44. package/config/claude-agents/extraction-script-writer.md +51 -0
  45. package/config/claude-agents/financial-analyst.md +49 -0
  46. package/config/claude-agents/growth-engineer.md +50 -0
  47. package/config/claude-agents/hr-specialist.md +50 -0
  48. package/config/claude-agents/investment-strategist.md +50 -0
  49. package/config/claude-agents/knowledge-curator.md +51 -0
  50. package/config/claude-agents/knowledge-director.md +51 -0
  51. package/config/claude-agents/landing-cro-specialist.md +50 -0
  52. package/config/claude-agents/laravel-eng.md +52 -0
  53. package/config/claude-agents/leadership-director.md +50 -0
  54. package/config/claude-agents/market-analyst.md +50 -0
  55. package/config/claude-agents/marketing-director.md +50 -0
  56. package/config/claude-agents/metrics-analyst.md +50 -0
  57. package/config/claude-agents/node-ts-eng.md +52 -0
  58. package/config/claude-agents/okr-steward.md +51 -0
  59. package/config/claude-agents/ops-lead.md +50 -0
  60. package/config/claude-agents/org-designer.md +49 -0
  61. package/config/claude-agents/paid-specialist.md +50 -0
  62. package/config/claude-agents/people-ops.md +50 -0
  63. package/config/claude-agents/pm-director.md +52 -0
  64. package/config/claude-agents/product-owner.md +52 -0
  65. package/config/claude-agents/python-eng.md +52 -0
  66. package/config/claude-agents/repurpose-distributor.md +50 -0
  67. package/config/claude-agents/research-analyst.md +50 -0
  68. package/config/claude-agents/retention-manager.md +50 -0
  69. package/config/claude-agents/revops-lead.md +51 -0
  70. package/config/claude-agents/saas-strategist.md +50 -0
  71. package/config/claude-agents/sales-closer.md +50 -0
  72. package/config/claude-agents/sales-copywriter.md +51 -0
  73. package/config/claude-agents/sales-director.md +50 -0
  74. package/config/claude-agents/sales-ops.md +49 -0
  75. package/config/claude-agents/scriptwriter.md +50 -0
  76. package/config/claude-agents/scrum-master.md +50 -0
  77. package/config/claude-agents/sdr.md +51 -0
  78. package/config/claude-agents/security-eng.md +1 -1
  79. package/config/claude-agents/seo-specialist.md +50 -0
  80. package/config/claude-agents/shadcn-padronizer.md +51 -0
  81. package/config/claude-agents/strategic-pm.md +51 -0
  82. package/config/claude-agents/strategy-director.md +51 -0
  83. package/config/claude-agents/ux-designer.md +50 -0
  84. package/config/claude-agents/ux-researcher.md +51 -0
  85. package/config/claude-agents/ux-strategist.md +51 -0
  86. package/config/claude-agents/viral-engineer.md +50 -0
  87. package/config/claude-agents/visual-designer.md +50 -0
  88. package/config/claude-agents/wcag-auditor.md +51 -0
  89. package/config/hooks/user-prompt-submit.sh +7 -0
  90. package/core/agents/__pycache__/behavioral_compiler.cpython-313.pyc +0 -0
  91. package/core/agents/behavioral_compiler.py +66 -34
  92. package/core/budget/__pycache__/__init__.cpython-314.pyc +0 -0
  93. package/core/budget/__pycache__/manager.cpython-314.pyc +0 -0
  94. package/core/budget/__pycache__/schema.cpython-314.pyc +0 -0
  95. package/core/forge/__pycache__/__init__.cpython-314.pyc +0 -0
  96. package/core/forge/__pycache__/complexity.cpython-314.pyc +0 -0
  97. package/core/forge/__pycache__/handoff.cpython-314.pyc +0 -0
  98. package/core/forge/__pycache__/orchestrator.cpython-314.pyc +0 -0
  99. package/core/forge/__pycache__/persistence.cpython-314.pyc +0 -0
  100. package/core/forge/__pycache__/renderer.cpython-314.pyc +0 -0
  101. package/core/forge/__pycache__/runtime_dispatcher.cpython-314.pyc +0 -0
  102. package/core/forge/__pycache__/schema.cpython-314.pyc +0 -0
  103. package/core/governance/__pycache__/agent_experiences.cpython-314.pyc +0 -0
  104. package/core/governance/__pycache__/compliance_telemetry_cli.cpython-313.pyc +0 -0
  105. package/core/governance/__pycache__/enforcement_telemetry_cli.cpython-313.pyc +0 -0
  106. package/core/governance/__pycache__/phantom_action_check.cpython-313.pyc +0 -0
  107. package/core/governance/__pycache__/phantom_action_check.cpython-314.pyc +0 -0
  108. package/core/governance/__pycache__/qg_verdict.cpython-313.pyc +0 -0
  109. package/core/governance/__pycache__/quality_api.cpython-314.pyc +0 -0
  110. package/core/governance/__pycache__/quality_router.cpython-314.pyc +0 -0
  111. package/core/governance/__pycache__/review_workflow.cpython-314.pyc +0 -0
  112. package/core/governance/phantom_action_check.py +19 -4
  113. package/core/hooks/__pycache__/user_prompt_submit.cpython-313.pyc +0 -0
  114. package/core/hooks/__pycache__/user_prompt_submit.cpython-314.pyc +0 -0
  115. package/core/hooks/user_prompt_submit.py +9 -2
  116. package/core/knowledge/__pycache__/__init__.cpython-314.pyc +0 -0
  117. package/core/knowledge/__pycache__/chunker.cpython-314.pyc +0 -0
  118. package/core/knowledge/__pycache__/embedder.cpython-314.pyc +0 -0
  119. package/core/knowledge/__pycache__/pattern_cards.cpython-314.pyc +0 -0
  120. package/core/knowledge/__pycache__/vector_store.cpython-314.pyc +0 -0
  121. package/core/memory/__pycache__/rehydrator.cpython-314.pyc +0 -0
  122. package/core/runtime/__pycache__/claude_code.cpython-313.pyc +0 -0
  123. package/core/runtime/__pycache__/claude_code.cpython-314.pyc +0 -0
  124. package/core/runtime/__pycache__/codex_cli.cpython-313.pyc +0 -0
  125. package/core/runtime/__pycache__/codex_cli.cpython-314.pyc +0 -0
  126. package/core/runtime/__pycache__/gemini_cli.cpython-313.pyc +0 -0
  127. package/core/runtime/__pycache__/gemini_cli.cpython-314.pyc +0 -0
  128. package/core/runtime/__pycache__/subagent.cpython-313.pyc +0 -0
  129. package/core/runtime/claude_code.py +2 -1
  130. package/core/runtime/codex_cli.py +2 -0
  131. package/core/runtime/gemini_cli.py +2 -0
  132. package/core/runtime/subagent.py +11 -170
  133. package/core/synapse/__pycache__/agent_experiences_layer.cpython-312.pyc +0 -0
  134. package/core/synapse/__pycache__/agent_experiences_layer.cpython-313.pyc +0 -0
  135. package/core/synapse/__pycache__/agent_experiences_layer.cpython-314.pyc +0 -0
  136. package/core/synapse/__pycache__/engine.cpython-312.pyc +0 -0
  137. package/core/synapse/__pycache__/engine.cpython-313.pyc +0 -0
  138. package/core/synapse/__pycache__/engine.cpython-314.pyc +0 -0
  139. package/core/synapse/__pycache__/graph_context_layer.cpython-313.pyc +0 -0
  140. package/core/synapse/__pycache__/graph_context_layer.cpython-314.pyc +0 -0
  141. package/core/synapse/__pycache__/layers.cpython-312.pyc +0 -0
  142. package/core/synapse/__pycache__/layers.cpython-313.pyc +0 -0
  143. package/core/synapse/__pycache__/layers.cpython-314.pyc +0 -0
  144. package/core/synapse/__pycache__/pattern_library_layer.cpython-313.pyc +0 -0
  145. package/core/synapse/__pycache__/pattern_library_layer.cpython-314.pyc +0 -0
  146. package/core/synapse/agent_experiences_layer.py +4 -0
  147. package/core/synapse/engine.py +9 -0
  148. package/core/synapse/graph_context_layer.py +4 -0
  149. package/core/synapse/layers.py +28 -0
  150. package/core/synapse/pattern_library_layer.py +4 -0
  151. package/core/workflow/__init__.py +5 -3
  152. package/core/workflow/__pycache__/__init__.cpython-313.pyc +0 -0
  153. package/core/workflow/__pycache__/__init__.cpython-314.pyc +0 -0
  154. package/departments/brand/skills/archetype-finder/SKILL.md +7 -1
  155. package/departments/brand/skills/colors/SKILL.md +7 -1
  156. package/departments/brand/skills/design-system/SKILL.md +9 -2
  157. package/departments/brand/skills/identity-system/SKILL.md +8 -1
  158. package/departments/brand/skills/logo-brief/SKILL.md +7 -1
  159. package/departments/brand/skills/mockup-generate/SKILL.md +7 -1
  160. package/departments/brand/skills/naming-evaluate/SKILL.md +7 -1
  161. package/departments/brand/skills/positioning-statement/SKILL.md +8 -1
  162. package/departments/brand/skills/primal-audit/SKILL.md +7 -2
  163. package/departments/brand/skills/ux-audit/SKILL.md +8 -1
  164. package/departments/brand/skills/voice-guide/SKILL.md +8 -1
  165. package/departments/brand/skills/wireframe/SKILL.md +8 -1
  166. package/departments/community/skills/ai-community/SKILL.md +7 -1
  167. package/departments/community/skills/betting-setup/SKILL.md +7 -1
  168. package/departments/community/skills/business-model/SKILL.md +9 -2
  169. package/departments/community/skills/content-calendar/SKILL.md +8 -1
  170. package/departments/community/skills/events-plan/SKILL.md +7 -1
  171. package/departments/community/skills/gamification-design/SKILL.md +8 -1
  172. package/departments/community/skills/metrics-track/SKILL.md +8 -1
  173. package/departments/community/skills/moderation/SKILL.md +8 -1
  174. package/departments/community/skills/monetize-plan/SKILL.md +8 -1
  175. package/departments/community/skills/niche-setup/SKILL.md +9 -1
  176. package/departments/community/skills/onboarding-flow/SKILL.md +8 -1
  177. package/departments/community/skills/platform-select/SKILL.md +8 -1
  178. package/departments/community/skills/retention-system/SKILL.md +8 -2
  179. package/departments/content/skills/ai-workflow/SKILL.md +8 -1
  180. package/departments/content/skills/analytics/SKILL.md +8 -1
  181. package/departments/content/skills/calendar/SKILL.md +8 -1
  182. package/departments/content/skills/content-system/SKILL.md +8 -2
  183. package/departments/content/skills/hook-write/SKILL.md +8 -2
  184. package/departments/content/skills/monetization-plan/SKILL.md +8 -1
  185. package/departments/content/skills/newsletter-write/SKILL.md +7 -1
  186. package/departments/content/skills/platform-optimize/SKILL.md +9 -1
  187. package/departments/content/skills/repurpose-plan/SKILL.md +7 -1
  188. package/departments/content/skills/script-structure/SKILL.md +8 -1
  189. package/departments/content/skills/short-form/SKILL.md +8 -1
  190. package/departments/content/skills/thumbnail-package/SKILL.md +8 -1
  191. package/departments/content/skills/viral-design/SKILL.md +8 -2
  192. package/departments/content/skills/youtube-strategy/SKILL.md +9 -3
  193. package/departments/dev/skills/agent-design/SKILL.md +9 -2
  194. package/departments/dev/skills/agent-workflow/SKILL.md +9 -2
  195. package/departments/dev/skills/ai-assisted-dev/SKILL.md +7 -1
  196. package/departments/dev/skills/ai-security/SKILL.md +9 -2
  197. package/departments/dev/skills/api-design/SKILL.md +8 -2
  198. package/departments/dev/skills/app-test/SKILL.md +7 -3
  199. package/departments/dev/skills/architecture-design/SKILL.md +8 -2
  200. package/departments/dev/skills/changelog/SKILL.md +8 -1
  201. package/departments/dev/skills/ci-cd-pipeline/SKILL.md +7 -2
  202. package/departments/dev/skills/codebase-onboard/SKILL.md +8 -1
  203. package/departments/dev/skills/db-design/SKILL.md +8 -1
  204. package/departments/dev/skills/db-schema/SKILL.md +8 -2
  205. package/departments/dev/skills/ddd-model/SKILL.md +8 -1
  206. package/departments/dev/skills/demo-gif/SKILL.md +7 -3
  207. package/departments/dev/skills/dependency-audit/SKILL.md +8 -1
  208. package/departments/dev/skills/deploy/SKILL.md +8 -1
  209. package/departments/dev/skills/devops-pipeline/SKILL.md +8 -1
  210. package/departments/dev/skills/docs/SKILL.md +7 -1
  211. package/departments/dev/skills/env-secrets/SKILL.md +7 -1
  212. package/departments/dev/skills/incident/SKILL.md +8 -1
  213. package/departments/dev/skills/mcp/SKILL.md +8 -5
  214. package/departments/dev/skills/mcp-builder/SKILL.md +8 -2
  215. package/departments/dev/skills/observability/SKILL.md +8 -1
  216. package/departments/dev/skills/onboard/SKILL.md +8 -8
  217. package/departments/dev/skills/performance-audit/SKILL.md +8 -2
  218. package/departments/dev/skills/performance-profiler/SKILL.md +9 -2
  219. package/departments/dev/skills/rag-architect/SKILL.md +8 -2
  220. package/departments/dev/skills/red-team/SKILL.md +10 -1
  221. package/departments/dev/skills/refactor-plan/SKILL.md +8 -1
  222. package/departments/dev/skills/release/SKILL.md +8 -1
  223. package/departments/dev/skills/runbook/SKILL.md +8 -1
  224. package/departments/dev/skills/scaffold/SKILL.md +23 -16
  225. package/departments/dev/skills/security-audit/SKILL.md +9 -1
  226. package/departments/dev/skills/security-compliance/SKILL.md +8 -1
  227. package/departments/dev/skills/skill-audit/SKILL.md +9 -1
  228. package/departments/dev/skills/spec/SKILL.md +11 -14
  229. package/departments/dev/skills/stack-check/SKILL.md +8 -1
  230. package/departments/dev/skills/tdd-cycle/SKILL.md +8 -2
  231. package/departments/dev/skills/tech-debt/SKILL.md +8 -1
  232. package/departments/ecom/skills/analytics/SKILL.md +9 -1
  233. package/departments/ecom/skills/browse-competitor/SKILL.md +10 -3
  234. package/departments/ecom/skills/cart-recovery/SKILL.md +8 -1
  235. package/departments/ecom/skills/cro-optimize/SKILL.md +9 -2
  236. package/departments/ecom/skills/customer-journey/SKILL.md +8 -1
  237. package/departments/ecom/skills/ecommerce/SKILL.md +9 -8
  238. package/departments/ecom/skills/fulfillment-plan/SKILL.md +9 -1
  239. package/departments/ecom/skills/marketplace-manage/SKILL.md +9 -1
  240. package/departments/ecom/skills/pricing-strategy/SKILL.md +9 -1
  241. package/departments/ecom/skills/product-launch/SKILL.md +9 -3
  242. package/departments/ecom/skills/rfm-segment/SKILL.md +9 -2
  243. package/departments/ecom/skills/social-commerce/SKILL.md +8 -1
  244. package/departments/ecom/skills/store-audit/SKILL.md +9 -1
  245. package/departments/ecom/skills/subscription-model/SKILL.md +8 -1
  246. package/departments/finance/skills/budget-plan/SKILL.md +9 -1
  247. package/departments/finance/skills/cashflow-forecast/SKILL.md +9 -1
  248. package/departments/finance/skills/ciso-advisor/SKILL.md +9 -2
  249. package/departments/finance/skills/financial-model/SKILL.md +9 -2
  250. package/departments/finance/skills/pitch-deck/SKILL.md +9 -1
  251. package/departments/finance/skills/scenario-analysis/SKILL.md +8 -1
  252. package/departments/finance/skills/unit-economics/SKILL.md +9 -2
  253. package/departments/finance/skills/valuation-model/SKILL.md +9 -1
  254. package/departments/kb/skills/ai-research/SKILL.md +8 -1
  255. package/departments/kb/skills/competitive-intel/SKILL.md +8 -1
  256. package/departments/kb/skills/knowledge/SKILL.md +10 -9
  257. package/departments/kb/skills/knowledge-review/SKILL.md +7 -1
  258. package/departments/kb/skills/learn-content/SKILL.md +11 -1
  259. package/departments/kb/skills/moc-create/SKILL.md +7 -1
  260. package/departments/kb/skills/persona-build/SKILL.md +9 -4
  261. package/departments/kb/skills/research-plan/SKILL.md +9 -2
  262. package/departments/kb/skills/search-kb/SKILL.md +7 -1
  263. package/departments/kb/skills/source-evaluate/SKILL.md +8 -1
  264. package/departments/kb/skills/taxonomy-manage/SKILL.md +7 -1
  265. package/departments/kb/skills/write-as-persona/SKILL.md +8 -1
  266. package/departments/kb/skills/zettelkasten-process/SKILL.md +9 -2
  267. package/departments/landing/skills/ab-test/SKILL.md +7 -1
  268. package/departments/landing/skills/affiliate-bridge/SKILL.md +7 -1
  269. package/departments/landing/skills/awareness-diagnose/SKILL.md +8 -1
  270. package/departments/landing/skills/copy-framework/SKILL.md +7 -2
  271. package/departments/landing/skills/email-sequence/SKILL.md +7 -1
  272. package/departments/landing/skills/funnel-design/SKILL.md +8 -2
  273. package/departments/landing/skills/funnel-metrics/SKILL.md +7 -1
  274. package/departments/landing/skills/headline-write/SKILL.md +7 -1
  275. package/departments/landing/skills/landing-gen/SKILL.md +9 -3
  276. package/departments/landing/skills/launch-sequence/SKILL.md +7 -1
  277. package/departments/landing/skills/offer-create/SKILL.md +8 -2
  278. package/departments/landing/skills/optimize-page/SKILL.md +8 -1
  279. package/departments/landing/skills/page-architect/SKILL.md +7 -1
  280. package/departments/landing/skills/persuasion-apply/SKILL.md +9 -1
  281. package/departments/landing/skills/webinar-funnel/SKILL.md +8 -2
  282. package/departments/leadership/skills/change-manage/SKILL.md +8 -1
  283. package/departments/leadership/skills/conflict-resolve/SKILL.md +8 -1
  284. package/departments/leadership/skills/culture-audit/SKILL.md +7 -1
  285. package/departments/leadership/skills/delegation-matrix/SKILL.md +8 -1
  286. package/departments/leadership/skills/disc-assess/SKILL.md +8 -1
  287. package/departments/leadership/skills/feedback-give/SKILL.md +8 -1
  288. package/departments/leadership/skills/hiring-plan/SKILL.md +8 -1
  289. package/departments/leadership/skills/okr-define/SKILL.md +8 -2
  290. package/departments/leadership/skills/performance-review/SKILL.md +8 -1
  291. package/departments/leadership/skills/team-health/SKILL.md +8 -2
  292. package/departments/marketing/skills/ab-test/SKILL.md +7 -1
  293. package/departments/marketing/skills/analytics-report/SKILL.md +10 -1
  294. package/departments/marketing/skills/audience-segment/SKILL.md +8 -1
  295. package/departments/marketing/skills/calendar-plan/SKILL.md +8 -1
  296. package/departments/marketing/skills/cold-email/SKILL.md +8 -3
  297. package/departments/marketing/skills/competitor-analysis/SKILL.md +8 -1
  298. package/departments/marketing/skills/content-audit/SKILL.md +7 -1
  299. package/departments/marketing/skills/email-sequence/SKILL.md +9 -1
  300. package/departments/marketing/skills/marketing-automation/SKILL.md +7 -1
  301. package/departments/marketing/skills/paid-campaign/SKILL.md +8 -1
  302. package/departments/marketing/skills/programmatic-seo/SKILL.md +8 -3
  303. package/departments/marketing/skills/seo-audit/SKILL.md +8 -2
  304. package/departments/marketing/skills/social-strategy/SKILL.md +8 -1
  305. package/departments/ops/skills/bottleneck-find/SKILL.md +6 -2
  306. package/departments/ops/skills/dashboard-build/SKILL.md +7 -1
  307. package/departments/ops/skills/gdpr-compliance/SKILL.md +6 -1
  308. package/departments/ops/skills/gtd-setup/SKILL.md +6 -1
  309. package/departments/ops/skills/integration-design/SKILL.md +6 -1
  310. package/departments/ops/skills/iso27001/SKILL.md +7 -1
  311. package/departments/ops/skills/lean-audit/SKILL.md +6 -1
  312. package/departments/ops/skills/metrics-dashboard/SKILL.md +6 -1
  313. package/departments/ops/skills/n8n-flow/SKILL.md +6 -1
  314. package/departments/ops/skills/operations/SKILL.md +8 -8
  315. package/departments/ops/skills/quality-management/SKILL.md +6 -1
  316. package/departments/ops/skills/risk-management/SKILL.md +7 -1
  317. package/departments/ops/skills/soc2-compliance/SKILL.md +7 -1
  318. package/departments/ops/skills/sop-create/SKILL.md +6 -1
  319. package/departments/ops/skills/update/SKILL.md +8 -1
  320. package/departments/ops/skills/workflow-automate/SKILL.md +7 -2
  321. package/departments/ops/skills/zapier-flow/SKILL.md +6 -1
  322. package/departments/org/skills/compensation-plan/SKILL.md +7 -1
  323. package/departments/org/skills/culture-define/SKILL.md +8 -3
  324. package/departments/org/skills/decision-framework/SKILL.md +7 -1
  325. package/departments/org/skills/hiring-plan/SKILL.md +7 -1
  326. package/departments/org/skills/meeting-optimize/SKILL.md +7 -1
  327. package/departments/org/skills/okr-cadence/SKILL.md +7 -3
  328. package/departments/org/skills/onboarding-design/SKILL.md +7 -1
  329. package/departments/org/skills/org-design/SKILL.md +7 -1
  330. package/departments/org/skills/principles-audit/SKILL.md +8 -3
  331. package/departments/org/skills/remote-setup/SKILL.md +7 -1
  332. package/departments/org/skills/sop-process/SKILL.md +7 -1
  333. package/departments/org/skills/team-assess/SKILL.md +7 -1
  334. package/departments/pm/skills/agile-po/SKILL.md +10 -3
  335. package/departments/pm/skills/backlog-groom/SKILL.md +8 -1
  336. package/departments/pm/skills/discovery-plan/SKILL.md +10 -2
  337. package/departments/pm/skills/estimate-forecast/SKILL.md +9 -1
  338. package/departments/pm/skills/impact-map/SKILL.md +9 -1
  339. package/departments/pm/skills/kanban-setup/SKILL.md +7 -1
  340. package/departments/pm/skills/risk-register/SKILL.md +9 -1
  341. package/departments/pm/skills/roadmap-build/SKILL.md +10 -4
  342. package/departments/pm/skills/shape-pitch/SKILL.md +8 -2
  343. package/departments/pm/skills/sprint-plan/SKILL.md +8 -1
  344. package/departments/pm/skills/stakeholder-map/SKILL.md +7 -1
  345. package/departments/pm/skills/standup-run/SKILL.md +8 -1
  346. package/departments/pm/skills/story-write/SKILL.md +8 -1
  347. package/departments/saas/skills/benchmark-compare/SKILL.md +8 -1
  348. package/departments/saas/skills/churn-analysis/SKILL.md +8 -1
  349. package/departments/saas/skills/customer-success/SKILL.md +9 -1
  350. package/departments/saas/skills/gtm-strategy/SKILL.md +9 -3
  351. package/departments/saas/skills/launch-execute/SKILL.md +8 -1
  352. package/departments/saas/skills/leaky-bucket/SKILL.md +8 -3
  353. package/departments/saas/skills/metrics-dashboard/SKILL.md +8 -1
  354. package/departments/saas/skills/micro-saas-stack/SKILL.md +8 -1
  355. package/departments/saas/skills/mvp-build/SKILL.md +8 -1
  356. package/departments/saas/skills/onboarding-optimize/SKILL.md +9 -1
  357. package/departments/saas/skills/plg-setup/SKILL.md +9 -2
  358. package/departments/saas/skills/pricing-strategy/SKILL.md +9 -2
  359. package/departments/saas/skills/saas-scaffold/SKILL.md +8 -3
  360. package/departments/saas/skills/voc-loop/SKILL.md +10 -3
  361. package/departments/sales/skills/challenger-sell/SKILL.md +7 -1
  362. package/departments/sales/skills/deal-qualify/SKILL.md +7 -1
  363. package/departments/sales/skills/discovery-call/SKILL.md +6 -1
  364. package/departments/sales/skills/forecast-revenue/SKILL.md +7 -1
  365. package/departments/sales/skills/negotiate-plan/SKILL.md +7 -1
  366. package/departments/sales/skills/objection-handle/SKILL.md +7 -1
  367. package/departments/sales/skills/pipeline-manage/SKILL.md +7 -1
  368. package/departments/sales/skills/pricing-negotiate/SKILL.md +7 -1
  369. package/departments/sales/skills/proposal-write/SKILL.md +7 -2
  370. package/departments/sales/skills/spin-sell/SKILL.md +8 -2
  371. package/departments/strategy/skills/blue-ocean/SKILL.md +9 -2
  372. package/departments/strategy/skills/bmc/SKILL.md +8 -1
  373. package/departments/strategy/skills/board-advisor/SKILL.md +10 -2
  374. package/departments/strategy/skills/cto-advisor/SKILL.md +9 -2
  375. package/departments/strategy/skills/extract-data/SKILL.md +9 -3
  376. package/departments/strategy/skills/five-forces/SKILL.md +9 -2
  377. package/departments/strategy/skills/moat-analysis/SKILL.md +8 -1
  378. package/departments/strategy/skills/position/SKILL.md +10 -1
  379. package/departments/strategy/skills/premortem/SKILL.md +9 -3
  380. package/departments/strategy/skills/scenario-plan/SKILL.md +9 -1
  381. package/knowledge/commands-registry.json +3006 -1676
  382. package/knowledge/commands-registry.json.bak +4121 -0
  383. package/package.json +1 -1
  384. package/pyproject.toml +1 -1
  385. package/scripts/__pycache__/synapse-bridge.cpython-314.pyc +0 -0
  386. package/scripts/tools/__pycache__/prompt_lint.cpython-313.pyc +0 -0
  387. package/core/workflow/announcer.py +0 -246
  388. package/core/workflow/engine.py +0 -260
@@ -1,31 +1,19 @@
1
- """Subagent Patternfresh agent instances per task.
1
+ """Subagent handoff artifact compacted context per dispatch.
2
2
 
3
3
  Each subagent gets a fresh context window, preventing context pollution
4
- between tasks. The orchestrator uses only 10-15% of its context to
5
- dispatch and collect results.
6
-
7
- Pattern: Orchestrator compacts task description + relevant context into
8
- a brief, dispatches to a subagent, and receives a structured result.
9
-
10
- Context budget:
11
- - Orchestrator: 10-15% of context window for dispatch + collection
12
- - Subagent: Full context window for task execution
13
- - Handoff artifact: ~379 tokens per agent switch (compacted persona + task)
4
+ between tasks. The orchestrator compacts task description + relevant
5
+ context into a brief (~379-token) artifact and dispatches via the
6
+ runtime's Task tool.
7
+
8
+ Dispatch itself is orchestrated by the runtime (hooks + skills + Task
9
+ tool); the former Python SubagentDispatcher had no production callers
10
+ and was removed (see docs/adr/2026-07-09-remove-dead-orchestration.md).
11
+ `HandoffArtifact` stays as the measured handoff contract consumed by
12
+ `scripts/bench/harness.py::bench_subagent_handoff` and
13
+ `core/runtime/context_compactor.py` builds its `context_summary`.
14
14
  """
15
15
 
16
16
  from dataclasses import dataclass, field
17
- from enum import Enum
18
- from typing import Optional, Any
19
-
20
- from core.agents.schema import Agent
21
-
22
-
23
- class SubagentStatus(str, Enum):
24
- PENDING = "pending"
25
- RUNNING = "running"
26
- COMPLETED = "completed"
27
- FAILED = "failed"
28
- TIMEOUT = "timeout"
29
17
 
30
18
 
31
19
  @dataclass
@@ -70,150 +58,3 @@ class HandoffArtifact:
70
58
  def estimated_tokens(self) -> int:
71
59
  """Estimate token count of this artifact."""
72
60
  return len(self.to_prompt().split())
73
-
74
-
75
- @dataclass
76
- class SubagentResult:
77
- """Result returned by a subagent."""
78
- task_id: str
79
- agent_id: str
80
- status: SubagentStatus
81
- output: str = ""
82
- files_modified: list[str] = field(default_factory=list)
83
- tokens_used: int = 0
84
- duration_ms: int = 0
85
- metadata: dict[str, Any] = field(default_factory=dict)
86
-
87
- def to_summary(self, max_tokens: int = 200) -> str:
88
- """Compact the result for the orchestrator's context.
89
-
90
- The orchestrator doesn't need the full output, just a summary
91
- to decide next steps.
92
- """
93
- words = self.output.split()
94
- if len(words) <= max_tokens:
95
- return self.output
96
- return " ".join(words[:max_tokens]) + "..."
97
-
98
-
99
- class SubagentDispatcher:
100
- """Dispatches tasks to fresh subagent instances.
101
-
102
- The dispatcher creates HandoffArtifacts from agent definitions
103
- and task descriptions, then delegates to the runtime adapter
104
- for actual execution.
105
-
106
- Nesting policy: Maximum 1 level of nesting (agent -> subagent).
107
- Sub-subagent dispatch is not recommended -- creates context fragmentation
108
- and debugging complexity. If a subagent needs help, it should escalate
109
- to its squad lead rather than spawning another subagent.
110
- """
111
-
112
- def __init__(self) -> None:
113
- self._pending: dict[str, HandoffArtifact] = {}
114
- self._results: dict[str, SubagentResult] = {}
115
- self._task_counter: int = 0
116
-
117
- def create_handoff(
118
- self,
119
- agent: Agent,
120
- task_description: str,
121
- relevant_files: list[str] | None = None,
122
- context_summary: str = "",
123
- constraints: list[str] | None = None,
124
- expected_output: str = "",
125
- ) -> HandoffArtifact:
126
- """Create a handoff artifact for a subagent dispatch.
127
-
128
- Args:
129
- agent: The agent to dispatch to.
130
- task_description: What the subagent should do.
131
- relevant_files: File paths the subagent should read.
132
- context_summary: Compacted context from prior work.
133
- Required when ARKAOS_STRICT_HANDOFF=1; otherwise emits a
134
- warning. Use ContextCompactor.build() to construct.
135
- constraints: Boundaries for the subagent.
136
- expected_output: What format/content is expected back.
137
-
138
- Returns:
139
- HandoffArtifact ready for dispatch.
140
- """
141
- import os, warnings
142
- if not context_summary or not context_summary.strip():
143
- msg = (
144
- "create_handoff called without context_summary — subagent will "
145
- "lack prior conversation context. Use ContextCompactor.build() "
146
- "to construct one. Set ARKAOS_STRICT_HANDOFF=1 to enforce."
147
- )
148
- if os.environ.get("ARKAOS_STRICT_HANDOFF") == "1":
149
- raise ValueError(msg)
150
- warnings.warn(msg, DeprecationWarning, stacklevel=2)
151
-
152
- self._task_counter += 1
153
- task_id = f"task-{self._task_counter}"
154
-
155
- disc_label = agent.behavioral_dna.disc.label
156
- quality = []
157
- if agent.tier <= 1:
158
- quality.append("Enterprise-grade quality expected")
159
- quality.append("Follow SOLID principles")
160
- quality.append("Human-readable output, no AI patterns")
161
-
162
- artifact = HandoffArtifact(
163
- task_id=task_id,
164
- task_description=task_description,
165
- agent_id=agent.id,
166
- agent_role=agent.role,
167
- agent_disc=disc_label,
168
- department=agent.department,
169
- relevant_files=relevant_files or [],
170
- context_summary=context_summary,
171
- constraints=constraints or [],
172
- expected_output=expected_output,
173
- quality_criteria=quality,
174
- )
175
-
176
- self._pending[task_id] = artifact
177
- return artifact
178
-
179
- def record_result(self, result: SubagentResult) -> None:
180
- """Record a subagent's result."""
181
- self._results[result.task_id] = result
182
- self._pending.pop(result.task_id, None)
183
-
184
- def get_result(self, task_id: str) -> Optional[SubagentResult]:
185
- """Get a subagent's result by task ID."""
186
- return self._results.get(task_id)
187
-
188
- def get_pending(self) -> list[HandoffArtifact]:
189
- """Get all pending (undispatched) handoffs."""
190
- return list(self._pending.values())
191
-
192
- def get_all_results(self) -> list[SubagentResult]:
193
- """Get all collected results."""
194
- return list(self._results.values())
195
-
196
- @property
197
- def pending_count(self) -> int:
198
- return len(self._pending)
199
-
200
- @property
201
- def completed_count(self) -> int:
202
- return len(self._results)
203
-
204
- def orchestrator_context_usage(self) -> dict:
205
- """Estimate how much context the orchestrator is using.
206
-
207
- Target: 10-15% of context window for dispatch + collection.
208
- """
209
- dispatch_tokens = sum(a.estimated_tokens for a in self._pending.values())
210
- result_tokens = sum(
211
- len(r.to_summary().split()) for r in self._results.values()
212
- )
213
- total = dispatch_tokens + result_tokens
214
- return {
215
- "dispatch_tokens": dispatch_tokens,
216
- "result_summary_tokens": result_tokens,
217
- "total_orchestrator_tokens": total,
218
- "tasks_dispatched": self._task_counter,
219
- }
@@ -46,6 +46,10 @@ class AgentExperiencesLayer(Layer):
46
46
  def name(self) -> str:
47
47
  return "AgentExperiences"
48
48
 
49
+ @property
50
+ def input_sensitive(self) -> bool:
51
+ return True
52
+
49
53
  @property
50
54
  def cache_ttl(self) -> int:
51
55
  return 30
@@ -8,6 +8,7 @@ Design goals:
8
8
  - Relevance filtering (skip irrelevant layers)
9
9
  """
10
10
 
11
+ import hashlib
11
12
  import time
12
13
  from dataclasses import dataclass, field
13
14
  from typing import Any
@@ -109,6 +110,14 @@ class SynapseEngine:
109
110
  def _compute_layer(self, layer: Layer, ctx: PromptContext) -> LayerResult:
110
111
  """Compute a single layer with caching."""
111
112
  cache_key = f"{layer.id}:{ctx.cwd}:{ctx.active_agent}"
113
+ if layer.input_sensitive:
114
+ # Input-dependent layers (hints, department, KB retrieval)
115
+ # must not serve one prompt's result to a different prompt
116
+ # within the TTL window.
117
+ digest = hashlib.sha1(
118
+ (ctx.user_input or "").encode("utf-8", "replace")
119
+ ).hexdigest()[:12]
120
+ cache_key += f":{digest}"
112
121
 
113
122
  # Check cache
114
123
  if layer.cache_ttl > 0:
@@ -141,6 +141,10 @@ class GraphContextLayer(Layer):
141
141
  def name(self) -> str:
142
142
  return "GraphContext"
143
143
 
144
+ @property
145
+ def input_sensitive(self) -> bool:
146
+ return True
147
+
144
148
  @property
145
149
  def cache_ttl(self) -> int:
146
150
  return 30
@@ -74,6 +74,18 @@ class Layer(ABC):
74
74
  """Cache TTL in seconds. 0 = no caching."""
75
75
  return 0
76
76
 
77
+ @property
78
+ def input_sensitive(self) -> bool:
79
+ """True when compute() depends on ctx.user_input.
80
+
81
+ Input-sensitive layers get the prompt hashed into their cache
82
+ key — without it, a cached result from one prompt is served for
83
+ a DIFFERENT prompt within the TTL window (found 2026-07-09: L5
84
+ served 'hello' hints for an explicit '/dev feature' command,
85
+ defeating its own slash-suppression rule).
86
+ """
87
+ return False
88
+
77
89
  @property
78
90
  def priority(self) -> int:
79
91
  """Layer priority (lower = computed first)."""
@@ -166,6 +178,10 @@ class DepartmentLayer(Layer):
166
178
  def name(self) -> str:
167
179
  return "Department"
168
180
 
181
+ @property
182
+ def input_sensitive(self) -> bool:
183
+ return True
184
+
169
185
  @property
170
186
  def priority(self) -> int:
171
187
  return 10
@@ -392,6 +408,10 @@ class CommandHintsLayer(Layer):
392
408
  def name(self) -> str:
393
409
  return "CommandHints"
394
410
 
411
+ @property
412
+ def input_sensitive(self) -> bool:
413
+ return True
414
+
395
415
  @property
396
416
  def cache_ttl(self) -> int:
397
417
  return 30
@@ -522,6 +542,10 @@ class KnowledgeRetrievalLayer(Layer):
522
542
  def name(self) -> str:
523
543
  return "KnowledgeRetrieval"
524
544
 
545
+ @property
546
+ def input_sensitive(self) -> bool:
547
+ return True
548
+
525
549
  @property
526
550
  def cache_ttl(self) -> int:
527
551
  return 30
@@ -1027,6 +1051,10 @@ class KBContextLayer(Layer):
1027
1051
  def name(self) -> str:
1028
1052
  return "KBContext"
1029
1053
 
1054
+ @property
1055
+ def input_sensitive(self) -> bool:
1056
+ return True
1057
+
1030
1058
  @property
1031
1059
  def cache_ttl(self) -> int:
1032
1060
  return 0
@@ -71,6 +71,10 @@ class PatternLibraryLayer(Layer):
71
71
  def name(self) -> str:
72
72
  return "PatternLibrary"
73
73
 
74
+ @property
75
+ def input_sensitive(self) -> bool:
76
+ return True
77
+
74
78
  @property
75
79
  def cache_ttl(self) -> int:
76
80
  return 60
@@ -1,10 +1,12 @@
1
- """YAML-based workflow engine for ArkaOS v2.
1
+ """YAML workflow definitions for ArkaOS v2.
2
2
 
3
3
  Declarative workflows with phases, conditions, gates, and parallelization.
4
+ The schema/loader pair is the contract for departments/*/workflows/*.yaml;
5
+ execution is orchestrated by the runtime (hooks + skills + Task tool), not
6
+ by a Python executor (see docs/adr/2026-07-09-remove-dead-orchestration.md).
4
7
  """
5
8
 
6
9
  from core.workflow.schema import Workflow, Phase, Gate, PhaseStatus
7
- from core.workflow.engine import WorkflowEngine
8
10
  from core.workflow.loader import load_workflow
9
11
  from core.workflow.state import (
10
12
  init_workflow as init_workflow_state,
@@ -17,7 +19,7 @@ from core.workflow.state import (
17
19
  )
18
20
 
19
21
  __all__ = [
20
- "Workflow", "Phase", "Gate", "PhaseStatus", "WorkflowEngine", "load_workflow",
22
+ "Workflow", "Phase", "Gate", "PhaseStatus", "load_workflow",
21
23
  "init_workflow_state", "get_workflow_state", "update_phase", "set_branch",
22
24
  "add_violation", "is_phase_completed", "clear_workflow",
23
25
  ]
@@ -1,7 +1,13 @@
1
1
  ---
2
2
  name: brand/archetype-finder
3
3
  description: >
4
- Identify brand archetype from the 12 Jungian archetypes with personality mapping.
4
+ Identifies a brand's archetype from the 12 Jungian archetypes and maps it to
5
+ personality traits, voice, and visual direction with real-world examples.
6
+ TRIGGER: "qual é o arquétipo da marca", "brand archetype", "define a
7
+ personalidade da marca", "archetype mapping", "que arquétipo somos", "/brand
8
+ archetype <brand>". SKIP: full identity package (strategy + verbal + visual)
9
+ -> brand/identity-system (archetype is one input, not the deliverable);
10
+ turning the personality into written tone rules -> brand/voice-guide.
5
11
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
12
  ---
7
13
 
@@ -1,7 +1,13 @@
1
1
  ---
2
2
  name: brand/colors
3
3
  description: >
4
- Color palette design: primary, secondary, accent, neutrals with contrast ratios.
4
+ Designs a brand color palette primary, secondary, accent, and neutrals
5
+ delivered with hex codes, usage guidelines, and WCAG contrast checks.
6
+ TRIGGER: "paleta de cores", "escolhe as cores da marca", "color palette",
7
+ "brand colors", "que cores combinam com esta marca", "/brand colors <mood>".
8
+ SKIP: palette as part of a full token and component system ->
9
+ brand/design-system (tokens, atomic catalog, WCAG gates for the whole UI);
10
+ complete brand identity from strategy up -> brand/identity-system.
5
11
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
12
  ---
7
13
 
@@ -1,8 +1,15 @@
1
1
  ---
2
2
  name: brand/design-system
3
3
  description: >
4
- Production design system specification: tokens, atoms, molecules, organisms,
5
- templates, and pages with WCAG AA conformance and Storybook export contract.
4
+ Ships a production design system in 5 deliverables: design-tokens.json
5
+ (primitive + semantic layers), an Atomic Design component catalog (atoms to
6
+ pages), WCAG 2.2 AA conformance report, Storybook CSF3 story stubs, and an
7
+ integration guide. TRIGGER: "design system", "cria o design system", "design
8
+ tokens", "component library", "biblioteca de componentes", "/brand
9
+ design-system". SKIP: only a color palette -> brand/colors; implementing the
10
+ components in application code -> dev frontend workflows (this skill
11
+ specifies the system, it does not build the app); reviewing an existing UI
12
+ against brand guidelines -> brand/design-review.
6
13
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
7
14
  ---
8
15
 
@@ -1,7 +1,14 @@
1
1
  ---
2
2
  name: brand/identity-system
3
3
  description: >
4
- Full brand identity: strategy, verbal, visual in the correct order (never skip to visuals).
4
+ Builds a full brand identity in the correct order strategy, then verbal,
5
+ then visual (never skips to visuals) — via the Wheeler process and Primal
6
+ Branding, verifying live brand elements through browser and Computer Use
7
+ steps. TRIGGER: "cria a identidade da marca", "brand identity", "identidade
8
+ visual completa", "rebranding completo", "build the brand from scratch",
9
+ "/brand identity <name>". SKIP: only a logo -> brand/logo-brief; only
10
+ positioning -> brand/positioning-statement; measuring an EXISTING brand's
11
+ strength -> brand/primal-audit (audit, not creation).
5
12
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
13
  ---
7
14
 
@@ -1,7 +1,13 @@
1
1
  ---
2
2
  name: brand/logo
3
3
  description: >
4
- Logo concept generation: brief, mood references, AI-generated concepts.
4
+ Generates logo concepts from a brief: mood references, AI-generated concept
5
+ directions, variations, rationale, and usage guidelines. TRIGGER: "logo
6
+ brief", "cria um logo", "desenha o logótipo", "logo concepts", "preciso de
7
+ um logo", "/brand logo <brief>". SKIP: logo as part of a whole identity
8
+ (strategy + verbal + visual) -> brand/identity-system (order matters, the
9
+ logo comes last); applying an existing logo to product, packaging, or social
10
+ scenes -> brand/mockup-generate.
5
11
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
12
  ---
7
13
 
@@ -1,7 +1,13 @@
1
1
  ---
2
2
  name: brand/mockup
3
3
  description: >
4
- Generate mockups: product, packaging, social, stationery with brand identity applied.
4
+ Generates brand-applied mockups product, packaging, social, and stationery
5
+ — with AI image-generation prompts and brand application guidelines.
6
+ TRIGGER: "cria mockups", "mockup do produto", "packaging mockup", "aplica a
7
+ marca no produto", "social media mockup", "/brand mockup <type>". SKIP:
8
+ low-fidelity screen structure and layout -> brand/wireframe (structure
9
+ before pixels); creating the logo itself -> brand/logo-brief (concepts, not
10
+ application).
5
11
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
12
  ---
7
13
 
@@ -1,7 +1,13 @@
1
1
  ---
2
2
  name: brand/naming-evaluate
3
3
  description: >
4
- Generate and evaluate brand names using Alexandra Watkins' SMILE & SCRATCH framework.
4
+ Generates 30+ brand name candidates across six categories and evaluates them
5
+ with Alexandra Watkins' SMILE & SCRATCH framework, plus domain and social
6
+ handle checks, down to a 5-name shortlist. TRIGGER: "nome para a marca",
7
+ "sugere nomes", "brand naming", "avalia este nome", "is this a good name",
8
+ "/brand naming <project>". SKIP: the name exists and needs a market position
9
+ -> brand/positioning-statement; defining the personality behind the name ->
10
+ brand/archetype-finder.
5
11
  allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
6
12
  ---
7
13
 
@@ -1,7 +1,14 @@
1
1
  ---
2
2
  name: brand/positioning-statement
3
3
  description: >
4
- Brand positioning: FOR [target] WHO [need] [brand] IS A [category] THAT [benefit].
4
+ Writes a brand positioning statement in the Ries/Trout format FOR [target]
5
+ WHO [need], [brand] IS A [category] THAT [benefit] — with competitive
6
+ context and validation criteria. TRIGGER: "posicionamento da marca",
7
+ "positioning statement", "como nos posicionamos", "define o posicionamento",
8
+ "what makes us different", "/brand positioning <name>". SKIP: market-level
9
+ strategic positioning and competitive moves -> strategy/position (business
10
+ strategy, not the brand message); brand still unnamed ->
11
+ brand/naming-evaluate first.
5
12
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
13
  ---
7
14
 
@@ -1,8 +1,13 @@
1
1
  ---
2
2
  name: brand/primal-audit
3
3
  description: >
4
- Audit an existing brand against Patrick Hanlon's 7 Primal Code elements.
5
- Identifies missing elements and provides recommendations to strengthen the brand.
4
+ Audits an existing brand against Patrick Hanlon's 7 Primal Code elements
5
+ using a 21-point evidence-cited rubric, a competitor benchmark, and a ranked
6
+ remediation plan. TRIGGER: "audita a marca", "brand audit", "primal audit",
7
+ "quão forte é a nossa marca", "how strong is our brand", "/brand audit".
8
+ SKIP: auditing the interface, not the brand -> brand/ux-audit (Nielsen
9
+ heuristics on usability); no brand exists yet to audit ->
10
+ brand/identity-system (creation, not audit).
6
11
  allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
7
12
  ---
8
13
 
@@ -1,7 +1,14 @@
1
1
  ---
2
2
  name: brand/ux-audit
3
3
  description: >
4
- UX heuristic audit: evaluate interface against Nielsen's 10 heuristics.
4
+ UX heuristic audit of a live interface against Nielsen's 10 heuristics and
5
+ Laws of UX — navigates real user flows in the browser, checks accessibility
6
+ and responsive breakpoints, and delivers severity-rated findings with fixes.
7
+ TRIGGER: "ux audit", "audita a usabilidade", "auditoria de UX", "heuristic
8
+ evaluation", "porque é que os users se perdem", "/brand ux-audit <url>".
9
+ SKIP: on-brand visual compliance (palette, typography vs brandbook) ->
10
+ brand/design-review; slow pages or Core Web Vitals -> dev/performance-audit;
11
+ brand strength, not interface -> brand/primal-audit.
5
12
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
13
  ---
7
14
 
@@ -1,7 +1,14 @@
1
1
  ---
2
2
  name: brand/voice-guide
3
3
  description: >
4
- Brand voice and tone guide: personality, vocabulary, do's/don'ts, examples per channel.
4
+ Creates a brand voice and tone guide personality, vocabulary, do's and
5
+ don'ts, tone matrix, and channel-specific examples — using StoryBrand and
6
+ the Primal sacred lexicon. TRIGGER: "brand voice", "tom de voz da marca",
7
+ "voice guide", "define o tom de comunicação", "como é que a marca fala",
8
+ "/brand voice <context>". SKIP: writing actual copy with that voice ->
9
+ landing/copy-framework or content/hook-write (they produce content, this
10
+ produces the rules); personality still undefined -> brand/archetype-finder
11
+ first.
5
12
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
13
  ---
7
14
 
@@ -1,7 +1,14 @@
1
1
  ---
2
2
  name: brand/wireframe
3
3
  description: >
4
- Wireframe design: layout, navigation, content hierarchy, interaction notes.
4
+ Designs wireframes layout, navigation, content hierarchy, and interaction
5
+ notes — using Garrett's 5 Planes and information architecture, delivered as
6
+ an annotated spec with component references and responsive notes. TRIGGER:
7
+ "wireframe", "esboça a página", "estrutura da página", "low-fi layout",
8
+ "wireframe the dashboard", "/brand wireframe <page>". SKIP: full
9
+ landing-page conversion structure -> landing/page-architect
10
+ (conversion-driven section architecture); pixel-level brand-applied visuals
11
+ -> brand/mockup-generate (wireframes come first).
5
12
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
13
  ---
7
14
 
@@ -1,7 +1,13 @@
1
1
  ---
2
2
  name: community/ai-community
3
3
  description: >
4
- AI/tech community setup: Discord channels, roles, bots, content strategy.
4
+ AI/tech community setup on Discord: channel architecture, roles, bots, and
5
+ content strategy, delivered as an AI community blueprint with growth plan.
6
+ TRIGGER: "comunidade de IA", "cria um Discord de AI", "AI community",
7
+ "Discord for my AI product", "setup tech community", "/community ai".
8
+ SKIP: niche undecided or non-AI vertical -> community/niche-setup (full
9
+ blueprint for any niche); platform still undecided ->
10
+ community/platform-select (compares Discord vs Telegram vs Skool first).
5
11
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
12
  ---
7
13
 
@@ -1,7 +1,13 @@
1
1
  ---
2
2
  name: community/betting-setup
3
3
  description: >
4
- Betting/trading community setup: Telegram VIP, signal delivery, tier pricing.
4
+ Betting/trading community setup on Telegram: VIP group structure, signal
5
+ delivery, bot config, and tier pricing, delivered as a launch-ready
6
+ blueprint. TRIGGER: "comunidade de apostas", "grupo VIP de sinais",
7
+ "betting community", "trading signals Telegram", "canal de tips",
8
+ "/community betting". SKIP: any other niche -> community/niche-setup
9
+ (generic niche blueprint); revenue design beyond tier pricing ->
10
+ community/monetize-plan (7-stream monetization with projections).
5
11
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
12
  ---
7
13
 
@@ -1,8 +1,15 @@
1
1
  ---
2
2
  name: community/business-model
3
3
  description: >
4
- Design a community business model: purpose, ideal member, value proposition,
5
- monetization, platform selection, and growth strategy.
4
+ Designs a community business model with the Community BMC + SPACES
5
+ framework: purpose, ideal member, value proposition, engagement model,
6
+ monetization streams, retention, platform, and 1000-true-fans math.
7
+ TRIGGER: "modelo de negócio da comunidade", "como ganhar dinheiro com a
8
+ comunidade", "community business model", "is my community viable",
9
+ "/community model <niche>". SKIP: company or product business model
10
+ canvas -> strat/bmc (general BMC, not community); executing the revenue
11
+ plan -> community/monetize-plan; full launch package ->
12
+ community/niche-setup.
6
13
  allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
7
14
  ---
8
15
 
@@ -1,7 +1,14 @@
1
1
  ---
2
2
  name: community/content-calendar
3
3
  description: >
4
- Community content calendar: daily prompts, weekly events, monthly themes.
4
+ Community content calendar: daily discussion prompts, weekly events, and
5
+ monthly themes, delivered with engagement triggers and an event schedule.
6
+ TRIGGER: "calendário de conteúdo da comunidade", "o que postar no grupo",
7
+ "community content calendar", "daily prompts for Discord", "planeia os
8
+ posts da comunidade", "/community calendar <period>". SKIP: creator or
9
+ multi-channel publishing calendar -> content/calendar (content business
10
+ pipeline); marketing campaign calendar -> mkt/calendar-plan; designing one
11
+ event in depth -> community/events-plan.
5
12
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
13
  ---
7
14