# Read with an agent

Fetch only the chapter relevant to the musical task. The Markdown links below carry the same explanations and source examples as these pages, without navigation or rendered SVG.

- [Compact discovery index](/llms.txt)
- [Chapter index](/docs/index.md)
- [Element lookup](/reference/elements.json)
- [Diagnostic lookup](/reference/diagnostics.json)
- [Instrument lookup](/reference/instruments.json)
- [Complete text, when needed](/llms-full.txt)

## An efficient writing loop

1. Read the task's chapter and look up unfamiliar instrument keys or marks.
2. Write complete `scorescript 0.3` source, or explicitly request a fragment.
3. Compile with the native CLI or `compile_score`. Resolve errors and read warnings.
4. Format, compile again, and inspect the rendered music.
5. For edits, preserve the actual file, movement, part, and measure scope.

Use `update_score` with a newer revision for an existing MCP document. Retrieve long source in bounded `read_score` ranges. A successful preview alone does not establish complete export or playback.