The maintained documentation describes the current master branch. Dated evidence and superseded instructions are kept under reports/ and legacy/.
| File | Subject |
|---|---|
| ARCHITECTURE.md | ARM64 decoder, gadget interpreter, memory model, userspace kernel and host boundaries. |
| LINUX_DEVELOPMENT.md | AArch64 Linux build, fakefs, command-line use and diagnostics. |
| IOS_APPLICATION.md | Xcode schemes, rootfs packaging, signing boundary and embedding interfaces. |
| VALIDATION.md | Build and runtime gates, focused fixtures, reports and failure rules. |
| LIMITATIONS.md | Security model, compatibility shims, incomplete facilities and unsupported workloads. |
| CONTRIBUTING.md | Source, test and documentation requirements for changes. |
| RELEASES.md | App versions, Apple build numbers, Git tags and release checks. |
Reports record a result at a named date or revision. Paths, package versions and pass counts in these files may be obsolete.
| Directory | Contents |
|---|---|
| reports/audits/ | Source and upstream comparison audits. |
| reports/benchmarks/game/ | Benchmarks Game harness and per-language results. |
| reports/benchmarks/historical/ | Retired x86/ARM64 compatibility and performance comparisons. |
| reports/releases/ | Previous production baseline and staging records. |
| reports/workloads/ | Workload investigations such as go-gte. |
- legacy/ORIGINAL_ISH_README_2026-05.md preserves the pre-rewrite fork README and its embedded upstream material.
- legacy/ also contains upstream translations and the superseded May 2026 Chinese backend guide.
- SECURITY.md defines the security model.
- LICENSE.md and LICENSE.IOS contain licence terms.
Generated fastlane/README.md and executable .pi/skills/*/SKILL.md files are tool inputs, not project guides. Vendored component notes under app/terminal/ describe only the bundled third-party assets at their named revisions.