Skip to content

docs(msp): add MSP_TechFullSpec.md - #10

Draft
Freshair129 wants to merge 1 commit into
mainfrom
claude/explain-msp-L63N8
Draft

Freshair129 wants to merge 1 commit into
mainfrom
claude/explain-msp-L63N8

Conversation

@Freshair129

Copy link
Copy Markdown
Owner

Summary

  • Adds MSP_TechFullSpec.md at repo root — a single-page technical reference for the MSP (Memory & Soul Passport) gatekeeper.
  • Extracts content from FRAMEWORK_MASTER_SPEC.md §7, scripts/msp/*.mjs, and .brain/msp/LLM_Contract/*.yaml so newcomers don't have to assemble it themselves.
  • Covers: why MSP, architecture/layers, inbound flow + submission envelope, atomic write contract (required/forbidden/anti-hallucination), codegen micro-task contract, phase governance (L1–L3, devlog IDs), memory subsystem (sessions JSONL + episodic memory), promotion/rollback, human review gates, escape hatches (HOTFIX, legacy), tooling commands, project path encoding, authority matrix, failure-mode diagnostics, and known TODOs.

Test plan

  • Boss reads §0 TL;DR + §13 Authority Matrix — confirms accuracy
  • Cross-check §4 (atomic contract) against .brain/msp/LLM_Contract/phase2_atomic_contract.yaml
  • Cross-check §5 (codegen contract) against .brain/msp/LLM_Contract/codegen_microtask_contract.yaml
  • Cross-check §6 (phase governance) against FRAMEWORK_MASTER_SPEC.md §7.7
  • Decide on §15 open issues (especially path encoding D--evaAI vs evaAI)

Note: This is a high-level navigator/reference doc — per Lean Navigator law (§9.3), detailed specs still live in their canonical sources; this file links out, not inlines.

https://claude.ai/code/session_01Kfp2cxCv7PoJNTVqVdQnYd


Generated by Claude Code

Extracts MSP gatekeeper internals from FRAMEWORK_MASTER_SPEC.md §7,
scripts/msp/*, and .brain/msp/LLM_Contract/*. Covers inbound flow,
atomic + codegen contracts, phase governance, memory subsystem,
promotion/rollback, tooling, and open TODOs.

https://claude.ai/code/session_01Kfp2cxCv7PoJNTVqVdQnYd
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants