docs/development/README.md

# Development & Architecture Notes

These documents preserve durable implementation rationale, compatibility
decisions, and migration history without coupling the repository layout to
development milestone numbers. Current validation is generated by the
repository gates; checked-in validation transcripts and one-off reports are
not treated as active instructions.

## Core architecture

- [Architecture](architecture.md)
- [CLI specification](cli-specification.md)
- [Runtime](runtime.md)
- [Platform/runtime policy](platform-runtime-policy.md)
- [Errors, exit codes & logging](errors-exit-codes-logging.md)
- [I/O, overwrite & temporary-file policy](io-overwrite-temp-policy.md)
- [Batch semantics](batch-semantics.md)

## Media domains

- [Environment inspection](environment-inspection.md)
- [Video editing](video-editing.md)
- [Audio processing](audio-processing.md)
- [Conversion & batch](conversion-and-batch.md)
- [Composition & filter graphs](composition-and-filter-graph.md)
- [Diagnostics & repair](diagnostics-and-repair.md)
- [Streaming & capture](streaming-and-capture.md)
- [Media capability expansion](media-capability-expansion.md)
- [Hardware acceleration](hardware-acceleration.md)

## Agent and distribution layers

- [Pipeline & preset system](pipeline-and-presets.md)

- [Stable v1 release](stable-cli-release.md)

- [CLI installation & release workflow](cli-installation-release-workflow.md)

- [Professional Skills](professional-skills.md)
- [Plugin packaging](plugin-packaging.md)
- [Test suite & fixtures](test-suite-and-fixtures.md)
- [UX, progress & agent output](ux-progress-agent-output.md)

## Historical migration

- [Migration from legacy Bash](../migration-from-bash.md)
- [Migration rules](migration-rules.md)
- [Video migration](video-migration.md)
- [Audio migration](audio-migration.md)
- [Conversion migration](conversion-migration.md)
- [Composition migration](composition-migration.md)
- [Diagnostics migration](diagnostics-migration.md)
- [Streaming migration](streaming-migration.md)

Completion records are grouped under [checklists/](checklists/). They are
historical evidence, not a replacement for the current public guides or
`npm run validate`.