Move PRD to docs/historical and scrub stale examples

[baanish]

Summary

Removes the stale root-level PRD.md from the public-facing repo surface and relocates it to docs/historical/PRD.md with a clear "historical design doc" header pointing readers to README.md for shipped behavior.

Changes

• Moved PRD.md → docs/historical/PRD.md
• Replaced personal/stale examples:
  • /Users/aanish/..., /Volumes/Delos/..., orion-app → generic ~/projects/demo-app paths
  • ~/.config/qr/projects/*.toml → <project>/.qr/profile.json (JSON)
  • qr run watch <script> → qr run --watch <script> (and siblings)
  • ~/.config/qr/config.toml / stats.db → ~/.qr/ layout
• Updated project structure, config defaults, and shipped-scope table to match current code/README
• Aligned .qr.toml override example with the actual flat-field + [scripts] format

Why

This was the last public-readiness nit called out before making the repo loud. README/config/code were already current; the PRD was the outlier with personal paths and pre-breaking-change syntax.

Testing

Docs-only change — no code or test updates required.

  

Summary by CodeRabbit

• Documentation
  • Updated the historical product guide to better distinguish internal notes from shipped behavior.
  • Refreshed command examples, shortcuts, and flag usage for clearer setup and usage guidance.
  • Revised AI workflow examples, stats output, and configuration samples to match the latest naming and storage locations.
  • Expanded the learning workflow example and updated config migration, environment overrides, and shell integration notes.

[coderabbitai]

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Free

Run ID: 817eee21-392b-472b-975b-746d38b45e64

📥 Commits

Reviewing files that changed from the base of the PR and between cd6ff3c and f912eb7.

📒 Files selected for processing (1)

• docs/historical/PRD.md

---

📝 Walkthrough

Walkthrough

This PR updates the historical PRD document to clarify its internal/reference status, rewrites command documentation (shortcuts, qr go, qr run flags), refreshes provider naming to "openai", changes stats/config storage paths, rewrites the qr learn section, and updates the shipped-scope feature matrix.

Changes

PRD Documentation Update

Layer / File(s)	Summary
Header and AI backend framing docs/historical/PRD.md	Header marks the document as historical/internal pointing to README.md; AI backend table clarifies supported protocol families.
Command reference updates docs/historical/PRD.md	Adds new single-letter shortcuts for qr do/qr learn, updates qr go sample project and roots, rewrites qr run to flag-based mutually-exclusive syntax, and updates picker example.
Stats and AI integration wording docs/historical/PRD.md	Refreshes provider naming to "openai" in stats examples and aggregate output, updates local stats storage path, revises AI protocol bullets, qr do intro, and approval flow output.
qr learn rewrite docs/historical/PRD.md	Rewrites the qr learn walkthrough using a demo-app example and project-local .qr/profile.json storage semantics.
Config examples and project structure docs/historical/PRD.md	Updates the .qr.toml override example, project structure tree, ~/.qr/config.toml location/migration docs, env-var overrides table, and shell integration note.
Shipped scope rewrite docs/historical/PRD.md	Replaces the v1 scope framing with a v2-oriented feature matrix and updated success metrics.

Estimated code review effort: 2 (Simple) | ~10 minutes

---

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

_{Comment @coderabbitai help to get the list of available commands.}

[kilo-code-bot]

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (1 file)

• docs/historical/PRD.md

---

_{Reviewed by glm-5.2-short · Input: 22.2K · Output: 2.1K · Cached: 85.9K}