# Self-Improvement Specs Index
Status: Draft
Owner: Thoughtbox team
Scope: Thoughtbox MCP server, agentic scripts, observability, evaluation
---
## Documents
1. `self-improvement/SPEC-current-state.md`
- Verified capabilities and artifacts in the repo.
2. `self-improvement/SPEC-gap-analysis.md`
- Comprehensive, specific gap analysis between needs and current state.
3. `self-improvement/SPEC-target-architecture.md`
- Target architecture for a self-improving codebase.
4. `self-improvement/SPEC-evaluation-gates.md`
- Deterministic and black-box evaluation requirements and gates.
5. `self-improvement/SPEC-persistence.md`
- Persistence requirements for improvement history and scorecards.
6. `self-improvement/SPEC-automation.md`
- Automation and scheduling requirements for continuous improvement.
---
## Quick Summary
The repo contains a self-improvement loop runner, tiered evaluator, behavioral
contracts, and observability infrastructure. These are not wired into a persistent,
automated feedback loop. The specs in this folder define the exact gaps and the
required work to make improvement measurable and continuous.
