@heretek-ai/epistemic-swarm 0.2.2 → 0.3.0

package/plugins/antigravity/skills/swarm_config/SKILL.md

@@ -0,0 +1,13 @@
+# Swarm Config (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/swarm_config/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_config`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/plugins/codex/AGENTS.md.snippet

@@ -0,0 +1,10 @@
+# IUMBTEMS — paste into your repo AGENTS.md (Codex rule injection)
+
+You operate under the Epistemic Integrity Protocol:
+- Parametric memory is quarantined. Fetch, verify, then assert.
+- Tag claims: `[VERIFIED:<hash>]`, `[INFERRED:<chain>]`, `[HYPOTHESIS:<falsification>]`, `[NEGATIVE_KNOWLEDGE:<query>]`.
+- Cache sources: `python3 skills/research-cache/hasher.py cache --url "<URL>" --content "$(cat file.md)"`.
+- Skills: `$grilling` (frontier framing), `$epistemic_search` (verified search),
+  `$code-audit` (line-proof audit), `$oss-scout` (license-aware scout),
+  `$brainstorming` (lateral ideation — never bug-fix lists).
+- Runners: `python3 runner/research_swarm.py --mode <research|audit|scout|hybrid|brainstorm> --objective "<...>"`.

package/plugins/codex/README.md

@@ -0,0 +1,37 @@
+# IUMBTEMS for Codex CLI
+
+Codex uses Skills (AgentSkills.io standard), not legacy `~/.codex/prompts/*.md`
+(`/prompts:<name>` is deprecated). Explicit `$skill` / `/skills`, implicit via
+`description`.
+
+## Repo-local use (no install)
+
+Codex auto-discovers `.agents/skills/*` from CWD up to repo root.
+This repo ships generated mirrors there (see `scripts/build_adapters.py`):
+
+```
+.agents/skills/{grilling,research_cache,epistemic_search,swarm_config,code_audit,oss_scout,brainstorming}/SKILL.md
+```
+
+Invoke: `$brainstorming Where do we go from here?` or let Codex pick
+implicitly on speculative prompts.
+
+## Plugin distribution
+
+`plugins/codex/` is the distributable skill pack:
+
+```
+plugins/codex/
+├── skills/<skill>/SKILL.md   # generated from canonical skills/
+├── openai.yaml               # plugin appearance + component index
+├── config.toml.snippet       # [mcp_servers.*] + [[skills.config]]
+└── AGENTS.md.snippet         # paste into repo AGENTS.md for rule injection
+```
+
+Publish as a Codex marketplace plugin (cf. `~/.codex/plugins/cache/...`
++ `~/.codex/config.toml` marketplace blocks), or copy
+`plugins/codex/skills/*` into any repo's `.agents/skills/`.
+
+MCP: see `config.toml.snippet` (`codex mcp add ...`, `codex mcp login`).
+Secrets via env: `BRAVE_SEARCH_API_KEY`, `FIRECRAWL_API_KEY`,
+`FIRECRAWL_API_URL`, `SEARXNG_URL`, or `bearer_token_env_var` for HTTP MCP.

package/plugins/codex/config.toml.snippet

@@ -0,0 +1,28 @@
+# IUMBTEMS Codex config snippet — merge into ~/.codex/config.toml
+# MCP servers (stdio via mcp_launcher.py; HTTP variants accept bearer_token_env_var)
+
+[mcp_servers.iumbtems-brave-search]
+command = "python3"
+args = ["<IUMBTEMS_ROOT>/config/mcp_launcher.py", "brave-search"]
+
+[mcp_servers.iumbtems-firecrawl]
+command = "python3"
+args = ["<IUMBTEMS_ROOT>/config/mcp_launcher.py", "firecrawl"]
+
+[mcp_servers.iumbtems-searxng]
+command = "python3"
+args = ["<IUMBTEMS_ROOT>/config/mcp_launcher.py", "searxng"]
+
+# Canonical first-party tool surface: the 7 iumbtems_* tools as MCP tools.
+[mcp_servers.iumbtems]
+command = "python3"
+args = ["<IUMBTEMS_ROOT>/runner/mcp_server.py"]
+
+# Optional: pin skill paths explicitly (repo .agents/skills auto-discovery
+# usually makes this unnecessary). Replace <IUMBTEMS_ROOT> with repo path.
+# [[skills.config]]
+# path = "<IUMBTEMS_ROOT>/plugins/codex/skills/brainstorming/SKILL.md"
+# enabled = true
+
+[features]
+# rm -rf guardrails etc. via exec policy live in ~/.codex/policy/*.codexpolicy

package/plugins/codex/openai.yaml

@@ -0,0 +1,24 @@
+name: epistemic-swarm
+description: IUMBTEMS Epistemic Swarm skill pack for Codex CLI
+version: 0.3.0
+license: Apache-2.0
+repository: https://github.com/Heretek-AI/IUMBTEMS
+skills:
+  - skills/grilling
+  - skills/research_cache
+  - skills/epistemic_search
+  - skills/swarm_config
+  - skills/code_audit
+  - skills/oss_scout
+  - skills/brainstorming
+runners:
+  research: python3 runner/research_swarm.py --objective "<objective>"
+  audit: python3 runner/research_swarm.py --mode audit --objective "<target>"
+  scout: python3 runner/research_swarm.py --mode scout --objective "<feature>"
+  brainstorm: python3 runner/research_swarm.py --mode brainstorm --objective "<prompt>"
+commands:
+  swarm: dialectic research swarm
+  grill: socratic frontier exploration
+  audit: codebase audit with line-level proof
+  scout: OSS discovery with license red-teaming
+  brainstorming: lateral ideation portfolio

package/plugins/codex/skills/brainstorming/SKILL.md

@@ -0,0 +1,13 @@
+# Brainstorming (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/brainstorming/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_brainstorm`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/plugins/codex/skills/code_audit/SKILL.md

@@ -0,0 +1,13 @@
+# Code Audit (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/code_audit/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_code_audit`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/plugins/codex/skills/epistemic_search/SKILL.md

@@ -0,0 +1,13 @@
+# Epistemic Search (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/epistemic_search/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `brave_web_search / firecrawl_scrape (research MCP servers)`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/plugins/codex/skills/grilling/SKILL.md

@@ -0,0 +1,13 @@
+# Socratic Grilling (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/grilling/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_socratic_frontier`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/plugins/codex/skills/oss_scout/SKILL.md

@@ -0,0 +1,13 @@
+# OSS Scout (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/oss_scout/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_oss_scout`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/plugins/codex/skills/research_cache/SKILL.md

@@ -0,0 +1,13 @@
+# Research Cache (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/research_cache/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_verify_quote`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/plugins/codex/skills/swarm_config/SKILL.md

@@ -0,0 +1,13 @@
+# Swarm Config (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/swarm_config/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_config`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/plugins/gemini/GEMINI.md

@@ -0,0 +1,15 @@
+# IUMBTEMS Epistemic Swarm — Gemini CLI context
+
+You operate under the Epistemic Integrity Protocol
+(see `prompts/base_epistemic_system.md` in the IUMBTEMS package).
+
+- Parametric memory is quarantined. Fetch, verify, then assert.
+- Tag every factual claim: `[VERIFIED:<hash>]`, `[INFERRED:<chain>]`,
+  `[HYPOTHESIS:<falsification>]`, `[NEGATIVE_KNOWLEDGE:<query>]`.
+- Cache every source to `.research/sources/<sha256>.md` before citing.
+- Available skills: `grilling`, `research_cache`, `epistemic_search`,
+  `swarm_config`, `code_audit`, `oss_scout`, `brainstorming`
+  (see `skills/<name>/SKILL.md`).
+- Runners: `python3 runner/research_swarm.py --mode <research|audit|scout|hybrid|brainstorm> --objective "<...>"`.
+- Custom commands (`commands/*.toml`): `/swarm`, `/grill`, `/audit`,
+  `/scout`, `/brainstorming`, `/swarm-config`.

package/plugins/gemini/README.md

@@ -0,0 +1,19 @@
+# IUMBTEMS for Gemini CLI
+
+Install from GitHub or local path:
+
+```bash
+gemini extensions install https://github.com/Heretek-AI/IUMBTEMS --path plugins/gemini
+# local dev:
+gemini extensions link /path/to/IUMBTEMS/plugins/gemini
+gemini extensions list
+/commands list
+```
+
+Contents: `gemini-extension.json` (manifest + MCP servers), `GEMINI.md`
+(context loader), `commands/*.toml` (`/swarm`, `/grill`, `/audit`,
+`/scout`, `/brainstorming`, `/swarm-config`), `hooks/hooks.json`,
+`skills/` (generated copies of canonical `skills/` — run
+`scripts/build_adapters.py`). Secrets via env:
+`BRAVE_SEARCH_API_KEY`, `FIRECRAWL_API_KEY`, `FIRECRAWL_API_URL`,
+`SEARXNG_URL`. Zero-key DuckDuckGo fallback needs no keys.

package/plugins/gemini/commands/audit.toml

@@ -0,0 +1,6 @@
+description = "Run dialectic codebase architecture and security audit"
+prompt = """Run the IUMBTEMS dialectic codebase audit on: {{args}}.
+
+Execute: python3 runner/research_swarm.py --mode audit --objective "{{args}}"
+Report: .research/code_audit_report.md with file:///path#Lstart-Lend pointers.
+"""

package/plugins/gemini/commands/brainstorming.toml

@@ -0,0 +1,10 @@
+description = "Lateral brainstorming: novel feature vectors and speculative spikes"
+prompt = """Run IUMBTEMS lateral brainstorming on: {{args}}.
+
+Follow skills/brainstorming/SKILL.md and prompts/agent_brainstormer.md:
+1. Ingest workspace context (read-only, capped at ~30% of window).
+2. Run Thesis / Radical Antithesis / Synthesis — never bug-fix lists.
+3. Output Novel Feature Vectors (3-5), Lateral Architectural Moves (2-3),
+   Experimental Hypotheses (2-3 with [HYPOTHESIS:<falsification test>]).
+4. Write .research/brainstorm_report.md (or run: python3 runner/research_swarm.py --mode brainstorm --objective "{{args}}").
+"""

package/plugins/gemini/commands/grill.toml

@@ -0,0 +1,6 @@
+description = "Launch Socratic grilling and decision frontier exploration"
+prompt = """Launch IUMBTEMS Socratic grilling for: {{args}}.
+
+Follow skills/grilling/SKILL.md frontier methodology (rounds, assumption inversion,
+factual vs decisional separation). Persist with: python3 skills/grilling/socratic_tree.py --export
+"""

package/plugins/gemini/commands/scout.toml

@@ -0,0 +1,7 @@
+description = "Scout open-source libraries and build clean-room blueprints"
+prompt = """Scout open-source solutions for: {{args}}.
+
+Execute: python3 runner/research_swarm.py --mode scout --objective "{{args}}"
+Flag GPL/AGPL contamination, maintenance health, and dependency weight.
+Report: .research/oss_scout_report.md
+"""

package/plugins/gemini/commands/swarm-config.toml

@@ -0,0 +1,7 @@
+description = "Inspect or tune Epistemic Swarm parameters (engine, depth, mode)"
+prompt = """Inspect or tune IUMBTEMS swarm parameters for: {{args}}.
+
+Execute: python3 skills/swarm_config/configure.py {{args}}
+Engines: duckduckgo (zero-key default), brave, firecrawl, searxng.
+Modes: research, audit, scout, hybrid, brainstorm. Depth: 1-4.
+"""

package/plugins/gemini/commands/swarm.toml

@@ -0,0 +1,8 @@
+description = "Run IUMBTEMS dialectic research swarm on an objective"
+prompt = """Run the IUMBTEMS dialectic research swarm on the given objective: {{args}}.
+
+Steps:
+1. Read skills/grilling/SKILL.md only if the objective is ambiguous.
+2. Execute: python3 runner/research_swarm.py --objective "{{args}}"
+3. Summarize .research/final_synthesis.md with [VERIFIED:<hash>] pointers preserved.
+"""

package/plugins/gemini/gemini-extension.json

@@ -0,0 +1,38 @@
+{
+  "name": "epistemic-swarm",
+  "version": "0.3.0",
+  "description": "IUMBTEMS Epistemic Swarm: dialectic research, code audit, OSS scout, and lateral brainstorming for Gemini CLI.",
+  "mcpServers": {
+    "brave-search": {
+      "command": "python3",
+      "args": ["${extensionPath}/../../config/mcp_launcher.py", "brave-search"],
+      "env": {
+        "BRAVE_SEARCH_API_KEY": "${BRAVE_SEARCH_API_KEY}"
+      }
+    },
+    "firecrawl": {
+      "command": "python3",
+      "args": ["${extensionPath}/../../config/mcp_launcher.py", "firecrawl"],
+      "env": {
+        "FIRECRAWL_API_KEY": "${FIRECRAWL_API_KEY}",
+        "FIRECRAWL_API_URL": "${FIRECRAWL_API_URL:-http://localhost:3002}"
+      }
+    },
+    "searxng": {
+      "command": "python3",
+      "args": ["${extensionPath}/../../config/mcp_launcher.py", "searxng"],
+      "env": {
+        "SEARXNG_URL": "${SEARXNG_URL:-http://localhost:8080}"
+      }
+    },
+    "iumbtems": {
+      "command": "python3",
+      "args": ["${extensionPath}/../../runner/mcp_server.py"],
+      "env": {
+        "PYTHONPATH": "${extensionPath}/../.."
+      }
+    }
+  },
+  "contextFileName": "GEMINI.md",
+  "excludeTools": []
+}

package/plugins/gemini/hooks/hooks.json

@@ -0,0 +1,11 @@
+{
+  "hooks": {
+    "pre_tool": [
+      {
+        "matcher": "WebSearch",
+        "action": "redirect",
+        "reason": "Use epistemic search (skills/epistemic_search/scripts/search.py) for SHA-256 cached verification."
+      }
+    ]
+  }
+}

package/plugins/gemini/skills/brainstorming/SKILL.md

@@ -0,0 +1,13 @@
+# Brainstorming (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/brainstorming/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_brainstorm`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/plugins/gemini/skills/code_audit/SKILL.md

@@ -0,0 +1,13 @@
+# Code Audit (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/code_audit/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_code_audit`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/plugins/gemini/skills/epistemic_search/SKILL.md

@@ -0,0 +1,13 @@
+# Epistemic Search (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/epistemic_search/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `brave_web_search / firecrawl_scrape (research MCP servers)`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/plugins/gemini/skills/grilling/SKILL.md

@@ -0,0 +1,13 @@
+# Socratic Grilling (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/grilling/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_socratic_frontier`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/plugins/gemini/skills/oss_scout/SKILL.md

@@ -0,0 +1,13 @@
+# OSS Scout (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/oss_scout/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_oss_scout`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/plugins/gemini/skills/research_cache/SKILL.md

@@ -0,0 +1,13 @@
+# Research Cache (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/research_cache/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_verify_quote`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.

package/plugins/gemini/skills/swarm_config/SKILL.md

@@ -0,0 +1,13 @@
+# Swarm Config (thin adapter stub)
+
+This file is a POINTER, not the implementation. It exists so harness skill
+discovery finds an entry; the real skill lives in the IUMBTEMS repo.
+
+- Canonical prose & scripts: `skills/swarm_config/`
+- Canonical programmatic surface: `python3 runner/mcp_server.py` (stdio MCP),
+  or one-shot: `python3 runner/mcp_server.py call <tool> '{...json...}'`
+- MCP tools for this skill: `iumbtems_config`
+
+Epistemic rules apply regardless of harness: tag claims as
+`[VERIFIED: <hash>]`, `[INFERRED: <reasoning>]`, `[HYPOTHESIS: <test>]`, or
+`[NEGATIVE_KNOWLEDGE: <query>]`. Writes go only to `.research/`.