# ADR-007: No comments in code

## Status

Accepted

## Context

Per project convention across @alkdev packages, inline comments in source files create maintenance burden and often go stale. Documentation belongs in architecture docs and TypeBox schema descriptions.

## Decision

Source files contain no inline comments. Documentation lives in architecture docs (`docs/architecture/`) and TypeBox schema `description` properties.

## Consequences

- Code is self-documenting through naming and structure
- All rationale and context lives in versioned architecture docs
- TypeBox schemas can carry `description` fields for runtime documentation

## References

- [overview.md](../overview.md)