Skip to content

AgentTrace MVP Architecture

AgentTrace is a standard-library Python CLI. The package is split into:

  • agenttrace.cli: argument parsing, command routing, and user-facing errors.
  • agenttrace.core: Git inspection, JSON persistence, evidence capture, and report generation.

The CLI stores all audit data in .agenttrace/ inside the current Git repository. Machine-readable state lives in JSON files. Human-readable evidence lives in Markdown or text files so it can be inspected, copied into a PR, or archived without AgentTrace.

The MVP avoids background services, remote APIs, databases, and nonessential dependencies. That keeps the trust boundary clear: AgentTrace observes the local repository and writes local audit artifacts.