fold/docs/architecture
trvon 2945e59bc2
docs: trim the README and move the performance roadmap to docs/
The README listed 11 of fold's 17 detectors, never explained the
confidence tiers every finding carries, did not mention the new exit
code 2 / coverage reporting, and spent half its length on a
performance roadmap.

It now says what fold is, defines the five tiers (from
include/fold/report/finding.hpp, including concrete-witness and
latent), what "bounded" means after the loop-exit fix, a quick start,
output formats and exit codes (0 none, 1 any unsuppressed finding, 2
unwritable report or any unanalysed translation unit), and links. The
detector list defers to the complete table in docs/USAGE.md.

The performance section moves to docs/architecture/performance.md, with
one correction: the gold set was derived from fold's own reviewed output
and is matched by detector kind and file, so it catches drift rather
than measuring precision/recall independently. The lint pre-commit hook
note moves to BUILD.md.
2026-09-24 21:11:54 -06:00
..
code-quality-and-yams-benchmark.md docs: expand fold-sast skill; document call-graph decomposition + budgets 2026-08-16 16:41:33 -06:00
component-and-cli-map.md docs: document convergence contracts 2026-07-29 00:58:19 -04:00
optimization-loop.md docs: expand fold-sast skill; document call-graph decomposition + budgets 2026-08-16 16:41:33 -06:00
performance.md docs: trim the README and move the performance roadmap to docs/ 2026-09-24 21:11:54 -06:00
production-reachability.md feat(analysis): harden project-wide scans 2026-07-30 18:18:04 -04:00