Agent workflow
==============

Recommended loop
----------------

1. Run ``archledger --json paths``.
2. Run ``archledger --json source changed`` before broad architecture refreshes.
3. Run ``archledger --json read --body --include-drafts``.
4. Edit only the fragment files under ``sections/`` and ``records/``.
5. Run ``archledger --json check``.
6. Build only when the user needs an exported artifact.
7. Run ``archledger --json source snapshot --reason after-archledger-update`` after the updates have been validated.

Rules
-----

- Treat the fragment tree as the source of truth.
- Do not edit generated build output as source; determine its location from ``archledger --json paths`` and ``[build].default_output_dir``.
- Add ``source_refs`` when a fragment describes concrete implementation artifacts.