arkaos 4.6.0 → 4.7.1

package/departments/content/skills/viral-design/SKILL.md

@@ -7,17 +7,9 @@ allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Viral Content Design — `/content viral <topic>`

package/departments/content/skills/youtube-strategy/SKILL.md

@@ -8,17 +8,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # YouTube Strategy — `/content youtube <topic>`

package/departments/dev/SKILL.md

@@ -9,17 +9,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Development Department — ArkaOS v2
@@ -121,7 +113,7 @@ Feature branches: `feature/<slug>` · `fix/<slug>` · `refactor/<slug>`
 When dispatching subagent work via the Task tool, include the `model` parameter from the target agent's YAML `model:` field:
 
 - Agent YAMLs at `departments/*/agents/*.yaml` have `model: opus | sonnet | haiku`
-- Quality Gate dispatch (Marta/Eduardo/Francisca) ALWAYS uses `model: opus` — NON-NEGOTIABLE
+- Quality Gate dispatch model: constitution `quality_gate.model_policy` (single source — best-available via Model Fabric; veto is model-independent)
 - Default to `sonnet` if the agent YAML has no `model` field
 - Mechanical tasks (commit messages, routing, keyword extraction) use `model: haiku`
 

package/departments/dev/agents/security-eng.yaml

@@ -16,7 +16,7 @@ behavioral_dna:
     type: 6
     wing: 5
     core_motivation: "Protecting systems and users from security threats"
-    core_fear: "A breach caused by an oversight he should have caught"
+    core_fear: "A breach caused by an oversight that should have been caught"
     subtype: self-preservation
   big_five:
     openness: 58

package/departments/dev/skills/adversarial-review/SKILL.md

@@ -1,8 +1,16 @@
 ---
 name: dev/adversarial-review
 description: >
-  Adversarial code review with 3 hostile personas: Saboteur, New Hire,
-  Security Auditor. Finds edge cases, race conditions, and abuse vectors.
+  Adversarial code review with 3 hostile personas (Saboteur, New Hire,
+  Security Auditor) that hunts edge cases, race conditions, and abuse
+  vectors and issues a BLOCK/CONCERNS/CLEAN merge verdict. TRIGGER:
+  "/dev adversarial-review", "red team", "adversarial", "try to break
+  this", "tenta partir isto", "ataca este código", "encontra falhas",
+  "abuse cases", "threat model this diff", "refuta isto", or any diff
+  touching auth, payments, or concurrency; run AFTER implementation on
+  the real diff, never on a plan. SKIP: routine pre-merge pass on
+  ordinary changes -> dev/code-review wins; style/SOLID-only sweep ->
+  dev/clean-code-review wins; visual/brand compliance -> brand/design-review wins.
 allowed-tools: [Read, Bash, Grep, Glob, Agent]
 ---
 

package/departments/dev/skills/ai-assisted-dev/SKILL.md

@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Ai Assisted Dev — `/dev ai-dev <task>`

package/departments/dev/skills/architecture-design/SKILL.md

@@ -7,17 +7,9 @@ allowed-tools: [Read, Write, Edit, Grep, Glob, Agent, WebFetch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Architecture Design — `/dev architecture <system>`

package/departments/dev/skills/clean-code-review/SKILL.md

@@ -1,8 +1,15 @@
 ---
 name: dev/clean-code-review
 description: >
-  Review code against Clean Code (Uncle Bob) and SOLID principles. Checks naming,
-  function size, nesting depth, dead code, god classes, and dependency direction.
+  Focused Clean Code (Uncle Bob) + SOLID sweep of a file or PR — naming,
+  function size, nesting depth, dead code, god classes, dependency
+  direction — reported as BLOCKER/WARNING/NOTE with scores. TRIGGER:
+  "/dev clean-review", "clean code", "SOLID", "code smells", "god class",
+  "naming review", "refactor review", "está limpo?", "verifica SOLID",
+  "revê a qualidade do código", "isto viola SRP?". SKIP: full review that
+  must also weigh tests, security, and a merge verdict -> dev/code-review wins;
+  hunting bugs, race conditions, or attack vectors -> dev/adversarial-review wins;
+  anything visual (UI, layout, brand compliance) -> brand/design-review wins.
 allowed-tools: [Read, Grep, Glob, Agent]
 ---
 

package/departments/dev/skills/code-review/SKILL.md

@@ -1,22 +1,22 @@
 ---
 name: dev/code-review
 description: >
-  Code review against Clean Code and SOLID. Checks naming, SRP, DIP, test coverage, security.
+  General code review of a file, diff, or PR against Clean Code, SOLID, test
+  coverage, and baseline security — the default pre-merge review pass in dev
+  workflows. TRIGGER: "/dev review", "code review", "review this PR/diff/file",
+  "revê o código", "faz review", "revê este PR", "análise ao código",
+  "pode fazer merge?"; run BEFORE approving any merge. SKIP: pure
+  naming/SOLID/style sweep with no test, security, or merge concern ->
+  dev/clean-code-review wins; red-team pass, "try to break it", hostile edge-case
+  or abuse-vector hunting -> dev/adversarial-review wins; visual/UI/brand review
+  (Figma, screenshots, pixels, guidelines) -> brand/design-review wins.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Code Review — `/dev review <file/pr>`

package/departments/dev/skills/db-design/SKILL.md

@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Db Design — `/dev db <action>`

package/departments/dev/skills/ddd-model/SKILL.md

@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Ddd Model — `/dev ddd <domain>`

package/departments/dev/skills/demo-gif/SKILL.md

@@ -8,17 +8,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Demo GIF Recording — `/dev demo-gif`

package/departments/dev/skills/deploy/SKILL.md

@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Deploy — `/dev deploy <env>`

package/departments/dev/skills/devops-pipeline/SKILL.md

@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Devops Pipeline — `/dev pipeline <project>`

package/departments/dev/skills/docs/SKILL.md

@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Docs — `/dev docs`

package/departments/dev/skills/mcp/SKILL.md

@@ -9,17 +9,9 @@ description: >
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # MCP Management — ARKA OS Dev Department

package/departments/dev/skills/performance-audit/SKILL.md

@@ -7,17 +7,9 @@ allowed-tools: [Read, Bash, Grep, Glob, Agent, WebFetch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Performance Audit — `/dev performance <target>`

package/departments/dev/skills/refactor-plan/SKILL.md

@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Refactor Plan — `/dev refactor <scope>`

package/departments/dev/skills/research/SKILL.md

@@ -1,22 +1,26 @@
 ---
 name: dev/research
 description: >
-  Research a technical topic: library evaluation, pattern comparison, best practice discovery.
+  Dev-scoped technical research (Lucas, Analyst): library evaluation,
+  framework/package selection, code pattern comparison, and engineering
+  best-practice discovery via Context7 official docs + web research,
+  ending in a trade-off report with a recommendation.
+  TRIGGER: user types "/dev research", "avalia a biblioteca", "que
+  lib/framework usamos", "compara X vs Y" for code dependencies,
+  "library evaluation", "which package/ORM/framework should we use",
+  "best practice" questions about implementation choices — load BEFORE
+  adding a new dependency or committing to an architecture-relevant
+  library.
+  SKIP: general, market, or knowledge-base research whose deliverable
+  is an Obsidian KB note — arka-research (/arka research, 5-source
+  fan-out) wins; requirements definition — arka-dev-spec wins.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Research — `/dev research <topic>`

package/departments/dev/skills/scaffold/SKILL.md

@@ -14,17 +14,21 @@ Create new projects from real git repositories with full automation: dependencie
 
 ## Commands
 
-| Command | Git Repository | Stack |
-|---------|---------------|-------|
-| `/dev scaffold laravel <name>` | `https://${GIT_HOST}/laravel/laravel.git` (override with `ARKAOS_LARAVEL_STARTER_REPO` env) | Laravel + Herd |
-| `/dev scaffold nuxt-saas <name>` | `https://github.com/nuxt-ui-templates/dashboard.git` | Nuxt 3 Dashboard |
-| `/dev scaffold nuxt-landing <name>` | `https://github.com/nuxt-ui-templates/landing.git` | Nuxt 3 Landing |
-| `/dev scaffold nuxt-docs <name>` | `https://github.com/nuxt-ui-templates/docs.git` | Nuxt 3 Docs |
-| `/dev scaffold vue-saas <name>` | `https://github.com/nuxt-ui-templates/dashboard-vue.git` | Vue 3 Dashboard |
-| `/dev scaffold vue-landing <name>` | `https://github.com/nuxt-ui-templates/starter-vue.git` | Vue 3 Landing |
-| `/dev scaffold full-stack <name>` | Laravel + Nuxt (both repos) | Full-stack |
-| `/dev scaffold react <name>` | React starter (TBD) | React SPA |
-| `/dev scaffold nextjs <name>` | Next.js starter (TBD) | Next.js App |
+<!-- Column convention: command | DESCRIPTION | repo. The registry
+     generator (bin/arka-registry-gen) reads column 2 as the user-facing
+     description — a repo URL there ships garbled command help (QG
+     blocker, 2026-07-09). -->
+| Command | Description | Git Repository |
+|---------|-------------|----------------|
+| `/dev scaffold laravel <name>` | Scaffold a Laravel app into ~/Herd from the starter repo | `https://${GIT_HOST}/laravel/laravel.git` (override with `ARKAOS_LARAVEL_STARTER_REPO` env) |
+| `/dev scaffold nuxt-saas <name>` | Scaffold a Nuxt 3 SaaS dashboard into ~/Work | `https://github.com/nuxt-ui-templates/dashboard.git` |
+| `/dev scaffold nuxt-landing <name>` | Scaffold a Nuxt 3 landing page into ~/Work | `https://github.com/nuxt-ui-templates/landing.git` |
+| `/dev scaffold nuxt-docs <name>` | Scaffold a Nuxt 3 docs site into ~/Work | `https://github.com/nuxt-ui-templates/docs.git` |
+| `/dev scaffold vue-saas <name>` | Scaffold a Vue 3 SaaS dashboard into ~/Work | `https://github.com/nuxt-ui-templates/dashboard-vue.git` |
+| `/dev scaffold vue-landing <name>` | Scaffold a Vue 3 landing page into ~/Work | `https://github.com/nuxt-ui-templates/starter-vue.git` |
+| `/dev scaffold full-stack <name>` | Scaffold Laravel (~/Herd) + Nuxt (~/Work) as a linked pair | Laravel + Nuxt starter repos above |
+| `/dev scaffold react <name>` | Scaffold a React SPA — starter repo not yet selected | (not yet selected) |
+| `/dev scaffold nextjs <name>` | Scaffold a Next.js app — starter repo not yet selected | (not yet selected) |
 
 ## Workflow: /dev scaffold <type> <name>
 

package/departments/dev/skills/security-compliance/SKILL.md

@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Security Compliance — `/dev security-compliance`

package/departments/dev/skills/spec/SKILL.md

@@ -1,20 +1,25 @@
 ---
 name: arka-dev-spec
 description: >
-  NON-NEGOTIABLE spec-driven development gate. Creates, validates, and manages feature
-  specifications before any code is written. Uses Living Specs engine (core/specs/).
-  Interactive workflow that collaborates with the user to produce detailed specs covering
-  scope, acceptance criteria, data model, API contracts, UI/UX requirements, edge cases,
-  and test scenarios. Auto-invoked as Phase 0 by all code-modifying Tier 1 and Tier 2
-  dev workflows (/dev feature, /dev api, /dev db, and code-modifying /dev do).
-  This is a Constitution rule (NON-NEGOTIABLE #7) — no code without an approved spec.
-  Use when user says "spec", "specification", "requirements", "define feature",
-  "write spec", "describe what to build", or when any code-modifying dev command is invoked.
+  Spec-driven development gate, constitution MUST rule spec-driven (Constitution #7 — no code
+  without an approved spec): creates, validates, and manages feature
+  specifications with the Living Specs engine (core/specs/), covering scope,
+  acceptance criteria, data model, API contracts, UI/UX requirements, edge
+  cases, and test scenarios. TRIGGER: "spec", "specification",
+  "requirements", "requisitos", "define feature", "write spec", "escreve a
+  spec", "critérios de aceitação", "describe what to build", "/dev spec";
+  auto-invoked as Phase 0 of every code-modifying dev workflow (/dev
+  feature, /dev api, /dev db, code-modifying /dev do) — load BEFORE writing
+  any code. SKIP: multi-agent planning, complexity escalation, or "how do
+  we execute this" -> /arka-forge (the Forge plans the WORK; spec defines
+  the WHAT — requirements and acceptance criteria); reviewing existing code
+  -> dev/code-review; /dev debug and /dev refactor operate on existing code
+  and need no new spec.
 ---
 
 # Spec-Driven Development — ARKA OS Dev Department
 
-No code is written until a detailed spec exists and is approved. **NON-NEGOTIABLE #7.**
+No code is written until a detailed spec exists and is approved. **Constitution MUST rule spec-driven (#7).**
 
 ## Commands
 

package/departments/dev/skills/stack-check/SKILL.md

@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Stack Check — `/dev stack-check`

package/departments/ecom/SKILL.md

@@ -7,17 +7,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # E-Commerce — ArkaOS v2
@@ -57,7 +49,7 @@ does not replace the vault.
 When dispatching subagent work via the Task tool, include the `model` parameter from the target agent's YAML `model:` field:
 
 - Agent YAMLs at `departments/*/agents/*.yaml` have `model: opus | sonnet | haiku`
-- Quality Gate dispatch (Marta/Eduardo/Francisca) ALWAYS uses `model: opus` — NON-NEGOTIABLE
+- Quality Gate dispatch model: constitution `quality_gate.model_policy` (single source — best-available via Model Fabric; veto is model-independent)
 - Default to `sonnet` if the agent YAML has no `model` field
 - Mechanical tasks (commit messages, routing, keyword extraction) use `model: haiku`
 

package/departments/ecom/skills/analytics/SKILL.md

@@ -6,17 +6,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-## KB-First Research (non-negotiable)
-
-Before any external research (Context7, WebSearch, WebFetch, Firecrawl):
-
-1. Call `mcp__obsidian__search_notes` on the query first.
-2. Cite relevant hits with `[[wikilinks]]` or explicitly declare a KB gap.
-3. Only after (1) and (2) may external tools run.
-
-The Synapse L2.5 layer pre-injects top KB matches on every user prompt;
-treat them as your default source. External research supplements, it
-does not replace the vault.
+> **KB-first:** query `mcp__obsidian__search_notes` and cite
+> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 
 # Analytics — `/ecom analytics`