# Head First DSM Agent documentation — 0.1.2

> Read the overview, then select one task. Keep /latest/ out of reproducible work.
> Pinned DSM source: https://github.com/xbdotl/dsm/tree/505e7557da94e3f74da84ecf75bc8a9282732e4f

## Overview
- [DSM Coding Agent Guide](/agent/en/v/0.1.2/overview.md)

## Tasks
- [Choose Register, Lease, or CRDT](/agent/en/v/0.1.2/tasks/choose-collection-semantics.md): Select a collection from business invariants while preserving fencing, idempotency, and source-of-truth responsibilities.
- [Classify Coordination State for DSM](/agent/en/v/0.1.2/tasks/classify-coordination-state.md): Produce a STOP, PROBE, or ADOPT decision from the source of truth, repairability, and failure consequences.
- [Diagnose Replication, Partitions, and Repair](/agent/en/v/0.1.2/tasks/diagnose-replication-and-repair.md): Locate replica divergence across local commit, delta propagation, remote apply, and repair stages.
- [Evaluate Boundaries and Deliver DSM](/agent/en/v/0.1.2/tasks/evaluate-and-deliver-dsm.md): Produce a reviewable release decision from real ports, federation experiments, exclusion, and an evidence chain.
- [Integrate DSM into an Application](/agent/en/v/0.1.2/tasks/integrate-dsm-application.md): Introduce DSM through domain ports, centralized assembly, stable identity, and layered tests.
- [Define DSM Operating Contracts](/agent/en/v/0.1.2/tasks/operate-dsm-runtime.md): Convert diagnostics, security, lifecycle, and capacity requirements into executable operating evidence.

## References
- [State and Collection Contracts](/agent/en/v/0.1.2/reference/state-and-collection-contracts.md): Locate DSM state boundaries, identity fields, and the semantics of its three collection families.
- [Validation Scopes](/agent/en/v/0.1.2/reference/validation-scopes.md): Separate the conclusions supported by fakes, one-process runtime tests, controlled multi-node tests, and real ports.
- [Version and Evidence](/agent/en/v/0.1.2/reference/version-and-evidence.md): Match the DSM version and bind implementation claims to pinned source, commands, and evidence scope.

## Policies
- [Safe Change Boundaries](/agent/en/v/0.1.2/policies/safe-change-boundaries.md): Constrain DSM integration changes, external effects, production operations, and workspace handling.
- [Source and Claim Discipline](/agent/en/v/0.1.2/policies/source-and-claim-discipline.md): Bind DSM technical claims to versions, commands, environments, and evidence boundaries.

## Fallback
- [llms-full.txt](/agent/en/v/0.1.2/llms-full.txt)