Memory-Assisted Shaping uses exactly three operating states. State transitions are explicit — the protocol is in precisely one state at any time, and no state is entered passively. The three states enforce the core ordering: read before shaping, shape before synthesis.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/xxyoudeadpunkxx/memory-assisted-shaping/llms.txt
Use this file to discover all available pages before exploring further.
State transition table
| State | Enter When | Exit When | Memory Action | Forbidden Action |
|---|---|---|---|---|
READING_ALIGNMENT | Session starts, re-entry occurs, or input needs source or gate alignment | Candidate shape and real gates are clear enough to shape | Append only declared constraints, candidate form, real gates, source conflicts, or material tension | Final artifact production |
SHAPING | Shape can be consolidated without final artifact production | Gates are closed or deferred enough for the current move, or OP explicitly approves synthesis | Append decisions, discarded paths, source changes, gate movement, artifact boundaries, or material recurring tension | Final drafting |
SYNTHESIS | OP explicitly approves artifact production | Requested artifact is produced or a blocking contradiction appears | Append approved mode transition before non-trivial synthesis when persistence is active | Redesigning the shape while writing |
READING_ALIGNMENT
This is the entry state for every session and re-entry. Its purpose is to establish a clear, honest picture of what the input is and what it needs to become — before any shaping work begins. Use this state to:- Understand the input.
- Separate declared from inferred material.
- Detect candidate form.
- Expose material tension.
- Identify real gates.
- Declared constraints.
- Candidate form.
- Real gate discovery.
- Source-of-truth conflict.
- Material tension likely to affect later shaping.
SHAPING
SHAPING is the working state. The candidate shape is clear enough to consolidate, but synthesis has not been approved. Most of the structural work — resolving friction, handling gates, removing overdesign, protecting source of truth — happens here.
Use this state to:
- Consolidate form.
- Resolve non-blocking friction.
- Surface or close gates.
- Propose reversible defaults.
- Remove overdesign.
- Protect source of truth.
- Prepare a possible artifact path.
- Decisions.
- Discarded paths.
- Real tensions.
- Source-of-truth changes.
- Shape movement.
- Deferred gates.
- Artifact boundaries.
SYNTHESIS
SYNTHESIS is entered only when the operator explicitly approves artifact production. This state produces the final artifact from consolidated form. No structural redesign happens here — the shape was decided in SHAPING.
Use this state to:
- Produce the requested artifact from consolidated form.
- Preserve shaped form without reopening closed gates.
- Keep the artifact local to its purpose and free of process trace.
SYNTHESIS. The following are not approval:
- Implied momentum from a long session.
- Positive feedback on shaping work.
- Silence or lack of objection.
mode transition signal is appended when Python persistence is active.
Memory signals: Append the mode transition before non-trivial synthesis when persistence is available. Memory signals may inform synthesis but do not appear inside the artifact as process trace.