Document Pathfinder and community feedback across the contributor docs

Moves the README's deep material into .readme/ (walkthrough, autonomous
loop, status line, metrics, test bot) and brings AGENTS.md, the .agents-docs
set and QUICK-REFERENCE.md in line with Step 0 and the metrics ingestion
flow.

AI Assisted

.readme/test-bot.md

@@ -0,0 +1,46 @@
+# Workflow Test Bot
+
+`plan2code-bot` drives the whole workflow end to end with no human in the loop — init, plan,
+document, implement, finalize — to test that the prompts still hold together.
+
+Built for **maintainers**. If you're using Plan2Code to ship features, you don't need this.
+
+← [Back to README](../README.md)
+
+---
+
+## Two modes, auto-detected
+
+| Condition | Mode | What it does |
+|-----------|------|--------------|
+| No `AGENTS.md` in the working directory | **New project** | Invents an app idea, creates a subdirectory, writes `IDEA.md`, runs init, then all four steps |
+| `AGENTS.md` present | **Enhancement** | Reads the existing codebase, proposes a realistic enhancement, writes `IDEA.md`, then runs plan → finalize |
+
+## Install
+
+```bash
+node install.js     # I  (everything)  — or  C → B  (bot only)
+```
+
+## Run
+
+```bash
+# New project mode — start from an empty directory
+mkdir /tmp/test-bot && cd /tmp/test-bot
+plan2code-bot
+
+# Enhancement mode — start from a project that has an AGENTS.md
+cd my-project
+plan2code-bot
+
+# Or seed the idea generator yourself
+plan2code-bot --idea "web app that renders the current weather as vector images"
+```
+
+---
+
+## Full documentation
+
+Agent SDK wiring, run evaluation, and scoring:
+[`plan2code-bot/README.md`](../plan2code-bot/README.md) ·
+[`plan2code-bot/EVALUATION-SYSTEM.md`](../plan2code-bot/EVALUATION-SYSTEM.md)