stm-design

Git-friendly state management for multi-agent workflows isolates state in session directories to minimize merge conflicts. This approach structures data so multiple agents can operate concurrently without overwriting shared history during version control operations.

Short-Term Memory (STM) in agent systems maintains temporary state across complex, multi-step operations. You need STM when your multi-agent workflow requires session isolation and recovery capabilities without committing transient operational data to Long-Term Memory.

Multi-user concurrency in agent state schemas requires specific isolation patterns to handle simultaneous access. By designing schemas that separate concurrent sessions into distinct directories, you prevent data loss and race conditions during multi-user operations.

Recovery-capable agent systems require dedicated recovery patterns within the state management design. By implementing structured directory layouts and schema mechanisms, the system can gracefully resume multi-step operations and restore state after unexpected interruptions.

Multi-agent state management causes git merge conflicts when state is not properly isolated in session directories. Without git-friendly patterns, concurrent agents writing to shared state files create overlapping changes that version control cannot resolve automatically.