opencode-swarm 7.28.3 → 7.29.1

package/dist/index.js

@@ -48,7 +48,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.28.3",
+    version: "7.29.1",
     description: "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
     main: "dist/index.js",
     types: "dist/index.d.ts",
@@ -61164,19 +61164,9 @@ function validateConfigKey(path31, value, _config) {
     case "guardrails.profiles": {
       const profiles = value;
       if (profiles) {
-        const validAgents = [
-          "architect",
-          "coder",
-          "test_engineer",
-          "explorer",
-          "reviewer",
-          "critic",
-          "sme",
-          "docs",
-          "designer"
-        ];
+        const validAgents = new Set(ALL_AGENT_NAMES);
         for (const [agentName, profile] of Object.entries(profiles)) {
-          if (!validAgents.includes(agentName)) {
+          if (!validAgents.has(agentName)) {
             findings.push({
               id: "unknown-agent-profile",
               title: "Unknown agent profile",
@@ -61337,23 +61327,23 @@ function validateConfigKey(path31, value, _config) {
     case "swarms": {
       const swarms = value;
       if (swarms && typeof swarms === "object") {
+        const validAgents = new Set(ALL_AGENT_NAMES);
         for (const [swarmId, swarmConfig] of Object.entries(swarms)) {
           const swarm = swarmConfig;
           if (swarm.agents && typeof swarm.agents === "object") {
             for (const [agentName] of Object.entries(swarm.agents)) {
-              const validAgents = [
-                "architect",
-                "coder",
-                "test_engineer",
-                "explorer",
-                "reviewer",
-                "critic",
-                "sme",
-                "docs",
-                "designer"
-              ];
-              const baseName = agentName.replace(/^[a-zA-Z0-9]+_/, "");
-              if (!validAgents.includes(baseName)) {
+              const baseName = stripKnownSwarmPrefix(agentName);
+              if (baseName !== agentName && agentName.startsWith(`${swarmId}_`) && validAgents.has(baseName)) {
+                findings.push({
+                  id: "prefixed-swarm-agent-override",
+                  title: "Prefixed agent override is ignored",
+                  description: `Agent "${agentName}" in swarm "${swarmId}" uses a generated agent name. ` + `Per-swarm overrides must use the canonical key "${baseName}", e.g. ` + `"swarms.${swarmId}.agents.${baseName}.model". Otherwise the override is ignored and the agent falls back to its default model.`,
+                  severity: "warn",
+                  path: `swarms.${swarmId}.agents.${agentName}`,
+                  currentValue: swarm.agents[agentName],
+                  autoFixable: false
+                });
+              } else if (!validAgents.has(baseName)) {
                 findings.push({
                   id: "unknown-swarm-agent",
                   title: "Unknown agent in swarm",
@@ -61704,6 +61694,8 @@ function removeStraySwarmDir(projectRoot, strayPath) {
 }
 var VALID_CONFIG_PATTERNS, DANGEROUS_PATH_SEGMENTS;
 var init_config_doctor = __esm(() => {
+  init_constants();
+  init_schema();
   init_utils();
   VALID_CONFIG_PATTERNS = [
     /^\.config[\\/]opencode[\\/]opencode-swarm\.json$/,
@@ -75598,7 +75590,7 @@ ANTI-RATIONALIZATION: Context does not clarify. Models revert to CC training.
 ## IDENTITY
 
 Swarm: {{SWARM_ID}}
-Your agents: {{AGENT_PREFIX}}explorer, {{AGENT_PREFIX}}sme, {{AGENT_PREFIX}}coder, {{AGENT_PREFIX}}reviewer, {{AGENT_PREFIX}}test_engineer, {{AGENT_PREFIX}}critic, {{AGENT_PREFIX}}critic_sounding_board, {{AGENT_PREFIX}}docs, {{AGENT_PREFIX}}designer
+Your agents: {{AGENT_PREFIX}}explorer, {{AGENT_PREFIX}}sme, {{AGENT_PREFIX}}coder, {{AGENT_PREFIX}}reviewer, {{AGENT_PREFIX}}test_engineer, {{AGENT_PREFIX}}critic, {{AGENT_PREFIX}}critic_sounding_board, {{AGENT_PREFIX}}skill_improver, {{AGENT_PREFIX}}spec_writer, {{AGENT_PREFIX}}docs, {{AGENT_PREFIX}}designer
 
 ## PROJECT CONTEXT
 Session-start priming block. Use any known values immediately; if a field is still unresolved, run MODE: DISCOVER before relying on it.
@@ -75939,63 +75931,38 @@ SECURITY_KEYWORDS: password, secret, token, credential, auth, login, encryption,
 {{AGENT_PREFIX}}test_engineer - Test generation AND execution (writes tests, runs them, reports PASS/FAIL)
 {{AGENT_PREFIX}}critic - Plan review gate (reviews plan BEFORE implementation)
 {{AGENT_PREFIX}}critic_sounding_board - Pre-escalation pushback (honest engineer review before user contact)
+{{AGENT_PREFIX}}skill_improver - Low-frequency skill / knowledge / prompt improvement adviser
+{{AGENT_PREFIX}}spec_writer - .swarm/spec.md authoring via spec_write
 {{AGENT_PREFIX}}docs - Documentation updates (README, API docs, guides — NOT .swarm/ files)
 {{AGENT_PREFIX}}designer - UI/UX design specs (scaffold generation for UI components — runs BEFORE coder on UI tasks)
 
 ## SKILLS PROPAGATION
 
-Subagents run in isolated contexts. Project-specific skills loaded in your session are NOT automatically visible to them. Prefer repo-relative \`file:\` references; inline bodies bloat context and are fallback only.
-
-### Step 1 — Discover available skills (once per session)
-
-At session start, before your first delegation:
-1. Read contract files first: \`AGENTS.md\`, \`CLAUDE.md\`, \`CONTRIBUTING.md\`, \`TESTING.md\` when present. Extract task-relevant MUST/NEVER rules and pass them in INPUT/CONSTRAINT.
-2. Reuse \`<skill-context>\` skills when present.
-3. Otherwise use \`search\` with \`include\` patterns like \`.opencode/skills/*/SKILL.md,.claude/skills/*/SKILL.md\` and frontmatter queries \`^name:\` / \`^description:\`.
-4. Cache a short \`.swarm/context.md\` \`## Available Skills\` index. Include the repo-relative \`file:\` path and description so subagents can load on demand:
-   - writing-tests: Guidelines for writing tests (used: 12, compliance: 95%) → test_engineer, coder
-   - engineering-conventions: Engineering invariants (used: 8, compliance: 100%) → coder, reviewer, test_engineer
-   - [name]: [description] (used: N, compliance: N%) → [applicable agents]
-
-   Use \`.swarm/skill-usage.jsonl\` when present; otherwise weight skills equally.
-
-   If skill-usage.jsonl does not exist, proceed with equal weighting — no enrichment needed.
+Subagents run in isolated contexts. Any project-specific skill constraints loaded into your session (e.g. \`writing-tests\`, \`engineering-conventions\`, coding standards, security guidelines) are NOT automatically visible to them. The hook system auto-injects relevant skills into delegation prompts.
 
+### Step 1 — Skills are auto-discovered and scored
 
-### Step 2 — Route skills to agents
+The hook system discovers available skills and scores them by relevance to the task. The hook auto-injects them into the delegation prompt.
 
-Include a skill when its name/description matches:
+### Step 2 — SKILLS: field is auto-populated
 
-| Skill description / name contains…               | Pass to agents…                       |
-Route tests to test_engineer/coder; conventions to coder/reviewer/test_engineer; implementation to coder/reviewer; review/security to reviewer; docs to docs; architecture/ui/domain topics to designer or sme.
+The hook auto-populates the \`SKILLS:\` field with top recommended skills (max 5, threshold 0.5). Explicit \`SKILLS: none\` is preserved.
 
-When uncertain, pass the skill. Missing applicable skills cause convention drift.
+### Step 3 — Skill references with context descriptions
 
-### Step 3 — Include skill references in delegations
+When passing skill references, you may add brief context descriptions. The hook injects \`file:path (-- description)\` format.
 
-Add \`SKILLS:\` to every coder, reviewer, test_engineer, sme, docs, and designer delegation:
+### Step 4 — Forward SKILLS_USED_BY_CODER to reviewer
 
-- \`SKILLS: none\` — only when no project-specific skill applies to that delegation
-- \`SKILLS: file:.claude/skills/writing-tests/SKILL.md\` — preferred for skills that exist on disk; use repo-relative \`file:\` references, comma-separated when multiple skills apply
-- Descriptive multi-line catalog:
-  SKILLS:
-  - file:.claude/skills/writing-tests/SKILL.md - Guidelines for writing tests
-  - file:.claude/skills/engineering-conventions/SKILL.md - Engineering invariants for safe changes
-- Inline fallback:
-  SKILLS:
-  --- [skill-name] ---
-  [full SKILL.md body content pasted here]
+When delegating to the reviewer after a coder task, include a \`SKILLS_USED_BY_CODER: [comma-separated list of skill paths from the coder delegation]\` field. The reviewer must receive the same skill context the coder received so it can verify skill compliance.
 
-Default to repo-relative \`file:\` references. Use inline skill bodies only when no stable repo path exists or a prior agent reported \`SKILL_LOAD_FAILED\`.
+Example: If the coder received \`SKILLS: file:.claude/skills/writing-tests/SKILL.md\`, the reviewer delegation must include \`SKILLS_USED_BY_CODER: file:.claude/skills/writing-tests/SKILL.md\` in addition to the reviewer's own \`SKILLS:\` field.
 
-**SKILL_LOAD_FAILED recovery:** do NOT retry with the same reference. Re-delegate with the full skill body inline, or \`SKILLS: none\` if no applicable content exists.
+**Skill-to-agent routing:** Managed via \`.opencode/skill-routing.yaml\`. The hook reads this file at delegation time.
 
-**Mandatory for coding tasks:** provide \`writing-tests\` to test_engineer and \`engineering-conventions\` to coder + reviewer when present.
-
-### Step 4 — Forward skills to reviewer
-
-When delegating to reviewer after coder, include \`SKILLS_USED_BY_CODER: [comma-separated skill paths from coder]\` plus reviewer \`SKILLS:\` so compliance can be checked.
+**SKILL_LOAD_FAILED recovery:** If a subagent reports SKILL_LOAD_FAILED for a \`file:\` reference, do NOT retry with the same reference. Instead, re-delegate with either: (a) the full skill body pasted inline, or (b) \`SKILLS: none\` if no applicable skill content is available. Never re-use a file: reference that has already failed.
 
+**Mandatory for coding tasks:** Always provide \`writing-tests\` to test_engineer and \`engineering-conventions\` to coder + reviewer when those skills are present in the project. Prefer \`file:\` references when the files exist.
 
 ## SWARM KNOWLEDGE DIRECTIVES (v2 acknowledgment contract)
 
@@ -76016,16 +75983,20 @@ For every applicable directive in the block:
 
 You may also call the \`knowledge_ack\` tool to record an outcome explicitly when chat-text markers would be ambiguous (e.g. inside structured tool args).
 
-## SKILL IMPROVER (low-frequency, expensive-model adviser)
+## SKILL IMPROVER
 
-Use \`skill_improver\` / \`skill_improve\` rarely for repeated review failures, ignored knowledge clusters, stale skills, or fresh spec drift. It is quota-bounded and proposal-only.
+\`{{AGENT_PREFIX}}skill_improver\` / \`skill_improve\`: rare, quota-bounded,
+disabled by default, proposal-only. Use for repeated rejections,
+\`KNOWLEDGE_IGNORED\`, stale skills, or spec drift.
 
 When \`skill_improver.require_user_approval\` is true (default), ASK the user
 before running. Default outputs are proposals only — they never modify source.
 
 ## SPEC WRITER
 
-For substantial spec authoring/revision, prefer \`spec_writer\`; it writes only via \`spec_write\`. Use it for new/major specs, non-trivial requirements decomposition, or when you would otherwise inline-author \`.swarm/spec.md\`. Handle small typos/cross-references inline.
+For substantial spec authoring/revision, prefer \`{{AGENT_PREFIX}}spec_writer\`;
+it writes via \`spec_write\`. Use for major specs or non-trivial
+decomposition. Handle small touch-ups.
 
 ### ANTI-RATIONALIZATION
 - ✗ "The coder already knows these conventions" → Skills contain project-specific rules the model cannot know from training. Always pass.
@@ -76038,7 +76009,7 @@ For substantial spec authoring/revision, prefer \`spec_writer\`; it writes only
 ## SLASH COMMANDS
 {{SLASH_COMMANDS}}
 Commands above are documented with args and behavioral details. Run commands via /swarm <command> [args].
-Outside OpenCode, use \`bunx opencode-swarm run <command> [args]\`; never use \`bun -e\` or internal \`src/commands/\` paths. Human-only commands (\`acknowledge-spec-drift\`, \`reset\`, \`reset-session\`, \`rollback\`, \`checkpoint\`, safety-gate release, plan-state destruction) MUST be presented to the user to run. Never invoke them via Bash, swarm_command, or chat fallback; if blocked as human-only, present it to the user.
+Outside OpenCode, invoke any plugin command via: \`bunx opencode-swarm run <command> [args]\` (e.g. \`bunx opencode-swarm run knowledge migrate\`). Do not use \`bun -e\` or look for \`src/commands/\` — those paths are internal to the plugin source and do not exist in user project directories. EXCEPTION — human-only commands (including but not limited to \`acknowledge-spec-drift\`, \`reset\`, \`reset-session\`, \`rollback\`, \`checkpoint\`, and any command that releases a runtime safety gate or destroys plan state): you MUST present these to the user and ask them to run the command themselves. Never invoke a human-only command via Bash, swarm_command, or chat fallback. The runtime guardrail will block such attempts; if a Bash call returns \`BLOCKED\` with a "human-only" message, do not retry under a different shell form — present the situation to the user instead.
 
 SMEs advise only. Reviewer and critic review only. None of them write code.
 
@@ -76046,15 +76017,15 @@ Available Tools: {{AVAILABLE_TOOLS}}
 
 ## DELEGATION FORMAT
 
-Delegations happen ONLY through the **Task** tool; chat text is not delivered to agents. Examples below are Task content.
+Delegations are performed ONLY by calling the **Task** tool. Writing delegation text into the chat does nothing — the agent will not receive it. Every delegation below is the content you pass to the Task tool, not text you output to the conversation.
 
-follow the receiving agent's INPUT FORMAT exactly; do NOT invent/omit fields. Begin with agent name, \`TASK:\`, and \`SKILLS:\` when supported.
+All delegations MUST follow the receiving agent's INPUT FORMAT exactly. Do NOT invent fields, omit required fields, or force one agent's schema onto another. Every delegation MUST begin with the agent name, include \`TASK:\`, and include \`SKILLS:\` when that agent prompt supports skills.
 Do NOT add conversational preamble before the agent prefix. Begin directly with the agent name.
 
 {{AGENT_PREFIX}}[agent]
 TASK: [single objective]
 [agent-specific fields required by that agent's INPUT FORMAT]
-SKILLS: [either "none", repo-relative file references with descriptions, or inline skill bodies — see SKILLS PROPAGATION; use "none" only when no project-specific skill applies]
+SKILLS: [either "none", repo-relative file: references, or inline skill bodies — see SKILLS PROPAGATION; use "none" only when no project-specific skill applies]
 
 Examples:
 
@@ -76087,22 +76058,22 @@ FILE: src/auth/login.ts
 INPUT: Validate email format, password >= 8 chars
 OUTPUT: Modified file
 CONSTRAINT: Do not modify other functions
-SKILLS: file:.claude/skills/engineering-conventions/SKILL.md - safe code changes
+SKILLS: file:.claude/skills/engineering-conventions/SKILL.md
 
 {{AGENT_PREFIX}}reviewer
 TASK: Review login validation
 FILE: src/auth/login.ts
 CHECK: [security, correctness, edge-cases]
 GATES: lint=PASS, sast_scan=PASS, secretscan=PASS
-SKILLS_USED_BY_CODER: file:.claude/skills/engineering-conventions/SKILL.md - safe code changes
+SKILLS_USED_BY_CODER: file:.claude/skills/engineering-conventions/SKILL.md
 OUTPUT: VERDICT + RISK + ISSUES
-SKILLS: file:.claude/skills/engineering-conventions/SKILL.md - safe code changes
+SKILLS: file:.claude/skills/engineering-conventions/SKILL.md
 
 {{AGENT_PREFIX}}test_engineer
 TASK: Generate and run login validation tests
 FILE: src/auth/login.ts
 OUTPUT: Test file at src/auth/login.test.ts + VERDICT: PASS/FAIL with failure details
-SKILLS: file:.claude/skills/writing-tests/SKILL.md - tests
+SKILLS: file:.claude/skills/writing-tests/SKILL.md
 
 {{AGENT_PREFIX}}critic
 TASK: Review plan for user authentication feature
@@ -76117,14 +76088,14 @@ FILE: src/auth/login.ts
 CHECK: [security-only] — evaluate against OWASP Top 10, scan for hardcoded secrets, injection vectors, insecure crypto, missing input validation
 GATES: lint=PASS, sast_scan=PASS, secretscan=PASS
 OUTPUT: VERDICT + RISK + SECURITY ISSUES ONLY
-SKILLS: file:.claude/skills/engineering-conventions/SKILL.md - safe code changes
+SKILLS: file:.claude/skills/engineering-conventions/SKILL.md
 
 {{AGENT_PREFIX}}test_engineer
 TASK: Adversarial security testing
 FILE: src/auth/login.ts
 CONSTRAINT: ONLY attack vectors — malformed inputs, oversized payloads, injection attempts, auth bypass, boundary violations
 OUTPUT: Test file + VERDICT: PASS/FAIL
-SKILLS: file:.claude/skills/writing-tests/SKILL.md - tests
+SKILLS: file:.claude/skills/writing-tests/SKILL.md
 
 {{AGENT_PREFIX}}explorer
 TASK: Integration impact analysis
@@ -76206,11 +76177,12 @@ MODE: BRAINSTORM runs seven phases in strict order. Do not skip phases. Do not c
 - Exit with a design outline the user can skim in under two minutes.
 
 **Phase 5: SPEC WRITE + SELF-REVIEW (architect + reviewer).**
-- Generate \`.swarm/spec.md\` following the same SPEC CONTENT RULES that MODE: SPECIFY uses: WHAT/WHY only, no tech stack, no implementation details, FR-### / SC-### numbering, Given/When/Then scenarios, \`[NEEDS CLARIFICATION]\` markers (max 3).
+- Delegate substantial spec drafting to \`{{AGENT_PREFIX}}spec_writer\` with the chosen design, dialogue notes, SME context, and SPEC CONTENT RULES. The spec writer must persist \`.swarm/spec.md\` through \`spec_write\`.
+- The spec must follow the same SPEC CONTENT RULES that MODE: SPECIFY uses: WHAT/WHY only, no tech stack, no implementation details, FR-### / SC-### numbering, Given/When/Then scenarios, \`[NEEDS CLARIFICATION]\` markers (max 3).
 - Cross-reference design sections by name where relevant context helps (but keep HOW out of the spec).
 - Delegate to \`{{AGENT_PREFIX}}reviewer\` for an independent review of the draft spec. Reviewer must flag: requirements that encode HOW, untestable requirements, missing edge cases, silent assumptions.
 - Apply reviewer feedback. If reviewer rejects, iterate once and re-review. After two rounds, surface remaining disagreements to the user.
-- Write the final spec to \`.swarm/spec.md\`.
+- Read back and lint the final spec after \`{{AGENT_PREFIX}}spec_writer\` writes it.
 - Exit when reviewer signs off (or user explicitly accepts remaining disagreements).
 
 **Phase 6: QA GATE SELECTION (architect, dialogue only).**
@@ -76282,7 +76254,7 @@ Activates when: user asks to "specify", "define requirements", "write a spec", o
 1b. Run CODEBASE REALITY CHECK for any codebase references mentioned by the user or implied by the feature. Skip if work is purely greenfield (no existing codebase to check). Report discrepancies before proceeding to explorer.
 2. Delegate to \`{{AGENT_PREFIX}}explorer\` to scan the codebase for relevant context (existing patterns, related code, affected areas).
 3. Delegate to \`{{AGENT_PREFIX}}sme\` for domain research on the feature area to surface known constraints, best practices, and integration concerns.
-4. Generate \`.swarm/spec.md\` capturing:
+4. Delegate substantial spec drafting to \`{{AGENT_PREFIX}}spec_writer\`. Include the user requirements, explorer findings, SME constraints, and these required contents:
    - First line must be: \`# Specification: <feature-name>\`
    - Feature description: WHAT users need and WHY — never HOW to implement
    - User scenarios with acceptance criteria (Given/When/Then format)
@@ -76291,7 +76263,7 @@ Activates when: user asks to "specify", "define requirements", "write a spec", o
    - Key entities if data is involved (no schema or field definitions — entity names only)
    - Edge cases and known failure modes
    - \`[NEEDS CLARIFICATION]\` markers (max 3) for items where uncertainty could change scope, security, or core behavior; prefer informed defaults over asking
-5. Write the spec to \`.swarm/spec.md\`.
+5. Require \`{{AGENT_PREFIX}}spec_writer\` to write the spec via \`spec_write\`, then read back and lint \`.swarm/spec.md\`.
 5b. **QA GATE SELECTION (dialogue only).**
 {{QA_GATE_DIALOGUE_SPECIFY}}
 
@@ -79494,8 +79466,24 @@ function createSwarmAgents(swarmId, swarmConfig, isDefault, pluginConfig, projec
     const swarmIdentity = isDefault ? "default" : swarmId;
     const agentPrefix = prefix;
     architect.config.prompt = architect.config.prompt?.replace(/\{\{SWARM_ID\}\}/g, swarmIdentity).replace(/\{\{AGENT_PREFIX\}\}/g, agentPrefix).replace(/\{\{QA_RETRY_LIMIT\}\}/g, String(qaRetryLimit)).replace(/\{\{PROJECT_LANGUAGE\}\}/g, projectContext.PROJECT_LANGUAGE).replace(/\{\{PROJECT_FRAMEWORK\}\}/g, projectContext.PROJECT_FRAMEWORK).replace(/\{\{BUILD_CMD\}\}/g, projectContext.BUILD_CMD).replace(/\{\{TEST_CMD\}\}/g, projectContext.TEST_CMD).replace(/\{\{LINT_CMD\}\}/g, projectContext.LINT_CMD).replace(/\{\{ENTRY_POINTS\}\}/g, projectContext.ENTRY_POINTS).replace(/\{\{CODER_CONSTRAINTS\}\}/g, projectContext.CODER_CONSTRAINTS).replace(/\{\{TEST_CONSTRAINTS\}\}/g, projectContext.TEST_CONSTRAINTS).replace(/\{\{REVIEWER_CHECKLIST\}\}/g, projectContext.REVIEWER_CHECKLIST).replace(/\{\{PROJECT_CONTEXT_SECONDARY_LANGUAGES\}\}/g, projectContext.PROJECT_CONTEXT_SECONDARY_LANGUAGES);
+    const skillImproverEnabled = !isAgentDisabled("skill_improver", swarmAgents, swarmPrefix);
+    const specWriterEnabled = !isAgentDisabled("spec_writer", swarmAgents, swarmPrefix);
+    if (!skillImproverEnabled) {
+      architect.config.prompt = architect.config.prompt?.replace(`, ${agentPrefix}skill_improver`, "").replace(`
+${agentPrefix}skill_improver - Low-frequency skill / knowledge / prompt improvement adviser`, "").replace(/\n## SKILL IMPROVER[\s\S]*?(?=\n\n## SPEC WRITER)/, "");
+    }
+    if (!specWriterEnabled) {
+      const escapedAgentPrefix = agentPrefix.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+      architect.config.prompt = architect.config.prompt?.replace(`, ${agentPrefix}spec_writer`, "").replace(`
+${agentPrefix}spec_writer - .swarm/spec.md authoring via spec_write`, "").replace(/\n## SPEC WRITER[\s\S]*?(?=\n\n### ANTI-RATIONALIZATION)/, "").replace(new RegExp(`- Delegate substantial spec drafting to \`${escapedAgentPrefix}spec_writer\`[^\\n]*\\n`, "g"), "- spec_writer is disabled. Ask the user to enable the spec_writer agent before creating or revising `.swarm/spec.md`.\n").replace(new RegExp(`4\\. Delegate substantial spec drafting to \`${escapedAgentPrefix}spec_writer\`[^\\n]*`), "4. spec_writer is disabled. Ask the user to enable the spec_writer agent before creating or revising `.swarm/spec.md`.").replace(new RegExp(`5\\. Require \`${escapedAgentPrefix}spec_writer\` to write the spec via \`spec_write\`, then read back and lint \`\\.swarm/spec\\.md\`\\.`), "5. Do not continue SPECIFY until spec_writer is available.").replace(new RegExp(`- Read back and lint the final spec after \`${escapedAgentPrefix}spec_writer\` writes it\\.`), "- Do not continue BRAINSTORM spec writing until spec_writer is available.");
+    }
     if (!isDefault) {
       architect.description = `[${swarmName}] ${architect.description}`;
+      const optionalAgentLines = [
+        skillImproverEnabled ? `- @${swarmId}_skill_improver (not @skill_improver)` : undefined,
+        specWriterEnabled ? `- @${swarmId}_spec_writer (not @spec_writer)` : undefined
+      ].filter((line) => Boolean(line)).join(`
+`);
       const swarmHeader = `## ⚠️ YOU ARE THE ${swarmName.toUpperCase()} SWARM ARCHITECT
 
 Your swarm ID is "${swarmId}". ALL your agents have the "${swarmId}_" prefix:
@@ -79503,7 +79491,8 @@ Your swarm ID is "${swarmId}". ALL your agents have the "${swarmId}_" prefix:
 - @${swarmId}_coder (not @coder)
 - @${swarmId}_sme (not @sme)
 - @${swarmId}_reviewer (not @reviewer)
-- etc.
+${optionalAgentLines ? `${optionalAgentLines}
+` : ""}- etc.
 
 CRITICAL: Agents without the "${swarmId}_" prefix DO NOT EXIST or belong to a DIFFERENT swarm.
 If you call @coder instead of @${swarmId}_coder, the call will FAIL or go to the wrong swarm.
@@ -95117,6 +95106,9 @@ function utcDayKey(d = new Date) {
 function buildAckDedupKey(sessionId, id, result, now = new Date) {
   return `${sessionId}|${id}|${result}|${utcDayKey(now)}`;
 }
+function filterHighConfidenceKnowledge(entries, threshold = 0.8) {
+  return entries.filter((entry) => entry.confidence >= threshold);
+}
 
 // src/hooks/knowledge-application-gate.ts
 var HIGH_RISK_TOOLS = new Set([
@@ -95569,7 +95561,8 @@ function createKnowledgeInjectorHook(directory, config3) {
       currentPhase: phaseDescription
     };
     const entries = await readContextualKnowledge(directory, config3, retrievalCtx);
-    cachedShownIds = entries.map((e) => e.id);
+    const filteredEntries = filterHighConfidenceKnowledge(entries);
+    cachedShownIds = filteredEntries.map((e) => e.id);
     let freshPreamble = null;
     try {
       const driftReports = await readPriorDriftReports(directory);
@@ -95590,7 +95583,7 @@ function createKnowledgeInjectorHook(directory, config3) {
 ${freshPreamble}` : `<curator_briefing>${truncatedBriefing}</curator_briefing>`;
       }
     } catch {}
-    if (entries.length === 0) {
+    if (filteredEntries.length === 0) {
       if (freshPreamble === null)
         return;
       cachedInjectionText = freshPreamble;
@@ -95601,9 +95594,9 @@ ${freshPreamble}` : `<curator_briefing>${truncatedBriefing}</curator_briefing>`;
     const isFullBudget = effectiveBudget === maxInjectChars;
     const directiveBudget = Math.floor(effectiveBudget * 0.45);
     const lessonBudget = Math.floor(effectiveBudget * 0.3);
-    const directiveEntries = entries.filter((e) => e.triggers && e.triggers.length > 0 || e.required_actions && e.required_actions.length > 0 || e.forbidden_actions && e.forbidden_actions.length > 0 || e.directive_priority === "critical" || e.directive_priority === "high" || e.generated_skill_path);
+    const directiveEntries = filteredEntries.filter((e) => e.triggers && e.triggers.length > 0 || e.required_actions && e.required_actions.length > 0 || e.forbidden_actions && e.forbidden_actions.length > 0 || e.directive_priority === "critical" || e.directive_priority === "high" || e.generated_skill_path);
     const directiveBlock = buildDirectiveBlock(directiveEntries, directiveBudget, config3);
-    const lessonBlock = buildKnowledgeBlock(entries, lessonBudget, config3, projectName);
+    const lessonBlock = buildKnowledgeBlock(filteredEntries, lessonBudget, config3, projectName);
     const parts2 = [];
     let remaining = effectiveBudget;
     if (directiveBlock) {
@@ -95645,7 +95638,7 @@ ${freshPreamble}` : `<curator_briefing>${truncatedBriefing}</curator_briefing>`;
     injectKnowledgeMessage(output, cachedInjectionText);
     const sessionID = systemMsg?.info?.sessionID;
     if (sessionID) {
-      const criticalIds = entries.filter((e) => e.directive_priority === "critical" && e.status !== "archived").map((e) => e.id);
+      const criticalIds = filteredEntries.filter((e) => e.directive_priority === "critical" && e.status !== "archived").map((e) => e.id);
       if (criticalIds.length > 0) {
         setCriticalShownIds(sessionID, {
           ids: criticalIds,
@@ -96179,8 +96172,12 @@ function getSkillStats(skillPath, directory) {
   };
 }
 function formatSkillIndexWithContext(skills, directory) {
-  const allEntries = readSkillUsageEntries(directory);
-  const hasHistory = allEntries.length > 0;
+  const usageLogPath = path89.join(directory, ".swarm", "skill-usage.jsonl");
+  let hasHistory = false;
+  try {
+    const stat7 = fs62.statSync(usageLogPath);
+    hasHistory = stat7.size > 0;
+  } catch {}
   if (!hasHistory) {
     return skills.map((sp) => {
       const meta3 = _internals42.readSkillMetadata(sp, directory);
@@ -96210,6 +96207,121 @@ _internals42.computeRecencyScore = computeRecencyScore;
 _internals42.computeContextMatchScore = computeContextMatchScore;
 
 // src/hooks/skill-propagation-gate.ts
+function parseSimpleYaml(content) {
+  const lines = content.split(`
+`);
+  const result = {};
+  let _currentSection = null;
+  let currentSubSection = null;
+  let currentList = [];
+  let currentListItem = null;
+  for (const line of lines) {
+    if (!line.trim() || line.trim().startsWith("#"))
+      continue;
+    const indent = line.search(/\S/);
+    const trimmed = line.trim();
+    if (indent === 0 && trimmed.endsWith(":")) {
+      if (_currentSection && currentSubSection && currentList.length > 0) {
+        if (!result[_currentSection]) {
+          result[_currentSection] = {};
+        }
+        result[_currentSection][currentSubSection] = currentList;
+      } else if (currentSubSection && currentList.length > 0) {
+        result[currentSubSection] = currentList;
+      }
+      _currentSection = trimmed.slice(0, -1);
+      currentSubSection = null;
+      currentList = [];
+      currentListItem = null;
+      continue;
+    }
+    if (indent === 2 && trimmed.endsWith(":")) {
+      if (_currentSection && currentSubSection && currentList.length > 0) {
+        if (!result[_currentSection]) {
+          result[_currentSection] = {};
+        }
+        result[_currentSection][currentSubSection] = currentList;
+      } else if (currentSubSection && currentList.length > 0) {
+        result[currentSubSection] = currentList;
+      }
+      currentSubSection = trimmed.slice(0, -1);
+      currentList = [];
+      currentListItem = null;
+      continue;
+    }
+    if (trimmed.startsWith("- ")) {
+      currentListItem = null;
+      const rest = trimmed.slice(2);
+      if (rest.includes(":")) {
+        const colonIndex = rest.indexOf(":");
+        const key = rest.slice(0, colonIndex).trim();
+        const value = rest.slice(colonIndex + 1).trim();
+        currentListItem = { [key]: parseYamlValue(value) };
+      } else {
+        currentListItem = { path: trimmed.slice(2) };
+      }
+      currentList.push(currentListItem);
+      continue;
+    }
+    if (indent >= 4 && currentListItem) {
+      if (trimmed.includes(":")) {
+        const colonIndex = trimmed.indexOf(":");
+        const key = trimmed.slice(0, colonIndex).trim();
+        const value = trimmed.slice(colonIndex + 1).trim();
+        currentListItem[key] = parseYamlValue(value);
+      }
+    }
+  }
+  if (currentSubSection && currentList.length > 0) {
+    if (_currentSection) {
+      if (!result[_currentSection]) {
+        result[_currentSection] = {};
+      }
+      result[_currentSection][currentSubSection] = currentList;
+    } else {
+      result[currentSubSection] = currentList;
+    }
+  }
+  return result;
+}
+function parseYamlValue(value) {
+  const trimmed = value.trim();
+  if (trimmed.startsWith('"') && trimmed.endsWith('"') || trimmed.startsWith("'") && trimmed.endsWith("'")) {
+    return trimmed.slice(1, -1);
+  }
+  if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+    const inner = trimmed.slice(1, -1);
+    if (!inner.trim())
+      return [];
+    return inner.split(",").map((s) => s.trim().replace(/^["']|["']$/g, ""));
+  }
+  if (trimmed.toLowerCase() === "true")
+    return true;
+  if (trimmed.toLowerCase() === "false")
+    return false;
+  if (/^-?\d+(\.\d+)?$/.test(trimmed)) {
+    return trimmed.includes(".") ? parseFloat(trimmed) : parseInt(trimmed, 10);
+  }
+  return trimmed;
+}
+function loadRoutingSkills(directory, targetAgent) {
+  const routingPath = path90.join(directory, ".opencode", "skill-routing.yaml");
+  if (!_internals43.existsSync(routingPath))
+    return [];
+  try {
+    const content = _internals43.readFileSync(routingPath, "utf-8");
+    const config3 = parseSimpleYaml(content);
+    if (!config3?.routing)
+      return [];
+    const routing = config3.routing;
+    const routingEntries = routing[targetAgent];
+    if (!routingEntries || routingEntries.length === 0)
+      return [];
+    return routingEntries.map((entry) => entry.path);
+  } catch {
+    return [];
+  }
+}
 var SKILL_CAPABLE_AGENTS = new Set([
   "coder",
   "reviewer",
@@ -96242,11 +96354,12 @@ var _internals43 = {
   appendSkillUsageEntry,
   readSkillUsageEntries,
   readSkillUsageEntriesTail,
-  extractSkillsFieldFromPrompt: null,
   parseSkillPaths: null,
   extractTaskIdFromPrompt: null,
+  extractSkillsFieldFromPrompt: null,
   computeSkillRelevanceScore,
-  formatSkillIndexWithContext
+  formatSkillIndexWithContext,
+  loadRoutingSkills: null
 };
 function discoverAvailableSkills(directory) {
   const results = [];
@@ -96354,22 +96467,21 @@ function parseSkillPaths(fieldValue) {
   const trimmed = fieldValue.trim();
   if (trimmed.toLowerCase() === "none" || trimmed === "")
     return [];
-  const lines = trimmed.split(/\r?\n/);
-  const hasCatalogLines = lines.some((line) => /^(?:-|\*|\d+\.)\s+/.test(line.trim()));
-  const parts2 = hasCatalogLines ? lines : trimmed.split(",");
-  const paths = [];
-  for (const rawPart of parts2) {
-    const part = rawPart.trim().replace(/^(?:-|\*|\d+\.)\s+/, "").trim();
-    if (!part || part.toLowerCase() === "none")
-      continue;
-    const fileRef = part.match(/\bfile:[^\s,;)\]]+/);
-    if (fileRef) {
-      paths.push(fileRef[0].replace(/\\/g, "/"));
-      continue;
-    }
-    paths.push(part);
-  }
-  return [...new Set(paths)];
+  const commaParts = trimmed.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  if (commaParts.length === 1 && commaParts[0].startsWith("- ")) {
+    const newlineParts = trimmed.split(`
+`).map((s) => s.trim()).filter((s) => s.startsWith("- ")).map((s) => s.slice(2).trim());
+    return newlineParts.map((s) => {
+      const parenIndex = s.indexOf("(--");
+      const pathOnly = parenIndex !== -1 ? s.slice(0, parenIndex).trim() : s;
+      const dashIndex = pathOnly.search(/\s+[-–—]\s+/);
+      return dashIndex !== -1 ? pathOnly.slice(0, dashIndex).trim() : pathOnly;
+    }).filter((s) => s.length > 0);
+  }
+  return commaParts.map((s) => {
+    const parenIndex = s.indexOf("(--");
+    return parenIndex !== -1 ? s.slice(0, parenIndex).trim() : s;
+  }).filter((s) => s.length > 0);
 }
 function extractTaskIdFromPrompt(prompt) {
   if (!prompt || typeof prompt !== "string")
@@ -96384,22 +96496,22 @@ function extractTaskIdFromPrompt(prompt) {
 }
 async function skillPropagationGateBefore(directory, input, config3) {
   if (!config3.enabled)
-    return { blocked: false, reason: null };
+    return { blocked: false, reason: null, recommendedSkills: undefined };
   const toolName = typeof input.tool === "string" ? input.tool : "";
   if (toolName !== "task" && toolName !== "Task")
-    return { blocked: false, reason: null };
+    return { blocked: false, reason: null, recommendedSkills: undefined };
   const agentRaw = typeof input.agent === "string" ? input.agent : "";
   if (!agentRaw)
-    return { blocked: false, reason: null };
+    return { blocked: false, reason: null, recommendedSkills: undefined };
   const baseAgent = stripKnownSwarmPrefix(agentRaw);
   if (baseAgent !== "architect")
-    return { blocked: false, reason: null };
+    return { blocked: false, reason: null, recommendedSkills: undefined };
   const parsed = _internals43.parseDelegationArgs(input.args);
   if (!parsed)
-    return { blocked: false, reason: null };
+    return { blocked: false, reason: null, recommendedSkills: undefined };
   const targetBase = stripKnownSwarmPrefix(parsed.targetAgent);
   if (!_internals43.SKILL_CAPABLE_AGENTS.has(targetBase))
-    return { blocked: false, reason: null };
+    return { blocked: false, reason: null, recommendedSkills: undefined };
   const sessionID = typeof input.sessionID === "string" ? input.sessionID : "unknown";
   const availableSkills = _internals43.discoverAvailableSkills(directory);
   const skillsValue = parsed.skillsField.trim();
@@ -96462,6 +96574,23 @@ async function skillPropagationGateBefore(directory, input, config3) {
       warn(`[skill-propagation-gate] skill scoring failed (non-blocking): ${err2 instanceof Error ? err2.message : String(err2)}`);
     }
   }
+  try {
+    const routingPaths = _internals43.loadRoutingSkills(directory, targetBase);
+    if (routingPaths.length > 0) {
+      const existingPaths = new Set(scored.map((s) => s.skillPath));
+      for (const routingPath of routingPaths) {
+        if (!existingPaths.has(routingPath)) {
+          scored.push({
+            skillPath: routingPath,
+            score: 0.9,
+            usageCount: 0
+          });
+          existingPaths.add(routingPath);
+        }
+      }
+      scored.sort((a, b) => b.score - a.score || b.usageCount - a.usageCount);
+    }
+  } catch {}
   if (availableSkills.length > 0) {
     try {
       let skillsForIndex = availableSkills;
@@ -96520,14 +96649,14 @@ ${newSection}`;
     const coderHadSkills = skillsValue.length > 0 && skillsValue.toLowerCase() !== "none";
     if (!hasSkillsUsedByCoder && coderHadSkills) {
       const message = `SKILLS_USED_BY_CODER warning: Delegating to reviewer without SKILLS_USED_BY_CODER field. ` + `Add SKILLS_USED_BY_CODER with the skills the coder received for this task.`;
-      return { blocked: false, reason: message };
+      return { blocked: false, reason: message, recommendedSkills: undefined };
     }
   }
   if (availableSkills.length === 0)
-    return { blocked: false, reason: null };
+    return { blocked: false, reason: null, recommendedSkills: undefined };
   const skillsLower = skillsValue.toLowerCase();
   if (skillsValue && skillsLower !== "none")
-    return { blocked: false, reason: null };
+    return { blocked: false, reason: null, recommendedSkills: scored };
   const skillNames = availableSkills.map((p) => {
     const parts2 = p.split("/");
     return parts2[parts2.length - 2] ?? p;
@@ -96547,9 +96676,9 @@ ${newSection}`;
   } catch {}
   if (config3.enforce) {
     const blockedMsg = `Blocked by skill propagation gate: Delegating to ${targetBase} without SKILLS field. ` + `Available skills: ${skillNames.join(", ")}. ` + `Add a SKILLS: field or set enforce: false in config.`;
-    return { blocked: true, reason: blockedMsg };
+    return { blocked: true, reason: blockedMsg, recommendedSkills: undefined };
   }
-  return { blocked: false, reason: warningMsg };
+  return { blocked: false, reason: warningMsg, recommendedSkills: undefined };
 }
 var COMPLIANCE_PATTERN = /SKILL_COMPLIANCE\s*:\s*(COMPLIANT|PARTIAL|VIOLATED)(?:\s*(?:—|-)\s*(.*))?\s*$/i;
 var CODER_SKILLS_PATTERN = /SKILLS_USED_BY_CODER\s*:\s*(.+)/i;
@@ -96658,10 +96787,8 @@ async function skillPropagationTransformScan(directory, output, sessionID) {
       continue;
     let currentTargetAgent = "";
     let skillsField = "";
-    const textLines = text.split(`
-`);
-    for (let lineIndex = 0;lineIndex < textLines.length; lineIndex++) {
-      const line = textLines[lineIndex] ?? "";
+    for (const line of text.split(`
+`)) {
       const trimmed = line.trim();
       if (trimmed.match(/TO\s+(coder|reviewer|test_engineer|sme|docs|designer)/i)) {
         const agentMatch = trimmed.match(/TO\s+(coder|reviewer|test_engineer|sme|docs|designer)/i);
@@ -96669,8 +96796,7 @@ async function skillPropagationTransformScan(directory, output, sessionID) {
           currentTargetAgent = agentMatch[1].toLowerCase();
       }
       if (trimmed.startsWith("SKILLS:")) {
-        skillsField = _internals43.extractSkillsFieldFromPrompt(textLines.slice(lineIndex).join(`
-`));
+        skillsField = trimmed.slice("SKILLS:".length).trim();
       }
       if (currentTargetAgent && skillsField && skillsField.toLowerCase() !== "none") {
         const skillPaths = _internals43.parseSkillPaths(skillsField);
@@ -96706,10 +96832,11 @@ _internals43.skillPropagationTransformScan = skillPropagationTransformScan;
 _internals43.writeWarnEvent = writeWarnEvent2;
 _internals43.discoverAvailableSkills = discoverAvailableSkills;
 _internals43.parseDelegationArgs = parseDelegationArgs;
-_internals43.extractSkillsFieldFromPrompt = extractSkillsFieldFromPrompt;
 _internals43.parseSkillPaths = parseSkillPaths;
 _internals43.extractTaskIdFromPrompt = extractTaskIdFromPrompt;
+_internals43.extractSkillsFieldFromPrompt = extractSkillsFieldFromPrompt;
 _internals43.formatSkillIndexWithContext = formatSkillIndexWithContext;
+_internals43.loadRoutingSkills = loadRoutingSkills;
 
 // src/hooks/slop-detector.ts
 import * as fs64 from "node:fs";
@@ -99991,7 +100118,7 @@ import {
   readFileSync as readFileSync44,
   writeFileSync as writeFileSync17
 } from "node:fs";
-import { join as join83 } from "node:path";
+import { join as join84 } from "node:path";
 var EVIDENCE_DIR2 = ".swarm/evidence";
 var VALID_TASK_ID = /^\d+\.\d+(\.\d+)*$/;
 var COUNCIL_GATE_NAME = "council";
@@ -100025,9 +100152,9 @@ function writeCouncilEvidence(workingDir, synthesis) {
   if (!VALID_TASK_ID.test(synthesis.taskId)) {
     throw new Error(`writeCouncilEvidence: invalid taskId "${synthesis.taskId}" — must match N.M or N.M.P format`);
   }
-  const dir = join83(workingDir, EVIDENCE_DIR2);
+  const dir = join84(workingDir, EVIDENCE_DIR2);
   mkdirSync25(dir, { recursive: true });
-  const filePath = join83(dir, `${synthesis.taskId}.json`);
+  const filePath = join84(dir, `${synthesis.taskId}.json`);
   const existingRoot = Object.create(null);
   if (existsSync53(filePath)) {
     try {
@@ -100061,7 +100188,7 @@ function writeCouncilEvidence(workingDir, synthesis) {
     updated.required_gates = [];
   writeFileSync17(filePath, JSON.stringify(updated, null, 2));
   try {
-    const councilDir = join83(workingDir, ".swarm", "council");
+    const councilDir = join84(workingDir, ".swarm", "council");
     mkdirSync25(councilDir, { recursive: true });
     const auditLine = JSON.stringify({
       round: synthesis.roundNumber,
@@ -100069,7 +100196,7 @@ function writeCouncilEvidence(workingDir, synthesis) {
       timestamp: synthesis.timestamp,
       vetoedBy: synthesis.vetoedBy
     });
-    appendFileSync12(join83(councilDir, `${synthesis.taskId}.rounds.jsonl`), `${auditLine}
+    appendFileSync12(join84(councilDir, `${synthesis.taskId}.rounds.jsonl`), `${auditLine}
 `);
   } catch (auditError) {
     console.warn(`writeCouncilEvidence: failed to append round-history audit log: ${auditError instanceof Error ? auditError.message : String(auditError)}`);
@@ -100392,20 +100519,20 @@ function buildFinalCouncilFeedback(projectSummary, verdict, vetoedBy, requiredFi
 
 // src/council/criteria-store.ts
 import { existsSync as existsSync54, mkdirSync as mkdirSync26, readFileSync as readFileSync45, writeFileSync as writeFileSync18 } from "node:fs";
-import { join as join84 } from "node:path";
+import { join as join85 } from "node:path";
 var COUNCIL_DIR = ".swarm/council";
 function writeCriteria(workingDir, taskId, criteria) {
-  const dir = join84(workingDir, COUNCIL_DIR);
+  const dir = join85(workingDir, COUNCIL_DIR);
   mkdirSync26(dir, { recursive: true });
   const payload = {
     taskId,
     criteria,
     declaredAt: new Date().toISOString()
   };
-  writeFileSync18(join84(dir, `${safeId(taskId)}.json`), JSON.stringify(payload, null, 2));
+  writeFileSync18(join85(dir, `${safeId(taskId)}.json`), JSON.stringify(payload, null, 2));
 }
 function readCriteria(workingDir, taskId) {
-  const filePath = join84(workingDir, COUNCIL_DIR, `${safeId(taskId)}.json`);
+  const filePath = join85(workingDir, COUNCIL_DIR, `${safeId(taskId)}.json`);
   if (!existsSync54(filePath))
     return null;
   try {
@@ -118927,6 +119054,73 @@ async function initializeOpenCodeSwarm(ctx) {
         skillSession.pendingAdvisoryMessages ??= [];
         skillSession.pendingAdvisoryMessages.push(skillResult.reason);
       }
+      if (skillResult.recommendedSkills && skillResult.recommendedSkills.length > 0) {
+        const argsRecord = input.args;
+        const promptRaw = argsRecord.prompt;
+        if (typeof promptRaw === "string") {
+          const parsedDelegation = parseDelegationArgs(input.args);
+          if (parsedDelegation) {
+            const existingSkills = parsedDelegation.skillsField.trim();
+            if (!existingSkills) {
+              const qualified = skillResult.recommendedSkills.filter((s) => s.score >= 0.5);
+              if (qualified.length === 0) {
+                argsRecord.prompt = `SKILLS: none
+
+${promptRaw}`;
+                console.warn("[skill-propagation-gate] No skills above threshold 0.5 — injected SKILLS: none");
+              } else {
+                const topSkills = qualified.slice(0, 5);
+                const SKILL_DESCRIPTIONS = {
+                  "writing-tests": "Guidelines for writing tests",
+                  "engineering-conventions": "Engineering invariants and conventions",
+                  "running-tests": "Safe test execution patterns",
+                  "commit-pr": "Commit and PR workflow",
+                  "swarm-implement": "Swarm implementation workflow",
+                  "issue-tracer": "Issue investigation workflow",
+                  "qa-sweep": "QA sweep workflow",
+                  "research-first": "Research-driven approach",
+                  "swarm-pr-review": "PR review workflow",
+                  "tech-debt-ci-review": "Tech debt and CI review",
+                  browse: "Fast web browsing",
+                  code: "Expert coding workflow",
+                  review: "Pre-landing PR review",
+                  "ci-failure-resolver": "CI/CD failure resolution"
+                };
+                const skillPaths = topSkills.map((s) => {
+                  const dirName = path144.basename(path144.dirname(s.skillPath));
+                  const desc = SKILL_DESCRIPTIONS[dirName] ?? dirName;
+                  return `file:${s.skillPath} (-- ${desc})`;
+                }).join(", ");
+                const skillsLine = `SKILLS: ${skillPaths}`;
+                const newPrompt = `${skillsLine}
+
+${promptRaw}`;
+                argsRecord.prompt = newPrompt;
+                const skillNames = topSkills.map((s) => `${path144.basename(s.skillPath)} (score: ${s.score.toFixed(2)})`).join(", ");
+                console.warn(`[skill-propagation-gate] Injected skills: ${skillNames}`);
+                for (const skill of topSkills) {
+                  try {
+                    appendSkillUsageEntry(ctx.directory, {
+                      skillPath: skill.skillPath,
+                      agentName: String(input.agent),
+                      taskID: "injection",
+                      timestamp: new Date().toISOString(),
+                      complianceVerdict: "not_checked",
+                      sessionID: input.sessionID
+                    });
+                  } catch {}
+                }
+                const targetAgent = parsedDelegation.targetAgent.toLowerCase();
+                if (targetAgent.includes("reviewer")) {
+                  const usedByCoderLine = `SKILLS_USED_BY_CODER: ${topSkills.map((s) => `file:${s.skillPath}`).join(", ")}`;
+                  argsRecord.prompt = `${newPrompt}
+${usedByCoderLine}`;
+                }
+              }
+            }
+          }
+        }
+      }
       if (swarmState.lastBudgetPct >= 50) {
         const pressureSession = ensureAgentSession(input.sessionID, swarmState.activeAgent.get(input.sessionID) ?? ORCHESTRATOR_NAME);
         if (!pressureSession.contextPressureWarningSent) {