Git Templates

GitHub repo bootstrap files — CODEOWNERS, pull-request template, branch-protection rules guide, CI workflow. The artifacts that encode ADR-0001 (solo operator with disciplined review) in every Abukix repo.

Four files. Each one lands in .github/ (or repo root) of a new Abukix repo. Together they encode the workflow ADR-0001 mandates: PR + CI + overnight wait + (consequential cases) external review.

What’s in this family

TemplateDestination in target repoPurpose
CODEOWNERS.github/CODEOWNERS (or CODEOWNERS at repo root)Declares who owns each path; enables required code-owner reviews.
pull-request-template.md.github/pull_request_template.mdPrompts the PR author for summary, validation, risk, public-safety check.
branch-protection-rules.mdDocumentation only (not a YAML file)The branch protection rules to configure via GitHub UI or gh api. GitHub doesn’t store these declaratively by default.
ci-check.yml.github/workflows/ci-check.ymlGitHub Actions workflow running required CI checks: gitleaks, flux validate, kustomize build, kyverno test, go test.

When to use

Copy these into:

  • basecamp when it goes public at Y3 Phase 24
  • Each OSS project repo (rxp, pulse, triage, terralabs, platform-ctl, data-tier, llm-gateway, mcp-servers, aiops, studio) when it ships per its phase
  • The ops-handbook repo (private, Y1 Phase 1) — same templates, just on a private repo

Bootstrap recipe

cd <new-repo>
mkdir -p .github/workflows

# Copy the file templates:
cp ~/abukix-root/root/src/content/docs/meta/git-templates/CODEOWNERS                .github/CODEOWNERS
cp ~/abukix-root/root/src/content/docs/meta/git-templates/pull-request-template.md  .github/pull_request_template.md
cp ~/abukix-root/root/src/content/docs/meta/git-templates/ci-check.yml              .github/workflows/ci-check.yml

# Search-replace placeholders:
sed -i '' 's|@<your-handle>|@<actual-github-handle>|g' .github/CODEOWNERS

# Configure branch protection per the rules doc:
# See: ~/abukix-root/root/src/content/docs/meta/git-templates/branch-protection-rules.md

After committing the files, configure the branch protection rules following branch-protection-rules.md. That step is one-time per repo via gh api or the GitHub UI.

Cross-references