Skip to content

docs: rewrite root README for org operators - #1113

Draft
seonghobae wants to merge 3 commits into
mainfrom
cursor/operator-readme-8f20
Draft

docs: rewrite root README for org operators#1113
seonghobae wants to merge 3 commits into
mainfrom
cursor/operator-readme-8f20

Conversation

@seonghobae

@seonghobae seonghobae commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

Rewrite the root README for the org operator and sibling-repo maintainers. This repository is the ContextualWisdomLab org profile source and the central required-workflow source. It runs alone. Siblings consume it by inheriting organization ruleset 18156473 (CWL Central required workflows); they do not copy workflow files.

What changed

  • README.md is now the buyer/operator story: what this repo is, where the public profile lives (profile/README.md), current ruleset status, how to run this repo alone, and how a sibling consumes the central workflows (MSA 따로 또 같이).
  • docs/pr-review-and-merge-procedure.md keeps the previous bot/agent operational truth (exact-head CI, successor heads, do-not-merge / DIRTY–CONFLICTING repair, writer boundaries, approve-gate, OpenCode/Strix scheduler details). Nothing in that contract was deleted.
  • Pointers in PR_GOVERNANCE_AUDIT.md, CLAUDE.md, and ARCHITECTURE.md now send agents to the procedure doc instead of treating the root README as the review manual.
  • CI fix: scripts/ci/test_strix_quick_gate.sh now asserts those procedure strings in docs/pr-review-and-merge-procedure.md and keeps a README pointer. That was the failing Strix Changed Path Quality CI / exact-head-path-policy check.

Naruon remains the composition hub that can receive other CWL products. This README does not treat that as a bug, and this control plane still documents an independent run without naruon.

Existing APA 7th DIKW citations stay in profile/README.md. No new citations were invented.

Verification

  • pytest tests/test_pr_governance_audit_contract.py tests/test_central_required_workflow_ruleset_audit.py — 18 passed
  • Retargeted Strix prose needles verified present in the procedure doc and README pointer

Test plan

  • Confirm the root README reads as an operator/sibling-maintainer guide, not a bot review manual
  • Confirm docs/pr-review-and-merge-procedure.md still contains exact-head, successor-head, DIRTY/CONFLICTING, writer-boundary, and approve-gate procedure
  • Confirm a sibling maintainer can see that they inherit ruleset 18156473 and must not copy Strix/OpenCode/Noema/scheduler files
  • Confirm Strix Changed Path Quality CI / exact-head-path-policy is green on this head
Open in Web Open in Cursor 

cursoragent and others added 2 commits August 17, 2026 15:18
Replace the bot/agent PR-review manual in README.md with an org-operator
and sibling-maintainer overview: profile location, standalone run, and
how siblings consume ruleset 18156473 without copying workflows. Keep the
operational contract in docs/pr-review-and-merge-procedure.md.

Co-authored-by: Seongho Bae <seonghobae@users.noreply.github.com>
Keep the profile pointer for existing APA 7th DIKW references without
telling the operator what this README does not invent.

Co-authored-by: Seongho Bae <seonghobae@users.noreply.github.com>
@coderabbitai

coderabbitai Bot commented Aug 17, 2026

Copy link
Copy Markdown

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 88da9fe6-791b-4aad-8ade-b7abe0646656

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

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

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

The changed-path quality gate still required bot-procedure phrases in
README.md after those sentences moved to
docs/pr-review-and-merge-procedure.md. Keep the operator README as a
pointer and assert the operational strings in the procedure file.

Co-authored-by: Seongho Bae <seonghobae@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants