decisions

Decision Records

Read docs/README.md first if you are trying to understand where this directory fits.

This directory contains public-facing design decisions for MIP.

Goals:

• explain why the project chose a direction
• capture tradeoffs and rejected alternatives
• make future refactors legible to contributors

Records:

• 0001-mip-is-not-just-user-rules.md
• 0002-route-1-before-route-2.md
• 0003-route-1-focuses-on-verified-read-paths.md
• 0004-codex-is-the-first-reference-target.md
• 0005-mip-context-is-the-user-fact-source-of-truth.md
• 0006-experimental-targets-must-be-labeled-explicitly.md
• 0007-use-a-distinct-mip-user-context-block-inside-agents.md
• 0008-project-rules-outrank-user-preferences-for-repository-specific-work.md
• 0009-route-2-starts-as-an-extension-draft.md
• 0010-route-2-first-ships-as-suggestion-generation.md
• 0011-review-bundles-come-before-apply.md
• 0012-human-readable-review-comes-before-apply.md
• 0013-apply-starts-as-a-non-mutating-plan.md
• 0014-route-2-requires-target-paths-for-future-apply.md
• 0015-route-2-uses-an-explicit-safe-auto-merge-subset.md
• 0016-route-2-merge-semantics-must-be-explicit-per-safe-path.md
• 0017-current-memory-diff-comes-before-apply.md
• 0018-approval-artifacts-come-before-apply.md
• 0019-resolution-artifacts-must-capture-user-decisions-explicitly.md
• 0020-mip-must-be-consulted-selectively-not-always-injected.md
• 0021-selective-rendering-is-the-default-context-output.md
• 0022-read-policy-can-be-declared-in-memory-source.md
• 0023-memory-intake-accepts-open-ended-user-provided-sources.md
• 0024-guided-intake-produces-a-draft-before-initial-memory.md
• 0025-intake-review-comes-before-build-memory.md
• 0026-user-assets-live-in-mip-home-not-the-repository.md