Skip to content

docs: product brief, decision log and lessons log (D-007 accepted) - #1

Merged
nkeating-cmd merged 2 commits into
mainfrom
docs/product-brief
Oct 16, 2026
Merged

nkeating-cmd merged 2 commits into
mainfrom
docs/product-brief

Conversation

@nkeating-cmd

Copy link
Copy Markdown
Owner

What

Kōrero gets the three files every Kyt repo keeps (docs only: no code, build or test changes):

  • docs/PRODUCT.md: the product brief. Customer (Nic; external users parked since 20 Sept), four outcomes, 13 pieces of evidence with their basis, nine ranked bets. Now: B1 (release 1.44), B3 (in-room mode), B4 (speaker separation).
  • docs/DECISIONS.md: the one decision log. D-001 to D-006 backfilled from the project record; D-007 Accepted (in-room speaker separation on Kōrero's own ONNX runtime).
  • LESSONS.md: L-001 to L-012. L-001 to L-010 backfilled; statuses checked against the code on 16 Oct, so unverified ones stay open and several start past the 14-day limit.

Why

The bet gate (product-check.py gate) could not run without a brief, and decisions lived only in session notes outside the repo.

Evidence

  • product-check.py check docs/PRODUCT.md: 0 FAIL, 1 WARN. The warning is real: outcome O3 (te reo accuracy) has no bet in Now or Next. That's a decision for Nic, recorded in the brief.
  • product-check.py gate docs/PRODUCT.md B4: PASS.
  • D-007's evidence is the M0 probe on four AMI far-field meetings, run on the main laptop: mean error 23.1% with a 0.25 s collar (28.1% strict), against pyannote's published 22.4% strict on the full test set. pyannote-rs does not compile against ort rc.12, and its packaged embedding model separates speakers at chance.
  • Public repo: machine hostnames, personal paths and OneDrive references were removed. gitleaks on the staged changes: no leaks.

Bet: platform (docs). Decision record: this PR introduces the log.

🤖 Generated with Claude Code

https://claude.ai/code/session_01M9niYsTjphhTSYCLhCwg5n

Kōrero had no product brief, decision log or lessons log, so the Kyt bet gate
could not run and decisions lived only in session notes.

- docs/PRODUCT.md: customer (Nic, external users parked), four outcomes,
  13 pieces of evidence with their basis, nine ranked bets. product-check.py:
  0 FAIL, 1 WARN (the te reo outcome has no bet in Now or Next).
- docs/DECISIONS.md: D-001 to D-006 backfilled from the project record
  (fork, en-NZ default, Ollama context, freeing the speech model, notes in
  parts, wasapi upgrade); D-007 proposed: in-room speaker separation on
  Kōrero's own ONNX runtime, with the M0 probe's results.
- LESSONS.md: L-001 to L-010 backfilled, L-011 and L-012 from M0. Statuses
  checked against the code on 16 Oct; unverified ones stay open.

Docs only: no code, build or test changes.
Nic, 16 Oct 2026: "Execute D007". D-007 (in-room speaker separation on
Kōrero's own ONNX runtime) is Accepted, and B4 joins B1 and B3 in Now
(3 of 3). product-check.py: 0 FAIL, 1 WARN (O3); gate B4: PASS.
@nkeating-cmd
nkeating-cmd merged commit ee768f9 into main Oct 16, 2026
2 checks passed
@nkeating-cmd
nkeating-cmd deleted the docs/product-brief branch October 16, 2026 22:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant