opencode-web-quality-docs

name	opencode-web-quality-docs
description	Own quality gates and operator documentation for opencode_web_yolo. Use when building or updating tests, CI checks, shell lint/syntax validation, dry-run verification, security-focused acceptance checks, README quickstart/proxy guidance, TECHNICAL architecture notes, or troubleshooting docs.

Quality and Docs Scope

Implement quality and docs in:

• tests/
• .github/workflows/ci.yml
• README.md
• TECHNICAL.md

Follow acceptance criteria in TECHNICAL.md.

References

Load only the file needed for the current task:

• Read references/test-acceptance-matrix.md when adding/updating tests tied to plan acceptance criteria.
• Read references/ci-job-outline.md when editing .github/workflows/ci.yml.
• Read references/docs-coverage-checklist.md when writing or reviewing README/TECHNICAL docs.

Test and CI Baseline

Ensure CI validates at least:

• shell syntax checks (bash -n)
• shell linting (shellcheck)
• Docker build success
• dry-run output assertions
• required auth failure when password is missing
• package availability checks (gh, git, ssh) in image
• config/data mount contract checks for persistence behavior
• guard checks for version format and runtime-file/version drift

Prefer deterministic shell tests with clear failure messages.

Documentation Baseline

Document these operator-critical topics: