Track papers across labs, topics, and trends.
Search papers, labs, and topics across Lattice.
This paper introduces a C4-aligned documentation systematics tailored for agentic AI systems, focusing on capturing the collaboration between specialized agents through artifact exchange, tool invocation, and coordination patterns. It proposes a style-oriented modeling vocabulary and a set of views for agents, artifacts, tools, and coordination patterns, structured hierarchically using the C4 model. Industrial examples and lessons learned demonstrate the approach's effectiveness in creating transparent and maintainable architecture documentation for long-lived agentic AI systems.
Stop relying on ad-hoc sketches to document your agentic AI systems: a C4-aligned approach can capture the nuances of agent collaboration and improve maintainability.
Different domains foster different architectural styles -- and thus different documentation practices (e.g., state-based models for behavioral control vs. ER-style models for information structures). Agentic AI systems exhibit another characteristic style: specialized agents collaborate by exchanging artifacts, invoking external tools, and coordinating via recurring interaction patterns and quality gates. As these systems evolve into long-lived industrial solutions, documentation must capture these style-defining concerns rather than relying on ad-hoc code sketches or pipeline drawings. This paper reports industrial experience from joint projects and derives a documentation systematics tailored to this style. Concretely, we provide (i) a style-oriented modeling vocabulary and a small set of views for agents, artifacts, tools, and their coordination patterns, (ii) a hierarchical description technique aligned with C4 to structure these views across abstraction levels, and (iii) industrial examples with lessons learned that demonstrate how the approach yields transparent, maintainable architecture documentation supporting sustained evolution.