common-design-docs-k

A living design doc for agent workflows is a consistently updated record of system architecture and decisions. It applies structured frontmatter conventions and required sections to ensure traceability and accessibility across teams.

To structure design documentation, you outline plans, architecture, and decisions within design-docs. You must apply specified frontmatter conventions, required sections, and minimal structure to ensure consistent discovery and versioning.

Yes, frontmatter conventions for living docs are required. They provide standardized metadata for traceability, ensuring new agents can quickly surface the architecture and decisions behind system-level and package-level documentation.

The best way to document design decisions across packages is applying a shared design language. This specifies folder structure, doc types, and responsibilities, ensuring consistent discovery and versioning across teams.

You need to create living docs for agent systems when onboarding new team members or agents. It surfaces up-to-date architecture, principles, and rationale, solving the problem of scattered or neglected design documentation.