arkaos 2.0.0-alpha.1

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 (486) hide show
  1. package/CONSTITUTION.md +81 -0
  2. package/LICENSE +21 -0
  3. package/README.md +154 -0
  4. package/VERSION +1 -0
  5. package/arka/SKILL.md +134 -0
  6. package/bin/arkaos +107 -0
  7. package/config/constitution.yaml +168 -0
  8. package/config/hooks/post-tool-use-v2.sh +116 -0
  9. package/config/hooks/post-tool-use.sh +188 -0
  10. package/config/hooks/pre-compact-v2.sh +43 -0
  11. package/config/hooks/pre-compact.sh +99 -0
  12. package/config/hooks/user-prompt-submit-v2.sh +119 -0
  13. package/config/hooks/user-prompt-submit.sh +312 -0
  14. package/core/__init__.py +3 -0
  15. package/core/__pycache__/__init__.cpython-313.pyc +0 -0
  16. package/core/agents/__init__.py +14 -0
  17. package/core/agents/__pycache__/__init__.cpython-313.pyc +0 -0
  18. package/core/agents/__pycache__/loader.cpython-313.pyc +0 -0
  19. package/core/agents/__pycache__/registry_gen.cpython-313.pyc +0 -0
  20. package/core/agents/__pycache__/schema.cpython-313.pyc +0 -0
  21. package/core/agents/__pycache__/validator.cpython-313.pyc +0 -0
  22. package/core/agents/loader.py +88 -0
  23. package/core/agents/registry_gen.py +118 -0
  24. package/core/agents/schema.py +265 -0
  25. package/core/agents/validator.py +141 -0
  26. package/core/conclave/__init__.py +12 -0
  27. package/core/conclave/__pycache__/__init__.cpython-313.pyc +0 -0
  28. package/core/conclave/__pycache__/advisor_db.cpython-313.pyc +0 -0
  29. package/core/conclave/__pycache__/display.cpython-313.pyc +0 -0
  30. package/core/conclave/__pycache__/matcher.cpython-313.pyc +0 -0
  31. package/core/conclave/__pycache__/persistence.cpython-313.pyc +0 -0
  32. package/core/conclave/__pycache__/profiler.cpython-313.pyc +0 -0
  33. package/core/conclave/__pycache__/prompts.cpython-313.pyc +0 -0
  34. package/core/conclave/__pycache__/schema.cpython-313.pyc +0 -0
  35. package/core/conclave/advisor_db.py +373 -0
  36. package/core/conclave/display.py +104 -0
  37. package/core/conclave/matcher.py +104 -0
  38. package/core/conclave/persistence.py +61 -0
  39. package/core/conclave/profiler.py +298 -0
  40. package/core/conclave/prompts.py +77 -0
  41. package/core/conclave/schema.py +132 -0
  42. package/core/governance/__init__.py +5 -0
  43. package/core/governance/__pycache__/__init__.cpython-313.pyc +0 -0
  44. package/core/governance/__pycache__/constitution.cpython-313.pyc +0 -0
  45. package/core/governance/constitution.py +152 -0
  46. package/core/registry/__init__.py +1 -0
  47. package/core/registry/__pycache__/__init__.cpython-313.pyc +0 -0
  48. package/core/registry/__pycache__/generator.cpython-313.pyc +0 -0
  49. package/core/registry/generator.py +199 -0
  50. package/core/runtime/__init__.py +6 -0
  51. package/core/runtime/__pycache__/__init__.cpython-313.pyc +0 -0
  52. package/core/runtime/__pycache__/base.cpython-313.pyc +0 -0
  53. package/core/runtime/__pycache__/claude_code.cpython-313.pyc +0 -0
  54. package/core/runtime/__pycache__/codex_cli.cpython-313.pyc +0 -0
  55. package/core/runtime/__pycache__/cursor.cpython-313.pyc +0 -0
  56. package/core/runtime/__pycache__/gemini_cli.cpython-313.pyc +0 -0
  57. package/core/runtime/__pycache__/registry.cpython-313.pyc +0 -0
  58. package/core/runtime/__pycache__/subagent.cpython-313.pyc +0 -0
  59. package/core/runtime/base.py +143 -0
  60. package/core/runtime/claude_code.py +104 -0
  61. package/core/runtime/codex_cli.py +71 -0
  62. package/core/runtime/cursor.py +71 -0
  63. package/core/runtime/gemini_cli.py +68 -0
  64. package/core/runtime/registry.py +86 -0
  65. package/core/runtime/subagent.py +201 -0
  66. package/core/specs/__init__.py +10 -0
  67. package/core/specs/__pycache__/__init__.cpython-313.pyc +0 -0
  68. package/core/specs/__pycache__/manager.cpython-313.pyc +0 -0
  69. package/core/specs/__pycache__/schema.cpython-313.pyc +0 -0
  70. package/core/specs/manager.py +164 -0
  71. package/core/specs/schema.py +199 -0
  72. package/core/squads/__init__.py +7 -0
  73. package/core/squads/__pycache__/__init__.cpython-313.pyc +0 -0
  74. package/core/squads/__pycache__/loader.cpython-313.pyc +0 -0
  75. package/core/squads/__pycache__/registry.cpython-313.pyc +0 -0
  76. package/core/squads/__pycache__/schema.cpython-313.pyc +0 -0
  77. package/core/squads/loader.py +40 -0
  78. package/core/squads/registry.py +145 -0
  79. package/core/squads/schema.py +93 -0
  80. package/core/synapse/__init__.py +11 -0
  81. package/core/synapse/__pycache__/__init__.cpython-313.pyc +0 -0
  82. package/core/synapse/__pycache__/cache.cpython-313.pyc +0 -0
  83. package/core/synapse/__pycache__/engine.cpython-313.pyc +0 -0
  84. package/core/synapse/__pycache__/layers.cpython-313.pyc +0 -0
  85. package/core/synapse/cache.py +82 -0
  86. package/core/synapse/engine.py +184 -0
  87. package/core/synapse/layers.py +441 -0
  88. package/core/tasks/__init__.py +6 -0
  89. package/core/tasks/__pycache__/__init__.cpython-313.pyc +0 -0
  90. package/core/tasks/__pycache__/manager.cpython-313.pyc +0 -0
  91. package/core/tasks/__pycache__/schema.cpython-313.pyc +0 -0
  92. package/core/tasks/manager.py +150 -0
  93. package/core/tasks/schema.py +108 -0
  94. package/core/workflow/__init__.py +10 -0
  95. package/core/workflow/__pycache__/__init__.cpython-313.pyc +0 -0
  96. package/core/workflow/__pycache__/engine.cpython-313.pyc +0 -0
  97. package/core/workflow/__pycache__/loader.cpython-313.pyc +0 -0
  98. package/core/workflow/__pycache__/schema.cpython-313.pyc +0 -0
  99. package/core/workflow/engine.py +216 -0
  100. package/core/workflow/loader.py +28 -0
  101. package/core/workflow/schema.py +129 -0
  102. package/departments/brand/SKILL.md +85 -0
  103. package/departments/brand/agents/brand-director.yaml +77 -0
  104. package/departments/brand/agents/brand-strategist.md +182 -0
  105. package/departments/brand/agents/brand-strategist.yaml +58 -0
  106. package/departments/brand/agents/creative-director.md +149 -0
  107. package/departments/brand/agents/motion-designer.md +113 -0
  108. package/departments/brand/agents/ux-designer.yaml +60 -0
  109. package/departments/brand/agents/visual-designer.md +187 -0
  110. package/departments/brand/agents/visual-designer.yaml +58 -0
  111. package/departments/brand/references/brand-creation-guide.md +559 -0
  112. package/departments/brand/scripts/provider-call.sh +262 -0
  113. package/departments/brand/skills/archetype-finder/SKILL.md +18 -0
  114. package/departments/brand/skills/colors/SKILL.md +18 -0
  115. package/departments/brand/skills/design-system/SKILL.md +18 -0
  116. package/departments/brand/skills/identity-system/SKILL.md +18 -0
  117. package/departments/brand/skills/logo-brief/SKILL.md +18 -0
  118. package/departments/brand/skills/mockup-generate/SKILL.md +18 -0
  119. package/departments/brand/skills/naming-evaluate/SKILL.md +50 -0
  120. package/departments/brand/skills/positioning-statement/SKILL.md +18 -0
  121. package/departments/brand/skills/primal-audit/SKILL.md +43 -0
  122. package/departments/brand/skills/ux-audit/SKILL.md +18 -0
  123. package/departments/brand/skills/voice-guide/SKILL.md +18 -0
  124. package/departments/brand/skills/wireframe/SKILL.md +18 -0
  125. package/departments/brand/squad.yaml +39 -0
  126. package/departments/brand/workflows/identity.yaml +113 -0
  127. package/departments/brand/workflows/naming.yaml +58 -0
  128. package/departments/community/SKILL.md +62 -0
  129. package/departments/community/agents/community-manager.yaml +57 -0
  130. package/departments/community/agents/community-strategist.yaml +74 -0
  131. package/departments/community/agents/engagement-designer.yaml +56 -0
  132. package/departments/community/skills/ai-community/SKILL.md +18 -0
  133. package/departments/community/skills/betting-setup/SKILL.md +18 -0
  134. package/departments/community/skills/business-model/SKILL.md +53 -0
  135. package/departments/community/skills/content-calendar/SKILL.md +18 -0
  136. package/departments/community/skills/events-plan/SKILL.md +18 -0
  137. package/departments/community/skills/gamification-design/SKILL.md +18 -0
  138. package/departments/community/skills/growth-plan/SKILL.md +18 -0
  139. package/departments/community/skills/metrics-track/SKILL.md +18 -0
  140. package/departments/community/skills/moderation/SKILL.md +18 -0
  141. package/departments/community/skills/monetize-plan/SKILL.md +18 -0
  142. package/departments/community/skills/niche-setup/SKILL.md +18 -0
  143. package/departments/community/skills/onboarding-flow/SKILL.md +18 -0
  144. package/departments/community/skills/platform-select/SKILL.md +18 -0
  145. package/departments/community/skills/retention-system/SKILL.md +48 -0
  146. package/departments/community/squad.yaml +32 -0
  147. package/departments/community/workflows/setup.yaml +62 -0
  148. package/departments/content/SKILL.md +65 -0
  149. package/departments/content/agents/content-strategist.yaml +74 -0
  150. package/departments/content/agents/repurpose-distributor.yaml +57 -0
  151. package/departments/content/agents/scriptwriter.yaml +56 -0
  152. package/departments/content/agents/viral-engineer.yaml +56 -0
  153. package/departments/content/skills/ai-workflow/SKILL.md +18 -0
  154. package/departments/content/skills/analytics/SKILL.md +18 -0
  155. package/departments/content/skills/calendar/SKILL.md +18 -0
  156. package/departments/content/skills/content-system/SKILL.md +75 -0
  157. package/departments/content/skills/hook-write/SKILL.md +43 -0
  158. package/departments/content/skills/monetization-plan/SKILL.md +18 -0
  159. package/departments/content/skills/newsletter-write/SKILL.md +18 -0
  160. package/departments/content/skills/platform-optimize/SKILL.md +18 -0
  161. package/departments/content/skills/repurpose-plan/SKILL.md +18 -0
  162. package/departments/content/skills/script-structure/SKILL.md +18 -0
  163. package/departments/content/skills/short-form/SKILL.md +18 -0
  164. package/departments/content/skills/thumbnail-package/SKILL.md +18 -0
  165. package/departments/content/skills/viral-design/SKILL.md +45 -0
  166. package/departments/content/skills/youtube-strategy/SKILL.md +18 -0
  167. package/departments/content/squad.yaml +39 -0
  168. package/departments/content/workflows/viral.yaml +99 -0
  169. package/departments/dev/SKILL.md +135 -0
  170. package/departments/dev/agents/analyst.md +184 -0
  171. package/departments/dev/agents/architect.md +184 -0
  172. package/departments/dev/agents/architect.yaml +74 -0
  173. package/departments/dev/agents/backend-dev.yaml +70 -0
  174. package/departments/dev/agents/cto.md +140 -0
  175. package/departments/dev/agents/cto.yaml +77 -0
  176. package/departments/dev/agents/dba.yaml +72 -0
  177. package/departments/dev/agents/devops-eng.yaml +72 -0
  178. package/departments/dev/agents/devops.md +204 -0
  179. package/departments/dev/agents/frontend-dev.md +213 -0
  180. package/departments/dev/agents/frontend-dev.yaml +71 -0
  181. package/departments/dev/agents/qa-eng.yaml +72 -0
  182. package/departments/dev/agents/qa.md +231 -0
  183. package/departments/dev/agents/security-eng.yaml +72 -0
  184. package/departments/dev/agents/security.md +174 -0
  185. package/departments/dev/agents/senior-dev.md +177 -0
  186. package/departments/dev/agents/tech-lead.md +188 -0
  187. package/departments/dev/agents/tech-lead.yaml +72 -0
  188. package/departments/dev/skills/adversarial-review/SKILL.md +117 -0
  189. package/departments/dev/skills/agent-design/SKILL.md +127 -0
  190. package/departments/dev/skills/agent-workflow/SKILL.md +116 -0
  191. package/departments/dev/skills/ai-assisted-dev/SKILL.md +18 -0
  192. package/departments/dev/skills/ai-security/SKILL.md +112 -0
  193. package/departments/dev/skills/api-design/SKILL.md +59 -0
  194. package/departments/dev/skills/architecture-design/SKILL.md +89 -0
  195. package/departments/dev/skills/changelog/SKILL.md +110 -0
  196. package/departments/dev/skills/ci-cd-pipeline/SKILL.md +130 -0
  197. package/departments/dev/skills/clean-code-review/SKILL.md +65 -0
  198. package/departments/dev/skills/code-review/SKILL.md +18 -0
  199. package/departments/dev/skills/codebase-onboard/SKILL.md +109 -0
  200. package/departments/dev/skills/db-design/SKILL.md +18 -0
  201. package/departments/dev/skills/db-schema/SKILL.md +130 -0
  202. package/departments/dev/skills/ddd-model/SKILL.md +18 -0
  203. package/departments/dev/skills/dependency-audit/SKILL.md +118 -0
  204. package/departments/dev/skills/deploy/SKILL.md +18 -0
  205. package/departments/dev/skills/devops-pipeline/SKILL.md +18 -0
  206. package/departments/dev/skills/docs/SKILL.md +18 -0
  207. package/departments/dev/skills/env-secrets/SKILL.md +89 -0
  208. package/departments/dev/skills/incident/SKILL.md +125 -0
  209. package/departments/dev/skills/mcp/SKILL.md +106 -0
  210. package/departments/dev/skills/mcp-builder/SKILL.md +121 -0
  211. package/departments/dev/skills/observability/SKILL.md +119 -0
  212. package/departments/dev/skills/onboard/SKILL.md +389 -0
  213. package/departments/dev/skills/onboard/scripts/detect-stack.py +472 -0
  214. package/departments/dev/skills/performance-audit/SKILL.md +49 -0
  215. package/departments/dev/skills/performance-profiler/SKILL.md +128 -0
  216. package/departments/dev/skills/rag-architect/SKILL.md +125 -0
  217. package/departments/dev/skills/red-team/SKILL.md +112 -0
  218. package/departments/dev/skills/refactor-plan/SKILL.md +18 -0
  219. package/departments/dev/skills/release/SKILL.md +130 -0
  220. package/departments/dev/skills/research/SKILL.md +18 -0
  221. package/departments/dev/skills/runbook/SKILL.md +103 -0
  222. package/departments/dev/skills/scaffold/SKILL.md +249 -0
  223. package/departments/dev/skills/security-audit/SKILL.md +68 -0
  224. package/departments/dev/skills/skill-audit/SKILL.md +96 -0
  225. package/departments/dev/skills/spec/SKILL.md +218 -0
  226. package/departments/dev/skills/stack-check/SKILL.md +18 -0
  227. package/departments/dev/skills/tdd-cycle/SKILL.md +56 -0
  228. package/departments/dev/skills/tech-debt/SKILL.md +100 -0
  229. package/departments/dev/squad.yaml +62 -0
  230. package/departments/dev/workflows/debug.yaml +63 -0
  231. package/departments/dev/workflows/feature.yaml +129 -0
  232. package/departments/dev/workflows/refactor.yaml +64 -0
  233. package/departments/ecom/SKILL.md +39 -0
  234. package/departments/ecom/agents/commerce-engineer.yaml +58 -0
  235. package/departments/ecom/agents/cro-specialist.yaml +56 -0
  236. package/departments/ecom/agents/ecom-director.yaml +73 -0
  237. package/departments/ecom/agents/retention-manager.yaml +59 -0
  238. package/departments/ecom/skills/analytics/SKILL.md +18 -0
  239. package/departments/ecom/skills/cart-recovery/SKILL.md +18 -0
  240. package/departments/ecom/skills/cro-optimize/SKILL.md +58 -0
  241. package/departments/ecom/skills/customer-journey/SKILL.md +18 -0
  242. package/departments/ecom/skills/fulfillment-plan/SKILL.md +18 -0
  243. package/departments/ecom/skills/marketplace-manage/SKILL.md +18 -0
  244. package/departments/ecom/skills/pricing-strategy/SKILL.md +18 -0
  245. package/departments/ecom/skills/product-launch/SKILL.md +18 -0
  246. package/departments/ecom/skills/rfm-segment/SKILL.md +44 -0
  247. package/departments/ecom/skills/social-commerce/SKILL.md +18 -0
  248. package/departments/ecom/skills/store-audit/SKILL.md +18 -0
  249. package/departments/ecom/skills/subscription-model/SKILL.md +18 -0
  250. package/departments/ecom/squad.yaml +39 -0
  251. package/departments/ecom/workflows/product-page.yaml +62 -0
  252. package/departments/ecommerce/SKILL.md +363 -0
  253. package/departments/ecommerce/agents/ecommerce-manager.md +91 -0
  254. package/departments/finance/SKILL.md +37 -0
  255. package/departments/finance/agents/cfo.md +85 -0
  256. package/departments/finance/agents/cfo.yaml +77 -0
  257. package/departments/finance/agents/financial-analyst.yaml +57 -0
  258. package/departments/finance/agents/investment-strategist.yaml +58 -0
  259. package/departments/finance/skills/budget-plan/SKILL.md +18 -0
  260. package/departments/finance/skills/cashflow-forecast/SKILL.md +18 -0
  261. package/departments/finance/skills/ciso-advisor/SKILL.md +113 -0
  262. package/departments/finance/skills/financial-model/SKILL.md +70 -0
  263. package/departments/finance/skills/pitch-deck/SKILL.md +18 -0
  264. package/departments/finance/skills/scenario-analysis/SKILL.md +18 -0
  265. package/departments/finance/skills/unit-economics/SKILL.md +44 -0
  266. package/departments/finance/skills/valuation-model/SKILL.md +18 -0
  267. package/departments/finance/squad.yaml +37 -0
  268. package/departments/finance/workflows/cashflow.yaml +47 -0
  269. package/departments/finance/workflows/model.yaml +83 -0
  270. package/departments/kb/SKILL.md +38 -0
  271. package/departments/kb/agents/knowledge-curator.yaml +60 -0
  272. package/departments/kb/agents/knowledge-director.yaml +72 -0
  273. package/departments/kb/agents/research-analyst.yaml +58 -0
  274. package/departments/kb/skills/ai-research/SKILL.md +18 -0
  275. package/departments/kb/skills/competitive-intel/SKILL.md +18 -0
  276. package/departments/kb/skills/knowledge-review/SKILL.md +18 -0
  277. package/departments/kb/skills/learn-content/SKILL.md +18 -0
  278. package/departments/kb/skills/moc-create/SKILL.md +18 -0
  279. package/departments/kb/skills/persona-build/SKILL.md +18 -0
  280. package/departments/kb/skills/research-plan/SKILL.md +51 -0
  281. package/departments/kb/skills/search-kb/SKILL.md +18 -0
  282. package/departments/kb/skills/source-evaluate/SKILL.md +18 -0
  283. package/departments/kb/skills/taxonomy-manage/SKILL.md +18 -0
  284. package/departments/kb/skills/write-as-persona/SKILL.md +18 -0
  285. package/departments/kb/skills/zettelkasten-process/SKILL.md +56 -0
  286. package/departments/kb/squad.yaml +34 -0
  287. package/departments/kb/workflows/learn.yaml +63 -0
  288. package/departments/knowledge/SKILL.md +474 -0
  289. package/departments/knowledge/agents/knowledge-curator.md +89 -0
  290. package/departments/knowledge/scripts/kb-check-capabilities.sh +143 -0
  291. package/departments/knowledge/scripts/kb-cleanup.sh +135 -0
  292. package/departments/knowledge/scripts/kb-queue.sh +156 -0
  293. package/departments/knowledge/scripts/kb-status.sh +195 -0
  294. package/departments/knowledge/scripts/kb-worker.sh +217 -0
  295. package/departments/landing/SKILL.md +65 -0
  296. package/departments/landing/agents/affiliate-manager.yaml +57 -0
  297. package/departments/landing/agents/conversion-strategist.yaml +74 -0
  298. package/departments/landing/agents/cro-specialist.yaml +58 -0
  299. package/departments/landing/agents/sales-copywriter.yaml +61 -0
  300. package/departments/landing/skills/ab-test/SKILL.md +18 -0
  301. package/departments/landing/skills/affiliate-bridge/SKILL.md +18 -0
  302. package/departments/landing/skills/awareness-diagnose/SKILL.md +18 -0
  303. package/departments/landing/skills/copy-framework/SKILL.md +55 -0
  304. package/departments/landing/skills/email-sequence/SKILL.md +18 -0
  305. package/departments/landing/skills/funnel-design/SKILL.md +49 -0
  306. package/departments/landing/skills/funnel-metrics/SKILL.md +18 -0
  307. package/departments/landing/skills/headline-write/SKILL.md +18 -0
  308. package/departments/landing/skills/landing-gen/SKILL.md +124 -0
  309. package/departments/landing/skills/launch-sequence/SKILL.md +18 -0
  310. package/departments/landing/skills/offer-create/SKILL.md +62 -0
  311. package/departments/landing/skills/optimize-page/SKILL.md +18 -0
  312. package/departments/landing/skills/page-architect/SKILL.md +18 -0
  313. package/departments/landing/skills/persuasion-apply/SKILL.md +18 -0
  314. package/departments/landing/skills/webinar-funnel/SKILL.md +18 -0
  315. package/departments/landing/squad.yaml +39 -0
  316. package/departments/landing/workflows/launch.yaml +72 -0
  317. package/departments/landing/workflows/offer.yaml +99 -0
  318. package/departments/leadership/SKILL.md +35 -0
  319. package/departments/leadership/agents/culture-coach.yaml +59 -0
  320. package/departments/leadership/agents/hr-specialist.yaml +57 -0
  321. package/departments/leadership/agents/leadership-director.yaml +72 -0
  322. package/departments/leadership/skills/change-manage/SKILL.md +18 -0
  323. package/departments/leadership/skills/conflict-resolve/SKILL.md +18 -0
  324. package/departments/leadership/skills/culture-audit/SKILL.md +18 -0
  325. package/departments/leadership/skills/delegation-matrix/SKILL.md +18 -0
  326. package/departments/leadership/skills/disc-assess/SKILL.md +18 -0
  327. package/departments/leadership/skills/feedback-give/SKILL.md +18 -0
  328. package/departments/leadership/skills/hiring-plan/SKILL.md +18 -0
  329. package/departments/leadership/skills/okr-define/SKILL.md +69 -0
  330. package/departments/leadership/skills/performance-review/SKILL.md +18 -0
  331. package/departments/leadership/skills/team-health/SKILL.md +56 -0
  332. package/departments/leadership/squad.yaml +35 -0
  333. package/departments/leadership/workflows/team-build.yaml +55 -0
  334. package/departments/marketing/SKILL.md +61 -0
  335. package/departments/marketing/agents/content-creator.md +85 -0
  336. package/departments/marketing/agents/content-marketer.yaml +58 -0
  337. package/departments/marketing/agents/marketing-director.yaml +75 -0
  338. package/departments/marketing/agents/paid-specialist.yaml +58 -0
  339. package/departments/marketing/agents/seo-specialist.yaml +57 -0
  340. package/departments/marketing/skills/ab-test/SKILL.md +18 -0
  341. package/departments/marketing/skills/analytics-report/SKILL.md +18 -0
  342. package/departments/marketing/skills/audience-segment/SKILL.md +18 -0
  343. package/departments/marketing/skills/calendar-plan/SKILL.md +18 -0
  344. package/departments/marketing/skills/cold-email/SKILL.md +128 -0
  345. package/departments/marketing/skills/competitor-analysis/SKILL.md +18 -0
  346. package/departments/marketing/skills/content-audit/SKILL.md +18 -0
  347. package/departments/marketing/skills/email-sequence/SKILL.md +18 -0
  348. package/departments/marketing/skills/growth-loop/SKILL.md +50 -0
  349. package/departments/marketing/skills/marketing-automation/SKILL.md +18 -0
  350. package/departments/marketing/skills/paid-campaign/SKILL.md +18 -0
  351. package/departments/marketing/skills/programmatic-seo/SKILL.md +123 -0
  352. package/departments/marketing/skills/seo-audit/SKILL.md +48 -0
  353. package/departments/marketing/skills/social-strategy/SKILL.md +18 -0
  354. package/departments/marketing/squad.yaml +39 -0
  355. package/departments/marketing/workflows/campaign.yaml +112 -0
  356. package/departments/marketing/workflows/social.yaml +56 -0
  357. package/departments/operations/SKILL.md +422 -0
  358. package/departments/operations/agents/coo.md +88 -0
  359. package/departments/ops/SKILL.md +37 -0
  360. package/departments/ops/agents/automation-engineer.yaml +58 -0
  361. package/departments/ops/agents/ops-lead.yaml +71 -0
  362. package/departments/ops/skills/bottleneck-find/SKILL.md +49 -0
  363. package/departments/ops/skills/dashboard-build/SKILL.md +18 -0
  364. package/departments/ops/skills/gtd-setup/SKILL.md +18 -0
  365. package/departments/ops/skills/integration-design/SKILL.md +18 -0
  366. package/departments/ops/skills/lean-audit/SKILL.md +18 -0
  367. package/departments/ops/skills/metrics-dashboard/SKILL.md +18 -0
  368. package/departments/ops/skills/n8n-flow/SKILL.md +18 -0
  369. package/departments/ops/skills/sop-create/SKILL.md +18 -0
  370. package/departments/ops/skills/workflow-automate/SKILL.md +39 -0
  371. package/departments/ops/skills/zapier-flow/SKILL.md +18 -0
  372. package/departments/ops/squad.yaml +35 -0
  373. package/departments/ops/workflows/lean-audit.yaml +69 -0
  374. package/departments/org/SKILL.md +34 -0
  375. package/departments/org/agents/coo.yaml +80 -0
  376. package/departments/org/agents/org-designer.yaml +56 -0
  377. package/departments/org/agents/people-ops.yaml +56 -0
  378. package/departments/org/skills/compensation-plan/SKILL.md +18 -0
  379. package/departments/org/skills/culture-define/SKILL.md +18 -0
  380. package/departments/org/skills/decision-framework/SKILL.md +18 -0
  381. package/departments/org/skills/hiring-plan/SKILL.md +18 -0
  382. package/departments/org/skills/meeting-optimize/SKILL.md +18 -0
  383. package/departments/org/skills/onboarding-design/SKILL.md +18 -0
  384. package/departments/org/skills/org-design/SKILL.md +18 -0
  385. package/departments/org/skills/remote-setup/SKILL.md +18 -0
  386. package/departments/org/skills/sop-process/SKILL.md +18 -0
  387. package/departments/org/skills/team-assess/SKILL.md +18 -0
  388. package/departments/org/squad.yaml +33 -0
  389. package/departments/org/workflows/design.yaml +55 -0
  390. package/departments/pm/SKILL.md +39 -0
  391. package/departments/pm/agents/pm-director.yaml +75 -0
  392. package/departments/pm/agents/product-owner.yaml +59 -0
  393. package/departments/pm/agents/scrum-master.yaml +59 -0
  394. package/departments/pm/skills/agile-po/SKILL.md +118 -0
  395. package/departments/pm/skills/backlog-groom/SKILL.md +18 -0
  396. package/departments/pm/skills/discovery-plan/SKILL.md +48 -0
  397. package/departments/pm/skills/estimate-forecast/SKILL.md +18 -0
  398. package/departments/pm/skills/impact-map/SKILL.md +18 -0
  399. package/departments/pm/skills/kanban-setup/SKILL.md +18 -0
  400. package/departments/pm/skills/risk-register/SKILL.md +18 -0
  401. package/departments/pm/skills/roadmap-build/SKILL.md +18 -0
  402. package/departments/pm/skills/shape-pitch/SKILL.md +55 -0
  403. package/departments/pm/skills/sprint-plan/SKILL.md +18 -0
  404. package/departments/pm/skills/stakeholder-map/SKILL.md +18 -0
  405. package/departments/pm/skills/standup-run/SKILL.md +18 -0
  406. package/departments/pm/skills/story-write/SKILL.md +18 -0
  407. package/departments/pm/squad.yaml +37 -0
  408. package/departments/pm/workflows/retro.yaml +33 -0
  409. package/departments/quality/SKILL.md +66 -0
  410. package/departments/quality/agents/copy-director.md +134 -0
  411. package/departments/quality/agents/copy-director.yaml +73 -0
  412. package/departments/quality/agents/cqo.md +134 -0
  413. package/departments/quality/agents/cqo.yaml +76 -0
  414. package/departments/quality/agents/tech-director.yaml +79 -0
  415. package/departments/quality/agents/tech-ux-director.md +193 -0
  416. package/departments/quality/squad.yaml +25 -0
  417. package/departments/saas/SKILL.md +64 -0
  418. package/departments/saas/agents/cs-manager.yaml +57 -0
  419. package/departments/saas/agents/growth-engineer.yaml +57 -0
  420. package/departments/saas/agents/metrics-analyst.yaml +57 -0
  421. package/departments/saas/agents/saas-strategist.yaml +74 -0
  422. package/departments/saas/skills/benchmark-compare/SKILL.md +18 -0
  423. package/departments/saas/skills/churn-analysis/SKILL.md +18 -0
  424. package/departments/saas/skills/customer-success/SKILL.md +18 -0
  425. package/departments/saas/skills/growth-plan/SKILL.md +18 -0
  426. package/departments/saas/skills/gtm-strategy/SKILL.md +18 -0
  427. package/departments/saas/skills/launch-execute/SKILL.md +18 -0
  428. package/departments/saas/skills/metrics-dashboard/SKILL.md +18 -0
  429. package/departments/saas/skills/micro-saas-stack/SKILL.md +18 -0
  430. package/departments/saas/skills/mvp-build/SKILL.md +18 -0
  431. package/departments/saas/skills/niche-evaluate/SKILL.md +18 -0
  432. package/departments/saas/skills/onboarding-optimize/SKILL.md +18 -0
  433. package/departments/saas/skills/plg-setup/SKILL.md +53 -0
  434. package/departments/saas/skills/pricing-strategy/SKILL.md +48 -0
  435. package/departments/saas/skills/saas-scaffold/SKILL.md +127 -0
  436. package/departments/saas/skills/validate-idea/SKILL.md +55 -0
  437. package/departments/saas/squad.yaml +37 -0
  438. package/departments/saas/workflows/metrics.yaml +58 -0
  439. package/departments/saas/workflows/validate.yaml +103 -0
  440. package/departments/sales/SKILL.md +35 -0
  441. package/departments/sales/agents/sales-closer.yaml +58 -0
  442. package/departments/sales/agents/sales-director.yaml +72 -0
  443. package/departments/sales/agents/sales-ops.yaml +55 -0
  444. package/departments/sales/skills/challenger-sell/SKILL.md +18 -0
  445. package/departments/sales/skills/deal-qualify/SKILL.md +18 -0
  446. package/departments/sales/skills/discovery-call/SKILL.md +18 -0
  447. package/departments/sales/skills/forecast-revenue/SKILL.md +18 -0
  448. package/departments/sales/skills/negotiate-plan/SKILL.md +18 -0
  449. package/departments/sales/skills/objection-handle/SKILL.md +18 -0
  450. package/departments/sales/skills/pipeline-manage/SKILL.md +18 -0
  451. package/departments/sales/skills/pricing-negotiate/SKILL.md +18 -0
  452. package/departments/sales/skills/proposal-write/SKILL.md +54 -0
  453. package/departments/sales/skills/spin-sell/SKILL.md +50 -0
  454. package/departments/sales/squad.yaml +35 -0
  455. package/departments/sales/workflows/pipeline.yaml +49 -0
  456. package/departments/strategy/SKILL.md +37 -0
  457. package/departments/strategy/agents/business-model-designer.yaml +58 -0
  458. package/departments/strategy/agents/market-analyst.yaml +58 -0
  459. package/departments/strategy/agents/strategist.md +79 -0
  460. package/departments/strategy/agents/strategy-director.yaml +75 -0
  461. package/departments/strategy/skills/blue-ocean/SKILL.md +56 -0
  462. package/departments/strategy/skills/bmc/SKILL.md +18 -0
  463. package/departments/strategy/skills/board-advisor/SKILL.md +121 -0
  464. package/departments/strategy/skills/cto-advisor/SKILL.md +113 -0
  465. package/departments/strategy/skills/five-forces/SKILL.md +74 -0
  466. package/departments/strategy/skills/growth-strategy/SKILL.md +18 -0
  467. package/departments/strategy/skills/moat-analysis/SKILL.md +18 -0
  468. package/departments/strategy/skills/position/SKILL.md +18 -0
  469. package/departments/strategy/skills/scenario-plan/SKILL.md +18 -0
  470. package/departments/strategy/squad.yaml +37 -0
  471. package/departments/strategy/workflows/analysis.yaml +90 -0
  472. package/departments/strategy/workflows/swot.yaml +47 -0
  473. package/installer/adapters/claude-code.js +73 -0
  474. package/installer/adapters/codex-cli.js +34 -0
  475. package/installer/adapters/cursor.js +34 -0
  476. package/installer/adapters/gemini-cli.js +37 -0
  477. package/installer/cli.js +91 -0
  478. package/installer/detect-runtime.js +122 -0
  479. package/installer/doctor.js +105 -0
  480. package/installer/index.js +199 -0
  481. package/installer/uninstall.js +46 -0
  482. package/installer/update.js +39 -0
  483. package/knowledge/agents-registry-v2.json +2702 -0
  484. package/knowledge/commands-registry-v2.json +3827 -0
  485. package/package.json +58 -0
  486. package/pyproject.toml +64 -0
@@ -0,0 +1,262 @@
1
+ #!/usr/bin/env bash
2
+ # ============================================================================
3
+ # ARKA OS — Generic AI Provider API Caller
4
+ # Makes API calls to image/video/text providers using the provider registry
5
+ # Usage: bash provider-call.sh --type image --prompt "..." [--provider openai] [--model gpt-image-1] [--output /path]
6
+ # ============================================================================
7
+ set -e
8
+
9
+ SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
10
+ REPO_DIR="$(cd "$SCRIPT_DIR/../../.." && pwd)"
11
+ REGISTRY="$REPO_DIR/config/providers-registry.json"
12
+ ENV_FILE="$HOME/.arka-os/.env"
13
+ MEDIA_DIR="$HOME/.arka-os/media/brand"
14
+ COST_LOG="$MEDIA_DIR/cost-log.json"
15
+
16
+ # Load env
17
+ [ -f "$ENV_FILE" ] && source "$ENV_FILE"
18
+
19
+ # Require jq and curl
20
+ command -v jq &>/dev/null || { echo "Error: jq required"; exit 1; }
21
+ command -v curl &>/dev/null || { echo "Error: curl required"; exit 1; }
22
+
23
+ # ─── Parse Arguments ─────────────────────────────────────────────────────────
24
+ TYPE=""
25
+ PROMPT=""
26
+ PROVIDER=""
27
+ MODEL=""
28
+ OUTPUT_DIR=""
29
+ SIZE="1024x1024"
30
+
31
+ while [ $# -gt 0 ]; do
32
+ case "$1" in
33
+ --type) TYPE="$2"; shift 2 ;;
34
+ --prompt) PROMPT="$2"; shift 2 ;;
35
+ --provider) PROVIDER="$2"; shift 2 ;;
36
+ --model) MODEL="$2"; shift 2 ;;
37
+ --output) OUTPUT_DIR="$2"; shift 2 ;;
38
+ --size) SIZE="$2"; shift 2 ;;
39
+ --list)
40
+ echo "Available providers with configured keys:"
41
+ for pid in $(jq -r '.providers | keys[]' "$REGISTRY"); do
42
+ auth_env=$(jq -r --arg id "$pid" '.providers[$id].auth_env' "$REGISTRY")
43
+ value="${!auth_env:-}"
44
+ if [ -n "$value" ] && [ ${#value} -ge 8 ]; then
45
+ echo " ● $pid ($auth_env)"
46
+ jq -r --arg id "$pid" '.providers[$id].models | to_entries[] | " - \(.key) [\(.value.type)]"' "$REGISTRY"
47
+ fi
48
+ done
49
+ exit 0
50
+ ;;
51
+ *) shift ;;
52
+ esac
53
+ done
54
+
55
+ [ -z "$TYPE" ] && { echo "Error: --type (image|video|text) is required"; exit 1; }
56
+ [ -z "$PROMPT" ] && { echo "Error: --prompt is required"; exit 1; }
57
+
58
+ # ─── Setup output directory ──────────────────────────────────────────────────
59
+ JOB_ID=$(date +%s | md5 2>/dev/null | head -c 8 || echo "$$")
60
+ DATE_DIR=$(date +%Y-%m-%d)
61
+ [ -z "$OUTPUT_DIR" ] && OUTPUT_DIR="$MEDIA_DIR/$DATE_DIR/$JOB_ID"
62
+ mkdir -p "$OUTPUT_DIR"
63
+
64
+ # ─── Resolve provider from routing chain ─────────────────────────────────────
65
+ resolve_provider() {
66
+ local type="$1"
67
+ local routing_key=""
68
+
69
+ case "$type" in
70
+ image) routing_key="image-generation" ;;
71
+ video) routing_key="video-generation" ;;
72
+ text) routing_key="text-completion" ;;
73
+ esac
74
+
75
+ local chain
76
+ chain=$(jq -r --arg key "$routing_key" '.routing[$key] // [] | .[]' "$REGISTRY" 2>/dev/null)
77
+
78
+ for ref in $chain; do
79
+ local pid="${ref%%/*}"
80
+ local auth_env
81
+ auth_env=$(jq -r --arg id "$pid" '.providers[$id].auth_env' "$REGISTRY")
82
+ local value="${!auth_env:-}"
83
+ if [ -n "$value" ] && [ ${#value} -ge 8 ]; then
84
+ echo "$ref"
85
+ return 0
86
+ fi
87
+ done
88
+
89
+ return 1
90
+ }
91
+
92
+ # If no provider specified, resolve from routing chain
93
+ if [ -z "$PROVIDER" ] && [ -z "$MODEL" ]; then
94
+ RESOLVED=$(resolve_provider "$TYPE") || { echo "Error: No provider with configured API key found for type '$TYPE'. Run: arka providers add-key <KEY>"; exit 1; }
95
+ PROVIDER="${RESOLVED%%/*}"
96
+ MODEL="${RESOLVED#*/}"
97
+ elif [ -n "$PROVIDER" ] && [ -z "$MODEL" ]; then
98
+ # Pick first model of the right type from this provider
99
+ MODEL=$(jq -r --arg pid "$PROVIDER" --arg type "$TYPE" \
100
+ '.providers[$pid].models | to_entries[] | select(.value.type == $type) | .key' "$REGISTRY" | head -1)
101
+ [ -z "$MODEL" ] && { echo "Error: No $TYPE model found for provider '$PROVIDER'"; exit 1; }
102
+ fi
103
+
104
+ # Get provider config
105
+ BASE_URL=$(jq -r --arg id "$PROVIDER" '.providers[$id].base_url' "$REGISTRY")
106
+ AUTH_ENV=$(jq -r --arg id "$PROVIDER" '.providers[$id].auth_env' "$REGISTRY")
107
+ AUTH_HEADER=$(jq -r --arg id "$PROVIDER" '.providers[$id].auth_header' "$REGISTRY")
108
+ API_KEY="${!AUTH_ENV:-}"
109
+
110
+ [ -z "$API_KEY" ] && { echo "Error: $AUTH_ENV not set. Run: arka providers add-key $AUTH_ENV"; exit 1; }
111
+
112
+ # ─── Provider-specific API calls ─────────────────────────────────────────────
113
+
114
+ call_openai_image() {
115
+ local response
116
+ response=$(curl -s "$BASE_URL/images/generations" \
117
+ -H "Authorization: Bearer $API_KEY" \
118
+ -H "Content-Type: application/json" \
119
+ -d "$(jq -n --arg model "$MODEL" --arg prompt "$PROMPT" --arg size "$SIZE" \
120
+ '{model: $model, prompt: $prompt, size: $size, n: 1, response_format: "url"}')")
121
+
122
+ local url
123
+ url=$(echo "$response" | jq -r '.data[0].url // empty' 2>/dev/null)
124
+ if [ -n "$url" ]; then
125
+ curl -sL "$url" -o "$OUTPUT_DIR/output.png"
126
+ echo "$OUTPUT_DIR/output.png"
127
+ else
128
+ echo "$response" | jq -r '.error.message // "Unknown error"' 2>/dev/null >&2
129
+ echo "$response" > "$OUTPUT_DIR/error.json"
130
+ return 1
131
+ fi
132
+ }
133
+
134
+ call_replicate() {
135
+ # Create prediction
136
+ local response
137
+ response=$(curl -s "$BASE_URL/predictions" \
138
+ -H "Authorization: Bearer $API_KEY" \
139
+ -H "Content-Type: application/json" \
140
+ -d "$(jq -n --arg model "$MODEL" --arg prompt "$PROMPT" \
141
+ '{version: $model, input: {prompt: $prompt}}')")
142
+
143
+ local prediction_url
144
+ prediction_url=$(echo "$response" | jq -r '.urls.get // empty' 2>/dev/null)
145
+ [ -z "$prediction_url" ] && { echo "Error: Failed to create prediction" >&2; echo "$response" > "$OUTPUT_DIR/error.json"; return 1; }
146
+
147
+ # Poll for result
148
+ local status=""
149
+ local max_polls=60
150
+ local poll_count=0
151
+ while [ "$status" != "succeeded" ] && [ "$status" != "failed" ] && [ "$poll_count" -lt "$max_polls" ]; do
152
+ sleep 5
153
+ response=$(curl -s "$prediction_url" -H "Authorization: Bearer $API_KEY")
154
+ status=$(echo "$response" | jq -r '.status' 2>/dev/null)
155
+ poll_count=$((poll_count + 1))
156
+ done
157
+
158
+ if [ "$status" = "succeeded" ]; then
159
+ local output_url
160
+ output_url=$(echo "$response" | jq -r '.output | if type == "array" then .[0] else . end' 2>/dev/null)
161
+ local ext="png"
162
+ echo "$output_url" | grep -q "\.mp4" && ext="mp4"
163
+ curl -sL "$output_url" -o "$OUTPUT_DIR/output.$ext"
164
+ echo "$OUTPUT_DIR/output.$ext"
165
+ else
166
+ echo "Error: Prediction $status" >&2
167
+ echo "$response" > "$OUTPUT_DIR/error.json"
168
+ return 1
169
+ fi
170
+ }
171
+
172
+ call_fal() {
173
+ local response
174
+ response=$(curl -s "$BASE_URL/$MODEL" \
175
+ -H "Authorization: Key $API_KEY" \
176
+ -H "Content-Type: application/json" \
177
+ -d "$(jq -n --arg prompt "$PROMPT" '{prompt: $prompt}')")
178
+
179
+ # FAL may return a request_id for async, or direct result
180
+ local request_id
181
+ request_id=$(echo "$response" | jq -r '.request_id // empty' 2>/dev/null)
182
+
183
+ if [ -n "$request_id" ]; then
184
+ # Poll for result
185
+ local status=""
186
+ local max_polls=60
187
+ local poll_count=0
188
+ while [ "$status" != "COMPLETED" ] && [ "$poll_count" -lt "$max_polls" ]; do
189
+ sleep 5
190
+ response=$(curl -s "$BASE_URL/$MODEL/requests/$request_id/status" \
191
+ -H "Authorization: Key $API_KEY")
192
+ status=$(echo "$response" | jq -r '.status // ""' 2>/dev/null)
193
+ poll_count=$((poll_count + 1))
194
+ done
195
+ # Get result
196
+ response=$(curl -s "$BASE_URL/$MODEL/requests/$request_id" \
197
+ -H "Authorization: Key $API_KEY")
198
+ fi
199
+
200
+ # Extract output URL
201
+ local output_url
202
+ output_url=$(echo "$response" | jq -r '.images[0].url // .video.url // .output.url // empty' 2>/dev/null)
203
+ if [ -n "$output_url" ]; then
204
+ local ext="png"
205
+ echo "$output_url" | grep -qE "\.(mp4|webm)" && ext="mp4"
206
+ curl -sL "$output_url" -o "$OUTPUT_DIR/output.$ext"
207
+ echo "$OUTPUT_DIR/output.$ext"
208
+ else
209
+ echo "Error: No output URL in response" >&2
210
+ echo "$response" > "$OUTPUT_DIR/error.json"
211
+ return 1
212
+ fi
213
+ }
214
+
215
+ call_generic() {
216
+ # Generic OpenAI-compatible API call (for text providers like OpenRouter)
217
+ local response
218
+ response=$(curl -s "$BASE_URL/chat/completions" \
219
+ -H "$AUTH_HEADER $API_KEY" \
220
+ -H "Content-Type: application/json" \
221
+ -d "$(jq -n --arg model "$MODEL" --arg prompt "$PROMPT" \
222
+ '{model: $model, messages: [{role: "user", content: $prompt}]}')")
223
+
224
+ local content
225
+ content=$(echo "$response" | jq -r '.choices[0].message.content // empty' 2>/dev/null)
226
+ if [ -n "$content" ]; then
227
+ echo "$content" > "$OUTPUT_DIR/output.txt"
228
+ echo "$OUTPUT_DIR/output.txt"
229
+ else
230
+ echo "$response" > "$OUTPUT_DIR/error.json"
231
+ return 1
232
+ fi
233
+ }
234
+
235
+ # ─── Execute call based on provider ──────────────────────────────────────────
236
+ echo "Calling $PROVIDER/$MODEL ($TYPE)..." >&2
237
+
238
+ RESULT=""
239
+ case "$PROVIDER" in
240
+ openai) RESULT=$(call_openai_image) ;;
241
+ replicate) RESULT=$(call_replicate) ;;
242
+ fal) RESULT=$(call_fal) ;;
243
+ *) RESULT=$(call_generic) ;;
244
+ esac
245
+
246
+ EXIT_CODE=$?
247
+
248
+ # ─── Log cost entry ──────────────────────────────────────────────────────────
249
+ mkdir -p "$(dirname "$COST_LOG")"
250
+ [ ! -f "$COST_LOG" ] && echo '[]' > "$COST_LOG"
251
+ NOW=$(date -u +%Y-%m-%dT%H:%M:%SZ)
252
+ jq --arg ts "$NOW" --arg provider "$PROVIDER" --arg model "$MODEL" --arg type "$TYPE" \
253
+ --arg output "${RESULT:-error}" --argjson success "$([ $EXIT_CODE -eq 0 ] && echo true || echo false)" \
254
+ '. += [{timestamp: $ts, provider: $provider, model: $model, type: $type, output: $output, success: $success}]' \
255
+ "$COST_LOG" > "$COST_LOG.tmp" 2>/dev/null && mv "$COST_LOG.tmp" "$COST_LOG"
256
+
257
+ if [ $EXIT_CODE -eq 0 ] && [ -n "$RESULT" ]; then
258
+ echo "$RESULT"
259
+ else
260
+ echo "Error: API call failed. Check $OUTPUT_DIR/error.json" >&2
261
+ exit 1
262
+ fi
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: brand/archetype-finder
3
+ description: >
4
+ Identify brand archetype from the 12 Jungian archetypes with personality mapping.
5
+ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
+ ---
7
+
8
+ # Archetype Finder — `/brand archetype <brand>`
9
+
10
+ > **Agent:** Mateus (Brand Strategist) | **Framework:** 12 Brand Archetypes (Jung)
11
+
12
+ ## What It Does
13
+
14
+ Identify brand archetype from the 12 Jungian archetypes with personality mapping.
15
+
16
+ ## Output
17
+
18
+ Archetype profile with personality traits, voice, visual direction, and examples
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: brand/colors
3
+ description: >
4
+ Color palette design: primary, secondary, accent, neutrals with contrast ratios.
5
+ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
+ ---
7
+
8
+ # Colors — `/brand colors <mood>`
9
+
10
+ > **Agent:** Isabel (Visual Designer) | **Framework:** Color Theory + Accessibility
11
+
12
+ ## What It Does
13
+
14
+ Color palette design: primary, secondary, accent, neutrals with contrast ratios.
15
+
16
+ ## Output
17
+
18
+ Color palette with hex codes, usage guidelines, and WCAG contrast checks
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: brand/design-system
3
+ description: >
4
+ Design system specification: tokens, atoms, molecules, organisms, templates.
5
+ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
+ ---
7
+
8
+ # Design System — `/brand design-system`
9
+
10
+ > **Agent:** Sofia D. (UX Designer) | **Framework:** Atomic Design (Brad Frost) + Design Tokens
11
+
12
+ ## What It Does
13
+
14
+ Design system specification: tokens, atoms, molecules, organisms, templates.
15
+
16
+ ## Output
17
+
18
+ Design system spec with token definitions, component catalog, and usage guidelines
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: brand/identity-system
3
+ description: >
4
+ Full brand identity: strategy, verbal, visual in the correct order (never skip to visuals).
5
+ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
+ ---
7
+
8
+ # Identity System — `/brand identity <name>`
9
+
10
+ > **Agent:** Valentina (Creative Director) | **Framework:** Wheeler Process + Primal Branding
11
+
12
+ ## What It Does
13
+
14
+ Full brand identity: strategy, verbal, visual in the correct order (never skip to visuals).
15
+
16
+ ## Output
17
+
18
+ Complete brand identity package saved to Obsidian
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: brand/logo
3
+ description: >
4
+ Logo concept generation: brief, mood references, AI-generated concepts.
5
+ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
+ ---
7
+
8
+ # Logo — `/brand logo <brief>`
9
+
10
+ > **Agent:** Isabel (Visual Designer) | **Framework:** Logo Design Principles + AI Generation
11
+
12
+ ## What It Does
13
+
14
+ Logo concept generation: brief, mood references, AI-generated concepts.
15
+
16
+ ## Output
17
+
18
+ Logo concepts with rationale, variations, and usage guidelines
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: brand/mockup
3
+ description: >
4
+ Generate mockups: product, packaging, social, stationery with brand identity applied.
5
+ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
+ ---
7
+
8
+ # Mockup — `/brand mockup <type>`
9
+
10
+ > **Agent:** Isabel (Visual Designer) | **Framework:** AI Image Generation + Brand Application
11
+
12
+ ## What It Does
13
+
14
+ Generate mockups: product, packaging, social, stationery with brand identity applied.
15
+
16
+ ## Output
17
+
18
+ Mockup set with AI generation prompts and brand application guidelines
@@ -0,0 +1,50 @@
1
+ ---
2
+ name: brand/naming-evaluate
3
+ description: >
4
+ Generate and evaluate brand names using Alexandra Watkins' SMILE & SCRATCH framework.
5
+ allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
6
+ ---
7
+
8
+ # Brand Naming — `/brand naming <project>`
9
+
10
+ > **Agent:** Mateus (Brand Strategist) | **Framework:** SMILE & SCRATCH (Alexandra Watkins)
11
+
12
+ ## SMILE (Good Names Have)
13
+
14
+ | Letter | Quality | Test |
15
+ |--------|---------|------|
16
+ | **S** | Suggestive | Does it evoke something about the brand? |
17
+ | **M** | Memorable | Does it create an association with something familiar? |
18
+ | **I** | Imagery | Does it conjure a visual in your mind? |
19
+ | **L** | Legs | Can it extend to a theme (taglines, campaigns, products)? |
20
+ | **E** | Emotional | Does it make you feel something? |
21
+
22
+ ## SCRATCH (Bad Names Have)
23
+
24
+ | Letter | Problem | Test |
25
+ |--------|---------|------|
26
+ | **S** | Spelling-challenged | Does it look like a typo? |
27
+ | **C** | Copycat | Is it too similar to competitors? |
28
+ | **R** | Restrictive | Does it limit future growth? |
29
+ | **A** | Annoying | Is it forced, try-hard, or frustrating? |
30
+ | **T** | Tame | Is it flat, generic, descriptive only? |
31
+ | **C** | Curse of knowledge | Do only insiders understand it? |
32
+ | **H** | Hard to pronounce | Can people say it without hesitation? |
33
+
34
+ ## Process
35
+
36
+ 1. **Brief** — Brand positioning, target audience, brand personality
37
+ 2. **Generate** — 30+ name candidates across categories:
38
+ - Descriptive (what it does)
39
+ - Evocative (how it feels)
40
+ - Invented (new word)
41
+ - Lexical (wordplay, portmanteau)
42
+ - Acronymic (initials)
43
+ - Geographical/Historical
44
+ 3. **SMILE Test** — Score each name 0-10 on SMILE
45
+ 4. **SCRATCH Test** — Flag any SCRATCH issues
46
+ 5. **Domain Check** — .com available? Social handles available?
47
+ 6. **Shortlist** — Top 5 with rationale for each
48
+ 7. **Present** — User selects final name
49
+
50
+ ## Output → 5 finalist names with SMILE scores, SCRATCH flags, and domain availability
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: brand/positioning-statement
3
+ description: >
4
+ Brand positioning: FOR [target] WHO [need] [brand] IS A [category] THAT [benefit].
5
+ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
+ ---
7
+
8
+ # Positioning Statement — `/brand positioning <name>`
9
+
10
+ > **Agent:** Mateus (Brand Strategist) | **Framework:** Positioning (Ries/Trout)
11
+
12
+ ## What It Does
13
+
14
+ Brand positioning: FOR [target] WHO [need] [brand] IS A [category] THAT [benefit].
15
+
16
+ ## Output
17
+
18
+ Positioning statement with competitive context and validation criteria
@@ -0,0 +1,43 @@
1
+ ---
2
+ name: brand/primal-audit
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.
6
+ allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
7
+ ---
8
+
9
+ # Primal Brand Audit — `/brand audit`
10
+
11
+ > **Agent:** Mateus (Brand Strategist) | **Framework:** Primal Branding (Patrick Hanlon)
12
+
13
+ ## The 7 Primal Code Elements
14
+
15
+ | # | Element | Question | Status |
16
+ |---|---------|----------|--------|
17
+ | 1 | **Creation Story** | How was the brand born? Is it told consistently? | |
18
+ | 2 | **Creed** | What does the brand believe? Core principles? | |
19
+ | 3 | **Icons** | What visual symbols are instantly associated? | |
20
+ | 4 | **Rituals** | What repeated interactions define the experience? | |
21
+ | 5 | **Non-Adherents** | Who is the opposition? What are we NOT? | |
22
+ | 6 | **Sacred Lexicon** | What special language do believers use? | |
23
+ | 7 | **Leader** | Who embodies the brand values? Visible face? | |
24
+
25
+ ## Audit Process
26
+
27
+ 1. **Gather** — Collect all brand assets: website, social, packaging, internal docs
28
+ 2. **Map** — Fill each of the 7 elements with what currently exists
29
+ 3. **Score** — Rate each element: Strong (3), Present (2), Weak (1), Missing (0)
30
+ 4. **Gaps** — Identify missing or weak elements
31
+ 5. **Recommend** — Specific actions to strengthen each weak element
32
+ 6. **Benchmark** — Compare against competitors' Primal Codes
33
+
34
+ ## Scoring
35
+
36
+ | Score | Rating | Meaning |
37
+ |-------|--------|---------|
38
+ | 18-21 | Iconic | Brand has cult-like following potential |
39
+ | 14-17 | Strong | Well-defined, minor gaps to fill |
40
+ | 10-13 | Developing | Foundation exists, significant gaps |
41
+ | 0-9 | Underdeveloped | Major brand building needed |
42
+
43
+ ## Output → Obsidian: `WizardingCode/Brand/Audits/PRIMAL-AUDIT-<brand>-<date>.md`
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: brand/ux-audit
3
+ description: >
4
+ UX heuristic audit: evaluate interface against Nielsen's 10 heuristics.
5
+ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
+ ---
7
+
8
+ # Ux Audit — `/brand ux-audit <url>`
9
+
10
+ > **Agent:** Sofia D. (UX Designer) | **Framework:** Nielsen 10 Heuristics + Laws of UX
11
+
12
+ ## What It Does
13
+
14
+ UX heuristic audit: evaluate interface against Nielsen's 10 heuristics.
15
+
16
+ ## Output
17
+
18
+ Heuristic audit report with severity ratings and fix recommendations
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: brand/voice-guide
3
+ description: >
4
+ Brand voice and tone guide: personality, vocabulary, do's/don'ts, examples per channel.
5
+ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
+ ---
7
+
8
+ # Voice Guide — `/brand voice <context>`
9
+
10
+ > **Agent:** Mateus (Brand Strategist) | **Framework:** StoryBrand (Miller) + Primal Sacred Lexicon
11
+
12
+ ## What It Does
13
+
14
+ Brand voice and tone guide: personality, vocabulary, do's/don'ts, examples per channel.
15
+
16
+ ## Output
17
+
18
+ Brand voice guide document with tone matrix and channel-specific examples
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: brand/wireframe
3
+ description: >
4
+ Wireframe design: layout, navigation, content hierarchy, interaction notes.
5
+ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
+ ---
7
+
8
+ # Wireframe — `/brand wireframe <page>`
9
+
10
+ > **Agent:** Sofia D. (UX Designer) | **Framework:** Garrett's 5 Planes + Information Architecture
11
+
12
+ ## What It Does
13
+
14
+ Wireframe design: layout, navigation, content hierarchy, interaction notes.
15
+
16
+ ## Output
17
+
18
+ Wireframe spec with annotations, component references, and responsive notes
@@ -0,0 +1,39 @@
1
+ id: brand-squad
2
+ name: Brand & Design Squad
3
+ description: Brand identity, visual design, UX/UI, design systems, and brand strategy
4
+ department: brand
5
+ squad_type: department
6
+ topology: stream-aligned
7
+
8
+ skills_prefix: "/brand"
9
+ obsidian_path: "WizardingCode/Brand/"
10
+ quality_gate_required: true
11
+ max_size: 5
12
+
13
+ members:
14
+ - agent_id: brand-director-valentina
15
+ role: Creative direction, brand oversight, design system governance
16
+ is_lead: true
17
+ - agent_id: brand-strategist-mateus
18
+ role: Positioning, naming, verbal identity, competitive brand analysis
19
+ - agent_id: visual-designer-isabel
20
+ role: Color palettes, logos, mockups, AI image generation, visual assets
21
+ - agent_id: ux-designer-sofia-d
22
+ role: UX research, wireframes, prototyping, accessibility, usability audits
23
+
24
+ workflows:
25
+ - workflow_id: brand-identity
26
+ trigger_command: "/brand identity"
27
+ tier: enterprise
28
+ - workflow_id: brand-audit
29
+ trigger_command: "/brand audit"
30
+ tier: enterprise
31
+ - workflow_id: brand-naming
32
+ trigger_command: "/brand naming"
33
+ tier: focused
34
+ - workflow_id: brand-ux-audit
35
+ trigger_command: "/brand ux-audit"
36
+ tier: focused
37
+ - workflow_id: brand-design-system
38
+ trigger_command: "/brand design-system"
39
+ tier: enterprise