Developers

This section covers everything developers need to use the ada CLI, build tools on top of ADA’s session data, or contribute to the project.

Using the CLI

For developers who want to use the ada CLI directly or integrate it into scripts and workflows.

  • CLI Reference — Complete reference for all ada commands, flags, and output formats.

Data Formats

For developers building tools that read ADA session data (viewers, analyzers, exporters).

  • Session Bundle Format — Specification of the ADA session bundle directory structure, metadata files, and conventions.
  • ATF Format Specification — Binary specification of the dual-lane ADA Trace Format (ATF) v2 used for function-level tracing data.

Building & Contributing

For developers working on the ADA codebase itself.

  • Build From Source — Local setup and build steps for the ReadyCheck workspace.
  • Packaging the Plugin — Create a distributable ReadyCheck Claude Code plugin bundle.
  • Repository Layout — A map of the core ReadyCheck components.
  • Contributing — Architecture overview, development workflow, and conventions for contributing to ADA.

Build Rules

  • Cargo is the single build driver — use cargo build / cargo test; don’t run CMake directly.
  • Use existing helper scripts for setup and tooling: ./utils/init_third_parties.sh, ./utils/init_media_tools.sh, ./utils/run_coverage.sh.