TORCH/docs/AGENT_COVERAGE_GAPS.md

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	test/ integration/e2e files (Node.js --test).	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: E2E/integration tests exist (e.g., test/scheduler-preflight-lock.e2e.test.mjs via Node.js --test), but no agent is dedicated to scenario maintenance.
• Mission: Maintain E2E scenarios, fix flaky tests, and ensure the dashboard and scheduler flow remain 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