This directory holds project documentation. The top-level README is the product summary; this directory keeps validation, architecture, workload, and provenance details.
| File | Purpose |
|---|---|
| RUNTIME_VALIDATION.md | Test gates, commands, report paths, coverage areas, and failure rules. |
| ARM64_WORKLOAD_SMOKE_TESTS.md | Workload matrix for language runtimes, package managers, CLIs, and Benchmarks Game rows. |
| ARM64_BACKEND.md | ARM64 guest backend architecture inherited from ish-arm64. |
| LINUX_BUILD_AND_HOST_ABI.md | Linux-host build and platform abstraction notes. |
| Area | Files |
|---|---|
| Runtime/syscall issue ledger | ARM64_SMOKE_ISSUES_AND_SYSCALL_COVERAGE.md |
| Production baseline | ARM64_PRODUCTION_BASELINE.md, ARM64_PRODUCTION_DEPLOYMENT.md |
| Benchmarks Game | BENCHMARKSGAME_HARNESS.md, BENCHMARKSGAME_MATRIX.md, per-language BENCHMARKSGAME_*_SMOKE.md reports |
| Historical benchmark reports | benchmark/ |
| go-gte workload | GO_GTE_PROGRESS.md |
| Material | Location |
|---|---|
| Original iSH README material | ORIGINAL_ISH_README.md |
| Localized upstream README files | legacy/ |
| Repository root exceptions | README.md, LICENSE.md, SECURITY.md, ISSUE_TEMPLATE.md, generated fastlane/README.md, and executable skill manifests under .pi/skills/*/SKILL.md. |