1 files changed, 27 insertions, 0 deletions
diff --git a/assets/codex-skills/mcp-bootstrap/references/bootstrap-retrofit.md b/assets/codex-skills/mcp-bootstrap/references/bootstrap-retrofit.md
new file mode 100644
index 0000000..5a766a6
--- /dev/null
+++ b/assets/codex-skills/mcp-bootstrap/references/bootstrap-retrofit.md
@@ -0,0 +1,27 @@
+# Retrofit
+
+Use this when the MCP already exists and cannot simply be reimagined from
+scratch.
+
+## Retrofit Order
+
+1. Separate session ownership from fragile execution.
+2. Define typed replay contracts and typed faults.
+3. Replace ad hoc backend dumps with porcelain-by-default output.
+4. Add health, telemetry, and recovery tests.
+5. Only then promise hot rollout or stronger operational guarantees.
+
+## Specific Warnings
+
+- Do not add retries before replay legality is explicit.
+- Do not hide routing bugs behind warm-up masking.
+- Do not call a worker self-healing if the host itself cannot roll forward.
+- Do not let the canonical skill drift away from the actual library contract.
+
+## Doctrine
+
+The retrofit is complete only when:
+
+- the hard posture lives in code
+- the model UX doctrine is visible at the tool surface
+- the skill, spec, and implementation agree