Portfolio: make the recruiter review path explicit

[duhenri9]

Goal

Apply the WM3 recruiter-facing portfolio presentation rule to ChainEvidence without flattening the project's existing technical identity.

Portfolio rule

A recruiter should understand the project in roughly 60–90 seconds and have a direct path to validate the engineering without needing private credentials, historical event context or a specific external provider.

This PR

• preserves the existing technical documentation and evidence boundaries;
• makes the problem / engineering signal easier to understand on first read;
• exposes a fast local proof or reviewer path;
• keeps implemented/tested/demonstrated/live claims bounded;
• leaves external providers/adapters in their real architectural role.

README/presentation-only change. Merge only with the repository's own CI green on this head.

Summary by CodeRabbit

• Documentation
  • Added a quick 60–90 second project overview.
  • Included a minimal reproduction command for generating a reorganization report.
  • Added links to engineering documentation.
  • Clarified the evidence boundaries and claims of the local engine, transactional recovery, and Anvil adapter.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: a7eb7a43-b063-497c-aed0-9096211c867e

📥 Commits

Reviewing files that changed from the base of the PR and between 73b75d9 and d99a30a.

📒 Files selected for processing (1)

• README.md

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.

---

📝 Walkthrough

Walkthrough

The README now includes a short project introduction, a local reproduction command, engineering documentation pointers, and explicit limits for the engine, recovery flow, and Anvil adapter.

Changes

Review Orientation

Layer / File(s)	Summary
README review guide README.md	Adds a 60–90 second review section with the fastest local proof command, links to engineering documentation and CI negative controls, and an evidence boundary covering consensus correctness, public-RPC completeness, live-tail reorg handling, and production readiness.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~3 minutes

Change: Other

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly describes the main change: adding an explicit recruiter review path to the portfolio README.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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