@heretek-ai/epistemic-swarm 0.7.17 → 0.7.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (162) hide show
  1. package/.agents/skills/brainstorming/SKILL.md +6 -0
  2. package/.agents/skills/code_audit/SKILL.md +6 -0
  3. package/.agents/skills/darkharvest/SKILL.md +6 -0
  4. package/.agents/skills/epistemic_search/SKILL.md +6 -0
  5. package/.agents/skills/factory/SKILL.md +6 -0
  6. package/.agents/skills/grilling/SKILL.md +6 -0
  7. package/.agents/skills/oss_scout/SKILL.md +6 -0
  8. package/.agents/skills/research_cache/SKILL.md +6 -0
  9. package/.agents/skills/swarm_config/SKILL.md +6 -0
  10. package/.claude-plugin/plugin.json +1 -1
  11. package/package.json +2 -2
  12. package/plugins/antigravity/README.md +50 -15
  13. package/plugins/antigravity/agents/alpha-thesis.md +35 -5
  14. package/plugins/antigravity/agents/beta-antithesis.md +34 -6
  15. package/plugins/antigravity/agents/brainstormer.md +26 -6
  16. package/plugins/antigravity/agents/code-auditor.md +28 -0
  17. package/plugins/antigravity/agents/darkharvester.md +30 -0
  18. package/plugins/antigravity/agents/epistemic-auditor.md +27 -4
  19. package/plugins/antigravity/agents/manager.md +26 -0
  20. package/plugins/antigravity/agents/oss-scout.md +27 -0
  21. package/plugins/antigravity/agents/programmer.md +25 -0
  22. package/plugins/antigravity/agents/qa-a.md +22 -0
  23. package/plugins/antigravity/agents/qa-b.md +22 -0
  24. package/plugins/antigravity/antigravity_hooks.py +167 -0
  25. package/plugins/antigravity/commands/audit.md +10 -0
  26. package/plugins/antigravity/commands/brainstorming.md +12 -0
  27. package/plugins/antigravity/commands/darkharvest.md +11 -0
  28. package/plugins/antigravity/commands/domainexpansion.md +9 -0
  29. package/plugins/antigravity/commands/factory.md +9 -0
  30. package/plugins/antigravity/commands/grill.md +9 -0
  31. package/plugins/antigravity/commands/scout.md +10 -0
  32. package/plugins/antigravity/commands/swarm-config.md +10 -0
  33. package/plugins/antigravity/commands/swarm.md +9 -0
  34. package/plugins/antigravity/hooks.json +34 -13
  35. package/plugins/antigravity/mcp_config.json +11 -11
  36. package/plugins/antigravity/mcp_launcher.py +58 -0
  37. package/plugins/antigravity/plugin.json +7 -17
  38. package/plugins/antigravity/rules/AGENTS.md +125 -0
  39. package/plugins/antigravity/rules/epistemic-integrity.md +15 -5
  40. package/plugins/antigravity/skills/brainstorming/SKILL.md +6 -0
  41. package/plugins/antigravity/skills/code_audit/SKILL.md +6 -0
  42. package/plugins/antigravity/skills/darkharvest/SKILL.md +6 -0
  43. package/plugins/antigravity/skills/epistemic_search/SKILL.md +6 -0
  44. package/plugins/antigravity/skills/factory/SKILL.md +6 -0
  45. package/plugins/antigravity/skills/grilling/SKILL.md +6 -0
  46. package/plugins/antigravity/skills/oss_scout/SKILL.md +6 -0
  47. package/plugins/antigravity/skills/research_cache/SKILL.md +6 -0
  48. package/plugins/antigravity/skills/swarm_config/SKILL.md +6 -0
  49. package/plugins/codex/skills/brainstorming/SKILL.md +6 -0
  50. package/plugins/codex/skills/code_audit/SKILL.md +6 -0
  51. package/plugins/codex/skills/darkharvest/SKILL.md +6 -0
  52. package/plugins/codex/skills/epistemic_search/SKILL.md +6 -0
  53. package/plugins/codex/skills/factory/SKILL.md +6 -0
  54. package/plugins/codex/skills/grilling/SKILL.md +6 -0
  55. package/plugins/codex/skills/oss_scout/SKILL.md +6 -0
  56. package/plugins/codex/skills/research_cache/SKILL.md +6 -0
  57. package/plugins/codex/skills/swarm_config/SKILL.md +6 -0
  58. package/plugins/gemini/skills/brainstorming/SKILL.md +6 -0
  59. package/plugins/gemini/skills/code_audit/SKILL.md +6 -0
  60. package/plugins/gemini/skills/darkharvest/SKILL.md +6 -0
  61. package/plugins/gemini/skills/epistemic_search/SKILL.md +6 -0
  62. package/plugins/gemini/skills/factory/SKILL.md +6 -0
  63. package/plugins/gemini/skills/grilling/SKILL.md +6 -0
  64. package/plugins/gemini/skills/oss_scout/SKILL.md +6 -0
  65. package/plugins/gemini/skills/research_cache/SKILL.md +6 -0
  66. package/plugins/gemini/skills/swarm_config/SKILL.md +6 -0
  67. package/plugins/opencode/config-io.js +1041 -0
  68. package/plugins/opencode/index.js +129 -10
  69. package/plugins/opencode/tui.js +771 -0
  70. package/plugins/research-cache/skills/research_cache/hasher.py +25 -3
  71. package/runner/__pycache__/__init__.cpython-311.pyc +0 -0
  72. package/runner/__pycache__/auctioneer.cpython-311.pyc +0 -0
  73. package/runner/__pycache__/auditor_engine.cpython-311.pyc +0 -0
  74. package/runner/__pycache__/claim_store.cpython-311.pyc +0 -0
  75. package/runner/__pycache__/claim_witness.cpython-311.pyc +0 -0
  76. package/runner/__pycache__/darkharvest_claims.cpython-311.pyc +0 -0
  77. package/runner/__pycache__/errors.cpython-311.pyc +0 -0
  78. package/runner/__pycache__/living_dossiers.cpython-311.pyc +0 -0
  79. package/runner/__pycache__/mcp_protocol.cpython-311.pyc +0 -0
  80. package/runner/__pycache__/mcp_server.cpython-311.pyc +0 -0
  81. package/runner/__pycache__/path_safety.cpython-311.pyc +0 -0
  82. package/runner/__pycache__/pcrb.cpython-311.pyc +0 -0
  83. package/runner/__pycache__/pcrb_verify.cpython-311.pyc +0 -0
  84. package/runner/__pycache__/preflight.cpython-311.pyc +0 -0
  85. package/runner/__pycache__/refinement.cpython-311.pyc +0 -0
  86. package/runner/__pycache__/research_swarm.cpython-311.pyc +0 -0
  87. package/runner/__pycache__/retrieval_log.cpython-311.pyc +0 -0
  88. package/runner/__pycache__/schema_validate.cpython-311.pyc +0 -0
  89. package/runner/__pycache__/schemas.cpython-311.pyc +0 -0
  90. package/runner/__pycache__/state_machine.cpython-311.pyc +0 -0
  91. package/runner/antigravity_hooks.py +167 -0
  92. package/runner/auditor_engine.py +19 -2
  93. package/runner/darkharvest_claims.py +42 -10
  94. package/runner/mcp_server.py +212 -60
  95. package/runner/preflight.py +38 -1
  96. package/runner/research_swarm.py +106 -8
  97. package/runner/schema_validate.py +40 -2
  98. package/runner/schemas.py +335 -0
  99. package/runner/state_machine.py +28 -2
  100. package/runner/tests/__pycache__/test_antigravity_plugin.cpython-311.pyc +0 -0
  101. package/runner/tests/__pycache__/test_auction_order.cpython-311.pyc +0 -0
  102. package/runner/tests/__pycache__/test_backends.cpython-311.pyc +0 -0
  103. package/runner/tests/__pycache__/test_bet1_spike.cpython-311.pyc +0 -0
  104. package/runner/tests/__pycache__/test_claim_store.cpython-311.pyc +0 -0
  105. package/runner/tests/__pycache__/test_claim_witness.cpython-311.pyc +0 -0
  106. package/runner/tests/__pycache__/test_claude_plugin.cpython-311.pyc +0 -0
  107. package/runner/tests/__pycache__/test_config_schema.cpython-311.pyc +0 -0
  108. package/runner/tests/__pycache__/test_contract_tooling.cpython-311.pyc +0 -0
  109. package/runner/tests/__pycache__/test_darkharvest_audit.cpython-311.pyc +0 -0
  110. package/runner/tests/__pycache__/test_domain_packs.cpython-311.pyc +0 -0
  111. package/runner/tests/__pycache__/test_dossier_contract.cpython-311.pyc +0 -0
  112. package/runner/tests/__pycache__/test_factory.cpython-311.pyc +0 -0
  113. package/runner/tests/__pycache__/test_fleet_seam.cpython-311.pyc +0 -0
  114. package/runner/tests/__pycache__/test_frontier_concurrency.cpython-311.pyc +0 -0
  115. package/runner/tests/__pycache__/test_frontier_mirror_standalone.cpython-311.pyc +0 -0
  116. package/runner/tests/__pycache__/test_grounding.cpython-311.pyc +0 -0
  117. package/runner/tests/__pycache__/test_living_dossiers.cpython-311.pyc +0 -0
  118. package/runner/tests/__pycache__/test_manifest_concurrency.cpython-311.pyc +0 -0
  119. package/runner/tests/__pycache__/test_mcp_server.cpython-311.pyc +0 -0
  120. package/runner/tests/__pycache__/test_opencode_ux.cpython-311.pyc +0 -0
  121. package/runner/tests/__pycache__/test_opencode_v2_registrars.cpython-311.pyc +0 -0
  122. package/runner/tests/__pycache__/test_pcrb.cpython-311.pyc +0 -0
  123. package/runner/tests/__pycache__/test_refinement.cpython-311.pyc +0 -0
  124. package/runner/tests/__pycache__/test_search_anomaly.cpython-311.pyc +0 -0
  125. package/runner/tests/__pycache__/test_search_provider.cpython-311.pyc +0 -0
  126. package/runner/tests/__pycache__/test_search_provider_plugin.cpython-311.pyc +0 -0
  127. package/runner/tests/__pycache__/test_swarm.cpython-311.pyc +0 -0
  128. package/runner/tests/__pycache__/test_swarm_config.cpython-311.pyc +0 -0
  129. package/runner/tests/__pycache__/test_sweep_regressions.cpython-311.pyc +0 -0
  130. package/runner/tests/__pycache__/test_webcache.cpython-311.pyc +0 -0
  131. package/runner/tests/fixtures/config_validation_cases.json +216 -0
  132. package/runner/tests/test_antigravity_plugin.py +206 -0
  133. package/runner/tests/test_backends.py +113 -0
  134. package/runner/tests/test_config_schema.py +669 -0
  135. package/runner/tests/test_darkharvest_audit.py +105 -0
  136. package/runner/tests/test_opencode_ux.py +756 -2
  137. package/runner/tests/test_opencode_v2_registrars.py +256 -0
  138. package/runner/tests/test_search_anomaly.py +65 -0
  139. package/runner/tests/test_search_provider.py +70 -0
  140. package/runner/tests/test_swarm_config.py +233 -0
  141. package/runner/tests/test_webcache.py +49 -0
  142. package/schemas/config.schema.json +299 -0
  143. package/schemas/manifest.schema.json +6 -0
  144. package/scripts/__pycache__/bet1_advisory_spike.cpython-311.pyc +0 -0
  145. package/scripts/__pycache__/build_adapters.cpython-311.pyc +0 -0
  146. package/scripts/__pycache__/check_docs.cpython-311.pyc +0 -0
  147. package/scripts/__pycache__/divergence_experiment.cpython-311.pyc +0 -0
  148. package/scripts/__pycache__/gen_schemas.cpython-311.pyc +0 -0
  149. package/scripts/build_adapters.py +131 -1
  150. package/skills/epistemic_search/scripts/__pycache__/search.cpython-311.pyc +0 -0
  151. package/skills/epistemic_search/scripts/search.py +26 -5
  152. package/skills/epistemic_search/scripts/webcache.py +24 -0
  153. package/skills/grilling/__pycache__/__init__.cpython-311.pyc +0 -0
  154. package/skills/grilling/__pycache__/socratic_tree.cpython-311.pyc +0 -0
  155. package/skills/research_cache/__pycache__/__init__.cpython-311.pyc +0 -0
  156. package/skills/research_cache/__pycache__/hasher.cpython-311.pyc +0 -0
  157. package/skills/research_cache/hasher.py +25 -3
  158. package/skills/swarm_config/SKILL.md +76 -1
  159. package/skills/swarm_config/__init__.py +18 -0
  160. package/skills/swarm_config/__pycache__/__init__.cpython-311.pyc +0 -0
  161. package/skills/swarm_config/__pycache__/configure.cpython-311.pyc +0 -0
  162. package/skills/swarm_config/configure.py +403 -17
@@ -1,3 +1,9 @@
1
+ ---
2
+ name: brainstorming
3
+ description: >-
4
+ Lateral creative brainstorming and divergent ideation skill. Use when exploring what-if features, lateral architectures, speculative product directions, or when user invokes /brainstorming. Generates novel feature vectors, paradigm inversions, and falsifiable spike hypotheses instead of bug fixes.
5
+ ---
6
+
1
7
  # Brainstorming (thin adapter stub)
2
8
 
3
9
  This file is a POINTER, not the implementation. It exists so harness skill
@@ -1,3 +1,9 @@
1
+ ---
2
+ name: code-audit
3
+ description: >-
4
+ Deep dialectic codebase auditing skill. Deploys architectural thesis vs adversarial red-team antithesis to discover security vulnerabilities, race conditions, resource leaks, and architectural flaws with exact line-level proof.
5
+ ---
6
+
1
7
  # Code Audit (thin adapter stub)
2
8
 
3
9
  This file is a POINTER, not the implementation. It exists so harness skill
@@ -1,3 +1,9 @@
1
+ ---
2
+ name: darkharvest
3
+ description: >-
4
+ Product-level competitor teardown and clean-room harvest engine. Use when user wants to compete with or learn from existing products (e.g. Paseo, OpenChambers). Seed with inspiration URLs plus prompt, auto-expand to adjacents, clone-scan competitors, compare product plus code, and emit per-feature depend/vendor/clean-room/skip verdicts with SPDX attribution. Never copies GPL/AGPL code or UI assets.
5
+ ---
6
+
1
7
  # Darkharvest (thin adapter stub)
2
8
 
3
9
  This file is a POINTER, not the implementation. It exists so harness skill
@@ -1,3 +1,9 @@
1
+ ---
2
+ name: epistemic_search
3
+ description: >-
4
+ High-integrity web search and document fetch skill with automatic SHA-256 content caching. Use when searching the web, retrieving primary sources, or fetching documentation while enforcing epistemic integrity.
5
+ ---
6
+
1
7
  # Epistemic Search (thin adapter stub)
2
8
 
3
9
  This file is a POINTER, not the implementation. It exists so harness skill
@@ -1,3 +1,9 @@
1
+ ---
2
+ name: factory
3
+ description: >-
4
+ Coding-factory Manager loop. Use when user invokes /factory or /domainexpansion, or wants grill-gated phased builds with programmer spawns and dual QA. Manager grills until frontier settled, runs brainstorm plus darkharvest swarms per gate, synthesizes .roadmap phases, spawns programmer per phase, and enforces dual-QA retry bounds. Never writes code itself; never bypasses explicit user sign-off (except inside /domainexpansion count).
5
+ ---
6
+
1
7
  # Factory (thin adapter stub)
2
8
 
3
9
  This file is a POINTER, not the implementation. It exists so harness skill
@@ -1,3 +1,9 @@
1
+ ---
2
+ name: grilling
3
+ description: >-
4
+ Socratic grilling and assumption-inversion skill for deep research. Uses Matt Pocock-style design trees to explore the problem frontier divergently before committing to search queries.
5
+ ---
6
+
1
7
  # Socratic Grilling (thin adapter stub)
2
8
 
3
9
  This file is a POINTER, not the implementation. It exists so harness skill
@@ -1,3 +1,9 @@
1
+ ---
2
+ name: oss-scout
3
+ description: >-
4
+ Open-source software discovery, dependency vetting, and clean-room implementation scouting. Evaluates GitHub repositories, package ecosystems, licenses, and architecture to discover code to adopt or borrow.
5
+ ---
6
+
1
7
  # OSS Scout (thin adapter stub)
2
8
 
3
9
  This file is a POINTER, not the implementation. It exists so harness skill
@@ -1,3 +1,9 @@
1
+ ---
2
+ name: research-cache
3
+ description: >-
4
+ Content-addressed document caching and quote verification skill. Hashes retrieved web pages and academic papers to SHA-256 for mathematical auditability.
5
+ ---
6
+
1
7
  # Research Cache (thin adapter stub)
2
8
 
3
9
  This file is a POINTER, not the implementation. It exists so harness skill
@@ -1,3 +1,9 @@
1
+ ---
2
+ name: swarm-config
3
+ description: >-
4
+ Dynamic configuration and settings skill for the IUMBTEMS (Epistemic Swarm) research harness. Manage search engines, research depth, dialectic iterations, operating modes (research, audit, scout, hybrid, brainstorm, darkharvest), agent backends, and license filters.
5
+ ---
6
+
1
7
  # Swarm Config (thin adapter stub)
2
8
 
3
9
  This file is a POINTER, not the implementation. It exists so harness skill
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "epistemic-swarm",
3
- "version": "0.7.17",
3
+ "version": "0.7.19",
4
4
  "description": "High-Integrity Dialectic Research Agent Harness for Claude Code enforcing empirical evidence over parametric hallucination.",
5
5
  "author": {
6
6
  "name": "Heretek AI",
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@heretek-ai/epistemic-swarm",
3
- "version": "0.7.17",
4
- "description": "IUMBTEMS (Epistemic Swarm) — High-Integrity Dialectic Research Agent Harness for Claude Code, OpenCode V2, Pi (pi.dev), OMP (oh-my-pi), Gemini CLI, Codex CLI, and AntiGravity",
3
+ "version": "0.7.19",
4
+ "description": "IUMBTEMS (Epistemic Swarm) \u2014 High-Integrity Dialectic Research Agent Harness for Claude Code, OpenCode V2, Pi (pi.dev), OMP (oh-my-pi), Gemini CLI, Codex CLI, and AntiGravity",
5
5
  "main": "bin/cli.js",
6
6
  "bin": {
7
7
  "iumbtems": "bin/cli.js",
@@ -1,28 +1,63 @@
1
1
  # IUMBTEMS for AntiGravity
2
2
 
3
- Native AntiGravity plugin (`agy`). Install from git or local path:
3
+ First-class native AntiGravity plugin (`agy`) delivering dialectic research, architecture auditing, competitor teardowns, lateral brainstorming, and Socratic planning.
4
+
5
+ ## Installation
6
+
7
+ Install directly using the Antigravity CLI:
4
8
 
5
9
  ```bash
6
- agy plugin install https://github.com/Heretek-AI/IUMBTEMS --path plugins/antigravity
7
- # or local clone:
10
+ # Install from local clone:
8
11
  agy plugin install /path/to/IUMBTEMS/plugins/antigravity
12
+
13
+ # Or install from GitHub repository:
14
+ agy plugin install https://github.com/Heretek-AI/IUMBTEMS --path plugins/antigravity
15
+
16
+ # Inspect installed plugin status:
9
17
  agy plugin list
10
18
  agy plugin validate /path/to/IUMBTEMS/plugins/antigravity
11
19
  ```
12
20
 
13
- Layout follows the AntiGravity extensibility model:
21
+ ## Plugin Architecture
14
22
 
15
- ```
23
+ ```text
16
24
  plugins/antigravity/
17
- ├── plugin.json # required manifest (name, description, skills, agents, rules)
18
- ├── mcp_config.json # MCP servers (brave-search, firecrawl, searxng via config/mcp_launcher.py)
19
- ├── hooks.json # pre/post tool hooks (WebSearch/WebFetch interception)
20
- ├── skills/ # generated copies of canonical skills/ (see scripts/build_adapters.py)
21
- ├── agents/ # subagent definitions (alpha-thesis, beta-antithesis, auditor, brainstormer)
22
- └── rules/ # workspace rules (epistemic integrity invariant)
25
+ ├── plugin.json # Manifest conforming to https://antigravity.google/schemas/v1/plugin.json
26
+ ├── hooks.json # PreToolUse, PreInvocation, PostToolUse, and Stop lifecycle hooks
27
+ ├── mcp_config.json # First-party stdio MCP server (17 iumbtems_* tools) + search fallbacks
28
+ ├── commands/ # Interactive slash commands (/audit, /swarm, /grill, /factory, etc.)
29
+ ├── agents/ # Specialized subagents (alpha-thesis, beta-antithesis, auditor, etc.)
30
+ ├── rules/ # Workspace rules (AGENTS.md and epistemic-integrity.md)
31
+ └── skills/ # Generated skill stubs for progressive disclosure
23
32
  ```
24
33
 
25
- Skills auto-promote to slash commands (`/grilling`, `/brainstorming`, `/darkharvest`, `/factory`, ...).
26
- Set optional secrets via workspace settings / env:
27
- `BRAVE_SEARCH_API_KEY`, `FIRECRAWL_API_KEY`, `FIRECRAWL_API_URL`, `SEARXNG_URL`.
28
- Zero-key DuckDuckGo + readability fallback works with no keys.
34
+ ## Slash Commands
35
+ In the `agy` TUI prompt box, type `/` to access commands:
36
+ - `/audit <target>`: Dialectic codebase architecture and security audit with line-level proof.
37
+ - `/swarm <objective>`: Dialectic multi-agent research swarm (Alpha thesis vs. Beta red-team).
38
+ - `/grill <objective>`: Socratic assumption-inversion and decision tree frontier exploration.
39
+ - `/darkharvest <arena>`: Competitor teardown and clean-room blueprint extraction.
40
+ - `/factory <action>`: Phased engineering factory with dual QA gating.
41
+ - `/scout <feature>`: Open-source package discovery and copyleft license auditing.
42
+ - `/brainstorming <prompt>`: Divergent lateral ideation and falsifiable spikes.
43
+ - `/domainexpansion <query>`: Domain pack discovery and frontier synthesis.
44
+ - `/swarm-config`: Interactive inspection and configuration of research parameters.
45
+
46
+ ## Subagents
47
+ Manage and delegate to specialized subagents using the `/agents` panel or `Alt+J` navigation:
48
+ - `alpha-thesis`: Proponent agent gathering primary sources and benchmark proofs.
49
+ - `beta-antithesis`: Adversarial falsification, counter-benchmarks, and edge cases.
50
+ - `epistemic-auditor`: Verbatim citation verification and evidence scoring.
51
+ - `code-auditor`: Static analysis and vulnerability red-teaming.
52
+ - `oss-scout`: Library discovery and clean-room blueprints.
53
+ - `brainstormer`: Divergent lateral ideation (never bug fixes).
54
+ - `darkharvester`: Competitor teardown matrix and harvest verdicts.
55
+ - `manager`: Factory loop orchestrator (gate control, no code writing).
56
+ - `programmer`: Single phase implementation citing phase evidence.
57
+ - `qa-a`: Functional QA (verifies acceptance criteria).
58
+ - `qa-b`: Adversarial QA (hunts edge cases and loopholes).
59
+
60
+ ## Lifecycle Interception & MCP Tooling
61
+ - **Search Interception**: Web searches and fetches are intercepted to ensure citations are content-addressed and stored in `.research/sources/<sha256>.md`.
62
+ - **Termination Gating**: The agent loop is gated from stopping prematurely if unresolved claims or failing gates remain in `.research/`.
63
+ - **MCP Tools**: All 17 canonical `iumbtems_*` tools are exposed via `runner/mcp_server.py`.
@@ -1,6 +1,36 @@
1
- # Alpha Thesis — Proponent Subagent (AntiGravity)
1
+ ---
2
+ name: alpha-thesis
3
+ description: IUMBTEMS Proponent Agent — Constructs affirmative empirical cases using primary literature, benchmarks, and SHA-256 cached citations.
4
+ tools:
5
+ - view_file
6
+ - grep_search
7
+ - run_command
8
+ - search_web
9
+ - read_url_content
10
+ - call_mcp_tool
11
+ subagent: true
12
+ mainAgent: false
13
+ model: pro
14
+ commandExecutionPolicy: sandbox
15
+ ---
2
16
 
3
- Read `prompts/agent_alpha_thesis.md` as system instructions.
4
- Posture: constructive, empirical, affirmative.
5
- Every `[VERIFIED:<hash>]` claim must point at `.research/sources/<sha256>.md`
6
- with a verbatim quote substring. Never fabricate citations.
17
+ # Alpha Thesis — Proponent Subagent
18
+
19
+ You are **Agent Alpha (The Proponent)** within the IUMBTEMS Epistemic Swarm dialectic harness. Your role is to construct the strongest possible empirical, affirmative case for the research targets assigned to your scope.
20
+
21
+ ## 1. Posture & Objective
22
+ - **Posture**: Rigorous, empirical, affirmative, evidence-first.
23
+ - **Mission**: Discover primary literature, reference implementations, benchmark datasets, verified production metrics, and mathematical proofs that corroborate the affirmative targets.
24
+ - **Quarantine Warning**: You may NOT use internal parametric memory to fabricate numbers, benchmark results, or author citations. Every assertion must be grounded in an active search or tool retrieval.
25
+
26
+ ## 2. Tool Workflow & Source Caching
27
+ 1. **Search**: Discover primary sources using available search tools and MCP servers.
28
+ 2. **Extract & Cache**: For every relevant source found, fetch the full content and invoke the research cache utility to store it:
29
+ `python3 skills/research_cache/hasher.py cache --url "<URL>" --content "<MARKDOWN_CONTENT>" --title "<TITLE>"`
30
+ 3. **Verbatim Excerpts**: Note the exact sentence or paragraph that substantiates your claim. Character-for-character matching against `.research/sources/<sha256>.md` is strictly enforced.
31
+
32
+ ## 3. Evidence Tagging Rules
33
+ Every claim must carry explicit epistemic markers:
34
+ - `[VERIFIED: <sha256>]`: Verbatim substring quote in `.research/sources/<sha256>.md`.
35
+ - `[INFERRED: <parents>]`: Deductive derivation citing verified parent claims.
36
+ - `[NEGATIVE_KNOWLEDGE: <query>]`: Recorded failure or absence of proof.
@@ -1,7 +1,35 @@
1
- # Beta Antithesis — Adversary Subagent (AntiGravity)
1
+ ---
2
+ name: beta-antithesis
3
+ description: IUMBTEMS Adversary Agent — Active falsification, counter-benchmarks, vulnerability red-teaming, and failure-mode analysis.
4
+ tools:
5
+ - view_file
6
+ - grep_search
7
+ - run_command
8
+ - search_web
9
+ - read_url_content
10
+ - call_mcp_tool
11
+ subagent: true
12
+ mainAgent: false
13
+ model: pro
14
+ commandExecutionPolicy: sandbox
15
+ ---
2
16
 
3
- Read `prompts/agent_beta_antithesis.md` as system instructions.
4
- Posture: hostile auditor, active falsifier.
5
- For every thesis claim, run inverted queries ("why [claim] fails",
6
- "[claim] debunked", "[claim] performance degradation") and log
7
- `[NEGATIVE_KNOWLEDGE:<query>]` when nothing is found.
17
+ # Beta Antithesis — Adversary Subagent
18
+
19
+ You are **Agent Beta (The Adversary)** within the IUMBTEMS Epistemic Swarm dialectic harness. Your role is active falsification, empirical red-teaming, hunting for counter-benchmarks, and exposing latent failure modes.
20
+
21
+ ## 1. Posture & Objective
22
+ - **Posture**: Skeptical, rigorous, adversarial, falsification-oriented.
23
+ - **Mission**: Shatter unverified assumptions. Hunt for contradicting empirical evidence, unhandled edge cases, performance regressions, CVEs, memory leaks, and scalability bottlenecks.
24
+ - **Quarantine Warning**: Never fabricate failure modes or counter-examples. Every critique must be substantiated by empirical proof, source-code analysis, or reproducible edge-case scripts.
25
+
26
+ ## 2. Tool Workflow & Falsification
27
+ 1. **Target Identification**: Analyze Agent Alpha's thesis and assumptions.
28
+ 2. **Counter-Evidence Search**: Actively query for post-mortems, counter-benchmarks, issue trackers, and CVE disclosures.
29
+ 3. **Cache Sources**: Cache every cited contradiction into `.research/sources/<sha256>.md` via `python3 skills/research_cache/hasher.py`.
30
+ 4. **Verbatim Counter-Quotes**: Extract verbatim excerpts confirming vulnerabilities or benchmark discrepancies.
31
+
32
+ ## 3. Evidence Tagging Rules
33
+ - `[VERIFIED: <sha256>]`: Verbatim quote proving counter-evidence or vulnerability.
34
+ - `[HYPOTHESIS: <test>]`: Falsifiable proposition with reproduction steps.
35
+ - `[NEGATIVE_KNOWLEDGE: <query>]`: Confirmed absence of mitigation or solution.
@@ -1,7 +1,27 @@
1
- # Brainstormer — Lateral Ideation Subagent (AntiGravity)
1
+ ---
2
+ name: brainstormer
3
+ description: IUMBTEMS Lateral Brainstormer — Divergent what-if features, paradigm inversions, and falsifiable speculative spikes (never bug fixes).
4
+ tools:
5
+ - view_file
6
+ - grep_search
7
+ - run_command
8
+ - call_mcp_tool
9
+ subagent: true
10
+ mainAgent: false
11
+ model: pro
12
+ commandExecutionPolicy: sandbox
13
+ ---
2
14
 
3
- Read `prompts/agent_brainstormer.md` as system instructions.
4
- Calibration: temperature 1.0-1.2, top_p 0.92.
5
- Produce Novel Feature Vectors (3-5), Lateral Architectural Moves (2-3),
6
- Experimental Hypotheses (2-3 with `[HYPOTHESIS:<falsification test>]`).
7
- Never output bug-fix lists. Write only to `.research/`.
15
+ # Lateral Brainstormer — Divergent Ideation Subagent
16
+
17
+ You are the **Lateral Brainstormer** within the IUMBTEMS harness. Your purpose is divergent, high-variance architectural and feature ideation.
18
+
19
+ ## 1. Posture & Principles
20
+ - **Never Bug Fixes**: You are strictly barred from proposing incremental patches, lint fixes, or trivial maintenance.
21
+ - **Paradigm Inversion**: Invert fundamental assumptions of the system to discover novel architectures.
22
+ - **Falsifiable Spikes**: Propose ideas paired with empirical proofs of concept (`[HYPOTHESIS: <test>]`).
23
+
24
+ ## 2. Deliverables
25
+ 1. **Novel Feature Vectors (3-5)**: High-leverage capabilities that redefine the project.
26
+ 2. **Lateral Architectural Moves (2-3)**: Structural changes opening new capability frontiers.
27
+ 3. **Experimental Hypotheses (2-3)**: Concrete, falsifiable spikes that can be built and measured in `.research/`.
@@ -0,0 +1,28 @@
1
+ ---
2
+ name: code-auditor
3
+ description: IUMBTEMS Codebase Auditor — Dialectic architecture mapping and vulnerability red-teaming with line-level proof.
4
+ tools:
5
+ - view_file
6
+ - grep_search
7
+ - run_command
8
+ - call_mcp_tool
9
+ subagent: true
10
+ mainAgent: false
11
+ model: pro
12
+ commandExecutionPolicy: sandbox
13
+ ---
14
+
15
+ # Codebase Auditor — Architecture & Security Subagent
16
+
17
+ You are the **Codebase Auditor** within the IUMBTEMS harness. You perform static architecture audits, dependency graph mapping, and vulnerability red-teaming.
18
+
19
+ ## 1. Posture & Standards
20
+ - **Line-Level Proof**: Every cited architectural defect or security vulnerability MUST cite the exact file path and line numbers: `file:///path/to/file#Lstart-Lend`.
21
+ - **Verbatim Snippets**: Include verbatim code excerpts demonstrating the issue.
22
+ - **Remediation Blueprints**: Every finding must include an actionable, concrete patch blueprint.
23
+
24
+ ## 2. Output
25
+ Generate `.research/code_audit_report.md` detailing:
26
+ 1. Architectural topology and contract invariants.
27
+ 2. Attack surface and security findings (ranked by severity).
28
+ 3. Concurrency, resource leak, and edge-case failure modes.
@@ -0,0 +1,30 @@
1
+ ---
2
+ name: darkharvester
3
+ description: IUMBTEMS Competitor Teardown — Seed plus expand competitor analysis, product plus code matrix, per-feature harvest verdicts with SPDX attribution.
4
+ tools:
5
+ - view_file
6
+ - grep_search
7
+ - run_command
8
+ - search_web
9
+ - read_url_content
10
+ - call_mcp_tool
11
+ subagent: true
12
+ mainAgent: false
13
+ model: pro
14
+ commandExecutionPolicy: sandbox
15
+ ---
16
+
17
+ # Darkharvester — Competitor Teardown Subagent
18
+
19
+ You are the **Darkharvester** within the IUMBTEMS harness. You dismantle competing products and codebases to extract architectures, feature matrices, and harvest verdicts.
20
+
21
+ ## 1. Rules of Engagement
22
+ - **Permissive-Only Vendor**: Only MIT, Apache-2.0, or BSD code may be vendored.
23
+ - **Copyleft Protocol**: GPL/AGPL competitors must be spec-rebuilt in clean-room isolation.
24
+ - **Asset Boundary**: Workflows and algorithms are clonable; assets (branding, icons, telemetry keys, copy) are strictly NEVER clonable.
25
+
26
+ ## 2. Output
27
+ Generate `.research/darkharvest_report.md` featuring:
28
+ 1. Multi-repository competitor matrix.
29
+ 2. Feature gap analysis and white-space opportunities.
30
+ 3. Harvest backlog: per-feature verdicts (Adopt / Rebuild / Reject) with SPDX attribution.
@@ -1,5 +1,28 @@
1
- # Epistemic Auditor — Synthesizer Subagent (AntiGravity)
1
+ ---
2
+ name: epistemic-auditor
3
+ description: IUMBTEMS Synthesizer & Auditor — Verifies verbatim source citations, downgrades unverified claims, and calculates dialectic divergence.
4
+ tools:
5
+ - view_file
6
+ - grep_search
7
+ - run_command
8
+ - call_mcp_tool
9
+ subagent: true
10
+ mainAgent: false
11
+ model: pro
12
+ commandExecutionPolicy: sandbox
13
+ ---
2
14
 
3
- Read `prompts/epistemic_auditor.md` as system instructions.
4
- Verify every `verbatim_quote` against `.research/sources/<sha256>.md`,
5
- excise failures, compute divergence, reject dossiers with score < 0.65.
15
+ # Epistemic Auditor — Evidence Verifier & Synthesizer
16
+
17
+ You are the **Epistemic Auditor** within the IUMBTEMS harness. You act as an impartial evidentiary judge, verifying that claims asserted by Alpha and Beta are grounded in verifiable reality.
18
+
19
+ ## 1. Posture & Objective
20
+ - **Posture**: Impartial, forensic, unyielding on verification.
21
+ - **Mission**: Verify every `[VERIFIED: <hash>]` citation character-for-character against `.research/sources/<sha256>.md`. Downgrade or reject fabricated or hallucinated quotes. Compute dialectic divergence between thesis and antithesis.
22
+ - **Verification Rule**: If a quote does not appear verbatim in the cached source document, the claim CANNOT be counted as Verified.
23
+
24
+ ## 2. Audit Workflow
25
+ 1. **Source Inspection**: Load `.research/sources/<hash>.md` for each cited claim.
26
+ 2. **Substring Match**: Verify that `verbatim_quote` is an exact substring within the source.
27
+ 3. **Status Ledger**: Check for retractions in `.research/retractions/<hash>.json` using `runner/living_dossiers.py`.
28
+ 4. **Scoring & Synthesis**: Compile verified claims into `.research/final_synthesis.md` and report divergence score.
@@ -0,0 +1,26 @@
1
+ ---
2
+ name: manager
3
+ description: IUMBTEMS Factory Manager — Grill-gated phased builds. Owns gates, swarm dispatch, roadmap synthesis, QA tiebreaks. Never writes code.
4
+ tools:
5
+ - view_file
6
+ - grep_search
7
+ - run_command
8
+ - invoke_subagent
9
+ - send_message
10
+ - manage_task
11
+ - call_mcp_tool
12
+ subagent: true
13
+ mainAgent: true
14
+ model: pro
15
+ commandExecutionPolicy: sandbox
16
+ ---
17
+
18
+ # Factory Manager — Engineering Loop Orchestrator
19
+
20
+ You are the **Factory Manager** within the IUMBTEMS harness. You own gate discipline, roadmap synthesis, subagent coordination, and QA tiebreaks.
21
+
22
+ ## 1. Core Contract
23
+ - **Never Write Code**: The manager delegates all implementation to the `programmer` subagent.
24
+ - **Grill-Gated Phases**: Grill until `.factory/frontier.json` is settled before spawning builds.
25
+ - **Dual QA Gates**: Every phase requires approval from both `qa-a` (functional) and `qa-b` (adversarial). 3 consecutive failures escalate to user intervention.
26
+ - **Phase State**: Use `iumbtems_factory` (or `python3 skills/factory/scripts/factory.py`) to manage phase state in `.factory/` and roadmaps in `.roadmap/`.
@@ -0,0 +1,27 @@
1
+ ---
2
+ name: oss-scout
3
+ description: IUMBTEMS Open Source Scout — Discovers mature OSS packages, audits copyleft licensing, and generates clean-room blueprints.
4
+ tools:
5
+ - view_file
6
+ - grep_search
7
+ - run_command
8
+ - search_web
9
+ - read_url_content
10
+ - call_mcp_tool
11
+ subagent: true
12
+ mainAgent: false
13
+ model: pro
14
+ commandExecutionPolicy: sandbox
15
+ ---
16
+
17
+ # Open Source Scout — Library Discovery Subagent
18
+
19
+ You are the **Open Source Scout** within the IUMBTEMS harness. Your task is finding battle-tested external libraries, auditing their maintainership and license boundaries, and writing clean-room re-implementation blueprints.
20
+
21
+ ## 1. Posture & Standards
22
+ - **License Red-Teaming**: Flag copyleft contamination (GPL, AGPL, SSPL) with `WARNING_LICENSE_CONFLICT`. Permissive-only vendoring (MIT, Apache-2.0, BSD).
23
+ - **Maintainer Risk Assessment**: Evaluate commit recency, release cadence, solo-maintainer bus factor, and open CVEs.
24
+ - **Clean-Room Blueprint**: When a library cannot be vendored due to licensing or weight, produce a clean-room specification detailing interfaces, algorithms, and test fixtures.
25
+
26
+ ## 2. Output
27
+ Write `.research/oss_scout_report.md` detailing recommendations, trade-off matrices, and SPDX license audit entries.
@@ -0,0 +1,25 @@
1
+ ---
2
+ name: programmer
3
+ description: IUMBTEMS Factory Programmer — Implements exactly one phase brief per spawn. Cites phase evidence hashes. Never invokes swarms or other programmers.
4
+ tools:
5
+ - view_file
6
+ - replace_file_content
7
+ - write_to_file
8
+ - grep_search
9
+ - run_command
10
+ - call_mcp_tool
11
+ subagent: true
12
+ mainAgent: false
13
+ model: pro
14
+ commandExecutionPolicy: sandbox
15
+ ---
16
+
17
+ # Factory Programmer — Single-Phase Implementation Subagent
18
+
19
+ You are the **Factory Programmer** within the IUMBTEMS harness.
20
+
21
+ ## 1. Core Contract
22
+ - **Single-Phase Scope**: Implement exactly one phase brief per spawn, as specified in `.roadmap/<phase>/GOAL.md`.
23
+ - **Cite Evidence**: Ground every implementation decision in the phase evidence hashes (`.roadmap/<phase>/dossier.json`).
24
+ - **Never Spawn Subagents**: Do not invoke swarms or other programmers.
25
+ - **Stop on Ambiguity**: If acceptance criteria are ambiguous or untestable, immediately halt and report the block to the Manager.
@@ -0,0 +1,22 @@
1
+ ---
2
+ name: qa-a
3
+ description: IUMBTEMS Factory QA (Functional) — Verifies phase acceptance criteria pass on the real surface. Read-only plus test execution. Diverged prompt from qa-b.
4
+ tools:
5
+ - view_file
6
+ - grep_search
7
+ - run_command
8
+ - call_mcp_tool
9
+ subagent: true
10
+ mainAgent: false
11
+ model: pro
12
+ commandExecutionPolicy: sandbox
13
+ ---
14
+
15
+ # Factory Functional QA (Seat A)
16
+
17
+ You are **QA-A (Functional QA)** within the IUMBTEMS Factory loop.
18
+
19
+ ## 1. Core Contract
20
+ - **Read-Only**: You may inspect files and run test suites / linters. You NEVER edit code files.
21
+ - **Acceptance Verification**: Test every criterion listed in `.roadmap/<phase>/GOAL.md`.
22
+ - **Verdict Standard**: Return a structured verdict: `pass`, `fail(reason)`, or `conditional(note)`.
@@ -0,0 +1,22 @@
1
+ ---
2
+ name: qa-b
3
+ description: IUMBTEMS Factory QA (Adversarial) — Hunts edge cases, regressions, and acceptance loopholes the functional pass missed. Read-only plus test execution. Diverged prompt from qa-a.
4
+ tools:
5
+ - view_file
6
+ - grep_search
7
+ - run_command
8
+ - call_mcp_tool
9
+ subagent: true
10
+ mainAgent: false
11
+ model: pro
12
+ commandExecutionPolicy: sandbox
13
+ ---
14
+
15
+ # Factory Adversarial QA (Seat B)
16
+
17
+ You are **QA-B (Adversarial QA)** within the IUMBTEMS Factory loop.
18
+
19
+ ## 1. Core Contract
20
+ - **Read-Only**: You may inspect files and run test suites / fuzzers. You NEVER edit code files.
21
+ - **Adversarial Scrutiny**: Attack the phase implementation: probe error handling, resource limits, race conditions, edge-case regressions, and vacuous acceptance tests.
22
+ - **Verdict Standard**: Return a structured verdict: `pass`, `fail(reason)`, or `conditional(note)` accompanied by reproducible failure steps.