Skip to content

Documentation redirect map ​

The 0.1.x docs reorganized the old single index into user sections and a separate evidence index. No documentation file path changed, so existing relative links to a page still resolve. What changed is where each page is listed and reached from navigation.

Use this map when following an old bookmark, an old section anchor, or a link from a historical record. npm run docs:check keeps the section indexes, the style guide, and this map reachable from the docs home.

Site redirects ​

The published site uses clean URLs under /ensemble/ and rewrites each section README.md to its directory URL. GitHub Pages cannot read _redirects, so the site build emits meta-refresh pages for the old URL forms. The generated map covers:

  • the old docs home (/docs/, /docs/README.html, /docs.html) to /;
  • section README and .md/.html forms such as /getting-started/README.html to /getting-started/;
  • the old docs home alias /docs/ to /.

Section landing pages are served from their directory routes (/getting-started/, /reference/). A separate .html alias is not emitted because it would shadow the real directory index on some static servers.

The site build fails when a redirect target is not a built page or a redirect would overwrite a real page. See docs-site-check and docs-site-artifacts.

Section redirects ​

Old docs/README.md sectionNew home
ProductDocs home for the overview; Reference for compatibility and look-up material
Working agreementsContributing for workflow; Evidence index for ADRs; Security and Privacy for their own sections
SupportSupport
OperationsOperations
VerificationEvidence index: verification records
Architecture statusEvidence index: implementation and assessments

Product entries ​

Old index entryNew home
Project overview (README.md)Root README (path unchanged); docs home
Changelog (CHANGELOG.md)Changelog (path unchanged)
Domain glossary (GLOSSARY.md)Domain glossary (path unchanged); canonical terms in the style guide
Implementation and acceptance notes (docs/implementation.md)Evidence index: implementation
Scale, soak, and local diagnostics (docs/operations/scale-and-monitoring.md)Operations: diagnosis and capacity; evidence remains here
v2 product specification (#17)External issue link; see Contributing for workflow
v2 implementation tickets (#18–#29)External issue links; see Contributing for workflow
Historical v1 specification (#1)External issue link; historical only
OpenCode host support range (docs/compatibility/opencode-host-range.md)Reference: supported hosts; evidence in the evidence index
OpenCode 2.2.1 compatibility report (docs/compatibility/opencode-2.2.1.md)Reference: historical compatibility; evidence in the evidence index

Working-agreement entries ​

Old index entryNew home
ADR index (docs/adr/README.md)Evidence index: architecture decisions
ADR 0001, 0009, 0010, 0011, and every other ADR (docs/adr/*.md)Evidence index: architecture decisions; file paths unchanged
Agent instructions (AGENTS.md)Contributing (path unchanged)
Handoff contract (docs/agents/handoff.md)Contributing: review and process
OpenCode/OpenTUI runtime guide (docs/agents/opencode-tui-runtime.md)Contributing: before you start
Issue tracker (docs/agents/issue-tracker.md)Contributing: before you start
Labels (docs/agents/triage-labels.md)Contributing: before you start
Review workflow (docs/agents/review-workflow.md)Contributing: review and process
Reviewer standards (docs/agents/review-standards.md)Contributing: review and process
Domain document conventions (docs/agents/domain.md)Contributing: review and process
Contributing (CONTRIBUTING.md)Contributing hub (root path unchanged)
Security policy (SECURITY.md)Security (root path unchanged)
Threat model (docs/security/threat-model.md)Security: security documents
Permission-model review (docs/security/permission-model-review.md)Security: security documents
Accepted risks (docs/security/accepted-risks.md)Security: security documents
Data classes, retention, export, and delete (docs/privacy/data-and-retention.md)Privacy

Support entries ​

Old index entryNew home
Support policy (docs/support/README.md)Support (path unchanged)
Incident runbook (docs/support/incident-runbook.md)Support and Operations: recovery
Support matrix and known limitations (docs/support/support-matrix.md)Support and Getting started: before you install

Operations entries ​

Old index groupNew home
Backup and restore (docs/operations/backup-restore.md)Operations: recovery
Upgrade from the pre-release (docs/operations/upgrade.md)Operations: recovery
Package rollback (docs/operations/rollback.md)Operations: recovery
Release operations (docs/operations/release.md)Operations: release
Release notes for 0.1.0 (docs/operations/release-notes-0.1.0.md)Operations: release
Release notes for 0.1.0-rc.2 (docs/operations/release-notes-0.1.0-rc.2.md)Operations: release history
Launch plan for 0.1.0-rc.2 (docs/operations/launch-plan-0.1.0-rc.2.md)Operations: release history
Release sign-off checklist (docs/operations/release-signoff.md)Operations: release
Scale, soak, and local diagnostics (docs/operations/scale-and-monitoring.md)Operations: diagnosis and capacity

Verification entries ​

Every record that appeared under the old Verification section, including the current release, soak, compatibility, security, documentation, native-first, accessibility, and v5.x records, now lives in the evidence index. The file paths under docs/verification/ are unchanged.

This includes every record pattern listed below:

  • docs/verification/<date>-*.md
  • docs/verification/flake-policy.md
  • docs/verification/latency-budget.md
  • docs/verification/macos-herdr-checklist.md
  • docs/verification/terminal-accessibility-checklist.md

Architecture status ​

The old Architecture status paragraph moved to the evidence index and the implementation notes. User-facing architecture concepts belong in Concepts.

Unchanged root pages ​

These paths did not move and remain the source of truth:

PagePath
Product overview and installREADME.md
ChangelogCHANGELOG.md
Domain glossaryGLOSSARY.md
Contributor quickstartCONTRIBUTING.md
Security policySECURITY.md
Repository agent instructionsAGENTS.md

Released under the MIT License.