v1-readiness.md

V1 Readiness and Pilot Checklist

V1 Acceptance Criteria

Система вважається готовою до v1, якщо:

• schema v1 формально описана і використовується в шаблонах;
• є canonical concept, decision, context, task та index docs;
• vault-index містить усі стартові canonical nodes;
• shared adapter contract зафіксований;
• Codex і Claude skills посилаються на той самий contract;
• validator spec і indexer spec визначені;
• repo має зрозумілий entrypoint для нового користувача.

Metrics for pilot

• retrieval hit-rate: ціль не нижче 80% задач без ручного пошуку стартових вузлів
• duplicate rate: не більше 10% нових docs виявляються дублями після review
• orphan-doc rate: не більше 5% knowledge docs залишаються сиротами
• stale-doc rate: не більше 15% docs мають прострочений або сумнівний current state
• manual cleanup after agent writes: не більше 15 хвилин ручного cleanup на 10 agent-generated updates

Pilot project checklist

• проєкт має достатньо контексту для knowledge graph
• є повторювані задачі, де retrieval реально потрібен
• є місце для canonical docs, decisions, tasks і contexts
• можна перевірити, чи агенти не плодять дублікати

Pilot report should include

• короткий опис проєкту
• які задачі проганялися через memory workflow
• де retrieval спрацював добре
• де write flow зламався або дав шум
• які docs стали duplicate/orphan/stale candidates
• які зміни потрібні до переходу за межі v1