docs: sync README files with latest repo state

[yyiilluu]

Summary

• Refreshes the shadow_comparison code-map README to include the new publish-time dispatcher and bounded background worker flow.
• Updates the parent services code map so agents can discover the current shadow-comparison entry points.
• Follows /root/reflexio-enterprise/how_to_write_readme.md for concise, navigation-focused code-map README updates.

Repositories/submodules reviewed

• Parent: ReflexioAI/reflexio-enterprise
• Submodules: ReflexioAI/reflexio, ReflexioAI/claude-smart

README files updated

• reflexio/server/services/README.md
• reflexio/server/services/shadow_comparison/README.md

Validation

• git diff --check
• python /root/.hermes/skills/github/scheduled-code-map-readme-maintenance/scripts/readme_link_check.py "$PWD" reflexio/server/services/README.md reflexio/server/services/shadow_comparison/README.md

Notes/Risks

• No code changes.
• open_source/reflexio/README.md remains untouched because it is the user-facing public README and excluded from code-map restructuring by the policy.

Summary by CodeRabbit

• Documentation
  • Expanded the shadow comparison documentation into a fuller guide covering the publish-time comparison flow, key service components, and expected behavior.
  • Clarified best practices and operational guidance for running comparisons reliably, including how failures are handled and what to avoid during processing.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 4a4538d4-9070-4944-af97-6f2239a63c00

📥 Commits

Reviewing files that changed from the base of the PR and between f94e967 and 50d7d66.

📒 Files selected for processing (2)

• reflexio/server/services/README.md
• reflexio/server/services/shadow_comparison/README.md

---

📝 Walkthrough

Walkthrough

Documentation-only update rewriting descriptions of the shadow_comparison service in two README files, changing from a compact overview to a detailed publish-time background-job pipeline description covering worker, dispatcher, judge, and outcome components.

Changes

Shadow Comparison Documentation

Layer / File(s)	Summary
Pipeline documentation rewrite reflexio/server/services/README.md, reflexio/server/services/shadow_comparison/README.md	Rewrote descriptions of the shadow_comparison service to detail the publish-time pipeline: queued bounded jobs via worker.py, filtering/verdict recording via dispatcher.py, structured LLM judging via judge.py, and win/tie/loss derivation via outcome.py, plus entry points and best-practice requirements.

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

Possibly related PRs

• ReflexioAI/reflexio#104: Introduces/implements the same shadow_comparison pipeline components (worker.py, dispatcher.py, judge.py, outcome.py) documented in this PR.
• ReflexioAI/reflexio#135: Also modifies reflexio/server/services/README.md to document the shadow_comparison service's placement in the services layer.
• ReflexioAI/reflexio#307: Introduced the publish-time shadow comparison pipeline (worker/dispatcher/judge/outcome flow) that this PR's documentation now reflects.

🚥 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 accurately reflects the documentation-only README sync and is specific enough for the main change.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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)

• Create PR with unit tests
• Commit unit tests in branch docs/sync-readmes-20260709

---

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.}