# Sundog Documentation

This folder is organized as a research-facing landing layer over the Sundog
code, experiments, prior theorem materials, and application bridges.

## Primary Entry Points

- [Researcher guide](RESEARCHER_GUIDE.md): shortest path for reviewers and
  collaborators.
- [Scientific criteria](SCIENTIFIC_CRITERIA.md): what is testable, what is
  only partially supported, and what remains future work.
- [Application map](APPLICATIONS.md): how EyesOnly, Dungeon Gleaner, and Money
  Bags relate to the theorem.
- [Promo highlights](PROMO_HIGHLIGHTS.md): hooks, headlines, provocative
  statements, and future-facing language.
- [Standalone app roadmap](STANDALONE_APP_ROADMAP.md): plan for a no/low
  dependency `.html`, `.exe`, and eventual `.apk` observer app.
- [Paper draft](PAPER_v1_draft.md): current academic paper draft.
- [Paper outline](PAPER_OUTLINE_v0.md): venue framing, reviewer risks, and
  stress-test interpretation.

## Supporting Docs

- [Runners](runners.md): Gone Rogue / EyesOnly runner integration.
- [Phase-2 blocks design](PHASE2_BLOCKS_DESIGN.md): occlusion and block-based
  follow-up experiment design.
- [Website development](WEBSITE_DEVELOPMENT.md): how to edit root HTML pages,
  link docs, build `dist/`, and deploy through Cloudflare Pages.

## Reading Order

1. Start with the repository root `README.md`.
2. Read `RESEARCHER_GUIDE.md`.
3. Read `SCIENTIFIC_CRITERIA.md`.
4. Inspect `PAPER_v1_draft.md` and the recorded results under `../results/`.
5. Use `APPLICATIONS.md` to branch into the related product repositories.