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.