[Docs] Comparison: gitagent vs ADL vs raw YAML #6
Description
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