docs: convert product review feedback into a tracked action plan

[smusali]

Summary

Adds docs/PRODUCT_ACTION_PLAN.md, which converts the external "brutal review" of checkOwners into a fully actionable, codebase-grounded plan. This is a documentation-only change — no code is modified.

The document breaks the feedback into:

• Baseline scores from the review and the guiding constraints it prescribes (one target user, one urgent job, one primary output, one distribution path, one proof asset, one trust promise; observed vs. recommended vs. declared vs. approved ownership vocabulary).
• 14 workstreams (A–N), each feedback point converted into a tracked step with an ID, the exact files it touches (e.g. README.md:9/README.md:11 positioning edits, new checkowners/audit.py, explain in expertise.py/cli.py, doctor, stable exit codes across cli.py, action.yml least-privilege/audit-mode split, SARIF, protected paths through config.py/models.py, state schema bump in state.py), and acceptance criteria:
  • A: positioning and README rewrite
  • B: checkowners audit as the default first-run path
  • C: explainability, uncertainty labels, and false-positive honesty
  • D: safe, reviewable CODEOWNERS changes (diff-first, no silent modification)
  • E: scoring and configuration controls
  • F: team ownership modes
  • G: owner-validity checks
  • H: GitHub Action conversion
  • I: CLI/installation gaps, doctor, stable exit codes
  • J: documentation priorities
  • K: evaluation, metrics, and accept/reject/correct feedback loop
  • L: the public case study
  • M: the 10–15-session validation plan
  • N: explicit de-prioritization policy for platform features
• Roadmap mapping the review's P0/P1/P2 lists to the step IDs, plus success metrics defining when the pivot is done.

Notes

• The plan documents the feedback; it intentionally implements none of it, so each workstream can be picked up as its own PR.

🤖 Generated with Claude Code

https://claude.ai/code/session_0176E2yMicwEB1hSrk1p7sDa

---

Generated by Claude Code