5. FDD files for architectural documentation

Status: Accepted Date: 2025-06-28

Context

Need architectural documentation that stays close to code, follows hierarchy, and supports AI-powered development workflows.

Decision

Use FDD.md files at each level for documentation.

Consequences

Positive:

• Documentation close to code
• Hierarchical context recovery
• AI-friendly structured format
• Version controlled with code

Negative:

• Additional maintenance overhead
• Risk of documentation drift