[Docs] Comparison: gitagent vs ADL vs raw YAML

[shreyas-lyzr]

Summary

Create a comparison document showing how gitagent compares to other approaches for defining AI agents.

Motivation

Developers evaluating gitagent need to understand how it differs from:

• Agent Definition Language (ADL) and similar emerging standards
• Raw YAML/JSON configuration files
• Framework-specific configs (CrewAI YAML, OpenAI assistant JSON, etc.)
• No standard (just code and prompts)

Proposed Content

A comparison page (could be in docs, README section, or website) covering:

Dimension	gitagent	ADL	Raw YAML	Framework-specific
Git-native	Yes	No	Partial	No
Multi-framework	Yes	Varies	No	No
Compliance	First-class	No	No	No
Composability	Yes	Varies	Manual	Varies
...	...	...	...	...

Acceptance Criteria

• Fair and accurate comparison
• Include code examples for each approach
• Published on gitagent.sh and/or in repo docs