Skip to content

Adopt the governance profile in the organization configuration repository #2685

Open

Description

@codeforester

Problem

The accepted Base governance design and implementation plan identify package 12/.github as a required deliverable. This issue translates that package into a reviewed, bounded issue/PR train; it does not authorize implementation before the issue reaches Ready.

Expected behavior

Inventory and apply only the governance requirements applicable to basefoundry/.github, the organization-configuration repository. GitHub Issues are disabled there, so this Base-repository tracking issue owns the work and its PR must link back to this tracker using the full issue URL. Do not enable repository Issues as a side effect. Treat this repository as a special organization-config profile; do not require a Base manifest or consumer governance/ folder unless a separately reviewed decision justifies it.

Scope and non-goals

Scope: Inventory and apply only the governance requirements applicable to basefoundry/.github, the organization-configuration repository. GitHub Issues are disabled there, so this Base-repository tracking issue owns the work and its PR must link back to this tracker using the full issue URL. Do not enable repository Issues as a side effect. Treat this repository as a special organization-config profile; do not require a Base manifest or consumer governance/ folder unless a separately reviewed decision justifies it.

Non-goals: Do not silently expand scope, activate unreviewed policy, mirror issue fields onto PRs, grant agents merge/release authority, or make changes outside the named affected areas. Any new product decision or materially new work gets a separate issue and decision record.

Affected areas

Impact and evidence

  1. Product intent: Implements only the accepted governance design and plan; any product-requirement change must be filed separately.
  2. Architecture and contracts: Destination is the package-specific section of the merged governance design/implementation plan plus the affected canonical contract named above.
  3. User guidance: The issue identifies likely guidance paths; the implementation PR must name updated user/FAQ/README paths or give a change-specific reason why none is affected.
  4. CLI/API and reference: The affected-area list determines whether CLI/API/reference docs change; the implementation PR must cite the exact reference path or justify no impact.
  5. Operations and safety: No privileged automation or merge authority is implied; the PR must list operational/security effects and any rollback.
  6. Validation and testing: The issue lists the planned tests; the PR must report executed validation and explain any unavailable test.
  7. Examples and downstream use: The implementation PR must identify affected examples/consumers or give evidence that this change has no downstream surface.
  8. Governance and contributor process: This package changes or preserves the contributor/governance contract as described in Scope; links must point to the canonical rules.
  9. Decision records: No new decision is accepted by this issue; any durable deviation requires a proposed decision record and explicit maintainer acceptance.
  10. Release notes: The PR must include a user-facing release-note line or a reasoned none; this issue does not pre-decide that disposition.

These are issue-stage dispositions to refine during Triage. Before Ready, every category must have its exact destination or evidence-based no-impact reason; the PR repeats the ten-category evidence for actual changes.

Open questions

  • None known. If implementation exposes an unresolved contract, return this issue to Triage and record the decision before implementation continues.

Plan

  • S1: One focused PR for this issue. Use Fixes #N only if no additional slice is needed; if the maintainer approves multiple PRs, name each S1…Sn here before the first is opened and use Part of #N.
  • Dependencies: the P2 issue, the P5a issue, the P8a issue, the P9 issue, the P16a issue, the P17 issue, the P19 issue, the P20 issue
  • Acceptance criteria:
  • The current .github repository contents, default templates, workflows, branch rules and issue-disabled setting are inventoried.
  • Applicable org-level templates/policy are aligned with the accepted issue/PR contracts and do not contradict repo-specific configurations.
  • Any non-applicable manifest/Project requirements have an evidence-backed no-impact disposition.
  • The PR links to this Base issue, and issue-disabled state remains unchanged unless a separate explicit maintainer decision is recorded.
  • All title and template changes have a rollback path and no org-wide policy is activated implicitly.
  • Validation:
  • Validate templates/workflows in the target repository and test fixture rendering/contract checks.
  • Read back issue-disabled and branch policy settings.
  • Compare effective org templates against representative repositories.
  • Risks and rollback: Org defaults can affect every repository; stage with a preview inventory, keep repo-specific exceptions explicit and revert the PR if any consumer contract breaks.
  • Decision impact: No decision is accepted merely by implementing the issue. Record the relevant accepted decision/ADR and file a superseding record if the maintainer approves a change.

Activity

  1. self-assigned this
    on Nov 10, 2026
  2. added this to the v1.11.0 milestone on Nov 11, 2026
  3. codeforester commented on Nov 11, 2026

    @codeforester
    CollaboratorAuthor

    Pre-Triage review against the accepted plan (#2664, tracker #2665)

    1. This is the template change for seven repos. basefoundry/.github holds the org default ISSUE_TEMPLATE/ (bug_report, documentation, feature_request, support and config) and PULL_REQUEST_TEMPLATE.md. Seven repos have no issue forms of their own and use these defaults: base-demo, base-bash-libs-demo, base-cli-demo, base-workspace, base-platform-tools, banyanlabs and homebrew-base. homebrew-base also uses the org PR template. So this issue is where those repos get the single issue form.
    2. Suggested slices. Slice S1 for the templates, right after Use one issue form and a reviewed Ready checklist #2667 and Define the pull request template and documentation-impact contract #2669, and slice S2 for the rest. Template changes don't need the pinned-enforcement gates (Add warn-only governance checks and an expiring maintainer override record #2682, Pin the released governance checker and promote rules from evidence #2683), and the seven repos' adoption issues should depend on S1.
    3. Category labels. The org forms also apply category labels, so they have the same labeling question as Use one issue form and a reviewed Ready checklist #2667.

    Dependencies text. Replace the the P… issue placeholders with #2667, #2669, #2672, #2674, #2680, #2583, #2682 and #2683. The native blocked-by links are already correct; the body is what a reviewer reads.

    Contract text. The Impact, Scope and Open questions sections are still the shared template text. The Impact section is identical in 24 of #2666–#2690, and Scope repeats Expected behavior. That's fine in Backlog. Before Ready, replace each with this issue's own dispositions.

    Claude Code (Opus 5.5), reviewing from Ramesh's account at his request. This review comes before Triage, so it is not an issue-loop round.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

enhancementNew feature or product improvement

Type

Projects

  • Status
    Backlog

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions