Foundation
In progressNext.js shell, docs, GitHub, routing, and mock-mode architecture are established.
Internal Build Console
Internal progress tracker for what is live, what is structured, and what still needs to be built before Kay OS becomes the operating system for the practice.
Overall
51%
Current Phase
Open Dental Export Bridge Sprint
Next Milestone
Founder tests the first authorized Open Dental export through the local bridge.
Project Coverage
Artifact-based completeness from the Master Coverage Map. These numbers are formulas, not subjective progress estimates.
| Coverage Area | Formula | Coverage | Status | What it means |
|---|---|---|---|---|
| Kay Operating Principles | 1 constitution document / 1 required governance document | 100% documented / 0% automated enforcement | Complete | The product constitution now governs SOPs, decisions, signals, queries, UI, automation, and AI. Enforcement remains a human review requirement. |
| Single-Sprint Governance | 1 active sprint / 1 allowed active sprint | 100% locked | Complete | Briefing is the only active sprint. Recover, Executive Memory, additional modules, other page redesigns, and unrelated functionality are paused until founder approval. |
| Analytics Coverage Matrix | 1 benchmark matrix / 1 requested analytics coverage artifact | 100% drafted / 0% live data validated | Drafted | Analytics features are mapped to business questions, benchmark coverage, Kay OS reasoning extension, evidence, recommendation, automation, and gaps. This supports Briefing and does not start an Analytics sprint. |
| Data Dictionary | 1 v0.4 data dictionary / 1 requested data governance artifact | 100% drafted / 0% production field validated | Drafted | Data Dictionary v0.4 defines Executive Brief V1 fields, analytics support fields, recommendations, evidence, Practice DNA configuration, future Open Dental read models, and learning events. |
| Practice Blueprint | 1 persistent configuration page + 1 local private store / 1 required operating-model foundation | Implemented foundation / production permissions not yet connected | In progress | The Practice Blueprint now stores clinic goals, provider goals, schedule rules, O-KAY weights, thresholds, confidence rules, and excluded metrics outside the repository. Role-based authorization and audit history remain future work. |
| Open Dental Read-Only Alpha | 3 alpha safety docs + 1 adapter contract drafted / 0 live connections | 100% planning artifacts drafted / 0% live connected | Drafted | Discovery, local alpha security, first dataset requirements, export bridge strategy, and the fail-closed adapter contract are drafted. Founder/admin approval is required before API keys, SQL, services, or live PHI access. |
| Open Dental Export Bridge | security folders + normalized models + validation + import center + Recover snapshot integration / production live integration | Foundation implemented with fake-data tests / 0 real authorized exports tested | In progress | Local export bridge foundation supports ignored local import storage, deterministic alias mapping, validation, normalized export snapshots, Import Center status, and Recover export labels. Real Hometown exports have not been tested or approved. |
| Founder Requirements Lock | 10 locked capability requirements / 10 reviewed capabilities | 100% requirements locked / 1 visible Briefing slice implemented | Drafted | Founder-reviewed requirements are documented for Executive Brief, Growth, Financing, Insurance, AR, Same-Day Treatment, Treatment Acceptance, Recare Psychology, Dynamic Open-Chair Recovery, and Role-Specific Task Intelligence. Executive Brief V1 is implemented for founder review only. |
| Executive Memory Foundation | 10 created foundation artifacts / 10 requested Executive Memory artifacts | 100% artifact-created / 0% production connected | Drafted | Architecture, schema prep, memory types, candidate rules, retention rules, development repository, internal review route, timeline component, Recover evidence example, and security limits are drafted. |
| Project Coverage | 0 production-ready decisions / 100 Decision Library drafts | 0% | Not started | Production readiness remains zero until decisions are SME reviewed, query validated, and connected to real workflows. |
| Decision Library Coverage | 100 drafted decisions / 100 planned decisions | 100% draft / 0% validated | Drafted | Draft coverage is complete; SME review and production readiness are both still 0. |
| Signal Coverage | 10 registered signals / 100 Decision Library drafts | 10% | Drafted | All registered signals are Recover/Schedule signals. Non-Recover modules have no signal registry yet. |
| SOP Coverage | 22 mapped source references / 22 indexed references | 100% mapped / 0% validated | Drafted | Source references are mapped, but all require manual review because original files are not present. |
| Role Coverage | 7 drafted role blueprints / 8 target roles | 88% drafted / 0% production-ready | Drafted | Doctor is the missing target role. All drafted role blueprints remain non-production. |
| Recover Coverage | 10 registered Recover signals / 15 Recover query contracts | 67% signal / 0% validated | In progress | Recover has the strongest artifact coverage, but no Open Dental validation and known Schedule ID conflicts. |
| Today Coverage | 0 validated Today workflows / 1 Today route | 0% production-ready | Drafted | The Today/Morning Brief UI exists, but Today-specific signals and validated queries are not documented yet. |
SOP and Role Knowledge Ingestion
Tracks source references, manual review status, role blueprints, decision drafts, automations, and query requirements from the Hometown Dental source-material pass.
Source docs
22
Processed
22
Manual review
22
Role drafts
7
Decision drafts
100
Automations
100
Query reqs
100
Redaction
Pass: no original source files or credentials committed
Current Milestone
First 100 structured Kay OS operational decisions are drafted. Next milestone: Founder Recover Review.
Planned
100
Identified
100
Drafted
100
SME reviewed
0
Data mapped
100
Query designed
100
Query validated
0
Production ready
0
Schedule
15
Patient Access / Leads
10
Front Desk
10
Financial / Insurance
10
Treatment / Patient
10
Recall / Retention
10
Clinical Readiness
10
Operations / Readiness
10
Team / Coaching
10
Marketing / Practice Growth
5
Recover Intelligence
Tracks the first real Recover work center: live openings, ranked patient recovery, next action controls, doctor impact, and SCH query contracts.
Progress
56
Queries identified
15
Queries designed
15
Queries validated
0
Query register
docs/query-requirements/recover.md
Next validation step
Do not begin Recover improvements until the founder approves the Briefing sprint.
Overall Kay OS Progress
The major construction tracks required to turn Kay OS from a mock operating guide into a production-ready system.
Next.js shell, docs, GitHub, routing, and mock-mode architecture are established.
Operating-system navigation, morning brief experience, and founder demo route are usable.
Local CSV worksheets power the founder demo only. Operational pages use the Open Dental export bridge snapshot or show unavailable data.
Polished /demo route explains Kay OS with structured mock data, role-specific guidance, and Open Dental disclosure.
Decision Library 100 is drafted with 100 query requirements and 100 automation mappings. SME review remains required.
RB-001 through RB-007 are Draft v1 and Role Blueprint architecture is documented.
100 Decision Library requirements plus 15 Recover Intelligence query contracts are mapped at draft level. Data Dictionary v0.4 and Open Dental alpha dataset docs define future read models; no SQL or Open Dental connection exists.
Requirements locked; implementation started; fake fixtures and bridge tests added. Providers/operatories, appointments, patient scheduling index, treatment, A/R, and recall export definitions exist. Real authorized export testing and founder approval remain pending.
v0.4 documents Executive Brief V1 fields, analytics support, recommendations, evidence, Practice DNA settings, future Open Dental read models, sensitivity classes, and validation rules.
Recover maps live openings, patient ranking, next action, doctor impact, Executive Brief, evidence, confidence, and bounded autonomy to future SCH queries.
Recommendation types, confidence labels, evidence structure, outcome tracking, and Recover integration are now drafted.
Practice boundaries now classify what Kay may observe, recommend, prepare, execute with approval, or restrict.
Permanent single-sprint methodology is documented: one major concept, one business problem, one founder approval before moving forward.
Practice DNA and Practice Profile concepts are documented for future office-specific configuration.
Executive Memory types, retention rules, candidate engine, development repository, schema preparation, and /practice/memory review surface are drafted.
Coaching Layer philosophy is documented; recommendations must convert findings into role-specific next actions.
No AI calls yet; reasoning contracts are being shaped before connection.
Auth, permissions, real data, auditability, and deployment hardening remain future work.
GitHub is documented as the permanent source of truth with commit, tag, security, and session closeout standards.
Current Active Build Focus
Executive Briefing experience
Executive Briefing experience
Make the Briefing page exceptional enough that the founder says: I would open this every morning.
One major concept selected: Briefing
CompleteOne business problem selected: morning operating focus
CompleteFounder approval required before moving forward
CompleteBriefing page approved by founder
Not startedFounder Review V1 visible slice implemented
CompleteRecover improvements paused
CompleteExecutive Memory enhancements paused
CompleteAdditional modules paused
CompleteOther page redesigns paused
CompleteUnrelated functionality paused
CompleteIntelligence Progress
Each intelligence area becomes useful only when decisions, queries, rules, and learning events line up.
Recover Intelligence Sprint 1 adds schedule recovery work queues and 15 query contracts without SQL.
Live openings, ranked patient fit, next action, doctor impact, evidence, confidence, and bounded action flow are mapped to SCH-001 through SCH-015.
Executive Brief, Evidence, Analytics flow is documented and applied first to Recover.
Recommendations now distinguish verified, predictive, inferred, and monitor-level confidence.
Practice boundary rules are modeled for patient contact, appointment movement, schedule overrides, financing, and restricted clinical decisions.
Patient behavior patterns are mocked inside Practice Memory.
Treatment acceptance and diagnosed treatment needs are modeled with mock data.
FIN-001 Patient Financial and Treatment Readiness is Draft v1; continuity of care is documented.
Role Blueprints are drafted for Director, Front Desk, Dental Assistant, Hygienist, Clinical Coordinator, Treatment Coordinator, and Office Manager.
Practice DNA, Procedure Blueprints, automation philosophy, and Executive Memory foundation are documented as future-ready structures.
Version 1 Scope
Scope stays focused on what helps a practice know what to do next.
Product
Product
Product + Ops
Product
Data
Product
Product + Ops
Operations
Intelligence
Operational Intelligence Workstreams
Shows how source documents are being converted into Kay OS decisions, readiness checks, automation candidates, and future query requirements.
Requirements locked; Founder Review V1 visible slice implemented on homepage with five ranked actions, evidence drawers, practice goal context, and analytics links. Architecture refinement, query development, live integration, and production readiness remain pending.
Requirements locked; forecasting assumptions, Practice DNA configuration, capacity model, and query design remain pending; not production ready.
Requirements locked; provider abstraction documented; payment and financing APIs are not connected; legal/compliance review required.
Requirements locked; carrier performance, denial, appeal, attachment, and variance intelligence are pending; no payer integrations connected.
Requirements locked; balance reason, owner, next step, due point, and resolution path are documented; collections automation is not implemented.
Requirements locked; patient-interest-first language and feasibility gates are documented; clinical authority remains with the doctor.
Requirements locked; active engagement workflow and clinical documentation boundaries are documented; not implemented.
Requirements locked; warm, formal, barrier-aware communication requirements are documented; communication automation not connected.
Requirements locked; live queue, ranking groups, time degradation, and reliability standards are documented; no live re-ranking engine built.
Requirements locked; task research package requirements are documented; no persistent role task engine implemented.
22 source references indexed; all require manual review because original files were not available.
7 Role Blueprints are drafted from current source references and role philosophy.
Decision Library 100 drafts are generated and tracked with source, owner, correction path, coaching, and automation level.
13 readiness categories are defined with checkpoints, risks, owners, and correction paths.
100 Decision Library automation mappings are classified by autonomy level.
100 Decision Library query requirements plus 15 Recover Intelligence query contracts are mapped without SQL.
Field dictionary is drafted for Executive Brief V1, analytics, recommendations, evidence, Practice DNA configuration, future Open Dental read models, and learning events. No production field validation has started.
Planning artifacts are updated for self-hosted Open Dental on practice-controlled AWS infrastructure. API access remains blocked, so an export-based bridge strategy is documented. Live connection, credentials, SQL, ShortQuery, public API exposure, PHI access, and service changes remain blocked until AWS/Open Dental administrator confirmation.
Architecture complete; local import storage selected; provider, appointment, treatment, A/R, patient scheduling, and recall definitions drafted; validation and mapping engines started; normalized data snapshot implemented; Import Center and Recover export labels wired; rollback/security review/real export testing remain pending.
Recover route has an Executive Brief, evidence drawer, confidence labels, owner, due time, bounded action level, and analytics handoff. Further improvements are paused until Briefing is approved.
Data to Signals to Decision Rules to Confidence to Recommendation to Outcome to Practice Memory is documented and partially implemented.
Current engine labels deterministic, predictive, and inferred recommendations based on verified signal count.
Recommendations are sorted into right-now, protect-today, prepare-tomorrow, monitor, and analytics-only buckets.
Evidence Drawer shows direct facts, supporting metrics, decision rules, practice boundaries, timestamps, notes, and confidence basis.
Autonomy levels and practice boundaries are documented and checked before Recover recommendations.
Outcome structures are ready for later persistence of completed, ignored, dismissed, and realized-impact events.
Configured boundaries define role authority and approval requirements before Kay can prepare or execute work.
Recover is drafted and paused. Briefing is now the only active sprint.
Architecture documented; schema drafted; development repository connected; memory candidate rules created; approval workflow created; /practice/memory available; Recover evidence integration added; production database, authentication, HIPAA configuration, Open Dental, and AI API remain not connected.
Founder observations are now routed into Decision Library entries, signals, query requirements, role updates, Practice DNA, automation candidates, and UI refinements.
Founder demo data is refreshed from data/demo-spreadsheet with npm run refresh:data and displayed with a last-refreshed timestamp. It is not an operational source.
No original source files were committed; sensitive-risk references are documented for future review.
Documentation-first workflow, Git milestone tags, end-of-session GitHub checkpoint rules, and Kay Operating Principles are documented.
Demo route, story flow, mock-data disclosure, role guidance, and learning vision are documented for founder-led walkthroughs.
Role Blueprint Workstream
Tracks the first role drafts and the stages needed before role-specific guidance can become production-ready.
RB-001
Source role document received
CompleteMission extracted
CompleteOwnership mapped
CompleteCheckpoints mapped
DraftedAutomation mapped
DraftedCoaching mapped
DraftedQueries mapped
Not startedProduction-ready
Not startedRB-002
Source role document received
CompleteMission extracted
CompleteOwnership mapped
CompleteCheckpoints mapped
DraftedAutomation mapped
DraftedCoaching mapped
DraftedQueries mapped
Not startedProduction-ready
Not startedRB-003
Source role document received
CompleteMission extracted
CompleteOwnership mapped
CompleteCheckpoints mapped
DraftedAutomation mapped
DraftedCoaching mapped
DraftedQueries mapped
Not startedProduction-ready
Not startedRB-004
Source role document received
CompleteMission extracted
CompleteOwnership mapped
CompleteCheckpoints mapped
DraftedAutomation mapped
DraftedCoaching mapped
DraftedQueries mapped
Not startedProduction-ready
Not startedRB-005
Source role document received
CompleteMission extracted
CompleteOwnership mapped
CompleteCheckpoints mapped
DraftedAutomation mapped
DraftedCoaching mapped
DraftedQueries mapped
DraftedProduction-ready
Not startedRB-006
Source role document received
CompleteMission extracted
CompleteOwnership mapped
CompleteCheckpoints mapped
DraftedAutomation mapped
DraftedCoaching mapped
DraftedQueries mapped
DraftedProduction-ready
Not startedRB-007
Source role document received
CompleteMission extracted
CompleteOwnership mapped
CompleteCheckpoints mapped
DraftedAutomation mapped
DraftedCoaching mapped
DraftedQueries mapped
DraftedProduction-ready
Not startedDecision Library Tracker
Tracks how many decisions have moved from idea to draft, query mapping, validation, and production readiness.
Planned
100
Drafted
100
Mapped
100
Validated
0
Ready
0
| Category | Planned | Drafted | Mapped to query | Validated | Production-ready |
|---|---|---|---|---|---|
| Schedule | 15 | 15 | 15 | 0 | 0 |
| Patient Access / Leads | 10 | 10 | 10 | 0 | 0 |
| Front Desk | 10 | 10 | 10 | 0 | 0 |
| Financial | 10 | 10 | 10 | 0 | 0 |
| Treatment / Patient | 10 | 10 | 10 | 0 | 0 |
| Recall / Retention | 10 | 10 | 10 | 0 | 0 |
| Clinical Readiness | 10 | 10 | 10 | 0 | 0 |
| Operations / Readiness | 10 | 10 | 10 | 0 | 0 |
| Team | 10 | 10 | 10 | 0 | 0 |
| Marketing / Practice Growth | 5 | 5 | 5 | 0 | 0 |
Roadmap View
A phase-by-phase view of what is done, what is underway, and what has not started yet.
Phase 0
Secure repo, product docs, app shell, and mock-data baseline.
Phase 1
Premium Kay OS shell with morning brief and core navigation.
Phase 2
Decision Library 100 is drafted with query requirements and automation mappings; SME review remains required.
Phase 3
Hold Open Dental validation until Recover founder review produces the next requirements set.
Phase 4
Rank what matters now, show evidence, respect boundaries, then coach the owner through the next best action.
Phase 5
Executive Memory foundation is drafted with schema prep, development repository, candidate rules, retention rules, review route, and Recover evidence example.
Phase 6
Connect reasoning once data, rules, and memory contracts are reliable.
Phase 7
Harden auth, deployment, monitoring, permissions, and real data access.