repowisea2aproject/a2a

Architecture of a2aproject/a2a

a2aproject/a2a is 86 source files holding 21 symbols across 5 modules, written mainly in Shell, Python, JavaScript. The largest module is docs, with 32 files, and 3 files are entry points into the dependency graph.

How a2a fits together

The repository is organized around its documentation and protocol specification rather than a single runtime program. docs/index.md is the entry point of the documentation site, and docs/sdk/index.md and docs/tutorials/index.md are the entry points for the SDK and tutorial pages. The specification directory holds the protocol specification. Agents communicate using JSON-RPC 2.0 over HTTP(S), and they publish Agent Cards that describe their capabilities and connection information. The requirements-docs.txt manifest lists the Python packages used to build the docs, including mkdocs-material and sphinx. The .devcontainer/setup.sh script sets up the development container defined in .devcontainer/devcontainer.json.

Largest modules

  • docs: 32 files and 5,597 lines of code
  • .github: 23 files and 771 lines of code
  • root: 11 files and 848 lines of code
  • scripts: 8 files and 371 lines of code
  • specification: 5 files and 998 lines of code
  • .devcontainer: 3 files and 143 lines of code
  • adrs: 2 files and 112 lines of code
  • .gemini: 1 file and 3 lines of code

Languages

By file count: Shell 9 files, Python 2 files, JavaScript 1 file.

More on a2a: summary and FAQ, codebase overview, code health.

Related guide: Best dependency graph tools for monorepos