# ACE-VOS Missing-Information Matrix and Remediation Plan

Version: 1.0.0  
Owner: `ACE-VOS`  
Purpose: chart gaps and required detail level for all new agent manifests, instructions, and skills.

## Summary

Initial gaps observed in new artifacts:

- Missing explicit Socratic loop requirements.
- Weak MICE boundary definitions.
- Thin TEAL topology/dependency detail.
- No explicit event schemas and failure routing contracts.
- No deterministic output templates.
- Insufficient cross-client turnkey setup details.

## Required Detail Matrix

| Artifact Type | Required Sections | Why It Matters | Status |
|---|---|---|---|
| Agent `AGENTS.md` | objective, permissions, inputs/outputs, events emit/consume, gates, handoff routes, anti-patterns | Prevent role drift and hidden coupling | `addressed` |
| Agent `instructions.md` | exact 5-phase headers, deterministic step protocol, wrong-stuff protocol, evidence update rules | Enforces execution quality and repeatability | `addressed` |
| Skill `SKILL.md` | trigger conditions, prerequisites, pipeline steps, output contract, failure policy, integration hooks | Makes skills composable and testable | `addressed` |
| Kernel directives | MICE, goal orientation, clarity loop, state truth model, communication rules | Shared operating law for all modules | `addressed` |
| TEAL config + role manifests | dependency graph, topology variants, event contracts, scaling rules | Enables dynamic composition and orchestration | `addressed` |
| README/setup docs | Codex/VS Code/Claude/Cursor/Antigravity compatibility and turnkey scripts | Out-of-box operator usability | `addressed` |

## Validation Checklist

- [x] All new 7 agents have expanded `AGENTS.md`.
- [x] All new 7 agents have expanded `instructions.md`.
- [x] All 8 new skills have protocol-grade `SKILL.md`.
- [x] Kernel and registry docs reflect MICE + TEAL + Socratic loop.
- [x] Bootstrap writes `.mcp-config` client bundle and `scripts/ace/*`.
- [x] MCP tools expose client-specific config snippets.

## Enforcement Guidance

1. Reject PRs that add agent/skill docs without protocol sections above.
2. Reject changes that alter handoff/event payloads without schema updates.
3. Reject release if docs claim behaviors not present in runtime artifacts.