arkaos 4.7.1 → 4.9.0

package/core/evals/verdict_labels.py

@@ -0,0 +1,72 @@
+"""QG verdicts as free eval labels.
+
+Every Quality Gate review already produces a structured ``QGVerdict``
+(APPROVED/REJECTED + blockers + evidence summary). Persisting them turns
+each review into a labeled example — the training/eval signal the E2E
+audit called "labels gratuitos". Append-only JSONL, same conventions as
+the other ``~/.arkaos/telemetry`` writers: never raises, fcntl advisory
+lock via ``llm_cost_telemetry._locked_append`` (QG reviews run as
+parallel subagents and verdict lines far exceed atomic-write sizes, so
+unlocked appends could interleave and corrupt the label corpus),
+``ARKA_QG_LABELS_PATH`` override for tests.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+from core.governance.qg_verdict import QGVerdict
+from core.runtime.llm_cost_telemetry import _locked_append
+
+DEFAULT_LABELS_PATH = (
+    Path.home() / ".arkaos" / "telemetry" / "qg-verdicts.jsonl"
+)
+
+
+def _labels_path() -> Path:
+    override = os.environ.get("ARKA_QG_LABELS_PATH", "").strip()
+    return Path(override) if override else DEFAULT_LABELS_PATH
+
+
+def record_verdict_label(
+    verdict: QGVerdict,
+    deliverable: str = "",
+    department: str = "",
+    eval_task_id: str = "",
+    session_id: str = "",
+) -> None:
+    """Append one labeled QG example. Never raises (telemetry contract)."""
+    try:
+        entry: dict[str, Any] = {
+            "ts": datetime.now(timezone.utc).isoformat(),
+            "deliverable": str(deliverable or ""),
+            "department": str(department or ""),
+            "eval_task_id": str(eval_task_id or ""),
+            "session_id": str(session_id or ""),
+            **verdict.model_dump(),
+        }
+        with _locked_append(_labels_path()) as fh:
+            fh.write(json.dumps(entry, ensure_ascii=False) + "\n")
+    except Exception:  # noqa: BLE001 — telemetry must never raise
+        return
+
+
+def load_verdict_labels(path: Path | None = None) -> list[dict[str, Any]]:
+    """Read all labeled examples; malformed lines are skipped."""
+    target = path or _labels_path()
+    if not target.exists():
+        return []
+    out: list[dict[str, Any]] = []
+    for line in target.read_text(encoding="utf-8").splitlines():
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            out.append(json.loads(line))
+        except json.JSONDecodeError:
+            continue
+    return out

package/core/runtime/llm_cost_telemetry.py

@@ -232,6 +232,16 @@ def _load_slice(
     return kept, corrupt
 
 
+def _is_fallback_diagnostic(entry: dict[str, Any]) -> bool:
+    """Provider-fallback rows carry the fallback REASON in the model field
+    (_log_fallback in llm_provider.py: model='unavailable'/'selected').
+    They belong in the by-provider view (degraded chains) but leak bogus
+    zero-token rows into any model-keyed breakdown. Totals and by_provider
+    keep counting them, so sum(by_model[*].call_count) < call_count when
+    fallbacks occurred — intentional, not a reconciliation bug."""
+    return str(entry.get("provider") or "").startswith("fallback:")
+
+
 def _group(entries: list[dict[str, Any]], key: str) -> dict[str, dict[str, Any]]:
     out: dict[str, dict[str, Any]] = {}
     for entry in entries:
@@ -298,7 +308,9 @@ def summarise(
         cache_hit_rate=finalised["cache_hit_rate"],
         call_count=finalised["call_count"],
         by_provider=_group(entries, "provider"),
-        by_model=_group(entries, "model"),
+        by_model=_group(
+            [e for e in entries if not _is_fallback_diagnostic(e)], "model"
+        ),
         by_category=_group(entries, "category"),
         by_session=sessions,
         advisories=_build_advisories(sessions, advisory_threshold_usd),

package/core/runtime/subagent.py

@@ -1,31 +1,19 @@
-"""Subagent Pattern — fresh agent instances per task.
+"""Subagent handoff artifact — compacted context per dispatch.
 
 Each subagent gets a fresh context window, preventing context pollution
-between tasks. The orchestrator uses only 10-15% of its context to
-dispatch and collect results.
-
-Pattern: Orchestrator compacts task description + relevant context into
-a brief, dispatches to a subagent, and receives a structured result.
-
-Context budget:
-- Orchestrator: 10-15% of context window for dispatch + collection
-- Subagent: Full context window for task execution
-- Handoff artifact: ~379 tokens per agent switch (compacted persona + task)
+between tasks. The orchestrator compacts task description + relevant
+context into a brief (~379-token) artifact and dispatches via the
+runtime's Task tool.
+
+Dispatch itself is orchestrated by the runtime (hooks + skills + Task
+tool); the former Python SubagentDispatcher had no production callers
+and was removed (see docs/adr/2026-07-09-remove-dead-orchestration.md).
+`HandoffArtifact` stays as the measured handoff contract — consumed by
+`scripts/bench/harness.py::bench_subagent_handoff` and
+`core/runtime/context_compactor.py` builds its `context_summary`.
 """
 
 from dataclasses import dataclass, field
-from enum import Enum
-from typing import Optional, Any
-
-from core.agents.schema import Agent
-
-
-class SubagentStatus(str, Enum):
-    PENDING = "pending"
-    RUNNING = "running"
-    COMPLETED = "completed"
-    FAILED = "failed"
-    TIMEOUT = "timeout"
 
 
 @dataclass
@@ -70,150 +58,3 @@ class HandoffArtifact:
     def estimated_tokens(self) -> int:
         """Estimate token count of this artifact."""
         return len(self.to_prompt().split())
-
-
-@dataclass
-class SubagentResult:
-    """Result returned by a subagent."""
-    task_id: str
-    agent_id: str
-    status: SubagentStatus
-    output: str = ""
-    files_modified: list[str] = field(default_factory=list)
-    tokens_used: int = 0
-    duration_ms: int = 0
-    metadata: dict[str, Any] = field(default_factory=dict)
-
-    def to_summary(self, max_tokens: int = 200) -> str:
-        """Compact the result for the orchestrator's context.
-
-        The orchestrator doesn't need the full output, just a summary
-        to decide next steps.
-        """
-        words = self.output.split()
-        if len(words) <= max_tokens:
-            return self.output
-        return " ".join(words[:max_tokens]) + "..."
-
-
-class SubagentDispatcher:
-    """Dispatches tasks to fresh subagent instances.
-
-    The dispatcher creates HandoffArtifacts from agent definitions
-    and task descriptions, then delegates to the runtime adapter
-    for actual execution.
-
-    Nesting policy: Maximum 1 level of nesting (agent -> subagent).
-    Sub-subagent dispatch is not recommended -- creates context fragmentation
-    and debugging complexity. If a subagent needs help, it should escalate
-    to its squad lead rather than spawning another subagent.
-    """
-
-    def __init__(self) -> None:
-        self._pending: dict[str, HandoffArtifact] = {}
-        self._results: dict[str, SubagentResult] = {}
-        self._task_counter: int = 0
-
-    def create_handoff(
-        self,
-        agent: Agent,
-        task_description: str,
-        relevant_files: list[str] | None = None,
-        context_summary: str = "",
-        constraints: list[str] | None = None,
-        expected_output: str = "",
-    ) -> HandoffArtifact:
-        """Create a handoff artifact for a subagent dispatch.
-
-        Args:
-            agent: The agent to dispatch to.
-            task_description: What the subagent should do.
-            relevant_files: File paths the subagent should read.
-            context_summary: Compacted context from prior work.
-                Required when ARKAOS_STRICT_HANDOFF=1; otherwise emits a
-                warning. Use ContextCompactor.build() to construct.
-            constraints: Boundaries for the subagent.
-            expected_output: What format/content is expected back.
-
-        Returns:
-            HandoffArtifact ready for dispatch.
-        """
-        import os, warnings
-        if not context_summary or not context_summary.strip():
-            msg = (
-                "create_handoff called without context_summary — subagent will "
-                "lack prior conversation context. Use ContextCompactor.build() "
-                "to construct one. Set ARKAOS_STRICT_HANDOFF=1 to enforce."
-            )
-            if os.environ.get("ARKAOS_STRICT_HANDOFF") == "1":
-                raise ValueError(msg)
-            warnings.warn(msg, DeprecationWarning, stacklevel=2)
-
-        self._task_counter += 1
-        task_id = f"task-{self._task_counter}"
-
-        disc_label = agent.behavioral_dna.disc.label
-        quality = []
-        if agent.tier <= 1:
-            quality.append("Enterprise-grade quality expected")
-        quality.append("Follow SOLID principles")
-        quality.append("Human-readable output, no AI patterns")
-
-        artifact = HandoffArtifact(
-            task_id=task_id,
-            task_description=task_description,
-            agent_id=agent.id,
-            agent_role=agent.role,
-            agent_disc=disc_label,
-            department=agent.department,
-            relevant_files=relevant_files or [],
-            context_summary=context_summary,
-            constraints=constraints or [],
-            expected_output=expected_output,
-            quality_criteria=quality,
-        )
-
-        self._pending[task_id] = artifact
-        return artifact
-
-    def record_result(self, result: SubagentResult) -> None:
-        """Record a subagent's result."""
-        self._results[result.task_id] = result
-        self._pending.pop(result.task_id, None)
-
-    def get_result(self, task_id: str) -> Optional[SubagentResult]:
-        """Get a subagent's result by task ID."""
-        return self._results.get(task_id)
-
-    def get_pending(self) -> list[HandoffArtifact]:
-        """Get all pending (undispatched) handoffs."""
-        return list(self._pending.values())
-
-    def get_all_results(self) -> list[SubagentResult]:
-        """Get all collected results."""
-        return list(self._results.values())
-
-    @property
-    def pending_count(self) -> int:
-        return len(self._pending)
-
-    @property
-    def completed_count(self) -> int:
-        return len(self._results)
-
-    def orchestrator_context_usage(self) -> dict:
-        """Estimate how much context the orchestrator is using.
-
-        Target: 10-15% of context window for dispatch + collection.
-        """
-        dispatch_tokens = sum(a.estimated_tokens for a in self._pending.values())
-        result_tokens = sum(
-            len(r.to_summary().split()) for r in self._results.values()
-        )
-        total = dispatch_tokens + result_tokens
-        return {
-            "dispatch_tokens": dispatch_tokens,
-            "result_summary_tokens": result_tokens,
-            "total_orchestrator_tokens": total,
-            "tasks_dispatched": self._task_counter,
-        }

package/core/synapse/engine.py

@@ -118,6 +118,12 @@ class SynapseEngine:
                 (ctx.user_input or "").encode("utf-8", "replace")
             ).hexdigest()[:12]
             cache_key += f":{digest}"
+        if getattr(layer, "session_sensitive", False):
+            # Session-sensitive layers (KB retrieval) must recompute per
+            # session: a cross-session cache hit would skip their
+            # per-session side effects (KBSessionCache.store).
+            session_id = (ctx.extra or {}).get("session_id", "default")
+            cache_key += f":{session_id}"
 
         # Check cache
         if layer.cache_ttl > 0:

package/core/synapse/layers.py

@@ -86,6 +86,19 @@ class Layer(ABC):
         """
         return False
 
+    @property
+    def session_sensitive(self) -> bool:
+        """True when compute() has per-session side effects or output.
+
+        Session-sensitive layers get ctx.extra['session_id'] added to
+        their cache key — without it, a cache hit from one session
+        suppresses compute() for a concurrent session in the same cwd,
+        skipping that session's side effects (found 2026-07-09: L3.5's
+        KBSessionCache.store() never ran for the second session, so its
+        KB-injected state and overlap markers belonged to the first).
+        """
+        return False
+
     @property
     def priority(self) -> int:
         """Layer priority (lower = computed first)."""
@@ -546,6 +559,10 @@ class KnowledgeRetrievalLayer(Layer):
     def input_sensitive(self) -> bool:
         return True
 
+    @property
+    def session_sensitive(self) -> bool:
+        return True
+
     @property
     def cache_ttl(self) -> int:
         return 30

package/core/workflow/__init__.py

@@ -1,10 +1,12 @@
-"""YAML-based workflow engine for ArkaOS v2.
+"""YAML workflow definitions for ArkaOS v2.
 
 Declarative workflows with phases, conditions, gates, and parallelization.
+The schema/loader pair is the contract for departments/*/workflows/*.yaml;
+execution is orchestrated by the runtime (hooks + skills + Task tool), not
+by a Python executor (see docs/adr/2026-07-09-remove-dead-orchestration.md).
 """
 
 from core.workflow.schema import Workflow, Phase, Gate, PhaseStatus
-from core.workflow.engine import WorkflowEngine
 from core.workflow.loader import load_workflow
 from core.workflow.state import (
     init_workflow as init_workflow_state,
@@ -17,7 +19,7 @@ from core.workflow.state import (
 )
 
 __all__ = [
-    "Workflow", "Phase", "Gate", "PhaseStatus", "WorkflowEngine", "load_workflow",
+    "Workflow", "Phase", "Gate", "PhaseStatus", "load_workflow",
     "init_workflow_state", "get_workflow_state", "update_phase", "set_branch",
     "add_violation", "is_phase_completed", "clear_workflow",
 ]

package/departments/brand/skills/archetype-finder/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: brand/archetype-finder
 description: >
-  Identify brand archetype from the 12 Jungian archetypes with personality mapping.
+  Identifies a brand's archetype from the 12 Jungian archetypes and maps it to
+  personality traits, voice, and visual direction with real-world examples.
+  TRIGGER: "qual é o arquétipo da marca", "brand archetype", "define a
+  personalidade da marca", "archetype mapping", "que arquétipo somos", "/brand
+  archetype <brand>". SKIP: full identity package (strategy + verbal + visual)
+  -> brand/identity-system (archetype is one input, not the deliverable);
+  turning the personality into written tone rules -> brand/voice-guide.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/colors/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: brand/colors
 description: >
-  Color palette design: primary, secondary, accent, neutrals with contrast ratios.
+  Designs a brand color palette — primary, secondary, accent, and neutrals —
+  delivered with hex codes, usage guidelines, and WCAG contrast checks.
+  TRIGGER: "paleta de cores", "escolhe as cores da marca", "color palette",
+  "brand colors", "que cores combinam com esta marca", "/brand colors <mood>".
+  SKIP: palette as part of a full token and component system ->
+  brand/design-system (tokens, atomic catalog, WCAG gates for the whole UI);
+  complete brand identity from strategy up -> brand/identity-system.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

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

@@ -1,8 +1,15 @@
 ---
 name: brand/design-system
 description: >
-  Production design system specification: tokens, atoms, molecules, organisms,
-  templates, and pages — with WCAG AA conformance and Storybook export contract.
+  Ships a production design system in 5 deliverables: design-tokens.json
+  (primitive + semantic layers), an Atomic Design component catalog (atoms to
+  pages), WCAG 2.2 AA conformance report, Storybook CSF3 story stubs, and an
+  integration guide. TRIGGER: "design system", "cria o design system", "design
+  tokens", "component library", "biblioteca de componentes", "/brand
+  design-system". SKIP: only a color palette -> brand/colors; implementing the
+  components in application code -> dev frontend workflows (this skill
+  specifies the system, it does not build the app); reviewing an existing UI
+  against brand guidelines -> brand/design-review.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/identity-system/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: brand/identity-system
 description: >
-  Full brand identity: strategy, verbal, visual in the correct order (never skip to visuals).
+  Builds a full brand identity in the correct order — strategy, then verbal,
+  then visual (never skips to visuals) — via the Wheeler process and Primal
+  Branding, verifying live brand elements through browser and Computer Use
+  steps. TRIGGER: "cria a identidade da marca", "brand identity", "identidade
+  visual completa", "rebranding completo", "build the brand from scratch",
+  "/brand identity <name>". SKIP: only a logo -> brand/logo-brief; only
+  positioning -> brand/positioning-statement; measuring an EXISTING brand's
+  strength -> brand/primal-audit (audit, not creation).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/logo-brief/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: brand/logo
 description: >
-  Logo concept generation: brief, mood references, AI-generated concepts.
+  Generates logo concepts from a brief: mood references, AI-generated concept
+  directions, variations, rationale, and usage guidelines. TRIGGER: "logo
+  brief", "cria um logo", "desenha o logótipo", "logo concepts", "preciso de
+  um logo", "/brand logo <brief>". SKIP: logo as part of a whole identity
+  (strategy + verbal + visual) -> brand/identity-system (order matters, the
+  logo comes last); applying an existing logo to product, packaging, or social
+  scenes -> brand/mockup-generate.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/mockup-generate/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: brand/mockup
 description: >
-  Generate mockups: product, packaging, social, stationery with brand identity applied.
+  Generates brand-applied mockups — product, packaging, social, and stationery
+  — with AI image-generation prompts and brand application guidelines.
+  TRIGGER: "cria mockups", "mockup do produto", "packaging mockup", "aplica a
+  marca no produto", "social media mockup", "/brand mockup <type>". SKIP:
+  low-fidelity screen structure and layout -> brand/wireframe (structure
+  before pixels); creating the logo itself -> brand/logo-brief (concepts, not
+  application).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

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

@@ -1,7 +1,13 @@
 ---
 name: brand/naming-evaluate
 description: >
-  Generate and evaluate brand names using Alexandra Watkins' SMILE & SCRATCH framework.
+  Generates 30+ brand name candidates across six categories and evaluates them
+  with Alexandra Watkins' SMILE & SCRATCH framework, plus domain and social
+  handle checks, down to a 5-name shortlist. TRIGGER: "nome para a marca",
+  "sugere nomes", "brand naming", "avalia este nome", "is this a good name",
+  "/brand naming <project>". SKIP: the name exists and needs a market position
+  -> brand/positioning-statement; defining the personality behind the name ->
+  brand/archetype-finder.
 allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/positioning-statement/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: brand/positioning-statement
 description: >
-  Brand positioning: FOR [target] WHO [need] [brand] IS A [category] THAT [benefit].
+  Writes a brand positioning statement in the Ries/Trout format — FOR [target]
+  WHO [need], [brand] IS A [category] THAT [benefit] — with competitive
+  context and validation criteria. TRIGGER: "posicionamento da marca",
+  "positioning statement", "como nos posicionamos", "define o posicionamento",
+  "what makes us different", "/brand positioning <name>". SKIP: market-level
+  strategic positioning and competitive moves -> strategy/position (business
+  strategy, not the brand message); brand still unnamed ->
+  brand/naming-evaluate first.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/primal-audit/SKILL.md

@@ -1,8 +1,13 @@
 ---
 name: brand/primal-audit
 description: >
-  Audit an existing brand against Patrick Hanlon's 7 Primal Code elements.
-  Identifies missing elements and provides recommendations to strengthen the brand.
+  Audits an existing brand against Patrick Hanlon's 7 Primal Code elements
+  using a 21-point evidence-cited rubric, a competitor benchmark, and a ranked
+  remediation plan. TRIGGER: "audita a marca", "brand audit", "primal audit",
+  "quão forte é a nossa marca", "how strong is our brand", "/brand audit".
+  SKIP: auditing the interface, not the brand -> brand/ux-audit (Nielsen
+  heuristics on usability); no brand exists yet to audit ->
+  brand/identity-system (creation, not audit).
 allowed-tools: [Read, Write, Edit, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/ux-audit/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: brand/ux-audit
 description: >
-  UX heuristic audit: evaluate interface against Nielsen's 10 heuristics.
+  UX heuristic audit of a live interface against Nielsen's 10 heuristics and
+  Laws of UX — navigates real user flows in the browser, checks accessibility
+  and responsive breakpoints, and delivers severity-rated findings with fixes.
+  TRIGGER: "ux audit", "audita a usabilidade", "auditoria de UX", "heuristic
+  evaluation", "porque é que os users se perdem", "/brand ux-audit <url>".
+  SKIP: on-brand visual compliance (palette, typography vs brandbook) ->
+  brand/design-review; slow pages or Core Web Vitals -> dev/performance-audit;
+  brand strength, not interface -> brand/primal-audit.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/voice-guide/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: brand/voice-guide
 description: >
-  Brand voice and tone guide: personality, vocabulary, do's/don'ts, examples per channel.
+  Creates a brand voice and tone guide — personality, vocabulary, do's and
+  don'ts, tone matrix, and channel-specific examples — using StoryBrand and
+  the Primal sacred lexicon. TRIGGER: "brand voice", "tom de voz da marca",
+  "voice guide", "define o tom de comunicação", "como é que a marca fala",
+  "/brand voice <context>". SKIP: writing actual copy with that voice ->
+  landing/copy-framework or content/hook-write (they produce content, this
+  produces the rules); personality still undefined -> brand/archetype-finder
+  first.
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/brand/skills/wireframe/SKILL.md

@@ -1,7 +1,14 @@
 ---
 name: brand/wireframe
 description: >
-  Wireframe design: layout, navigation, content hierarchy, interaction notes.
+  Designs wireframes — layout, navigation, content hierarchy, and interaction
+  notes — using Garrett's 5 Planes and information architecture, delivered as
+  an annotated spec with component references and responsive notes. TRIGGER:
+  "wireframe", "esboça a página", "estrutura da página", "low-fi layout",
+  "wireframe the dashboard", "/brand wireframe <page>". SKIP: full
+  landing-page conversion structure -> landing/page-architect
+  (conversion-driven section architecture); pixel-level brand-applied visuals
+  -> brand/mockup-generate (wireframes come first).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/community/skills/ai-community/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: community/ai-community
 description: >
-  AI/tech community setup: Discord channels, roles, bots, content strategy.
+  AI/tech community setup on Discord: channel architecture, roles, bots, and
+  content strategy, delivered as an AI community blueprint with growth plan.
+  TRIGGER: "comunidade de IA", "cria um Discord de AI", "AI community",
+  "Discord for my AI product", "setup tech community", "/community ai".
+  SKIP: niche undecided or non-AI vertical -> community/niche-setup (full
+  blueprint for any niche); platform still undecided ->
+  community/platform-select (compares Discord vs Telegram vs Skool first).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---
 

package/departments/community/skills/betting-setup/SKILL.md

@@ -1,7 +1,13 @@
 ---
 name: community/betting-setup
 description: >
-  Betting/trading community setup: Telegram VIP, signal delivery, tier pricing.
+  Betting/trading community setup on Telegram: VIP group structure, signal
+  delivery, bot config, and tier pricing, delivered as a launch-ready
+  blueprint. TRIGGER: "comunidade de apostas", "grupo VIP de sinais",
+  "betting community", "trading signals Telegram", "canal de tips",
+  "/community betting". SKIP: any other niche -> community/niche-setup
+  (generic niche blueprint); revenue design beyond tier pricing ->
+  community/monetize-plan (7-stream monetization with projections).
 allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch, WebSearch]
 ---