S08.2 — Finalize operations, implementation status, and limitations

Planning / historicaltaskdelivery

Historical

Planning material. It summarizes and links to the authoritative specification and the current measured state — it does not replace either, and it is not current engineering truth.

Migration identity#

Canonical identifier: S08.2 (GitHub issue type: subtask).
Legacy identifier: C08.2 (retained as old_identifier).
Parent epic: E08.
Milestone: M1 — IntentGuard Weekend MVP.

Objective#

Document exact operating commands, configuration/artifact behavior, statuses, fallbacks, limitations, and unsupported claims.

Rationale#

Operational reproducibility and honest boundaries prevent a portfolio demo from being mistaken for an undeclared production system.

Parent identifier#

E08.

Source task#

T-008.

Traceability#

Primary: NFR-010. Secondary: NFR-003, NFR-008, AC-014.

Prerequisites#

U07 acceptance evidence and final runtime/configuration behavior.

Likely files#

docs/OPERATIONS.md, docs/IMPLEMENTATION_STATUS.md, docs/LIMITATIONS.md, .env.example, configs/default.toml.

Implementation boundary#

Operate the implemented local system and report state; do not add deployment or duplicate design authority.

MUST scope#

Setup/lifecycle/serve/demo commands, artifact paths, environment variables, status vocabulary, fallback consequences, CPU/GPU facts, revisions, limitations, troubleshooting stop points.

Explicit non-goals#

Docker, cloud, SLO/runbook theater, production incident process, or unmeasured hardware claims.

Acceptance criteria#

Commands and configuration match code; status matches acceptance JSON; every fallback has its strict-MVP consequence; all unverified claims are explicit.

Validation commands#

uv run python scripts/validate_foundation.py && uv run python scripts/validate_acceptance.py.

Expected evidence#

Valid links/config names, status-report parity, fallback table, and limitation checklist.

Fallback and status consequence#

Documentation may truthfully record degraded paths; missing or misleading operational boundaries make U08 Partial.

Stop condition#

Stop for stale commands, hidden secret/config need, status mismatch, duplicated specification, or unsupported claim.

Definition of ready#

Runtime and final acceptance outputs are stable.

Definition of done#

NFR-010 is satisfied and documents agree with executable behavior and evidence.

Labels#

type:subtask, priority:MUST, area:documentation

Estimate#

0.5 hour.