docs: link shared harness engineering research

[nnennandukwe]

Summary

The shared harness engineering research needs a durable entry point in ThreadLoop. Add a README link to the dated GAAP report and the shared adoption decision tracker so research candidates and their next experiments can be revisited across repositories.

Related issue

Refs nnennandukwe/governed-agent-autonomy-patterns#29

The shared tracker remains open for adoption decisions and follow-up experiments.

Changes

• Add a short Shared research section next to the existing documentation links.
• Pin the report link to its September 10, 2026 snapshot and link the living decision tracker.
• State that candidates remain research proposals until explicitly accepted into a repository roadmap.

Impact

• Documentation only

Validation

Check	Result	Notes
npm run check	Passed	Formatting, ESLint, Markdownlint, type checking, dead-code analysis, community validation, 495 tests across 35 files, production build, and packaged-install smoke test.
npm run security:dependencies	Passed	High/critical threshold passed; one existing low-severity esbuild advisory, GHSA-g7r4-m6w7-qqqr, remains. Dependencies were not changed.
git diff --check origin/main...HEAD	Passed	README-only change.

No new tests were added because this change only adds documentation links and explanation. The canonical report URL was verified live at its immutable commit before the README update.

Risk and recovery

Low risk: the change adds one README section and does not alter runtime behavior, lifecycle authority, persisted state, or packaging. Reverting the documentation commit removes the entry point. The report link preserves a dated snapshot; the issue holds evolving decisions.

Reviewer guidance

Check the two destinations and the distinction between research proposals and accepted roadmap work. The report and tracker are maintained in GAAP and shared with ThreadLoop and RunInvariant.

Checklist

• The PR is focused on the linked issue and contains no unrelated changes.
• Tests cover new behavior and important failure paths, or I explained why tests are not needed.
• CLI help, protocol output, examples, and docs remain aligned where applicable.
• State or schema changes include compatibility and migration coverage where applicable.
• User-facing or machine-readable breaking changes are called out explicitly.
• Logs, fixtures, screenshots, and generated artifacts contain no secrets or sensitive data.
• The branch is based on the latest origin/main.

[qodo-code-review]

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Great, no issues found!

Qodo reviewed your code and found no material issues that require review

Tip of the day

💡 Did you know, you can turn these tips off under Display preferences

More tips ↗ | Customize Qodo ↗ | Qodo docs ↗

Previous reviews

Review updated until commit cffb402 ⏭️ Skipped

Results up to commit 8fbd700 ⏭️ Skipped

No changes from previous review

[qodo-code-review]

PR approved by Qodo

All merge criteria satisfied — approved by default policy

[qodo-code-review]

PR Summary by Qodo

Link shared harness research from the README

📝 Documentation 🕐 Less than 5 minutes

AI Description

• Adds a durable README entry point for shared harness engineering research.
• Links the immutable report snapshot and living adoption decision tracker.
• Clarifies that candidates require explicit repository roadmap acceptance.

Diagram

graph TD
  README["Shared Research"] -->|living decisions| TRACKER["Decision Tracker"] -->|explicit acceptance| ROADMAP["Repository Roadmaps"]
  README -->|dated snapshot| REPORT["Research Report"]

Loading

High-Level Assessment

The chosen approach is appropriate: an immutable commit URL preserves the cited research snapshot, while the GitHub issue supports evolving adoption decisions. Copying the report locally or linking only a mutable document would create duplication or weaken historical durability, so neither is preferable.

Files changed (1) +9 / -0

Documentation (1) +9 / -0

README.mdAdd shared harness research links and adoption guidance +9/-0

Add shared harness research links and adoption guidance

• Adds a Shared research section linking the immutable September 10, 2026 harness engineering review and the living adoption tracker. It clarifies that research candidates are not roadmap commitments until explicitly accepted by a repository.

README.md

[qodo-code-review]

Qodo Fixer

No findings are available for this PR yet. Findings appear here once Qodo has reviewed the PR.

[qodo-code-review]

Code review by qodo was updated up to the latest commit cffb402