update

docs/AGENT_COVERAGE_GAPS.md

@@ -0,0 +1,54 @@
+# Agent Coverage Gaps
+
+This document identifies areas of the TORCH repository that lack specific agent coverage and recommends new agents to fill these gaps.
+
+## Summary of Identified Gaps
+
+| Gap | Evidence | Proposed Agent |
+| :--- | :--- | :--- |
+| **Database Migrations** | `migrations/` directory and SQL files present. | `migration-agent` |
+| **E2E Testing** | `playwright` dependency and `test/` integration files. | `e2e-agent` |
+| **Memory Subsystem** | `scripts/memory/`, `.scheduler-memory/` exist. | `memory-health-agent` |
+| **Relay Stability** | `src/relay-health.mjs` and known relay flakiness. | `relay-health-agent` |
+| **Skills Management** | `skills/` directory and `torch-basics.md`. | `skills-agent` |
+| **Landing Page** | `landing/` directory exists. | `landing-page-agent` |
+| **Prompt Contracts** | `scripts/validate-prompt-contract.mjs` and recurring violations. | `prompt-contract-agent` |
+
+---
+
+## Detailed Recommendations
+
+### 1. `migration-agent`
+- **Gap**: No agent monitors or audits the `migrations/` directory.
+- **Mission**: Audit pending migrations, ensure schema consistency, validate rollback scripts, and ensure migrations follow project naming conventions.
+- **Priority**: Medium
+
+### 2. `e2e-agent`
+- **Gap**: `playwright` is used for dashboard and integration testing, but no agent is dedicated to scenario maintenance.
+- **Mission**: Maintain Playwright E2E scenarios, fix flaky tests, and ensure the dashboard remains functional across protocol changes.
+- **Priority**: High (given the "Scenario-First" mandate in `AGENTS.md`)
+
+### 3. `memory-health-agent`
+- **Gap**: The memory subsystem (ingest, retrieve, prune) is a core part of TORCH but lacks a dedicated quality auditor.
+- **Mission**: Audit memory retrieval relevance, ensure embeddings are healthy, and manage long-term memory pruning policies.
+- **Priority**: High
+
+### 4. `relay-health-agent`
+- **Gap**: Relay instability is a recurring issue (`KNOWN_ISSUES.md`).
+- **Mission**: Continuously monitor relay performance, automatically rotate unhealthy relays in `torch-config.json`, and manage relay quarantine states.
+- **Priority**: High
+
+### 5. `skills-agent`
+- **Gap**: The `skills/` directory contains agent guidance that needs periodic auditing.
+- **Mission**: Audit and update agent skills, ensuring they reflect current protocol standards and tool availability.
+- **Priority**: Low
+
+### 6. `landing-page-agent`
+- **Gap**: The `landing/` page is a separate entity from the dashboard and needs maintenance.
+- **Mission**: Update the landing page with the latest release information, ensure the "Offline Bundle" links work, and maintain site aesthetic.
+- **Priority**: Low
+
+### 7. `prompt-contract-agent`
+- **Gap**: Recurring prompt contract violations despite automated scripts.
+- **Mission**: Specifically focused on ensuring all prompts in `src/prompts/` follow the latest shared agent run contract and metadata standards.
+- **Priority**: Medium