arkaos 4.6.0 → 4.7.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 (268) hide show
  1. package/CONSTITUTION.md +30 -16
  2. package/VERSION +1 -1
  3. package/arka/SKILL.md +24 -34
  4. package/arka/skills/bootstrap-agent/SKILL.md +6 -0
  5. package/arka/skills/checkpoint/SKILL.md +1 -1
  6. package/arka/skills/costs/SKILL.md +14 -5
  7. package/arka/skills/flow/SKILL.md +29 -14
  8. package/arka/skills/forge/SKILL.md +19 -15
  9. package/arka/skills/human-writing/SKILL.md +16 -7
  10. package/arka/skills/research/SKILL.md +20 -7
  11. package/arka/templates/skill-template.md +102 -0
  12. package/config/claude-agents/architect.md +51 -0
  13. package/config/claude-agents/backend-dev.md +51 -0
  14. package/config/claude-agents/dba.md +51 -0
  15. package/config/claude-agents/devops-eng.md +51 -0
  16. package/config/claude-agents/eduardo-copy.md +14 -7
  17. package/config/claude-agents/francisca-tech.md +24 -6
  18. package/config/claude-agents/frontend-dev.md +51 -0
  19. package/config/claude-agents/marta-cqo.md +28 -8
  20. package/config/claude-agents/qa-eng.md +51 -0
  21. package/config/claude-agents/research-assistant.md +50 -0
  22. package/config/claude-agents/security-eng.md +51 -0
  23. package/config/constitution.yaml +127 -88
  24. package/config/hooks/session-start.ps1 +3 -1
  25. package/config/hooks/session-start.sh +3 -1
  26. package/config/hooks/user-prompt-submit-v2.sh +4 -11
  27. package/config/hooks/user-prompt-submit.ps1 +4 -7
  28. package/config/hooks/user-prompt-submit.sh +1 -1
  29. package/core/agents/__pycache__/behavioral_compiler.cpython-313.pyc +0 -0
  30. package/core/agents/behavioral_compiler.py +294 -0
  31. package/core/governance/__pycache__/closing_marker_check.cpython-313.pyc +0 -0
  32. package/core/governance/__pycache__/closing_marker_check.cpython-314.pyc +0 -0
  33. package/core/governance/__pycache__/phantom_action_check.cpython-313.pyc +0 -0
  34. package/core/governance/__pycache__/phantom_action_check.cpython-314.pyc +0 -0
  35. package/core/governance/__pycache__/qg_verdict.cpython-313.pyc +0 -0
  36. package/core/governance/closing_marker_check.py +2 -2
  37. package/core/governance/phantom_action_check.py +206 -0
  38. package/core/governance/qg_verdict.py +12 -0
  39. package/core/hooks/__pycache__/stop.cpython-313.pyc +0 -0
  40. package/core/hooks/__pycache__/stop.cpython-314.pyc +0 -0
  41. package/core/hooks/__pycache__/user_prompt_submit.cpython-313.pyc +0 -0
  42. package/core/hooks/stop.py +25 -0
  43. package/core/hooks/user_prompt_submit.py +6 -8
  44. package/core/knowledge/__pycache__/vector_store.cpython-312.pyc +0 -0
  45. package/core/shared/__pycache__/temp_paths.cpython-312.pyc +0 -0
  46. package/core/synapse/__pycache__/engine.cpython-312.pyc +0 -0
  47. package/core/synapse/__pycache__/engine.cpython-313.pyc +0 -0
  48. package/core/synapse/__pycache__/engine.cpython-314.pyc +0 -0
  49. package/core/synapse/__pycache__/layers.cpython-312.pyc +0 -0
  50. package/core/synapse/__pycache__/layers.cpython-313.pyc +0 -0
  51. package/core/synapse/__pycache__/layers.cpython-314.pyc +0 -0
  52. package/core/synapse/engine.py +4 -2
  53. package/core/synapse/layers.py +0 -49
  54. package/departments/brand/SKILL.md +5 -13
  55. package/departments/brand/skills/archetype-finder/SKILL.md +3 -11
  56. package/departments/brand/skills/colors/SKILL.md +3 -11
  57. package/departments/brand/skills/design-review/SKILL.md +11 -3
  58. package/departments/brand/skills/design-system/SKILL.md +3 -11
  59. package/departments/brand/skills/identity-system/SKILL.md +3 -11
  60. package/departments/brand/skills/logo-brief/SKILL.md +3 -11
  61. package/departments/brand/skills/mockup-generate/SKILL.md +3 -11
  62. package/departments/brand/skills/naming-evaluate/SKILL.md +3 -11
  63. package/departments/brand/skills/positioning-statement/SKILL.md +3 -11
  64. package/departments/brand/skills/primal-audit/SKILL.md +3 -11
  65. package/departments/brand/skills/ux-audit/SKILL.md +3 -11
  66. package/departments/brand/skills/voice-guide/SKILL.md +3 -11
  67. package/departments/brand/skills/wireframe/SKILL.md +3 -11
  68. package/departments/community/SKILL.md +4 -12
  69. package/departments/community/skills/ai-community/SKILL.md +3 -11
  70. package/departments/community/skills/betting-setup/SKILL.md +3 -11
  71. package/departments/community/skills/business-model/SKILL.md +3 -11
  72. package/departments/community/skills/content-calendar/SKILL.md +3 -11
  73. package/departments/community/skills/events-plan/SKILL.md +3 -11
  74. package/departments/community/skills/gamification-design/SKILL.md +3 -11
  75. package/departments/community/skills/growth-plan/SKILL.md +13 -12
  76. package/departments/community/skills/metrics-track/SKILL.md +3 -11
  77. package/departments/community/skills/moderation/SKILL.md +3 -11
  78. package/departments/community/skills/monetize-plan/SKILL.md +3 -11
  79. package/departments/community/skills/niche-setup/SKILL.md +3 -11
  80. package/departments/community/skills/onboarding-flow/SKILL.md +3 -11
  81. package/departments/community/skills/platform-select/SKILL.md +3 -11
  82. package/departments/content/SKILL.md +4 -12
  83. package/departments/content/skills/ai-workflow/SKILL.md +3 -11
  84. package/departments/content/skills/analytics/SKILL.md +3 -11
  85. package/departments/content/skills/calendar/SKILL.md +3 -11
  86. package/departments/content/skills/content-system/SKILL.md +3 -11
  87. package/departments/content/skills/monetization-plan/SKILL.md +3 -11
  88. package/departments/content/skills/newsletter-write/SKILL.md +3 -11
  89. package/departments/content/skills/platform-optimize/SKILL.md +3 -11
  90. package/departments/content/skills/repurpose-plan/SKILL.md +3 -11
  91. package/departments/content/skills/script-structure/SKILL.md +3 -11
  92. package/departments/content/skills/short-form/SKILL.md +3 -11
  93. package/departments/content/skills/thumbnail-package/SKILL.md +3 -11
  94. package/departments/content/skills/viral-design/SKILL.md +3 -11
  95. package/departments/content/skills/youtube-strategy/SKILL.md +3 -11
  96. package/departments/dev/SKILL.md +4 -12
  97. package/departments/dev/agents/security-eng.yaml +1 -1
  98. package/departments/dev/skills/adversarial-review/SKILL.md +10 -2
  99. package/departments/dev/skills/ai-assisted-dev/SKILL.md +3 -11
  100. package/departments/dev/skills/architecture-design/SKILL.md +3 -11
  101. package/departments/dev/skills/clean-code-review/SKILL.md +9 -2
  102. package/departments/dev/skills/code-review/SKILL.md +12 -12
  103. package/departments/dev/skills/db-design/SKILL.md +3 -11
  104. package/departments/dev/skills/ddd-model/SKILL.md +3 -11
  105. package/departments/dev/skills/demo-gif/SKILL.md +3 -11
  106. package/departments/dev/skills/deploy/SKILL.md +3 -11
  107. package/departments/dev/skills/devops-pipeline/SKILL.md +3 -11
  108. package/departments/dev/skills/docs/SKILL.md +3 -11
  109. package/departments/dev/skills/mcp/SKILL.md +3 -11
  110. package/departments/dev/skills/performance-audit/SKILL.md +3 -11
  111. package/departments/dev/skills/refactor-plan/SKILL.md +3 -11
  112. package/departments/dev/skills/research/SKILL.md +16 -12
  113. package/departments/dev/skills/security-compliance/SKILL.md +3 -11
  114. package/departments/dev/skills/spec/SKILL.md +15 -10
  115. package/departments/dev/skills/stack-check/SKILL.md +3 -11
  116. package/departments/ecom/SKILL.md +4 -12
  117. package/departments/ecom/skills/analytics/SKILL.md +3 -11
  118. package/departments/ecom/skills/browse-competitor/SKILL.md +3 -11
  119. package/departments/ecom/skills/cart-recovery/SKILL.md +3 -11
  120. package/departments/ecom/skills/cro-optimize/SKILL.md +3 -11
  121. package/departments/ecom/skills/customer-journey/SKILL.md +3 -11
  122. package/departments/ecom/skills/fulfillment-plan/SKILL.md +3 -11
  123. package/departments/ecom/skills/marketplace-manage/SKILL.md +3 -11
  124. package/departments/ecom/skills/pricing-strategy/SKILL.md +3 -11
  125. package/departments/ecom/skills/product-launch/SKILL.md +3 -11
  126. package/departments/ecom/skills/rfm-segment/SKILL.md +3 -11
  127. package/departments/ecom/skills/social-commerce/SKILL.md +3 -11
  128. package/departments/ecom/skills/store-audit/SKILL.md +3 -11
  129. package/departments/ecom/skills/subscription-model/SKILL.md +3 -11
  130. package/departments/finance/SKILL.md +4 -12
  131. package/departments/finance/skills/budget-plan/SKILL.md +3 -11
  132. package/departments/finance/skills/cashflow-forecast/SKILL.md +3 -11
  133. package/departments/finance/skills/ciso-advisor/SKILL.md +3 -11
  134. package/departments/finance/skills/financial-model/SKILL.md +3 -11
  135. package/departments/finance/skills/pitch-deck/SKILL.md +3 -11
  136. package/departments/finance/skills/scenario-analysis/SKILL.md +3 -11
  137. package/departments/finance/skills/unit-economics/SKILL.md +3 -11
  138. package/departments/finance/skills/valuation-model/SKILL.md +3 -11
  139. package/departments/kb/SKILL.md +4 -12
  140. package/departments/kb/skills/ai-research/SKILL.md +3 -11
  141. package/departments/kb/skills/competitive-intel/SKILL.md +3 -11
  142. package/departments/kb/skills/knowledge-review/SKILL.md +3 -11
  143. package/departments/kb/skills/learn-content/SKILL.md +3 -11
  144. package/departments/kb/skills/moc-create/SKILL.md +3 -11
  145. package/departments/kb/skills/persona-build/SKILL.md +3 -11
  146. package/departments/kb/skills/research-plan/SKILL.md +3 -11
  147. package/departments/kb/skills/search-kb/SKILL.md +3 -11
  148. package/departments/kb/skills/source-evaluate/SKILL.md +3 -11
  149. package/departments/kb/skills/taxonomy-manage/SKILL.md +3 -11
  150. package/departments/kb/skills/write-as-persona/SKILL.md +3 -11
  151. package/departments/landing/SKILL.md +4 -12
  152. package/departments/landing/skills/ab-test/SKILL.md +3 -11
  153. package/departments/landing/skills/affiliate-bridge/SKILL.md +3 -11
  154. package/departments/landing/skills/awareness-diagnose/SKILL.md +3 -11
  155. package/departments/landing/skills/copy-framework/SKILL.md +1 -1
  156. package/departments/landing/skills/email-sequence/SKILL.md +3 -11
  157. package/departments/landing/skills/funnel-metrics/SKILL.md +3 -11
  158. package/departments/landing/skills/headline-write/SKILL.md +3 -11
  159. package/departments/landing/skills/launch-sequence/SKILL.md +3 -11
  160. package/departments/landing/skills/offer-create/SKILL.md +3 -11
  161. package/departments/landing/skills/optimize-page/SKILL.md +3 -11
  162. package/departments/landing/skills/page-architect/SKILL.md +3 -11
  163. package/departments/landing/skills/persuasion-apply/SKILL.md +3 -11
  164. package/departments/landing/skills/webinar-funnel/SKILL.md +3 -11
  165. package/departments/leadership/SKILL.md +4 -12
  166. package/departments/leadership/skills/change-manage/SKILL.md +3 -11
  167. package/departments/leadership/skills/conflict-resolve/SKILL.md +3 -11
  168. package/departments/leadership/skills/culture-audit/SKILL.md +3 -11
  169. package/departments/leadership/skills/delegation-matrix/SKILL.md +3 -11
  170. package/departments/leadership/skills/disc-assess/SKILL.md +3 -11
  171. package/departments/leadership/skills/feedback-give/SKILL.md +3 -11
  172. package/departments/leadership/skills/hiring-plan/SKILL.md +3 -11
  173. package/departments/leadership/skills/performance-review/SKILL.md +3 -11
  174. package/departments/marketing/SKILL.md +4 -12
  175. package/departments/marketing/skills/ab-test/SKILL.md +3 -11
  176. package/departments/marketing/skills/analytics-report/SKILL.md +3 -11
  177. package/departments/marketing/skills/audience-segment/SKILL.md +3 -11
  178. package/departments/marketing/skills/calendar-plan/SKILL.md +3 -11
  179. package/departments/marketing/skills/competitor-analysis/SKILL.md +3 -11
  180. package/departments/marketing/skills/content-audit/SKILL.md +3 -11
  181. package/departments/marketing/skills/email-sequence/SKILL.md +3 -11
  182. package/departments/marketing/skills/growth-loop/SKILL.md +15 -13
  183. package/departments/marketing/skills/marketing-automation/SKILL.md +3 -11
  184. package/departments/marketing/skills/paid-campaign/SKILL.md +3 -11
  185. package/departments/marketing/skills/programmatic-seo/SKILL.md +3 -11
  186. package/departments/marketing/skills/seo-audit/SKILL.md +3 -11
  187. package/departments/marketing/skills/social-strategy/SKILL.md +3 -11
  188. package/departments/ops/SKILL.md +4 -12
  189. package/departments/ops/skills/bottleneck-find/SKILL.md +3 -11
  190. package/departments/ops/skills/dashboard-build/SKILL.md +3 -11
  191. package/departments/ops/skills/gdpr-compliance/SKILL.md +3 -11
  192. package/departments/ops/skills/gtd-setup/SKILL.md +3 -11
  193. package/departments/ops/skills/integration-design/SKILL.md +3 -11
  194. package/departments/ops/skills/iso27001/SKILL.md +3 -11
  195. package/departments/ops/skills/lean-audit/SKILL.md +3 -11
  196. package/departments/ops/skills/metrics-dashboard/SKILL.md +3 -11
  197. package/departments/ops/skills/n8n-flow/SKILL.md +3 -11
  198. package/departments/ops/skills/quality-management/SKILL.md +3 -11
  199. package/departments/ops/skills/risk-management/SKILL.md +3 -11
  200. package/departments/ops/skills/soc2-compliance/SKILL.md +3 -11
  201. package/departments/ops/skills/sop-create/SKILL.md +3 -11
  202. package/departments/ops/skills/workflow-automate/SKILL.md +3 -11
  203. package/departments/ops/skills/zapier-flow/SKILL.md +3 -11
  204. package/departments/org/SKILL.md +4 -12
  205. package/departments/org/skills/compensation-plan/SKILL.md +3 -11
  206. package/departments/org/skills/culture-define/SKILL.md +3 -11
  207. package/departments/org/skills/decision-framework/SKILL.md +3 -11
  208. package/departments/org/skills/hiring-plan/SKILL.md +3 -11
  209. package/departments/org/skills/meeting-optimize/SKILL.md +3 -11
  210. package/departments/org/skills/onboarding-design/SKILL.md +3 -11
  211. package/departments/org/skills/org-design/SKILL.md +3 -11
  212. package/departments/org/skills/remote-setup/SKILL.md +3 -11
  213. package/departments/org/skills/sop-process/SKILL.md +3 -11
  214. package/departments/org/skills/team-assess/SKILL.md +3 -11
  215. package/departments/pm/SKILL.md +4 -12
  216. package/departments/pm/skills/backlog-groom/SKILL.md +3 -11
  217. package/departments/pm/skills/discovery-plan/SKILL.md +3 -11
  218. package/departments/pm/skills/estimate-forecast/SKILL.md +3 -11
  219. package/departments/pm/skills/impact-map/SKILL.md +3 -11
  220. package/departments/pm/skills/kanban-setup/SKILL.md +3 -11
  221. package/departments/pm/skills/risk-register/SKILL.md +3 -11
  222. package/departments/pm/skills/roadmap-build/SKILL.md +3 -11
  223. package/departments/pm/skills/sprint-plan/SKILL.md +3 -11
  224. package/departments/pm/skills/stakeholder-map/SKILL.md +3 -11
  225. package/departments/pm/skills/standup-run/SKILL.md +3 -11
  226. package/departments/pm/skills/story-write/SKILL.md +3 -11
  227. package/departments/quality/agents/copy-director.yaml +10 -4
  228. package/departments/saas/SKILL.md +4 -12
  229. package/departments/saas/skills/benchmark-compare/SKILL.md +3 -11
  230. package/departments/saas/skills/churn-analysis/SKILL.md +3 -11
  231. package/departments/saas/skills/customer-success/SKILL.md +3 -11
  232. package/departments/saas/skills/growth-plan/SKILL.md +13 -12
  233. package/departments/saas/skills/gtm-strategy/SKILL.md +3 -11
  234. package/departments/saas/skills/launch-execute/SKILL.md +3 -11
  235. package/departments/saas/skills/metrics-dashboard/SKILL.md +3 -11
  236. package/departments/saas/skills/micro-saas-stack/SKILL.md +3 -11
  237. package/departments/saas/skills/mvp-build/SKILL.md +3 -11
  238. package/departments/saas/skills/niche-evaluate/SKILL.md +13 -12
  239. package/departments/saas/skills/onboarding-optimize/SKILL.md +3 -11
  240. package/departments/saas/skills/plg-setup/SKILL.md +3 -11
  241. package/departments/saas/skills/pricing-strategy/SKILL.md +3 -11
  242. package/departments/saas/skills/validate-idea/SKILL.md +13 -13
  243. package/departments/sales/SKILL.md +4 -12
  244. package/departments/sales/skills/challenger-sell/SKILL.md +3 -11
  245. package/departments/sales/skills/deal-qualify/SKILL.md +3 -11
  246. package/departments/sales/skills/discovery-call/SKILL.md +3 -11
  247. package/departments/sales/skills/forecast-revenue/SKILL.md +3 -11
  248. package/departments/sales/skills/negotiate-plan/SKILL.md +3 -11
  249. package/departments/sales/skills/objection-handle/SKILL.md +3 -11
  250. package/departments/sales/skills/pipeline-manage/SKILL.md +3 -11
  251. package/departments/sales/skills/pricing-negotiate/SKILL.md +3 -11
  252. package/departments/strategy/SKILL.md +4 -12
  253. package/departments/strategy/skills/blue-ocean/SKILL.md +3 -11
  254. package/departments/strategy/skills/bmc/SKILL.md +3 -11
  255. package/departments/strategy/skills/board-advisor/SKILL.md +3 -11
  256. package/departments/strategy/skills/cto-advisor/SKILL.md +3 -11
  257. package/departments/strategy/skills/extract-data/SKILL.md +3 -11
  258. package/departments/strategy/skills/five-forces/SKILL.md +3 -11
  259. package/departments/strategy/skills/growth-strategy/SKILL.md +15 -14
  260. package/departments/strategy/skills/moat-analysis/SKILL.md +3 -11
  261. package/departments/strategy/skills/position/SKILL.md +3 -11
  262. package/departments/strategy/skills/scenario-plan/SKILL.md +3 -11
  263. package/package.json +1 -1
  264. package/pyproject.toml +1 -1
  265. package/scripts/__pycache__/migrate_skills_kb_first.cpython-313.pyc +0 -0
  266. package/scripts/migrate_skills_kb_first.py +41 -21
  267. package/scripts/tools/__pycache__/prompt_lint.cpython-313.pyc +0 -0
  268. package/scripts/tools/prompt_lint.py +276 -0
@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
6
  ---
7
7
 
8
8
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
9
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
10
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
11
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
12
  <!-- arka:kb-first-prefix end -->
21
13
 
22
14
  # Deploy — `/dev deploy <env>`
@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
6
  ---
7
7
 
8
8
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
9
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
10
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
11
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
12
  <!-- arka:kb-first-prefix end -->
21
13
 
22
14
  # Devops Pipeline — `/dev pipeline <project>`
@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
6
  ---
7
7
 
8
8
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
9
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
10
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
11
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
12
  <!-- arka:kb-first-prefix end -->
21
13
 
22
14
  # Docs — `/dev docs`
@@ -9,17 +9,9 @@ description: >
9
9
  ---
10
10
 
11
11
  <!-- arka:kb-first-prefix begin -->
12
- ## KB-First Research (non-negotiable)
13
-
14
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
15
-
16
- 1. Call `mcp__obsidian__search_notes` on the query first.
17
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
18
- 3. Only after (1) and (2) may external tools run.
19
-
20
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
21
- treat them as your default source. External research supplements, it
22
- does not replace the vault.
12
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
13
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
14
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
23
15
  <!-- arka:kb-first-prefix end -->
24
16
 
25
17
  # MCP Management — ARKA OS Dev Department
@@ -7,17 +7,9 @@ allowed-tools: [Read, Bash, Grep, Glob, Agent, WebFetch]
7
7
  ---
8
8
 
9
9
  <!-- arka:kb-first-prefix begin -->
10
- ## KB-First Research (non-negotiable)
11
-
12
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
13
-
14
- 1. Call `mcp__obsidian__search_notes` on the query first.
15
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
16
- 3. Only after (1) and (2) may external tools run.
17
-
18
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
19
- treat them as your default source. External research supplements, it
20
- does not replace the vault.
10
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
11
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
12
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
21
13
  <!-- arka:kb-first-prefix end -->
22
14
 
23
15
  # Performance Audit — `/dev performance <target>`
@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
6
  ---
7
7
 
8
8
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
9
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
10
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
11
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
12
  <!-- arka:kb-first-prefix end -->
21
13
 
22
14
  # Refactor Plan — `/dev refactor <scope>`
@@ -1,22 +1,26 @@
1
1
  ---
2
2
  name: dev/research
3
3
  description: >
4
- Research a technical topic: library evaluation, pattern comparison, best practice discovery.
4
+ Dev-scoped technical research (Lucas, Analyst): library evaluation,
5
+ framework/package selection, code pattern comparison, and engineering
6
+ best-practice discovery via Context7 official docs + web research,
7
+ ending in a trade-off report with a recommendation.
8
+ TRIGGER: user types "/dev research", "avalia a biblioteca", "que
9
+ lib/framework usamos", "compara X vs Y" for code dependencies,
10
+ "library evaluation", "which package/ORM/framework should we use",
11
+ "best practice" questions about implementation choices — load BEFORE
12
+ adding a new dependency or committing to an architecture-relevant
13
+ library.
14
+ SKIP: general, market, or knowledge-base research whose deliverable
15
+ is an Obsidian KB note — arka-research (/arka research, 5-source
16
+ fan-out) wins; requirements definition — arka-dev-spec wins.
5
17
  allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
18
  ---
7
19
 
8
20
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
21
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
22
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
23
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
24
  <!-- arka:kb-first-prefix end -->
21
25
 
22
26
  # Research — `/dev research <topic>`
@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
6
  ---
7
7
 
8
8
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
9
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
10
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
11
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
12
  <!-- arka:kb-first-prefix end -->
21
13
 
22
14
  # Security Compliance — `/dev security-compliance`
@@ -1,20 +1,25 @@
1
1
  ---
2
2
  name: arka-dev-spec
3
3
  description: >
4
- NON-NEGOTIABLE spec-driven development gate. Creates, validates, and manages feature
5
- specifications before any code is written. Uses Living Specs engine (core/specs/).
6
- Interactive workflow that collaborates with the user to produce detailed specs covering
7
- scope, acceptance criteria, data model, API contracts, UI/UX requirements, edge cases,
8
- and test scenarios. Auto-invoked as Phase 0 by all code-modifying Tier 1 and Tier 2
9
- dev workflows (/dev feature, /dev api, /dev db, and code-modifying /dev do).
10
- This is a Constitution rule (NON-NEGOTIABLE #7) no code without an approved spec.
11
- Use when user says "spec", "specification", "requirements", "define feature",
12
- "write spec", "describe what to build", or when any code-modifying dev command is invoked.
4
+ Spec-driven development gate, constitution MUST rule spec-driven (Constitution #7 — no code
5
+ without an approved spec): creates, validates, and manages feature
6
+ specifications with the Living Specs engine (core/specs/), covering scope,
7
+ acceptance criteria, data model, API contracts, UI/UX requirements, edge
8
+ cases, and test scenarios. TRIGGER: "spec", "specification",
9
+ "requirements", "requisitos", "define feature", "write spec", "escreve a
10
+ spec", "critérios de aceitação", "describe what to build", "/dev spec";
11
+ auto-invoked as Phase 0 of every code-modifying dev workflow (/dev
12
+ feature, /dev api, /dev db, code-modifying /dev do) load BEFORE writing
13
+ any code. SKIP: multi-agent planning, complexity escalation, or "how do
14
+ we execute this" -> /arka-forge (the Forge plans the WORK; spec defines
15
+ the WHAT — requirements and acceptance criteria); reviewing existing code
16
+ -> dev/code-review; /dev debug and /dev refactor operate on existing code
17
+ and need no new spec.
13
18
  ---
14
19
 
15
20
  # Spec-Driven Development — ARKA OS Dev Department
16
21
 
17
- No code is written until a detailed spec exists and is approved. **NON-NEGOTIABLE #7.**
22
+ No code is written until a detailed spec exists and is approved. **Constitution MUST rule spec-driven (#7).**
18
23
 
19
24
  ## Commands
20
25
 
@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
6
  ---
7
7
 
8
8
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
9
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
10
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
11
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
12
  <!-- arka:kb-first-prefix end -->
21
13
 
22
14
  # Stack Check — `/dev stack-check`
@@ -7,17 +7,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
7
7
  ---
8
8
 
9
9
  <!-- arka:kb-first-prefix begin -->
10
- ## KB-First Research (non-negotiable)
11
-
12
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
13
-
14
- 1. Call `mcp__obsidian__search_notes` on the query first.
15
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
16
- 3. Only after (1) and (2) may external tools run.
17
-
18
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
19
- treat them as your default source. External research supplements, it
20
- does not replace the vault.
10
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
11
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
12
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
21
13
  <!-- arka:kb-first-prefix end -->
22
14
 
23
15
  # E-Commerce — ArkaOS v2
@@ -57,7 +49,7 @@ does not replace the vault.
57
49
  When dispatching subagent work via the Task tool, include the `model` parameter from the target agent's YAML `model:` field:
58
50
 
59
51
  - Agent YAMLs at `departments/*/agents/*.yaml` have `model: opus | sonnet | haiku`
60
- - Quality Gate dispatch (Marta/Eduardo/Francisca) ALWAYS uses `model: opus` — NON-NEGOTIABLE
52
+ - Quality Gate dispatch model: constitution `quality_gate.model_policy` (single source best-available via Model Fabric; veto is model-independent)
61
53
  - Default to `sonnet` if the agent YAML has no `model` field
62
54
  - Mechanical tasks (commit messages, routing, keyword extraction) use `model: haiku`
63
55
 
@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
6
  ---
7
7
 
8
8
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
9
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
10
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
11
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
12
  <!-- arka:kb-first-prefix end -->
21
13
 
22
14
  # Analytics — `/ecom analytics`
@@ -8,17 +8,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
8
8
  ---
9
9
 
10
10
  <!-- arka:kb-first-prefix begin -->
11
- ## KB-First Research (non-negotiable)
12
-
13
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
14
-
15
- 1. Call `mcp__obsidian__search_notes` on the query first.
16
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
17
- 3. Only after (1) and (2) may external tools run.
18
-
19
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
20
- treat them as your default source. External research supplements, it
21
- does not replace the vault.
11
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
12
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
13
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
22
14
  <!-- arka:kb-first-prefix end -->
23
15
 
24
16
  # Browse Competitor — `/ecom browse-competitor`
@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
6
  ---
7
7
 
8
8
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
9
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
10
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
11
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
12
  <!-- arka:kb-first-prefix end -->
21
13
 
22
14
  # Cart Recovery — `/ecom cart-recovery`
@@ -7,17 +7,9 @@ allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
7
7
  ---
8
8
 
9
9
  <!-- arka:kb-first-prefix begin -->
10
- ## KB-First Research (non-negotiable)
11
-
12
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
13
-
14
- 1. Call `mcp__obsidian__search_notes` on the query first.
15
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
16
- 3. Only after (1) and (2) may external tools run.
17
-
18
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
19
- treat them as your default source. External research supplements, it
20
- does not replace the vault.
10
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
11
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
12
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
21
13
  <!-- arka:kb-first-prefix end -->
22
14
 
23
15
  # CRO Optimization — `/ecom cro <page>`
@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
6
  ---
7
7
 
8
8
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
9
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
10
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
11
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
12
  <!-- arka:kb-first-prefix end -->
21
13
 
22
14
  # Customer Journey — `/ecom journey <segment>`
@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
6
  ---
7
7
 
8
8
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
9
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
10
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
11
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
12
  <!-- arka:kb-first-prefix end -->
21
13
 
22
14
  # Fulfillment Plan — `/ecom fulfillment`
@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
6
  ---
7
7
 
8
8
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
9
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
10
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
11
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
12
  <!-- arka:kb-first-prefix end -->
21
13
 
22
14
  # Marketplace Manage — `/ecom marketplace <action>`
@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
6
  ---
7
7
 
8
8
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
9
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
10
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
11
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
12
  <!-- arka:kb-first-prefix end -->
21
13
 
22
14
  # Pricing Strategy — `/ecom pricing <product>`
@@ -8,17 +8,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
8
8
  ---
9
9
 
10
10
  <!-- arka:kb-first-prefix begin -->
11
- ## KB-First Research (non-negotiable)
12
-
13
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
14
-
15
- 1. Call `mcp__obsidian__search_notes` on the query first.
16
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
17
- 3. Only after (1) and (2) may external tools run.
18
-
19
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
20
- treat them as your default source. External research supplements, it
21
- does not replace the vault.
11
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
12
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
13
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
22
14
  <!-- arka:kb-first-prefix end -->
23
15
 
24
16
  # Product Launch — `/ecom launch <product>`
@@ -7,17 +7,9 @@ allowed-tools: [Read, Write, Edit, Agent, WebFetch]
7
7
  ---
8
8
 
9
9
  <!-- arka:kb-first-prefix begin -->
10
- ## KB-First Research (non-negotiable)
11
-
12
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
13
-
14
- 1. Call `mcp__obsidian__search_notes` on the query first.
15
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
16
- 3. Only after (1) and (2) may external tools run.
17
-
18
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
19
- treat them as your default source. External research supplements, it
20
- does not replace the vault.
10
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
11
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
12
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
21
13
  <!-- arka:kb-first-prefix end -->
22
14
 
23
15
  # RFM Segmentation — `/ecom rfm`
@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
6
  ---
7
7
 
8
8
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
9
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
10
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
11
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
12
  <!-- arka:kb-first-prefix end -->
21
13
 
22
14
  # Social Commerce — `/ecom social-commerce`
@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
6
  ---
7
7
 
8
8
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
9
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
10
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
11
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
12
  <!-- arka:kb-first-prefix end -->
21
13
 
22
14
  # Store Audit — `/ecom audit`
@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
6
  ---
7
7
 
8
8
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
9
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
10
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
11
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
12
  <!-- arka:kb-first-prefix end -->
21
13
 
22
14
  # Subscription Model — `/ecom subscription <model>`
@@ -8,17 +8,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
8
8
  ---
9
9
 
10
10
  <!-- arka:kb-first-prefix begin -->
11
- ## KB-First Research (non-negotiable)
12
-
13
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
14
-
15
- 1. Call `mcp__obsidian__search_notes` on the query first.
16
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
17
- 3. Only after (1) and (2) may external tools run.
18
-
19
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
20
- treat them as your default source. External research supplements, it
21
- does not replace the vault.
11
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
12
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
13
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
22
14
  <!-- arka:kb-first-prefix end -->
23
15
 
24
16
  # Finance & Investment — ArkaOS v2
@@ -55,7 +47,7 @@ does not replace the vault.
55
47
  When dispatching subagent work via the Task tool, include the `model` parameter from the target agent's YAML `model:` field:
56
48
 
57
49
  - Agent YAMLs at `departments/*/agents/*.yaml` have `model: opus | sonnet | haiku`
58
- - Quality Gate dispatch (Marta/Eduardo/Francisca) ALWAYS uses `model: opus` — NON-NEGOTIABLE
50
+ - Quality Gate dispatch model: constitution `quality_gate.model_policy` (single source best-available via Model Fabric; veto is model-independent)
59
51
  - Default to `sonnet` if the agent YAML has no `model` field
60
52
  - Mechanical tasks (commit messages, routing, keyword extraction) use `model: haiku`
61
53
 
@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
6
6
  ---
7
7
 
8
8
  <!-- arka:kb-first-prefix begin -->
9
- ## KB-First Research (non-negotiable)
10
-
11
- Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
12
-
13
- 1. Call `mcp__obsidian__search_notes` on the query first.
14
- 2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
15
- 3. Only after (1) and (2) may external tools run.
16
-
17
- The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
18
- treat them as your default source. External research supplements, it
19
- does not replace the vault.
9
+ > **KB-first:** query `mcp__obsidian__search_notes` and cite
10
+ > `[[wikilinks]]` — or declare the gap — BEFORE any external research.
11
+ > Full doctrine: `arka/SKILL.md` (KB-First Research).
20
12
  <!-- arka:kb-first-prefix end -->
21
13
 
22
14
  # Budget Plan — `/fin budget <scope>`