refactor(ai): OCR sidecar canonical naming cleanup — typhoon→np-dms, remove hardcoded keys, asyncio.to_thread, ADR-040/041

2026-06-20 16:37:04 +07:00
parent d418d791a4
commit a80ebef285
70 changed files with 5762 additions and 452 deletions
@@ -0,0 +1,36 @@
+# Specification Quality Checklist: Single-Host Server Consolidation
+
+**Purpose**: Validate specification completeness and quality before proceeding to planning
+**Created**: 2026-06-20
+**Feature**: [spec.md](../spec.md)
+
+## Content Quality
+
+- [x] No implementation details (languages, frameworks, APIs) — spec focuses on operational outcomes
+- [x] Focused on user value and business needs — admin/ops workflows clearly defined
+- [x] Written for non-technical stakeholders — user stories describe journeys, not code
+- [x] All mandatory sections completed — User Scenarios, Requirements, Success Criteria all filled
+
+## Requirement Completeness
+
+- [x] No [NEEDS CLARIFICATION] markers remain — all requirements have clear definitions
+- [x] Requirements are testable and unambiguous — each FR has measurable acceptance criteria
+- [x] Success criteria are measurable — SC-001 through SC-010 have specific metrics
+- [x] Success criteria are technology-agnostic — focus on outcomes (parity, latency, uptime) not tools
+- [x] All acceptance scenarios are defined — 5 user stories with Given/When/Then scenarios
+- [x] Edge cases are identified — 7 edge cases covering GPU OOM, RAM, CIFS, SPOF, network, migration failures
+- [x] Scope is clearly bounded — includes provisioning, migration, cutover, security, decommission
+- [x] Dependencies and assumptions identified — 7 assumptions documented
+
+## Feature Readiness
+
+- [x] All functional requirements have clear acceptance criteria — FR-001 through FR-015 mapped to user stories
+- [x] User scenarios cover primary flows — P1 (provision) → P2 (migrate) → P3 (cutover) → P4 (security) → P5 (decommission)
+- [x] Feature meets measurable outcomes defined in Success Criteria — 10 measurable outcomes
+- [x] No implementation details leak into specification — Docker/tech names are inherent to infra spec but kept at architecture level
+
+## Notes
+
+- This is an infrastructure specification based on ADR-041; some technical terms (Docker, CIFS, VRAM) are inherent to the domain
+- ADR-040 (OCR Sidecar Refactor) is a hard dependency for FR-008 (remove X-API-Key) and FR-009 (GPU VRAM management)
+- Spec is ready for `/speckit-clarify` or `/speckit-plan`