PDFToMD/phases/8-release-docs-packaging/step1.md

Step 1: environment-bootstrap-docs

Read First

• /AGENTS.md
• /PLAN.md
• /PROGRESS.md
• /docs/HARNESS.md
• /docs/IMPLEMENTATION_PLAN.md
• /docs/TOOLCHAIN.md
• /requirements.txt

Task

Document and optionally script the repo-local environment bootstrap flow.

Cover Conda Python 3.11, requirements install, CUDA smoke test, pip check, and Nougat help check.

Sprint Contract

• Done means: environment setup instructions reflect the verified GTX 1070 Ti / torch 2.7.1+cu126 baseline.
• Hard thresholds: dependency pins remain consistent across README, TOOLCHAIN, and requirements; no unverified torch upgrade is introduced.
• Files owned: README.md, docs/TOOLCHAIN.md, optional scripts/, PROGRESS.md, phase index.
• Dependencies: MVP CLI docs.

Acceptance Criteria

python scripts\validate_workspace.py
.\venv\python.exe -m pip check
.\venv\Scripts\nougat.exe --help

Verification

1. Run the acceptance commands where local environment is available.
2. Explain any skipped environment command in PROGRESS.md.
3. Update this phase index.

Do Not

• Do not replace the single venv policy.
• Do not require uv.
• Do not change pins without official compatibility verification.