Docs/Agent workflow

Agent workflow

Rehydrate, execute bounded work, preserve evidence, and hand off one concrete next action.

Start from durable state

Use the brief status first. Read full context only when the brief does not contain enough evidence to act safely.

$ ldgr status
$ ldgr context
$ ldgr workflow

Record what changes the conclusion

Observations preserve material findings. Artifacts bind files to a run. Decisions preserve a choice and rationale. Validation distinguishes a passing path from a claim that merely sounds complete.

  • Record evidence at the point it becomes relevant.
  • Keep failed checks and negative results visible.
  • Do not treat process success as acceptance evidence.
  • Leave the next action specific enough for a fresh agent to execute.

Close or hand off honestly

Close a successful run only after its acceptance criteria have been checked. Use partial or failed when work remains, and connect the next work item rather than burying it in prose.

$ ldgr status --full
$ ldgr context