What
Add a performance section to the documentation site showing benchmark results and overhead characteristics.
Why
Aegis is middleware — users need to know the performance cost. We have benchmarks/bench_policy.py but results aren't published in docs.
Expected content
- Policy evaluation latency (single rule, 10 rules, 100 rules)
- Full pipeline latency breakdown (evaluate + approve + execute + audit)
- Memory footprint
- Comparison: with vs. without Aegis
Implementation
- Run
benchmarks/bench_policy.py and capture results
- Create
docs/guides/performance.md with results and methodology
- Add to mkdocs nav under Guides
Acceptance criteria
Difficulty
Beginner — run benchmarks, format results, write markdown.
What
Add a performance section to the documentation site showing benchmark results and overhead characteristics.
Why
Aegis is middleware — users need to know the performance cost. We have
benchmarks/bench_policy.pybut results aren't published in docs.Expected content
Implementation
benchmarks/bench_policy.pyand capture resultsdocs/guides/performance.mdwith results and methodologyAcceptance criteria
docs/guides/performance.mdexists with real benchmark dataDifficulty
Beginner — run benchmarks, format results, write markdown.