# Documentation

Additional documentation for Sumac (`sxmc`) developers and maintainers.

| Document | Description |
|----------|-------------|
| [USAGE.md](USAGE.md) | Install, quick start, MCP workflows, client setup, and agent guidance |
| [SIDE_BY_SIDE.md](SIDE_BY_SIDE.md) | With vs without `sxmc`: OpenAPI, skills, MCP discovery, and full-test status notes |
| [ARCHITECTURE.md](ARCHITECTURE.md) | Module map, pipeline boundaries, extension points, and design decisions |
| [ROADMAP.md](ROADMAP.md) | Next major product phases: drift management, zero-config MCP wrapping, team distribution, and capability status |
| [DEMO.md](DEMO.md) | Short scripted demo path for terminal recordings or GIF capture |
| [OPERATIONS.md](OPERATIONS.md) | Hosted deployment, release process, and distribution notes |
| [VALIDATION.md](VALIDATION.md) | Test, smoke, compatibility, and benchmark summary |
| [CLI_TO_AI_COMPATIBILITY.md](CLI_TO_AI_COMPATIBILITY.md) | Host-by-host `CLI -> AI` coverage matrix for startup docs, native config, and apply behavior |
| [PRODUCT_CONTRACT.md](PRODUCT_CONTRACT.md) | Explicit support boundary: what Sumac guarantees, degrades gracefully, or leaves out of scope |
| [CLI_SURFACES.md](CLI_SURFACES.md) | Shipped `CLI -> AI` model: inspection, host-aware startup artifacts, provenance, depth limits, and review/apply rules |
| [TEST_SUITE_REPORT_v0.2.41.md](TEST_SUITE_REPORT_v0.2.41.md) | Comprehensive test results for v0.2.41 (275 tests, benchmarks, 10x10x10 matrix, discovery lifecycle) |
| [TEST_SCRIPT_GUIDE.md](TEST_SCRIPT_GUIDE.md) | Guide to the test script: architecture, sections, how to run on other platforms |
