arkaos 4.22.0 → 4.24.0

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

@@ -13,8 +13,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

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

@@ -12,8 +12,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

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

@@ -13,8 +13,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

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

@@ -13,8 +13,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

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

@@ -12,8 +12,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/dev/skills/evaluator-build-loop/SKILL.md

@@ -0,0 +1,93 @@
+---
+name: dev/evaluator-build-loop
+description: >
+  Adversarial build loop for UI work: a generator implements against a
+  weighted rubric while an independent, ruthless evaluator tests the LIVE
+  app in a real browser — not the code, not screenshots — and the loop
+  repeats until the score clears the threshold. TRIGGER: "/dev
+  evaluator-build-loop", "build until it passes", "itera até passar",
+  "loop de UI", "evaluator loop", "faz e avalia até estar excelente"; any
+  UI build where the excellence-mandate visual benchmark applies and the
+  operator wants convergence without babysitting. SKIP: one-shot review
+  of an existing diff -> dev/code-review wins; UX audit of a shipped page
+  without a build loop -> dev/click-path-audit wins; writing E2E suites
+  -> dev/app-test wins.
+allowed-tools: [Read, Grep, Glob, Bash, Edit, Write]
+metadata:
+  origin: arkaos
+---
+
+# Evaluator Build Loop — `/dev evaluator-build-loop`
+
+> **Agents:** Diana (Frontend, generator) + Rita (QA, evaluator) | **Framework:** Generator–evaluator separation, rubric-driven iteration
+
+The dev server is up, the screenshot looks fine, and the agent that built
+the page declares it done. Then someone clicks the second tab, resizes to
+390px, or submits the form empty — and the illusion collapses. Builders
+grade their own work with the same eyes that produced it, which is why
+this loop never lets them. One role writes; a different role, in a fresh
+context, tries to make the page fail.
+
+## Roles — never merged, never shared
+
+| Role | Agent | Contract |
+|---|---|---|
+| **Generator** | Diana | Reads the spec + the latest `feedback-NNN.md`; fixes EVERY open finding in order — functionality → craft → design → originality; keeps the dev server alive; commits once per iteration. |
+| **Evaluator** | Rita | Fresh subagent per iteration, launched with ONLY the spec, the rubric, and the app URL — never the generator's reasoning. Drives the live app via the Playwright MCP. Scores against the rubric; writes the next `feedback-NNN.md`. |
+
+The evaluator's launch context is the mechanism, not a detail: any shared
+reasoning re-imports the generator's blind spots.
+
+## The rubric
+
+Written BEFORE iteration 1, with explicit weights, from the spec plus the
+project design system and a named visual benchmark (excellence-mandate:
+UI work loads frontend-design, ui-ux-pro-max, and the project design
+system at maximum effort). Typical weighting: functionality 40 · craft
+(states, a11y, responsiveness) 30 · design fidelity 20 · originality 10.
+A dimension the spec does not care about gets weight 0 — do not invent
+criteria mid-loop.
+
+## Evaluator discipline
+
+- Test the **live app** in the browser: click paths, keyboard, empty and
+  error states, viewport extremes. Not the code. Not screenshots.
+- Be ruthless by instruction: hunt the edge case, penalize
+  default-looking output, refuse partial credit for "almost works".
+- **Default-refuted:** when unsure whether a criterion passes, it fails.
+  Optimism is the generator's disease; the evaluator is the cure.
+- Every finding names the concrete reproduction — URL, action, expected
+  vs. observed — so the generator fixes instead of guessing.
+
+## Loop mechanics
+
+1. Generator builds iteration N; commits on the working branch; emits the
+   `[arka:design]` evidence marker (frontend gate).
+2. Evaluator (fresh context) scores the live app → `feedback-NNN.md` with
+   the score per dimension and ranked findings.
+3. Score ≥ threshold (default 90/100) → exit to Quality Gate. Otherwise
+   loop.
+4. **Circuit breaker:** 5 iterations without clearing the threshold, or
+   two consecutive iterations with no score improvement → stop and
+   escalate to the operator with the score history. Never grind silently.
+
+All handoff is by file — spec, rubric, feedback — so the loop survives a
+`/clear` and either role can be resumed cold.
+
+## Output
+
+```markdown
+## Evaluator Build Loop Report
+
+**Spec:** {path} | **Rubric threshold:** {n}
+**Iterations:** {k} | **Final score:** {score}/100
+
+| Iter | Functionality | Craft | Design | Originality | Total |
+|---|---|---|---|---|---|
+
+**Open findings:** {none, or the escalation list with reproductions}
+**Evidence:** commits {range}, feedback files, `[arka:design]` markers
+```
+
+The loop feeds the Quality Gate; it does not replace it. Marta still has
+the veto.

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

@@ -12,8 +12,9 @@ description: >
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

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

@@ -13,8 +13,9 @@ allowed-tools: [Read, Bash, Grep, Glob, Agent, WebFetch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

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

@@ -13,8 +13,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

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

@@ -19,8 +19,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

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

@@ -13,8 +13,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

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

@@ -0,0 +1,86 @@
+---
+name: dev/spec-miner
+description: >
+  Mines a spec OUT of an existing codebase: maps entry points into
+  capabilities, samples the code under an explicit token budget, and
+  emits machine-parseable WHEN→THEN requirements and invariants — with
+  uncertainty marked, nothing invented, and the source commit recorded so
+  the spec knows when it has aged. TRIGGER: "/dev spec-miner", "extrai a
+  spec", "reverse-engineer the spec", "what does this code actually do,
+  as requirements", "documenta o comportamento existente", brownfield
+  onboarding, and always BEFORE refactoring code that has no spec. SKIP:
+  spec for something new -> dev/spec wins (greenfield WHAT); a guided
+  tour of the codebase -> dev/codebase-onboard wins; library or
+  framework evaluation -> dev/research wins.
+allowed-tools: [Read, Grep, Glob, Bash, Write]
+metadata:
+  origin: arkaos
+---
+
+# Spec Miner — `/dev spec-miner`
+
+> **Agent:** Gabriel (Architect) | **Framework:** Living Specs, budgeted behavioral sampling
+
+`arka-spec` answers "what should we build?" before code exists. This
+skill answers the inverse — "what did we already build?" — for the far
+more common case: a working system whose only specification is the code
+itself, about to be refactored by someone who cannot afford to be wrong
+about current behavior.
+
+## Phase 1 — Map
+
+Detect the structure and group entry points into capabilities: HTTP
+routes, CLI commands, queued jobs, scheduled tasks, event handlers,
+public package exports. Each capability gets a name and its entry files.
+No code reading yet — this phase is inventory, and it bounds phase 2.
+
+## Phase 2 — Sample and expand, under budget
+
+Reading everything is a trap: the budget burns on utilities while the
+behavior lives at the surface. So:
+
+1. Read the entry and facade files of each capability first — in most
+   codebases they encode ~70% of observable behavior.
+2. Descend ONE level into the call chain, only where the facade defers a
+   decision (validation, branching, persistence rules).
+3. **Stop** at external boundaries (SDKs, frameworks, network) or at 15
+   files per capability, whichever comes first.
+4. Whatever was deferred is listed in the spec as explicitly unmined —
+   deferred scope is visible scope, never silent scope.
+
+## Phase 3 — Emit
+
+Requirements in WHEN→THEN form, invariants as standalone guarantees, both
+machine-parseable, written as a markdown document that sits beside the
+authored specs in `core/specs/`:
+
+```markdown
+### Requirement: {capability} — {behavior}
+WHEN {trigger and preconditions}
+THEN {observable outcome}
+<!-- source: {file}:{lines} -->
+
+### Invariant: {guarantee}
+<!-- source: {file}:{lines} -->
+```
+
+Three hard rules:
+
+- **Never invent behavior.** If the code is ambiguous, write the
+  requirement with an `<!-- uncertainty: {what is unclear} -->` marker
+  instead of a guess. A wrong spec is worse than a gap — the gap gets
+  investigated, the wrong spec gets trusted.
+- **Every claim carries a source pointer.** A requirement nobody can
+  trace to a file and line is an opinion.
+- **Stamp the mined commit hash** in the spec frontmatter. When HEAD
+  moves, the spec's age is measurable with a single
+  `git log <hash>..HEAD`, so drift is visible instead of quiet.
+
+## Output
+
+The mined spec is a markdown document beside the authored ones, and
+`status: mined` in its frontmatter is a proposed convention, not an
+engine state: it stays `mined` until a human reviews the document and
+changes the status by hand. The report ends with the coverage summary —
+capabilities mined, files read vs. deferred, uncertainty count — so the
+reader knows exactly how much of the system the spec actually saw.

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

@@ -13,8 +13,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/ecom/SKILL.md

@@ -7,8 +7,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

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

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/ecom/skills/browse-competitor/SKILL.md

@@ -15,8 +15,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/ecom/skills/cart-recovery/SKILL.md

@@ -13,8 +13,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/ecom/skills/cro-optimize/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/ecom/skills/customer-journey/SKILL.md

@@ -13,8 +13,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/ecom/skills/fulfillment-plan/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/ecom/skills/marketplace-manage/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/ecom/skills/pricing-strategy/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/ecom/skills/product-launch/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/ecom/skills/rfm-segment/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Agent, WebFetch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/ecom/skills/social-commerce/SKILL.md

@@ -13,8 +13,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/ecom/skills/store-audit/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/ecom/skills/subscription-model/SKILL.md

@@ -13,8 +13,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/finance/SKILL.md

@@ -8,8 +8,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/finance/skills/budget-plan/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/finance/skills/cashflow-forecast/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/finance/skills/ciso-advisor/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/finance/skills/financial-model/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/finance/skills/pitch-deck/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/finance/skills/scenario-analysis/SKILL.md

@@ -13,8 +13,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/finance/skills/unit-economics/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->
 

package/departments/finance/skills/valuation-model/SKILL.md

@@ -14,8 +14,9 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 
 <!-- arka:kb-first-prefix begin -->
-> **KB-first:** query `mcp__obsidian__search_notes` and cite
-> `[[wikilinks]]` — or declare the gap — BEFORE any external research.
+> **KB-first:** query `mcp__obsidian__search_notes` (and
+> `mcp__graphify__query_graph` when configured) and cite `[[wikilinks]]`
+> or graph nodes — or declare the gap — BEFORE any external research.
 > Full doctrine: `arka/SKILL.md` (KB-First Research).
 <!-- arka:kb-first-prefix end -->