arkaos 4.6.0 → 4.7.1

package/core/hooks/user_prompt_submit.py

@@ -50,13 +50,11 @@ _CACHE_DIR = arkaos_temp_dir("arkaos-context-cache")
 _CACHE_TTL = 300  # Constitution cache: 5 minutes
 
 _L0_FALLBACK = (
-    "[Constitution] NON-NEGOTIABLE: branch-isolation, obsidian-output, "
-    "authority-boundaries, security-gate, context-first, solid-clean-code, "
-    "spec-driven, human-writing, squad-routing, full-visibility, "
-    "sequential-validation, mandatory-qa, arka-supremacy | QUALITY-GATE: "
-    "marta-cqo, eduardo-copy, francisca-tech-ux | MUST: "
-    "conventional-commits, test-coverage, pattern-matching, "
-    "actionable-output, memory-persistence"
+    "[Constitution] NON-NEGOTIABLE: branch-isolation, security-gate, "
+    "mandatory-qa, evidence-flow, arkaos-not-yes-man, excellence-mandate "
+    "| QUALITY-GATE: marta-cqo, eduardo-copy, francisca-tech-ux | "
+    "MUST (28) incl.: squad-routing, spec-driven, conventional-commits, "
+    "test-coverage, subagent-discipline, persona-vs-artifact"
 )
 
 _ROUTE_REMINDER = """
@@ -72,7 +70,7 @@ flow applies (constitution rule evidence-flow; source arka/skills/flow/SKILL.md)
 G1 CONTEXT ([arka:routing] + grounding) -> G2 PLAN (explicit approval) ->
 G3 EXECUTE (real test run + exit 0 on record) -> G4 REVIEW (executable checks).
 Emit [arka:gate:N] at each gate start. No writes before G2 approval.
-Trivial bypass: [arka:trivial] <reason>, single file, under 10 lines."""
+Trivial bypass: [arka:trivial] <reason> for a single-file edit under 10 lines."""
 
 # Keep in sync with ARKA_WF_VERB_PATTERN in _lib/workflow-classifier.sh.
 _WF_VERB_PATTERN = (
@@ -533,8 +531,15 @@ def main(stdin_json: dict | None = None, raw: str = "") -> int:
     except OSError:
         pass
 
-    user_input = get_str(stdin_json, "userInput") or get_str(
-        stdin_json, "message"
+    # Claude Code sends the user's text under "prompt" (UserPromptSubmit
+    # hook schema); "userInput"/"message" cover other runtimes. Missing
+    # "prompt" here meant the raw JSON line fell through as user_input,
+    # so L1/L5/L2.5 computed on JSON garbage every turn (found 2026-07-09
+    # by the un-swallowed orchestrator bats test).
+    user_input = (
+        get_str(stdin_json, "prompt")
+        or get_str(stdin_json, "userInput")
+        or get_str(stdin_json, "message")
     )
     session_id = get_str(stdin_json, "session_id")
     effort_level = get_str(stdin_json, "effort", "level") or os.environ.get(

package/core/runtime/claude_code.py

@@ -152,7 +152,8 @@ def _run_claude_cli(cmd: list[str]) -> subprocess.CompletedProcess:
 
     try:
         return subprocess.run(
-            cmd, capture_output=True, text=True, timeout=60, check=False
+            cmd, capture_output=True, text=True, encoding="utf-8",
+            errors="replace", timeout=60, check=False
         )
     except subprocess.TimeoutExpired as exc:
         raise LLMUnavailable("claude CLI timed out after 60s") from exc

package/core/runtime/codex_cli.py

@@ -170,6 +170,8 @@ def _run_codex_cli(cmd: list[str]) -> subprocess.CompletedProcess:
             cmd,
             capture_output=True,
             text=True,
+            encoding="utf-8",
+            errors="replace",
             timeout=_TIMEOUT_SECONDS,
             check=False,
             # CRITICAL: with a prompt arg AND piped stdin, codex exec

package/core/runtime/gemini_cli.py

@@ -147,6 +147,8 @@ def _run_gemini_cli(cmd: list[str]) -> subprocess.CompletedProcess:
             cmd,
             capture_output=True,
             text=True,
+            encoding="utf-8",
+            errors="replace",
             timeout=_TIMEOUT_SECONDS,
             check=False,
         )

package/core/synapse/agent_experiences_layer.py

@@ -46,6 +46,10 @@ class AgentExperiencesLayer(Layer):
     def name(self) -> str:
         return "AgentExperiences"
 
+    @property
+    def input_sensitive(self) -> bool:
+        return True
+
     @property
     def cache_ttl(self) -> int:
         return 30

package/core/synapse/engine.py

@@ -8,6 +8,7 @@ Design goals:
 - Relevance filtering (skip irrelevant layers)
 """
 
+import hashlib
 import time
 from dataclasses import dataclass, field
 from typing import Any
@@ -109,6 +110,14 @@ class SynapseEngine:
     def _compute_layer(self, layer: Layer, ctx: PromptContext) -> LayerResult:
         """Compute a single layer with caching."""
         cache_key = f"{layer.id}:{ctx.cwd}:{ctx.active_agent}"
+        if layer.input_sensitive:
+            # Input-dependent layers (hints, department, KB retrieval)
+            # must not serve one prompt's result to a different prompt
+            # within the TTL window.
+            digest = hashlib.sha1(
+                (ctx.user_input or "").encode("utf-8", "replace")
+            ).hexdigest()[:12]
+            cache_key += f":{digest}"
 
         # Check cache
         if layer.cache_ttl > 0:
@@ -181,7 +190,6 @@ def create_default_engine(
         BranchLayer,
         CommandHintsLayer,
         QualityGateLayer,
-        TimeLayer,
         KnowledgeRetrievalLayer,
         KBContextLayer,
         ForgeContextLayer,
@@ -221,7 +229,10 @@ def create_default_engine(
     engine.register_layer(BranchLayer())
     engine.register_layer(CommandHintsLayer(commands=commands))
     engine.register_layer(QualityGateLayer())
-    engine.register_layer(TimeLayer())
+    # L7 TimeLayer removed (prompt-surface P0 2026-07-08): the time-of-day tag
+    # had no consumer rule and invalidated the prompt cache at every
+    # 5h/12h/18h boundary — same rationale as the session-start hook's
+    # time-of-day removal.
     engine.register_layer(ForgeContextLayer())
     # L7.5 (PR4 v3.75.0) — Pattern Library injection. Surfaces prior
     # `PatternCard`s when the user prompt has matching keywords, so

package/core/synapse/graph_context_layer.py

@@ -141,6 +141,10 @@ class GraphContextLayer(Layer):
     def name(self) -> str:
         return "GraphContext"
 
+    @property
+    def input_sensitive(self) -> bool:
+        return True
+
     @property
     def cache_ttl(self) -> int:
         return 30

package/core/synapse/layers.py

@@ -74,6 +74,18 @@ class Layer(ABC):
         """Cache TTL in seconds. 0 = no caching."""
         return 0
 
+    @property
+    def input_sensitive(self) -> bool:
+        """True when compute() depends on ctx.user_input.
+
+        Input-sensitive layers get the prompt hashed into their cache
+        key — without it, a cached result from one prompt is served for
+        a DIFFERENT prompt within the TTL window (found 2026-07-09: L5
+        served 'hello' hints for an explicit '/dev feature' command,
+        defeating its own slash-suppression rule).
+        """
+        return False
+
     @property
     def priority(self) -> int:
         """Layer priority (lower = computed first)."""
@@ -166,6 +178,10 @@ class DepartmentLayer(Layer):
     def name(self) -> str:
         return "Department"
 
+    @property
+    def input_sensitive(self) -> bool:
+        return True
+
     @property
     def priority(self) -> int:
         return 10
@@ -392,6 +408,10 @@ class CommandHintsLayer(Layer):
     def name(self) -> str:
         return "CommandHints"
 
+    @property
+    def input_sensitive(self) -> bool:
+        return True
+
     @property
     def cache_ttl(self) -> int:
         return 30
@@ -496,55 +516,6 @@ class QualityGateLayer(Layer):
         )
 
 
-# --- L7: Time Signal ---
-
-
-class TimeLayer(Layer):
-    """L7: Time-of-day signal for context-aware behavior."""
-
-    @property
-    def id(self) -> str:
-        return "L7"
-
-    @property
-    def name(self) -> str:
-        return "Time"
-
-    @property
-    def cache_ttl(self) -> int:
-        # 1 hour — time-of-day period only changes at 5/12/18 boundaries.
-        # Cache bucket drift of up to 1h is acceptable for a low-signal tag
-        # and dramatically improves prompt-cache hit rate.
-        return 3600
-
-    @property
-    def priority(self) -> int:
-        return 70
-
-    def compute(self, ctx: PromptContext) -> LayerResult:
-        start = time.time()
-        import datetime
-
-        hour = datetime.datetime.now().hour
-        if 5 <= hour < 12:
-            period = "morning"
-        elif 12 <= hour < 18:
-            period = "afternoon"
-        else:
-            period = "evening"
-
-        tag = f"[time:{period}]"
-        ms = int((time.time() - start) * 1000)
-        return LayerResult(
-            layer_id=self.id,
-            tag=tag,
-            content=period,
-            tokens_est=1,
-            compute_ms=ms,
-            cached=False,
-        )
-
-
 # --- L3.5: Knowledge Retrieval ---
 
 
@@ -571,6 +542,10 @@ class KnowledgeRetrievalLayer(Layer):
     def name(self) -> str:
         return "KnowledgeRetrieval"
 
+    @property
+    def input_sensitive(self) -> bool:
+        return True
+
     @property
     def cache_ttl(self) -> int:
         return 30
@@ -1076,6 +1051,10 @@ class KBContextLayer(Layer):
     def name(self) -> str:
         return "KBContext"
 
+    @property
+    def input_sensitive(self) -> bool:
+        return True
+
     @property
     def cache_ttl(self) -> int:
         return 0

package/core/synapse/pattern_library_layer.py

@@ -71,6 +71,10 @@ class PatternLibraryLayer(Layer):
     def name(self) -> str:
         return "PatternLibrary"
 
+    @property
+    def input_sensitive(self) -> bool:
+        return True
+
     @property
     def cache_ttl(self) -> int:
         return 60

package/departments/brand/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 -->
 
 # Brand & Design Department — ArkaOS v2
@@ -52,7 +44,7 @@ does not replace the vault.
 | **Isabel** | Visual Designer | 2 | I+S | Colors, logos, mockups, visual assets |
 | **Sofia D.** | UX/UI Designer | 2 | C+I | Wireframes, usability, accessibility |
 
-## Brand Creation Method (NON-NEGOTIABLE: strategy before visuals)
+## Brand Creation Method (MUST: strategy before visuals)
 
 ```
 Level 1 — FOUNDATION (Mateus leads)
@@ -103,7 +95,7 @@ Level 4 — DELIVERY (Valentina leads)
 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/brand/skills/archetype-finder/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 -->
 
 # Archetype Finder — `/brand archetype <brand>`

package/departments/brand/skills/colors/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 -->
 
 # Colors — `/brand colors <mood>`

package/departments/brand/skills/design-review/SKILL.md

@@ -1,9 +1,17 @@
 ---
 name: brand/design-review
 description: >
-  Open a design tool (Figma, Sketch, Canva desktop) and compare live designs
-  against brand guidelines. Screenshot and annotate differences.
-  Requires Computer Use (/mcp → computer-use).
+  Visual review of live designs against brand guidelines — opens Figma,
+  Sketch, or Canva desktop via Computer Use, screenshots each artboard, and
+  annotates palette, typography, spacing, and logo deviations. Requires
+  Computer Use (/mcp -> computer-use). TRIGGER: "/brand design-review",
+  "design review", "visual review", "revê o design", "compara com o
+  brandbook", "está on-brand?", "visual QA", "UI review" of mockups or
+  screenshots, design file paths (*.fig, *.sketch, Canva links). SKIP:
+  reviewing the CODE behind a UI (components, CSS, diffs, PRs) ->
+  dev/code-review wins; SOLID/style sweep of frontend code ->
+  dev/clean-code-review wins; trying to break flows or find abuse vectors ->
+  dev/adversarial-review wins.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent]
 ---
 

package/departments/brand/skills/design-system/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 -->
 
 # Design System — `/brand design-system`

package/departments/brand/skills/identity-system/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 -->
 
 # Identity System — `/brand identity <name>`

package/departments/brand/skills/logo-brief/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 -->
 
 # Logo — `/brand logo <brief>`

package/departments/brand/skills/mockup-generate/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 -->
 
 # Mockup — `/brand mockup <type>`

package/departments/brand/skills/naming-evaluate/SKILL.md

@@ -6,17 +6,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 -->
 
 # Brand Naming — `/brand naming <project>`

package/departments/brand/skills/positioning-statement/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 -->
 
 # Positioning Statement — `/brand positioning <name>`

package/departments/brand/skills/primal-audit/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 -->
 
 # Primal Brand Audit — `/brand audit`

package/departments/brand/skills/ux-audit/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 -->
 
 # Ux Audit — `/brand ux-audit <url>`

package/departments/brand/skills/voice-guide/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 -->
 
 # Voice Guide — `/brand voice <context>`