Skip to content

[repo] Adapt governance docs from Blossom template to Open Brain#251

Closed
arpdale wants to merge 3 commits intoNateBJones-Projects:mainfrom
arpdale:contrib/MentorUX/adapt-governance-to-open-brain
Closed

[repo] Adapt governance docs from Blossom template to Open Brain#251
arpdale wants to merge 3 commits intoNateBJones-Projects:mainfrom
arpdale:contrib/MentorUX/adapt-governance-to-open-brain

Conversation

@arpdale
Copy link
Copy Markdown

@arpdale arpdale commented Apr 27, 2026

Contribution Type

  • Repo improvement (docs, CI, templates)

What does this do?

Adapts a set of governance docs that were initially cloned from a Blossom (different project) template so they correctly describe Open Brain. Replaces project-specific bits — 10k-user scale, RLS as primary auth boundary, /api/* routes, Sophie/Inngest/Resend/Stripe references, contacts/activities tables — with Open Brain reality: FSL-1.1-MIT licensing, contribution categories, the canonical thoughts table contract, and remote MCP via Edge Functions.

Adds an explicit Mode 1 / Mode 2 distinction so the heavy workflow (Discovery → Approach → Plan → Self-Review → Completion Summary) applies to committed code, while .planning/ remains a low-friction local maintainer scratch space.

Files

File Treatment
DISCOVERY.md, APPROACH.md Untouched — framework-pure
GOVERNANCE.md, WORKFLOW.md Light: Blossom→Open Brain, fix cross-refs, add Mode 2 carve-out
ROLES.md, CONSTRAINTS.md Targeted: kept structure, replaced project-specific blocking criteria with Open Brain criteria
ARCHITECTURE.md, CONTEXT.md Full rewrites — Open Brain is a contribution repo + upstream user instances, not a SPA
SECURITY.md Replaced TODO-email placeholder with the standard template, adapted for Edge Functions, MCP servers, embedding-cost rate limiting, and SQL safety rules from CLAUDE.md

Requirements

None — repo-internal documentation only. No new services, no new dependencies, no schema changes.

Checklist

  • I've read CONTRIBUTING.md
  • No credentials, API keys, or secrets are included
  • All cross-references between docs resolve to files that exist
  • Self-reviewed under Security Reviewer (no secrets, no leaked credentials)
  • Self-reviewed under Regression Reviewer (cross-refs verified, Mode 2 carve-out consistent across GOVERNANCE/WORKFLOW)

Rollback

git revert <commit> removes the changes cleanly. SECURITY.md reverts to its previous committed form; the other 8 files revert to untracked/absent.

🤖 Generated with Claude Code

arpdale and others added 3 commits April 25, 2026 17:17
Replaces project-specific bits (10k users, RLS as auth boundary, /api/* routes,
Sophie/Inngest/Resend/Stripe references) with Open Brain reality (FSL-1.1-MIT,
contribution categories, thoughts table contract, remote MCP via Edge Functions).

Adds explicit Mode 1 / Mode 2 carve-out so the heavy workflow applies to committed
code while .planning/ remains free for local maintainer experimentation.

Files:
- New: APPROACH, ARCHITECTURE, CONSTRAINTS, CONTEXT, DISCOVERY, GOVERNANCE, ROLES, WORKFLOW
- Modified: SECURITY (replaced TODO-email placeholder with the standard template,
  adapted for Edge Functions / MCP / SQL safety rules from CLAUDE.md guard rails)

DISCOVERY.md and APPROACH.md are framework-pure and unchanged from source.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Apr 27, 2026
@github-actions
Copy link
Copy Markdown

Hey @arpdale — welcome to Open Brain Source! 👋

Thanks for submitting your first PR. The automated review will run shortly and check things like metadata, folder structure, and README completeness. If anything needs fixing, the review comment will tell you exactly what.

Once the automated checks pass, a human admin will review for quality and clarity. Expect a response within a few days.

If you have questions, check out CONTRIBUTING.md or open an issue.

@arpdale
Copy link
Copy Markdown
Author

arpdale commented Apr 27, 2026

Closing — wrong target. Retargeting against my fork (arpdale/open-brain) for personal-repo governance. Apologies for the noise.

@arpdale arpdale closed this Apr 27, 2026
@arpdale arpdale deleted the contrib/MentorUX/adapt-governance-to-open-brain branch April 27, 2026 21:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant