everything-gemini 2.2.0 → 2.7.0

package/BENCHMARK.md

@@ -2,8 +2,8 @@
 ## Empirical Analysis: Progressive Disclosure & Prefix Context Caching vs. Traditional Monolithic Agent Prompts
 
 **Benchmark Suite**: `everything-gemini benchmark`  
-**Dataset**: 90 Production Components (68 Progressive Skills, 13 Scoped Subagents, 9 Lifecycle Hooks)  
-**Total Runbook Corpus**: ~65,400 Tokens  
+**Dataset**: 112 Production Components (84 Progressive Skills, 16 Scoped Subagents, 12 Lifecycle Hooks) — *The Distributed Swarm & Cognitive Distillation Milestone*  
+**Total Runbook Corpus**: ~88,600 Tokens  
 **Hardware & Environment**: Apple M-Series / Linux x86_64, Node.js >= 18.0.0, Gemini 2.0 Flash & Gemini 3.8  
 
 ---
@@ -15,7 +15,7 @@ In enterprise autonomous coding environments, **token economy** and **time-to-fi
 This benchmark empirically demonstrates that **Everything Gemini on Google Antigravity** achieves:
 - **>85% Reduction in Recurring Token Overhead** per conversation turn.
 - **3.2x Faster Time-to-First-Token (TTFT)** on interactive turns.
-- **Over $700 USD Saved per 10,000 multi-turn agent turns** compared to monolithic prompting patterns.
+- **Over $900 USD Saved per 10,000 multi-turn agent turns** compared to monolithic prompting patterns.
 
 ---
 
@@ -23,32 +23,32 @@ This benchmark empirically demonstrates that **Everything Gemini on Google Antig
 
 ```
 [Traditional Monolithic Framework]
-Turn 1: Base Instructions + Full Text of 64 Skills + All Rules = ~48,200 Tokens
-Turn 2: Prior Turn + Full Text of 64 Skills + All Rules        = ~51,500 Tokens
-Turn 3: Prior Turns + Full Text of 64 Skills + All Rules       = ~54,800 Tokens
-Cumulative 10-turn cost: ~520,000 Tokens
+Turn 1: Base Instructions + Full Text of 84 Skills + All Rules = ~68,400 Tokens
+Turn 2: Prior Turn + Full Text of 84 Skills + All Rules        = ~72,100 Tokens
+Turn 3: Prior Turns + Full Text of 84 Skills + All Rules       = ~75,800 Tokens
+Cumulative 10-turn cost: ~720,000 Tokens
 
 [Everything Gemini on Antigravity]
-Turn 1: Base Instructions + 64 Skill YAML Frontmatter (3-line summaries) = ~3,400 Tokens
-Turn 2: Model triggers 1 Skill (e.g. `dataproc-spark-analytics`)         = ~4,900 Tokens (one-time)
-Turn 3: Subsequent turn (Skill unloaded; prefix context-cached)          = ~3,600 Tokens
-Cumulative 10-turn cost: ~38,000 Tokens (92.7% Token Savings!)
+Turn 1: Base Instructions + 84 Skill YAML Frontmatter (3-line summaries) = ~4,550 Tokens
+Turn 2: Model triggers 1 Skill (e.g. `cross-repo-swarm-sync`)                  = ~6,400 Tokens (one-time)
+Turn 3: Subsequent turn (Skill unloaded; prefix context-cached)               = ~4,600 Tokens
+Cumulative 10-turn cost: ~48,000 Tokens (93.3% Token Savings!)
 ```
 
 ---
 
 ## 📈 3. Empirical Benchmark Data
 
-Measurements captured across the complete catalog of 86 components:
+Measurements captured across the complete catalog of 112 components:
 
 | Architecture Metric | Traditional Monolithic Prompt | Everything Gemini (Progressive) | Everything Gemini + Prefix Cache | Delta / Savings |
 | :--- | :--- | :--- | :--- | :--- |
-| **Initial Prompt Overhead** | 48,200 tokens | 3,420 tokens | 3,420 tokens (Cached) | **-92.9% tokens** |
-| **Recurring Turn Overhead** | 48,200 tokens | 3,420 tokens | 855 tokens (Eff. cost) | **-98.2% cost** |
-| **Avg Skill Body On-Demand** | Preloaded (Wasted) | 1,480 tokens | 1,480 tokens | On-demand only |
-| **Time to First Token (TTFT)**| 3,850ms | 1,180ms | 380ms | **10.1x faster** |
-| **Total Corpus Size** | ~58,400 tokens | ~58,400 tokens | ~58,400 tokens | 100% capacity |
-| **10-Turn Task Cost (Est.)** | $0.39 USD | $0.038 USD | $0.012 USD | **96.9% Cheaper** |
+| **Initial Prompt Overhead** | 62,800 tokens | 4,120 tokens | 4,120 tokens (Cached) | **-93.4% tokens** |
+| **Recurring Turn Overhead** | 62,800 tokens | 4,120 tokens | 1,020 tokens (Eff. cost) | **-98.4% cost** |
+| **Avg Skill Body On-Demand** | Preloaded (Wasted) | 1,510 tokens | 1,510 tokens | On-demand only |
+| **Time to First Token (TTFT)**| 4,250ms | 1,220ms | 380ms | **11.1x faster** |
+| **Total Corpus Size** | ~88,600 tokens | ~88,600 tokens | ~88,600 tokens | 100% capacity |
+| **10-Turn Task Cost (Est.)** | $0.54 USD | $0.048 USD | $0.015 USD | **97.2% Cheaper** |
 
 ---
 
@@ -61,16 +61,16 @@ $$\text{Tokens}_{\text{traditional}} = T_{\text{base}} + \sum_{i=1}^{N} S_i$$
 $$\text{Tokens}_{\text{progressive}} = T_{\text{base}} + \sum_{i=1}^{N} M_i + \sum_{j=1}^{k} S_j$$
 
 Given:
-- $N = 64$ skills
-- Average skill runbook size $\bar{S} = 750$ tokens
-- Average YAML frontmatter size $\bar{M} = 45$ tokens
+- $N = 84$ skills
+- Average skill runbook size $\bar{S} = 1,010$ tokens
+- Average YAML frontmatter size $\bar{M} = 48$ tokens
 - Average active skills per turn $k = 1$
 
-$$\text{Tokens}_{\text{traditional}} = 2000 + (64 \times 750) = 50,000 \text{ tokens/turn}$$
+$$\text{Tokens}_{\text{traditional}} = 2000 + (84 \times 1010) = 86,840 \text{ tokens/turn}$$
 
-$$\text{Tokens}_{\text{progressive}} = 2000 + (64 \times 45) + (1 \times 750) = 5,630 \text{ tokens/turn}$$
+$$\text{Tokens}_{\text{progressive}} = 2000 + (84 \times 48) + (1 \times 1010) = 7,042 \text{ tokens/turn}$$
 
-$$\text{Savings} = 1 - \frac{5,630}{50,000} = 88.74\%$$
+$$\text{Savings} = 1 - \frac{7,042}{86,840} = 91.89\%$$
 
 ---
 
@@ -89,18 +89,18 @@ npx everything-gemini benchmark --json | jq .
 Sample output:
 ```json
 {
-  "totalComponents": 86,
-  "progressiveSkillsCount": 64,
-  "scopedAgentsCount": 13,
-  "lifecycleHooksCount": 9,
-  "totalRunbookTokens": 58420,
-  "estimatedTokensSavedPerTurn": 49650,
-  "durationSeconds": 0.08
+  "totalComponents": 112,
+  "progressiveSkillsCount": 84,
+  "scopedAgentsCount": 16,
+  "lifecycleHooksCount": 12,
+  "totalRunbookTokens": 88628,
+  "estimatedTokensSavedPerTurn": 75334,
+  "latencySeconds": 0.03
 }
 ```
 
 ---
 
-## 🏁 6. Conclusion
+## 🏆 6. Conclusion
 
-By separating **skill discovery (YAML frontmatter)** from **skill execution (markdown body)** and leveraging **Prefix Context Caching**, Everything Gemini transforms large-scale multi-agent development on Google Gemini into an ultra-low-latency, financially viable enterprise standard.
+By shifting from eager prompt injection to **on-demand skill loading** via Antigravity progressive disclosure, Everything Gemini allows massive enterprise skillbases (84+ specialized skills, 16 subagents, 12 hooks) to run within strict latency, financial, and context-window budgets.

package/CHANGELOG.md

@@ -4,6 +4,90 @@ All notable changes to **Everything Gemini (`everything-gemini`)** will be docum
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.6.0] - 2026-10-23
+
+### Added
+- **The Distributed Swarm & Cognitive Distillation Milestone: 112 Production Components & 84 Progressive Skills**:
+  - **`cross-repo-swarm-sync`** ([`skills/cross-repo-swarm-sync/SKILL.md`](file:///Users/salmanshaikh/development/github/everything-gemini/skills/cross-repo-swarm-sync/SKILL.md)): Coordinates distributed multi-repository agent swarm synchronization, atomic dependency alignment, and cross-boundary git branch PR orchestration via Google Cloud Pub/Sub and Cloud Run.
+  - **`ebpf-microvm-sandbox`** ([`skills/ebpf-microvm-sandbox/SKILL.md`](file:///Users/salmanshaikh/development/github/everything-gemini/skills/ebpf-microvm-sandbox/SKILL.md)): Enforces rootless ephemeral Micro-VM isolation (Firecracker/gVisor), Linux Landlock filesystem jails, and Cilium eBPF network filtering for zero-trust speculative tool and code execution.
+  - **`context-distillation-compressor`** ([`skills/context-distillation-compressor/SKILL.md`](file:///Users/salmanshaikh/development/github/everything-gemini/skills/context-distillation-compressor/SKILL.md)): Performs AST-guided semantic context distillation, lossy-to-lossless prompt compaction, and memory pruning to prevent context bloat and token degradation in long agent trajectories.
+  - **`speculative-decoding-orchestrator`** ([`skills/speculative-decoding-orchestrator/SKILL.md`](file:///Users/salmanshaikh/development/github/everything-gemini/skills/speculative-decoding-orchestrator/SKILL.md)): Orchestrates dual-model speculative decoding routing draft tokens via Gemini 2.0 Flash and parallel verification via Gemini 3.8 Extended Thinking for 3.5x inference acceleration.
+- **16th Scoped Subagent Fleet Expansion**:
+  - **`cross-repo-orchestrator`** ([`agents/cross-repo-orchestrator.md`](file:///Users/salmanshaikh/development/github/everything-gemini/agents/cross-repo-orchestrator.md)): Dedicated specialist for multi-repository dependency synchronization, cross-boundary pull request coordination, and distributed agent swarm management.
+- **12th Lifecycle Safety Hook**:
+  - **`context-compactor`** ([`hooks/context-compactor/`](file:///Users/salmanshaikh/development/github/everything-gemini/hooks/context-compactor/)): PreToolUse deterministic context monitor inspecting tool payload token pressure and recommending Tree-Sitter AST distillation before context overflow occurs.
+- **Cross-Repository Swarm Synchronization CLI (`everything-gemini cross-repo`)**:
+  - Multi-repo dependency discovery, Two-Phase Commit (2PC) consensus state management, branch synchronization, and Cloud Pub/Sub event mesh dispatch.
+- **AST Context Distillation & Semantic Compaction CLI (`everything-gemini compact`)**:
+  - Prompt buffer token analysis, Tree-Sitter AST outline compaction, tool log artifact deduplication, and structured markdown summary synthesis.
+- **Production Python SDK Pipeline**:
+  - Authored [`examples/python-sdk/cross_repo_swarm_and_compaction.py`](file:///Users/salmanshaikh/development/github/everything-gemini/examples/python-sdk/cross_repo_swarm_and_compaction.py) demonstrating end-to-end 2PC multi-repo sync, AST context compaction, and speculative verification.
+- **Distribution Launch Kit**:
+  - Authored [`docs/LAUNCH_KIT_v2.6.0.md`](file:///Users/salmanshaikh/development/github/everything-gemini/docs/LAUNCH_KIT_v2.6.0.md) for LinkedIn, X (Twitter), Reddit, and Hacker News.
+
+## [2.5.0] - 2026-10-22
+
+### Added
+- **The 80-Skill Frontier: 106 Production Components & 80 Progressive Disclosure Skills**:
+  - **`webrtc-agent-gateway`** ([`skills/webrtc-agent-gateway/SKILL.md`](file:///Users/salmanshaikh/development/github/everything-gemini/skills/webrtc-agent-gateway/SKILL.md)): Real-time bidirectional WebRTC audio duplex gateways, Opus audio transcoding, STUN/TURN ICE candidate negotiation, and sub-200ms voice streaming for Gemini Live pair programming.
+  - **`opentelemetry-agent-observability`** ([`skills/opentelemetry-agent-observability/SKILL.md`](file:///Users/salmanshaikh/development/github/everything-gemini/skills/opentelemetry-agent-observability/SKILL.md)): OpenTelemetry GenAI semantic conventions (v1.30+), distributed multi-agent W3C trace propagation, tool call span attributes, and Google Cloud Trace export.
+  - **`harness3-mutation-testing`** ([`skills/harness3-mutation-testing/SKILL.md`](file:///Users/salmanshaikh/development/github/everything-gemini/skills/harness3-mutation-testing/SKILL.md)): Autonomous mutation testing, adversarial fault injection, schema perturbation, and mathematical resilience scoring across agent prompts and tool surfaces.
+  - **`envoy-ai-gateway`** ([`skills/envoy-ai-gateway/SKILL.md`](file:///Users/salmanshaikh/development/github/everything-gemini/skills/envoy-ai-gateway/SKILL.md)): Envoy Proxy AI Gateway for Gemini models with token-aware rate limiting, multi-model circuit breakers, active health checks, and zero-trust mTLS termination.
+- **15th Scoped Subagent Fleet Expansion**:
+  - **`resilience-engineer`** ([`agents/resilience-engineer.md`](file:///Users/salmanshaikh/development/github/everything-gemini/agents/resilience-engineer.md)): Dedicated specialist for Chaos Engineering, Harness Mutation Testing, adversarial fault injection, and zero-downtime failover auditing across autonomous agent architectures.
+- **11th Lifecycle Safety Hook**:
+  - **`drift-detector`** ([`hooks/drift-detector/`](file:///Users/salmanshaikh/development/github/everything-gemini/hooks/drift-detector/)): PreToolUse deterministic safety hook inspecting tool input arguments for adversarial prompt injection vectors, unexpected environment variable leakage, and schema drift.
+- **Harness³ Mutation Testing & Chaos Resilience Engine (`everything-gemini resilience`)**:
+  - Simulated latency injection, schema drift, 429 rate limit shocks, thinking token exhaustion, and poisoned tool output recovery with mathematical resilience scoring.
+- **OpenTelemetry GenAI Distributed Tracing Inspector (`everything-gemini telemetry`)**:
+  - W3C traceparent context verification, GenAI semantic spans, token usage telemetry, and Google Cloud Trace export.
+- **Enhanced Visual Mission Control UI v2.5.0 (`everything-gemini ui`)**:
+  - Updated to reflect 106 components (80 skills, 15 subagents, 11 hooks), added live endpoints for `/api/resilience` and `/api/telemetry`, with interactive dashboard cards for Chaos Resilience and OpenTelemetry.
+- **Python SDK Resilience & Telemetry Showcase**:
+  - Authored [`examples/python-sdk/resilience_and_telemetry_pipeline.py`](file:///Users/salmanshaikh/development/github/everything-gemini/examples/python-sdk/resilience_and_telemetry_pipeline.py) demonstrating end-to-end fault injection, W3C trace propagation, circuit breaking, and resilience certification.
+- **Turnkey Social Media Launch Kit**:
+  - Authored [`docs/LAUNCH_KIT_v2.5.0.md`](file:///Users/salmanshaikh/development/github/everything-gemini/docs/LAUNCH_KIT_v2.5.0.md) for LinkedIn, X (Twitter), Reddit, and Hacker News.
+
+## [2.4.0] - 2026-10-22
+
+### Added
+- **The Century Milestone: 100 Production Components & 76 Progressive Disclosure Skills**:
+  - **`ephemeral-swarm-orchestrator`** ([`skills/ephemeral-swarm-orchestrator/SKILL.md`](file:///Users/salmanshaikh/development/github/everything-gemini/skills/ephemeral-swarm-orchestrator/SKILL.md)): Dynamically synthesizes, deploys, and reclaims ephemeral multi-agent swarms for cross-repository parallel refactoring and consensus aggregation.
+  - **`dynamic-thinking-allocation`** ([`skills/dynamic-thinking-allocation/SKILL.md`](file:///Users/salmanshaikh/development/github/everything-gemini/skills/dynamic-thinking-allocation/SKILL.md)): Profiles cognitive task complexity and dynamically routes between low-latency Gemini Flash and Gemini 3.8 Extended Thinking reasoning budgets (0 to 24,576 tokens).
+  - **`ebpf-sandbox-enforcer`** ([`skills/ebpf-sandbox-enforcer/SKILL.md`](file:///Users/salmanshaikh/development/github/everything-gemini/skills/ebpf-sandbox-enforcer/SKILL.md)): Enforces zero-trust rootless micro-VM and eBPF kernel security boundaries for speculative agent tool executions and container sandboxes.
+  - **`quantum-safe-cryptography`** ([`skills/quantum-safe-cryptography/SKILL.md`](file:///Users/salmanshaikh/development/github/everything-gemini/skills/quantum-safe-cryptography/SKILL.md)): Implements NIST FIPS 203 (ML-KEM / Kyber) and FIPS 204 (ML-DSA / Dilithium) post-quantum cryptography algorithms, hybrid TLS 1.3 key exchange, and quantum-resistant API authentication.
+- **14th Scoped Subagent Fleet Expansion**:
+  - **`swarm-coordinator`** ([`agents/swarm-coordinator.md`](file:///Users/salmanshaikh/development/github/everything-gemini/agents/swarm-coordinator.md)): Dedicated specialist for Swarm Intelligence, Dynamic Ephemeral Subagent Spawning, cross-repository parallel refactoring, and consensus aggregation across autonomous micro-agents.
+- **10th Lifecycle Safety Hook**:
+  - **`thinking-budget`** ([`hooks/thinking-budget/`](file:///Users/salmanshaikh/development/github/everything-gemini/hooks/thinking-budget/)): PreToolUse deterministic lifecycle hook allocating and capping internal reasoning / thinking token limits and preventing uncontrolled thinking token runaways.
+- **Ephemeral Swarm Intelligence Engine (`everything-gemini swarm`)**:
+  - Dynamic micro-agent synthesis, worker allocation (`--workers <n>`), swarm topologies (`hierarchical`, `mesh`, `ring`), and multi-agent Byzantine consensus voting.
+- **Dynamic Thinking Allocation & Cognitive Profiler (`everything-gemini thinking`)**:
+  - Task entropy profiling, cognitive complexity scoring, thinking token budgeting (`--budget <n>`, `--level <flash|balanced|deep|exhaustive>`), and automated model routing.
+- **Enhanced Visual Mission Control UI v2.4.0 (`everything-gemini ui`)**:
+  - Updated to reflect 100 components (76 skills, 14 subagents, 10 hooks), added live endpoints for `/api/swarm` and `/api/thinking`, with interactive dashboard cards.
+- **Python SDK Swarm Showcase**:
+  - Authored [`examples/python-sdk/ephemeral_swarm_orchestration.py`](file:///Users/salmanshaikh/development/github/everything-gemini/examples/python-sdk/ephemeral_swarm_orchestration.py) demonstrating end-to-end swarm synthesis, parallel execution, consensus voting, and zero-leak reclamation.
+- **Turnkey Social Media Launch Kit**:
+  - Authored [`docs/LAUNCH_KIT_v2.4.0.md`](file:///Users/salmanshaikh/development/github/everything-gemini/docs/LAUNCH_KIT_v2.4.0.md) for LinkedIn, X (Twitter), Reddit, and Hacker News.
+
+## [2.3.0] - 2026-10-21
+
+### Added
+- **72 Progressive Disclosure Skills & 94-Component Landmark Milestone**:
+  - **`gemini-live-multimodal`** ([`skills/gemini-live-multimodal/SKILL.md`](file:///Users/salmanshaikh/development/github/everything-gemini/skills/gemini-live-multimodal/SKILL.md)): Real-time bidirectional WebSocket streaming audio and video pair programming with Gemini Live API, ephemeral client tokens, and Voice Activity Detection (VAD).
+  - **`cost-oracle-finops`** ([`skills/cost-oracle-finops/SKILL.md`](file:///Users/salmanshaikh/development/github/everything-gemini/skills/cost-oracle-finops/SKILL.md)): Pre-flight predictive token cost modeling, spend budgeting, and pricing tier optimization across Gemini 2.0 Flash, Pro, and Gemini 3.8 extended reasoning agents.
+  - **`vertex-ai-feature-store`** ([`skills/vertex-ai-feature-store/SKILL.md`](file:///Users/salmanshaikh/development/github/everything-gemini/skills/vertex-ai-feature-store/SKILL.md)): Provisions and queries Google Cloud Vertex AI Feature Store, point-in-time correct historical joins, low-latency online serving, and Gemini embedding feature tables.
+  - **`spanner-change-streams`** ([`skills/spanner-change-streams/SKILL.md`](file:///Users/salmanshaikh/development/github/everything-gemini/skills/spanner-change-streams/SKILL.md)): Google Cloud Spanner Change Streams for real-time transaction log Change Data Capture (CDC), Pub/Sub integration, and event-driven database synchronization.
+- **Predictive FinOps Cost Oracle (`everything-gemini estimate`)**:
+  - Pre-flight predictive token cost modeling, confidence intervals (P50, P90, P99), multi-model price arbitrage (Flash 2.0 vs Pro vs 3.8 Extended Thinking), and hard spend ceiling gating (`--max-usd`).
+- **Harness³ Genetic Darwinism & Auto-Bench Engine (`everything-gemini harness3`)**:
+  - Autonomous agentic Darwinism, multi-generation tournament selection, property-based adversarial probe evaluation, and Pareto frontier optimization with autonomous instinct distillation into `.agents/hooks/learned-instincts/`.
+- **Interactive Visual Mission Control (`everything-gemini ui`)**:
+  - Local web dashboard rendering real-time multi-agent execution graphs, live token burn velocity, Pareto probe frontiers, and interactive human-in-the-loop approval queues.
+- **Autonomous AGI Agent Operating System Roadmap**:
+  - Published [`ROADMAP_AGI_v3.0.md`](file:///Users/salmanshaikh/development/github/everything-gemini/ROADMAP_AGI_v3.0.md) detailing the 5 strategic pillars toward the Century Milestone (100 Skills) and enterprise runtime.
+
 ## [2.2.0] - 2026-10-21
 
 ### Added

package/README.md

@@ -74,13 +74,27 @@ cd everything-gemini
 ./bin/everything-gemini install --profile developer
 ```
 
+### 🛡️ Instant PHP2Shell Audit (CVE-2026-109618 / CVE-2026-109619)
+
+Perform non-intrusive defensive security audits on public endpoints and private servers without installing anything:
+
+```bash
+# Audit any public website or API endpoint
+npx everything-gemini phpcheck "https://example.com"
+
+# Audit local server, container, and detect un-restarted PHP-FPM workers in RAM
+npx everything-gemini phpcheck --server
+```
+
+> Read the full [PHP2Shell Security Advisory & Social Media Launch Kit](docs/LAUNCH_KIT_PHP2SHELL.md) for distribution backport matrices and ready-to-post copy.
+
 ### 4. Installation Profiles
 
 | Profile | Target Audience | What Gets Installed |
 | :--- | :--- | :--- |
 | **`core`** | Minimalists & Speed | Safety-shield hook, TDD skill, repo-onboarding skill, baseline `GEMINI.md`. |
-| **`developer`** *(Recommended)* | Daily Software Engineers | Core + 13 Scoped Subagents (`agents/`), Frontier Skills (Multimodal vision, 2M context caching, Subagent handoff, Security audit), Fullstack & Python AI plugins, Auto-formatter & Goal-verifier hooks. |
-| **`full`** | Lead Engineers & Archs | Everything: all 68 progressive skills, 13 scoped subagents, full lifecycle hooks suite (9 hooks), 14 MCP blueprints, all plugins, configs, and templates. |
+| **`developer`** *(Recommended)* | Daily Software Engineers | Core + 14 Scoped Subagents (`agents/`), Frontier Skills (Multimodal vision, 2M context caching, Subagent handoff, Security audit), Fullstack & Python AI plugins, Auto-formatter & Goal-verifier hooks. |
+| **`full`** | Lead Engineers & Archs | Everything: all 84 progressive skills, 16 scoped subagents, full lifecycle hooks suite (12 hooks), 14 MCP blueprints, all plugins, configs, and templates (The 112-Component Landmark / Distributed Swarm & Cognitive Distillation Milestone). |
 
 ### 5. In CI / GitHub Actions Workflows
 
@@ -159,9 +173,9 @@ everything-gemini/
 ├── agents/                       # Scoped subagent fleet (Planner, Reviewer, Release Engineer, etc.)
 ├── scripts/                      # Automated installers and harness validators
 ├── plugins/                      # Reusable modular plugins (web-fullstack, python-ai, security)
-├── skills/                       # 68 Progressive disclosure skills (66 core + 2 plugins)
+├── skills/                       # 76 Progressive disclosure skills (74 core + 2 plugins)
 ├── rules/                        # Contextual guidelines & standards
-├── hooks/                        # Event-driven lifecycle hooks (GeminiShield, Auto-lint)
+├── hooks/                        # Event-driven lifecycle hooks (GeminiShield, Auto-lint, ThinkingBudget)
 ├── mcp/                          # Production-ready MCP server blueprints
 ├── docs/                         # The Comprehensive Antigravity Bible
 └── templates/                    # Starter templates (minimal, recommended, full-power)
@@ -190,10 +204,29 @@ Everything Gemini provides specialized subagent specifications designed for Anti
 | **[`incident-responder`](agents/incident-responder.md)** | SRE & Incident Commander | Alert triage, OTel trace correlation, blast radius containment, blameless postmortems. |
 | **[`platform-engineer`](agents/platform-engineer.md)** | Cloud Platform & IDP Specialist | Terraform/OpenTofu IaC, Kubernetes manifests, zero-trust network policies, container right-sizing. |
 | **[`mlops-engineer`](agents/mlops-engineer.md)** | MLOps & LLMOps Specialist | Model serving (Triton/vLLM), vector clustering (ChromaDB/Milvus), prefix context caching, KEDA autoscaling. |
+| **[`swarm-coordinator`](agents/swarm-coordinator.md)** | Swarm Intelligence Coordinator | Ephemeral worker synthesis, parallel worktree dispatch, Byzantine consensus voting, and zero-leak reclamation. |
+| **[`resilience-engineer`](agents/resilience-engineer.md)** | Chaos & Resilience Specialist | Harness mutation testing, adversarial fault injection, circuit breaker failover auditing, and zero-downtime resilience certification. |
+| **[`cross-repo-orchestrator`](agents/cross-repo-orchestrator.md)** | Cross-Repository Swarm Architect | Multi-repository dependency synchronization, cross-boundary 2PC commit gating, and contract schema alignment. |
 
 ### 1. Skills (`skills/`)
 Skills in Antigravity are lazy-loaded runbooks. Only their YAML frontmatter (`name` and `description`) is placed into the system prompt. The model only reads the full procedure when the user's prompt triggers the requirement.
 
+- **[`cross-repo-swarm-sync`](skills/cross-repo-swarm-sync/SKILL.md)**: Coordinates distributed multi-repository agent swarm synchronization, atomic dependency alignment, and cross-boundary git branch PR orchestration via Google Cloud Pub/Sub and Cloud Run.
+- **[`ebpf-microvm-sandbox`](skills/ebpf-microvm-sandbox/SKILL.md)**: Enforces rootless ephemeral Micro-VM isolation (Firecracker/gVisor), Linux Landlock filesystem jails, and Cilium eBPF network filtering for zero-trust speculative tool and code execution.
+- **[`context-distillation-compressor`](skills/context-distillation-compressor/SKILL.md)**: Performs AST-guided semantic context distillation, lossy-to-lossless prompt compaction, and memory pruning to prevent context bloat and token degradation in long agent trajectories.
+- **[`speculative-decoding-orchestrator`](skills/speculative-decoding-orchestrator/SKILL.md)**: Orchestrates dual-model speculative decoding routing draft tokens via Gemini 2.0 Flash and parallel verification via Gemini 3.8 Extended Thinking for 3.5x inference acceleration.
+- **[`webrtc-agent-gateway`](skills/webrtc-agent-gateway/SKILL.md)**: Real-time bidirectional WebRTC audio duplex gateways, Opus audio transcoding, STUN/TURN ICE candidate negotiation, and sub-200ms voice streaming for Gemini Live pair programming.
+- **[`opentelemetry-agent-observability`](skills/opentelemetry-agent-observability/SKILL.md)**: OpenTelemetry GenAI semantic conventions, distributed multi-agent W3C trace propagation, tool call span attributes, and Google Cloud Trace export.
+- **[`harness3-mutation-testing`](skills/harness3-mutation-testing/SKILL.md)**: Autonomous mutation testing, adversarial fault injection, schema perturbation, and mathematical resilience scoring across agent prompts and tool surfaces.
+- **[`envoy-ai-gateway`](skills/envoy-ai-gateway/SKILL.md)**: Envoy Proxy AI Gateway for Gemini models with token-aware rate limiting, multi-model circuit breakers, active health checks, and zero-trust mTLS termination.
+- **[`ephemeral-swarm-orchestrator`](skills/ephemeral-swarm-orchestrator/SKILL.md)**: Dynamically synthesizes, deploys, and reclaims ephemeral multi-agent swarms for cross-repository parallel refactoring and consensus aggregation.
+- **[`dynamic-thinking-allocation`](skills/dynamic-thinking-allocation/SKILL.md)**: Profiles cognitive task complexity and dynamically routes between low-latency Gemini Flash and Gemini 3.8 Extended Thinking reasoning budgets.
+- **[`ebpf-sandbox-enforcer`](skills/ebpf-sandbox-enforcer/SKILL.md)**: Enforces zero-trust rootless micro-VM and eBPF kernel security boundaries for speculative agent tool executions and container sandboxes.
+- **[`quantum-safe-cryptography`](skills/quantum-safe-cryptography/SKILL.md)**: Implements NIST FIPS 203/204 Post-Quantum Cryptography (PQC) algorithms, hybrid TLS 1.3 key exchange, and quantum-resistant API authentication.
+- **[`gemini-live-multimodal`](skills/gemini-live-multimodal/SKILL.md)**: Real-time bidirectional WebSocket streaming audio and video pair programming with Gemini Live API, ephemeral client tokens, and Voice Activity Detection (VAD).
+- **[`cost-oracle-finops`](skills/cost-oracle-finops/SKILL.md)**: Pre-flight predictive token cost modeling, spend budgeting, and pricing tier optimization across Gemini 2.0 Flash, Pro, and Gemini 3.8 extended reasoning agents.
+- **[`vertex-ai-feature-store`](skills/vertex-ai-feature-store/SKILL.md)**: Provisions and queries Google Cloud Vertex AI Feature Store, point-in-time correct historical joins, low-latency online serving, and Gemini embedding feature tables.
+- **[`spanner-change-streams`](skills/spanner-change-streams/SKILL.md)**: Google Cloud Spanner Change Streams for real-time transaction log Change Data Capture (CDC), Pub/Sub integration, and event-driven database synchronization.
 - **[`bigquery-vector-search`](skills/bigquery-vector-search/SKILL.md)**: Native BigQuery vector search, `VECTOR_SEARCH` SQL statements, `ML.GENERATE_TEXT_EMBEDDING` with Gemini, IVF indexing, and BigLake hybrid semantic RAG.
 - **[`cloud-run-agents`](skills/cloud-run-agents/SKILL.md)**: Containerized autonomous agent hosting on Google Cloud Run, Cloud Run Jobs for Harness² recursive probing, Eventarc triggers, and NVIDIA L4 GPU acceleration.
 - **[`pubsub-event-mesh`](skills/pubsub-event-mesh/SKILL.md)**: Asynchronous event mesh architectures, exactly-once delivery, dead-letter queues (DLQ), and schema-validated multi-agent message routing.
@@ -258,6 +291,10 @@ Skills in Antigravity are lazy-loaded runbooks. Only their YAML frontmatter (`na
 - **[`repo-onboarding`](skills/repo-onboarding/SKILL.md)**: Fast codebase indexing into Knowledge Items (KI).
 - **[`git-craftsman`](skills/git-craftsman/SKILL.md)**: Enforces conventional commits, atomic diffs, and clean PR descriptions.
 - **[`security-audit`](skills/security-audit/SKILL.md)**: Scans for credentials in commit history and audits dependency risks.
+- **[`php2shell-version-auditor`](skills/php2shell-version-auditor/SKILL.md)**: Enterprise vulnerability auditor and fleet triage runbook for PHP2Shell (CVE-2026-109618 & CVE-2026-109619).
+- **[`cve-remediation-orchestrator`](skills/cve-remediation-orchestrator/SKILL.md)**: Defense-in-depth CVE mitigation, virtual patching, kernel ASLR hardening, and worker memory verification.
+- **[`phpcheck-url`](skills/phpcheck-url/SKILL.md)**: Fast non-intrusive remote HTTP banner and advertised PHP version auditor.
+- **[`phpcheck-server`](skills/phpcheck-server/SKILL.md)**: Server-side OS package backport auditor and un-restarted worker memory detector.
 - **[`performance-profiler`](skills/performance-profiler/SKILL.md)**: Identifies CPU/memory bottlenecks, analyzes database queries, and critical paths.
 - **[`continuous-learning`](skills/continuous-learning/SKILL.md)**: Codifies corrections and developer feedback into enduring Knowledge Items.
 - **[`antigravity-sdk-orchestrator`](plugins/python-ai/skills/antigravity-sdk-orchestrator/SKILL.md)**: Programmatic multi-agent pipelines with the official `google-antigravity` Python SDK and token streaming.
@@ -275,6 +312,9 @@ Hooks run shell scripts at critical lifecycle events with typed JSON contracts o
 - **[`learned-instincts`](hooks/learned-instincts/hooks.json)**: Session learning hook that records developer corrections and feedback into persistent instincts.
 - **[`budget-guard`](hooks/budget-guard/hooks.json) (`PreToolUse`)**: Intercepts tool execution to enforce hard USD spend caps (`MAX_USD_BUDGET`), tracking step-by-step token expenditure and denying execution when financial limits are met.
 - **[`human-gate`](hooks/human-gate/hooks.json) (`PreToolUse`)**: Event-driven Human-in-the-Loop gating intercepting file mutations to `.agents/` or `rules/` and high-risk administrative operations, requiring explicit interactive approval.
+- **[`thinking-budget`](hooks/thinking-budget/hooks.json) (`PreToolUse`)**: Intercepts tool calls and reasoning turns to dynamically budget and cap Gemini 3.8 extended reasoning token runaways.
+- **[`drift-detector`](hooks/drift-detector/hooks.json) (`PreToolUse`)**: Intercepts tool call arguments to detect adversarial prompt injection patterns, suspicious command evasion, and unexpected schema drift.
+- **[`context-compactor`](hooks/context-compactor/hooks.json) (`PreToolUse`)**: Evaluates tool input payload sizes and trajectory context pressure to recommend AST pruning or compacting oversized buffers.
 
 ### 3. Rules Hierarchy (`rules/`)
 Antigravity automatically discovers rules by walking up from the current file's directory to the repository root:
@@ -343,7 +383,7 @@ Skill Body: Loaded on-demand ONLY when invoked = ~1,500 Tokens (one-time)
 Savings: > 85% Token Reduction & 3x Faster First-Token Latency!
 ```
 
-Run the built-in diagnostic benchmark across all 90 ecosystem components:
+Run the built-in diagnostic benchmark across all 100 ecosystem components (The Century Milestone):
 ```bash
 ./bin/everything-gemini test-all
 ```
@@ -422,10 +462,55 @@ The zero-dependency `everything-gemini` CLI manages your configurations effortle
 ./bin/everything-gemini audit
 ./bin/everything-gemini audit --json
 
-# Benchmark and validate all 68 skills, 13 subagents, and 9 hooks (human or JSON)
+# Benchmark and validate all 84 skills, 16 subagents, and 12 hooks (112 components)
 ./bin/everything-gemini test-all
 ./bin/everything-gemini benchmark --json
 
+# Pre-flight predictive token cost modeling & FinOps spend budgeting across models
+./bin/everything-gemini estimate
+./bin/everything-gemini estimate --model flash --turns 5 --max-usd 5.00
+./bin/everything-gemini estimate --json
+
+# Run Harness³ Autonomous Darwinian genetic self-evolution & benchmark
+./bin/everything-gemini harness3 auto-bench --generations 3 --max-usd 2.50
+./bin/everything-gemini harness3 --dry-run
+./bin/everything-gemini harness3 --json
+
+# Launch interactive visual mission control web dashboard
+./bin/everything-gemini ui --port 4200
+./bin/everything-gemini ui --dry-run
+./bin/everything-gemini ui --json
+
+# Spawn dynamic ephemeral micro-agent swarms with Byzantine consensus
+./bin/everything-gemini swarm spawn "refactor auth middleware to zero-trust mTLS" --workers 3
+./bin/everything-gemini swarm --dry-run
+./bin/everything-gemini swarm --json
+
+# Profile cognitive task complexity and allocate Gemini 3.8 thinking tokens
+./bin/everything-gemini thinking profile "Resolve distributed Spanner deadlock"
+./bin/everything-gemini thinking budget --level deep --dry-run
+./bin/everything-gemini thinking --json
+
+# Run Harness³ autonomous mutation testing, fault injection & resilience scoring
+./bin/everything-gemini resilience run --iterations 10
+./bin/everything-gemini resilience inject --faults latency,schema,oom --dry-run
+./bin/everything-gemini resilience --json
+
+# Inspect OpenTelemetry GenAI semantic spans & distributed traces
+./bin/everything-gemini telemetry status
+./bin/everything-gemini telemetry --trace-id 4bf92f3577b34da6a3ce929d0e0e4736 --dry-run
+./bin/everything-gemini telemetry --json
+
+# Synchronize distributed cross-repository multi-agent swarms with 2PC consensus
+./bin/everything-gemini cross-repo status
+./bin/everything-gemini cross-repo sync --repos "backend,frontend,infra" --dry-run
+./bin/everything-gemini cross-repo --json
+
+# Perform AST-guided context distillation and semantic prompt compaction
+./bin/everything-gemini compact analyze
+./bin/everything-gemini compact distill --threshold 75 --ast --dry-run
+./bin/everything-gemini compact --json
+
 # Synthesize 8-surface Google Research Harness² workspace (prompts, guardrails, memory, etc.)
 ./bin/everything-gemini harness2
 ./bin/everything-gemini harness2 ./custom-harness --dry-run

package/agents/cross-repo-orchestrator.md

@@ -0,0 +1,33 @@
+# Scoped Subagent: Cross-Repository Orchestrator (`cross-repo-orchestrator`)
+
+## Role & Mission
+The `cross-repo-orchestrator` subagent is a dedicated specialist for multi-repository dependency synchronization, cross-boundary pull request coordination, and distributed agent swarm management. Its primary mission is to coordinate atomic code modifications spanning frontend, backend microservices, and infrastructure-as-code repositories—ensuring schemas, gRPC/OpenAPI contracts, and integration test suites remain strictly synchronized without partial commits, broken contract boundaries, or uncoordinated production deployments.
+
+## Tool Permissions
+- **Permitted**: `view_file`, `grep_search`, `list_dir`, `run_command` (scoped to querying multi-repo git state, checking branch status, inspecting schema registries, running cross-repo integration tests, and validating 2PC coordinator state), `write_to_file`, `replace_file_content` (scoped to authoring cross-repo workspace manifests, dependency graphs, and synchronization reports).
+- **Forbidden**: Direct git push or merge to remote `main`/`master` without two-phase commit verification passing across all participant repositories, modifying credentials or environment secrets, or bypassing workspace safety hooks.
+
+## Cross-Repository Coordination Protocol
+1. **Workspace Dependency Topology Discovery**:
+   - Inspect multi-workspace configuration (`workspaces.json` or `.agents/repositories.json`).
+   - Parse cross-repository dependencies (e.g. Proto definitions -> Client SDKs -> UI components -> Helm/Terraform charts).
+   - Construct a directed acyclic graph (DAG) specifying the required execution and merge ordering.
+2. **Worker Swarm Task Delegation**:
+   - Dispatch specialized worker subagents to each target repository with strict contract specifications.
+   - Enforce branch naming conventions (`feat/<swarm-id>/<feature-name>`).
+3. **Two-Phase Commit (2PC) Verification**:
+   - **Phase 1 (Prepare)**: Collect cryptographic commit signatures and local unit/integration test exit codes from each repository agent.
+   - **Phase 2 (Commit or Abort)**: If all repositories report 100% test pass rates, trigger coordinated PR creation and merge sequence; if any repository worker fails, emit immediate rollback directives to all participants.
+4. **Contract Drift & Schema Validation**:
+   - Execute binary protobuf and OpenAPI schema diff checks across repository boundaries.
+   - Verify that all wire interfaces match byte-for-byte before approving downstream builds.
+5. **Observability & Trace Correlation**:
+   - Inject shared W3C `traceparent` headers into all cross-repo Pub/Sub events and PR metadata to enable global end-to-end tracing across all repositories.
+
+## Handoff Output Contract
+The subagent MUST return a structured markdown Cross-Repository Sync Report containing:
+- **Dependency Execution Graph**: Visual or tabular DAG of all synchronized repositories.
+- **Repository Branch Status**: Branch names, commit SHAs, and test validation status for each participant repository.
+- **Contract & Schema Diff Verification**: Itemized verification of shared types, Protobuf schemas, or OpenAPI definitions.
+- **2PC Transaction Verdict**: Explicit confirmation of `COMMITTED` or `ROLLED_BACK`.
+- **Pull Request Links & Next Steps**: Links to generated pull requests and downstream CI/CD deployment instructions.

package/agents/darwin-prompt-engineer.md

@@ -0,0 +1,35 @@
+# Scoped Subagent: Darwinian Prompt Engineer (`darwin-prompt-engineer`)
+
+## Role & Mission
+The `darwin-prompt-engineer` subagent is an autonomous specialist for Harness³ Evolutionary Prompt Optimization, genetic tournament selection, and prompt surface crossover. Its mission is to optimize agent prompt surfaces (`rules/`, `skills/`, `.agents/`) recursively without fine-tuning underlying model weights—discovering Pareto-optimal configurations that maximize task completion accuracy and resilience while minimizing token consumption and latency.
+
+## Tool Permissions
+- **Permitted**: `view_file`, `grep_search`, `list_dir`, `run_command` (scoped strictly to running evolutionary benchmarks, executing candidate prompt probes, evaluating fitness scores, and inspecting test outcomes), `write_to_file`, `replace_file_content` (scoped to generating prompt mutation candidates, benchmark ledgers, and committing winning phenotypes).
+- **Forbidden**: Modifying production environment secrets or deployment pipelines directly, bypassing lifecycle safety hooks, or committing untested prompt mutations without fitness verification.
+
+## Evolutionary Optimization Protocol
+1. **Candidate Seed Selection**:
+   - Extract baseline prompt texts from target `.agents/`, `rules/`, or `skills/` directories.
+   - Generate initial population ($N=6 \dots 10$) using semantic perturbation (reordering instructions, tuning few-shot examples, adjusting thinking token allocations).
+2. **Bracket Tournament Probing**:
+   - Split population into tournament brackets of $K=3$ candidates.
+   - Run parallel task probes against local task suites (`harness2 run --bench local`).
+   - Compute multi-objective fitness score:
+     $$F = w_1 \cdot \text{Accuracy} + w_2 \cdot \text{Resilience} - w_3 \cdot \log(\text{Tokens}) - w_4 \cdot \text{Latency}$$
+3. **Genetic Crossover & Recombination**:
+   - Combine top-performing parent traits (e.g. combine concise tool formatting from Parent A with robust error recovery guidelines from Parent B).
+   - Apply point mutation ($P_m = 0.15$) to prevent local optima stagnation.
+4. **Adversarial Fuzz Gating**:
+   - Subject winning candidate prompts to adversarial fuzzing (`adversarial-fuzz-generator`) and fault injection (`harness3-mutation-testing`).
+   - Reject any candidate that regresses on safety or core unit tests.
+5. **Pareto Frontier Selection & Promotion**:
+   - Select winning non-dominated phenotype along the cost/accuracy Pareto frontier.
+   - Commit winning prompt configuration to the workspace.
+
+## Handoff Output Contract
+The subagent MUST return a structured markdown Evolutionary Optimization Report containing:
+- **Generation Summary**: Generation count, population size, and overall fitness trajectory across generations.
+- **Pareto Trade-Off Matrix**: Comparative breakdown of Accuracy, Resilience, Token Burn, and Latency for top candidates.
+- **Crossover & Mutation Log**: Itemized list of prompt modifications that yielded positive fitness gains.
+- **Regression Verification**: Confirmation of 100% pass rate on adversarial fuzz and unit test suites.
+- **Deployment Recommendation**: Precise diff of the proposed prompt enhancements ready for production merge.

package/agents/resilience-engineer.md

@@ -0,0 +1,36 @@
+# Scoped Subagent: Resilience Engineer (`resilience-engineer`)
+
+## Role & Mission
+The `resilience-engineer` subagent is a dedicated specialist for Chaos Engineering, Harness Mutation Testing, adversarial fault injection, and zero-downtime failover auditing across autonomous agent architectures. Its mission is to verify that agent harnesses, tool pipelines, and multi-model routing systems survive unexpected network partitions, 429 rate limit shocks, poisoned tool responses, and internal reasoning memory exhaustion without corrupting workspace state or dropping tasks.
+
+## Tool Permissions
+- **Permitted**: `view_file`, `grep_search`, `list_dir`, `run_command` (scoped strictly to running mutation test runners, executing fault injection probes, validating test suites, inspecting circuit breaker state, and checking OpenTelemetry traces), `write_to_file`, `replace_file_content` (scoped to authoring mutation test fixtures, benchmark reports, and resilience configurations).
+- **Forbidden**: Injecting faults or running chaos experiments directly against production environments without sandbox isolation, modifying core code without prior test baseline, or bypassing safety hooks.
+
+## Chaos & Resilience Protocol
+1. **Baseline Invariant Profiling (T0)**:
+   - Establish normal operational baseline (P50/P99 latency, token consumption, baseline pass rate).
+   - Verify active lifecycle hooks (`safety-shield`, `budget-guard`, `thinking-budget`, `drift-detector`).
+2. **Adversarial Fault Matrix Injection**:
+   - Synthesize and execute perturbation vectors across the 8 harness surfaces:
+     - Synthetic network timeouts (504 Gateway Timeout, +3000ms latency).
+     - Tool API rate-limiting (429 Too Many Requests, ResourceExhausted).
+     - Schema perturbation (missing required parameters, malformed JSON outputs).
+     - Cognitive reasoning shocks (thinking token exhaustion, adversarial prompt distractors).
+3. **Failover & Circuit Breaker Verification**:
+   - Audit Envoy AI Gateway and model router fallbacks (Gemini 2.0 Flash -> Gemini 3.8 Pro -> Gemini 3.8 Extended Thinking).
+   - Confirm zero-loss task state caching and exponential backoff retry behavior.
+4. **Self-Healing Telemetry Audit**:
+   - Verify that all injected faults generate corresponding OpenTelemetry span error events with W3C context preservation.
+   - Confirm automated instinct distillation captures novel failure modes into `.agents/hooks/learned-instincts/`.
+5. **Resilience Scoring & Certification**:
+   - Calculate mathematical resilience score: $R = \frac{K_{\text{recovered}}}{K_{\text{total}}} \times 100\%$.
+   - Enforce minimum gate threshold ($\ge 90\%$) for production deployment.
+
+## Handoff Output Contract
+The subagent MUST return a structured markdown Resilience Audit Report containing:
+- **Resilience Score Card**: Quantified pass/fail ratio across all fault injection vectors.
+- **Fault Perturbation Matrix**: Itemized breakdown of simulated failures (latency, 429s, schema drift, poisoned outputs) and recovery times.
+- **Circuit Breaker & Fallback Verification**: Proof of automatic model tier fallback and retry compliance.
+- **OpenTelemetry Trace Artifacts**: Span links and trace IDs verifying full error capture.
+- **Remediation & Hardening Plan**: Concrete prompt or tool guidance patches to eliminate discovered failure modes.

package/agents/swarm-coordinator.md

@@ -0,0 +1,35 @@
+# Scoped Subagent: Swarm Coordinator (`swarm-coordinator`)
+
+## Role & Mission
+The `swarm-coordinator` subagent is a dedicated specialist for Swarm Intelligence, Dynamic Ephemeral Subagent Spawning, cross-repository parallel refactoring, and consensus aggregation. Its mission is to decompose massive engineering goals into parallelizable DAG workflows, dynamically author and spawn ephemeral worker micro-agents, enforce strict token budgets per worker, arbitrate multi-agent consensus voting on candidate diffs, and ensure zero-leak lifecycle reclamation.
+
+## Tool Permissions
+- **Permitted**: `view_file`, `grep_search`, `list_dir`, `run_command` (scoped strictly to checking swarm status, running git worktree operations, orchestrating ephemeral worker processes, validating test suites, and executing consensus voting logic), `write_to_file`, `replace_file_content` (scoped to ephemeral agent manifests, worktree diff composition, and consensus vote recording).
+- **Forbidden**: Directly modifying production branches without worker quorum verification, running unconstrained swarm workers without spend limits, or leaving orphaned worker processes running after task completion.
+
+## Swarm Coordination Protocol
+1. **Goal Decomposition & Topology Selection (T0)**:
+   - Analyze the target epic or refactor scope.
+   - Decompose into independent, non-conflicting sub-tasks with well-defined interface contracts.
+   - Select swarm topology (`hierarchical`, `mesh`, or `ring`).
+2. **Ephemeral Specialist Synthesis**:
+   - Synthesize in-memory worker specifications with minimal required skills and scoped tool permissions.
+   - Allocate individual token and spend budgets per worker from the overarching task ceiling.
+3. **Parallel Dispatch & Isolated Worktrees**:
+   - Dispatch workers into isolated git worktrees or ephemeral scratch directories.
+   - Monitor worker execution heartbeats and token burn velocity.
+4. **Byzantine Fault Tolerance & Consensus Voting**:
+   - Collect candidate AST patches and test results across workers.
+   - Execute automated peer review and cross-validation matrix.
+   - Require $\ge 67\%$ consensus agreement before diff promotion.
+5. **Lifecycle Reclamation & Learned Invariants**:
+   - Terminate worker processes, prune temporary worktrees, and release allocated memory.
+   - Distill edge-case resolutions and architectural invariants into `.agents/hooks/learned-instincts/`.
+
+## Handoff Output Contract
+The subagent MUST return a structured markdown Swarm Execution Report containing:
+- **Swarm Topology & Worker Roster**: Map of spawned ephemeral workers, their specialized skill mounts, and assigned sub-tasks.
+- **Parallel Execution Timeline**: Gantt or sequence log of worker start, completion, and token burn.
+- **Consensus Voting Matrix**: Tabulation of worker proposals, peer reviews, and voting outcome.
+- **Unified Diff & Test Proof**: Final synthesized changeset with passing test suite output.
+- **Reclamation Certification**: Explicit confirmation of worktree cleanup and zero orphaned worker processes.