Skip to content

Specs

Specs live in the project wiki, not in this repository.

A spec is a point-in-time decision record — written once, true of a moment, read later for its conclusions. Keeping them here buried the living documentation they sat beside, so they moved. Contributor guides, engineering standards and testing conventions stay in docs/, because those change with the code.

Spec Title Status
0001 krites — design spec DRAFT
0002 krites — interface contracts (CLI, studio, MCP) DRAFT
0003 krites — studio interface contract (web UI + HTTP/SSE API) DRAFT
0004 face & eye/blink cull signal IN PROGRESS
0005 decision capture (the Phase-4 learning substrate) IN PROGRESS
0006 develop: straighten, crop, looks & the develop-aware export IMPLEMENTED
0007 aesthetic & expression cull signals IMPLEMENTED
0008 object removal: the Inpainter provider & the remove command IMPLEMENTED
0009 AI image review: the Critic capability IMPLEMENTED
0010 Mac packaging (.dmg) & in-studio self-update IMPLEMENTED
0011 GTB uplift & studio re-platform (v0.21 → v0.27.2) IMPLEMENTED
0012 Config lifecycle, first-run bootstrap & global settings IMPLEMENTED
0013 ONNX Runtime auto-provisioning & bundling IN PROGRESS
0014 Svelte UI Refactor: Componentisation & Performance APPROVED
0015 Agent Skills: Svelte Embedded UIs DRAFT
0016 krites — Proposed Feature Specifications DRAFT
0017 krites — Studio UI & UX Improvements DRAFT
0018 krites — Studio UI Mockups DRAFT
0019 Product roadmap: feature triage, UX direction & the hosted play DRAFT
0020 Explainable cull (face zoom · focus peaking · reasons heatmap) IMPLEMENTED
0021 Directory picker (native + server-side browse) IMPLEMENTED
0022 "Pro Dark" studio redesign (Stage 2 interface) IMPLEMENTED
0023 Tile & inspector data (score chip, burst crown, capture) IMPLEMENTED
0024 Settings, re-segmented into vertical tabs IMPLEMENTED
0025 Notifications bell (chrome popover) IMPLEMENTED
0026 User guide + in-chrome help panel IMPLEMENTED
0027 Shoot safety resets (guarded re-cull · reset · reset exports) IMPLEMENTED
0028 Long operations as reconnectable background jobs (cull first) IMPLEMENTED
0029 Trained expression signal (MediaPipe blendshapes: smile ↔ frown valence) IMPLEMENTED
0030 Diagnostics: consume the toolkit's scrapeable-metrics module (not in-tree) IMPLEMENTED
0031 krites-models: a signed, licence-clean model-provisioning repo IN PROGRESS
0032 Faithful MediaPipe ROI pipeline (fix the FaceMesh no-lock) IN PROGRESS
0033 Pluggable face detector (UltraFace YuNet)
0034 krites-models signing-key rotation (v1 → v2) IMPLEMENTED
0035 Sign krites release binaries (self-update trust anchor) IMPLEMENTED
0036 Phase 4: learning Hailey's taste DRAFT · blocked

Referring to a spec

By number and name — "0020, the explainable-cull spec" — never by date. The number is a stable handle; a date is not something anyone remembers.

Writing a new one

Claim the next number first, then draft against the canonical shape. See the spec-driven-development skill in the phpboyscout marketplace.