fold/docs/internal/README.md

Internal development notes

This directory holds verbose planning, audit, benchmark, and agent-oriented notes that are useful while developing fold but should not be part of the public-facing documentation surface.

Public docs should normally link here only when the extra implementation detail is useful to contributors. User-facing material belongs in docs/USAGE.md, docs/BUILDING.md, docs/positioning.md, or the top-level README/BUILD files.

Key internal references:

• cli-philosophy.md — CLI design policy for maintainers.
• library-expansion-matrix.md — Z3/Clang adoption decision log.
• library-expansion-followups.md — follow-up queue and measurement artifacts.
• perf-audit.md and perf-audit/ — performance audit notes and raw profiles.
• m31-phase3-concolic.md — concolic execution research plan.
• rust-frontend.md — Rust frontend implementation notes.
• fold-skill.md — agent skill guidance, not product documentation.