Files
skills/public/collaboration-github-repository-management.html
zeekay 747dafba10 Register WebMCP tools on every page, and name each page's twin from site.py
Every page now loads /webmcp.js, scripts/webmcp.ts with its types
stripped (npm run webmcp). Where the browser has document.modelContext
it registers two read-only tools: search_skills over the published
skills index, and get_skill, which returns a skill's markdown checked
against the index digest. The markdown alternate link moves from
build.py to site.py, so CI holds every page to it.

The API catalog gains the site itself (llms.txt and the skills index)
and hanzo.ai/agents; the live discovery check now fetches every
catalog link. tests/site.mjs drives the tools through a recording
modelContext, and checks a browser without one loads clean.
2026-10-26 20:57:05 -07:00

586 lines
26 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>collaboration-github-repository-management</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/collaboration-github-repository-management">
<link rel="alternate" type="text/markdown" href="/collaboration-github-repository-management.md">
<script type="module" src="/webmcp.js"></script>
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/collaboration-github-repository-management.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>collaboration-github-repository-management</h1><p class="lede">Repository creation, configuration, branch protection, tags, releases, and GitHub CLI operations</p><h1>GitHub Repository Management</h1>
<p><strong>Scope</strong>: Repository creation and configuration, branch management, branch protection rules, tags and releases, GitHub CLI operations, repository settings and templates</p>
<p><strong>Lines</strong>: ~280</p>
<p><strong>Last Updated</strong>: 2025-10-25</p>
<p><strong>Format Version</strong>: 1.0 (Atomic)</p>
<hr>
<h2>When to Use This Skill</h2>
<p>Activate this skill when:</p>
<ul><li>Creating and configuring new GitHub repositories</li><li>Setting up branch protection rules and required reviews</li><li>Managing releases with semantic versioning and release notes</li><li>Using GitHub CLI for repository operations</li><li>Configuring repository settings: webhooks, secrets, environments</li><li>Creating repository, issue, and PR templates</li><li>Setting default branches and branch naming conventions</li><li>Generating changelogs and managing tags</li></ul>
<hr>
<h2>Core Concepts</h2>
<h3>Repository Structure</h3>
<p><strong>Key components</strong>:</p>
<ul><li><strong>Default branch</strong>: Main development branch (main or master)</li><li><strong>Protected branches</strong>: Branches with enforcement rules</li><li><strong>Environments</strong>: Deployment targets with secrets and protection rules</li><li><strong>Webhooks</strong>: HTTP callbacks for repository events</li><li><strong>Secrets</strong>: Encrypted environment variables</li><li><strong>Templates</strong>: Standardized issue and PR formats</li></ul>
<pre><code class="lang-bash"># Repository hierarchy
repository/
├── .github/
│ ├── workflows/ # GitHub Actions
│ ├── ISSUE_TEMPLATE/ # Issue templates
│ ├── PULL_REQUEST_TEMPLATE.md
│ └── dependabot.yml
├── src/ # Source code
├── README.md
├── LICENSE
└── SECURITY.md</code></pre>
<h3>Branch Protection</h3>
<p><strong>Protection rules enforce</strong>:</p>
<ul><li>Required status checks before merging</li><li>Required reviews (count and approval)</li><li>Dismissal of stale reviews</li><li>Required linear history</li><li>Signed commits</li><li>Administrator enforcement</li></ul>
<h3>GitHub CLI Workflow</h3>
<pre><code class="lang-bash"># Authentication flow
gh auth login
gh auth status
# Repository operations
gh repo create → gh repo view → gh repo edit
↓
Branch protection → PR workflow → Release
↓
Cleanup and archival</code></pre>
<hr>
<h2>Patterns</h2>
<h3>Creating Repositories with GitHub CLI</h3>
<pre><code class="lang-bash"># Create new repository (interactive)
gh repo create my-project
# Create with flags
gh repo create my-project \
--public \
--description &quot;Project description&quot; \
--gitignore Node \
--license MIT
# Create from template
gh repo create my-project \
--template owner/template-repo \
--private
# Create and clone
gh repo create my-project --clone
# Initialize existing directory
cd existing-project
gh repo create --source=. --remote=origin --push</code></pre>
<h3>Repository Configuration</h3>
<pre><code class="lang-bash"># View repository details
gh repo view owner/repo
# Edit repository settings
gh repo edit owner/repo \
--description &quot;New description&quot; \
--homepage &quot;https://example.com&quot; \
--default-branch main \
--enable-issues=true \
--enable-wiki=false
# Archive repository
gh repo archive owner/repo
# Delete repository (careful!)
gh repo delete owner/repo --confirm</code></pre>
<h3>Branch Protection Rules</h3>
<p><strong>Via GitHub CLI</strong>:</p>
<pre><code class="lang-bash"># Enable branch protection (requires API)
gh api repos/owner/repo/branches/main/protection \
--method PUT \
--field required_status_checks=&#x27;{&quot;strict&quot;:true,&quot;contexts&quot;:[&quot;ci/build&quot;,&quot;ci/test&quot;]}&#x27; \
--field enforce_admins=true \
--field required_pull_request_reviews=&#x27;{&quot;required_approving_review_count&quot;:2}&#x27; \
--field restrictions=null</code></pre>
<p><strong>Via Web UI</strong> (recommended for complex rules):</p>
<ol><li>Settings → Branches → Add rule</li><li>Configure:</li></ol>
<ul><li>Require pull request before merging</li><li>Require approvals: 1-6 reviewers</li><li>Dismiss stale reviews when new commits pushed</li><li>Require review from Code Owners</li><li>Require status checks to pass</li><li>Require conversation resolution</li><li>Require signed commits</li><li>Require linear history</li></ul>
<p><strong>Protection rule pattern</strong>:</p>
<pre><code class="lang-yaml"># Common protection for main branch
Branch pattern: main
✅ Require pull request reviews (2 approvals)
✅ Dismiss stale reviews
✅ Require review from Code Owners
✅ Require status checks (ci/build, ci/test)
✅ Require branches to be up to date
✅ Require conversation resolution
✅ Include administrators</code></pre>
<h3>Tags and Releases</h3>
<p><strong>Creating tags</strong>:</p>
<pre><code class="lang-bash"># Create annotated tag (recommended)
git tag -a v1.0.0 -m &quot;Release version 1.0.0&quot;
git push origin v1.0.0
# Create lightweight tag
git tag v1.0.0
git push origin v1.0.0
# List tags
git tag -l
# Delete tag
git tag -d v1.0.0
git push origin :refs/tags/v1.0.0</code></pre>
<p><strong>Semantic versioning</strong>:</p>
<pre><code>MAJOR.MINOR.PATCH (1.2.3)
MAJOR: Breaking changes (1.x.x → 2.0.0)
MINOR: New features, backward compatible (1.2.x → 1.3.0)
PATCH: Bug fixes, backward compatible (1.2.3 → 1.2.4)
Pre-release: 1.0.0-alpha.1, 1.0.0-beta.2, 1.0.0-rc.1</code></pre>
<p><strong>Creating releases with GitHub CLI</strong>:</p>
<pre><code class="lang-bash"># Create release from tag
gh release create v1.0.0 \
--title &quot;Version 1.0.0&quot; \
--notes &quot;Release notes here&quot;
# Create release with assets
gh release create v1.0.0 \
--title &quot;Version 1.0.0&quot; \
--notes-file CHANGELOG.md \
dist/*.tar.gz dist/*.zip
# Create draft release
gh release create v1.0.0 \
--draft \
--title &quot;Version 1.0.0&quot; \
--notes &quot;Draft release&quot;
# Generate release notes automatically
gh release create v1.0.0 --generate-notes
# List releases
gh release list
# View specific release
gh release view v1.0.0
# Download release assets
gh release download v1.0.0</code></pre>
<h3>Repository Templates</h3>
<p><strong>Issue template</strong> (.github/ISSUE_TEMPLATE/bug_report.md):</p>
<pre><code class="lang-markdown">---
name: Bug Report
about: Report a bug to help us improve
title: &#x27;[BUG] &#x27;
labels: bug
assignees: &#x27;&#x27;
---
## Bug Description
A clear description of the bug.
## Steps to Reproduce
1. Go to &#x27;...&#x27;
2. Click on &#x27;...&#x27;
3. See error
## Expected Behavior
What should happen.
## Actual Behavior
What actually happens.
## Environment
- OS: [e.g., macOS 14.0]
- Browser: [e.g., Chrome 120]
- Version: [e.g., 1.2.3]
## Additional Context
Screenshots, logs, or other context.</code></pre>
<p><strong>Pull request template</strong> (.github/PULL_REQUEST_TEMPLATE.md):</p>
<pre><code class="lang-markdown">## Summary
Brief description of changes.
## Type of Change
- [ ] Bug fix
- [ ] New feature
- [ ] Breaking change
- [ ] Documentation update
## Testing
- [ ] Unit tests pass
- [ ] Integration tests pass
- [ ] Manual testing completed
## Checklist
- [ ] Code follows style guidelines
- [ ] Self-review completed
- [ ] Comments added for complex logic
- [ ] Documentation updated
- [ ] No new warnings generated
## Related Issues
Closes #123
Related to #456</code></pre>
<h3>Repository Secrets and Environments</h3>
<p><strong>Managing secrets with GitHub CLI</strong>:</p>
<pre><code class="lang-bash"># Set repository secret
gh secret set API_KEY &lt; api_key.txt
# Set secret with value
echo &quot;secret-value&quot; | gh secret set SECRET_NAME
# List secrets
gh secret list
# Delete secret
gh secret delete SECRET_NAME
# Set environment secret
gh secret set API_KEY --env production</code></pre>
<p><strong>Configuring environments</strong> (via Web UI):</p>
<ol><li>Settings → Environments → New environment</li><li>Configure:</li></ol>
<ul><li>Environment protection rules</li><li>Required reviewers before deployment</li><li>Wait timer (delay before deployment)</li><li>Environment secrets</li><li>Deployment branches (limit to specific branches)</li></ul>
<h3>Webhooks Configuration</h3>
<pre><code class="lang-bash"># Create webhook via API
gh api repos/owner/repo/hooks \
--method POST \
--field name=web \
--field config[url]=https://example.com/webhook \
--field config[content_type]=json \
--field events[]=&quot;push&quot; \
--field events[]=&quot;pull_request&quot;
# List webhooks
gh api repos/owner/repo/hooks
# Delete webhook
gh api repos/owner/repo/hooks/123 --method DELETE</code></pre>
<hr>
<h2>Quick Reference</h2>
<h3>GitHub CLI Commands</h3>
<pre><code class="lang-bash"># Authentication
gh auth login # Authenticate with GitHub
gh auth status # Check authentication status
gh auth logout # Log out
# Repository operations
gh repo create [name] # Create repository
gh repo clone owner/repo # Clone repository
gh repo view [owner/repo] # View repository details
gh repo edit [owner/repo] # Edit repository settings
gh repo fork owner/repo # Fork repository
gh repo sync owner/repo # Sync fork with upstream
# Release management
gh release create &lt;tag&gt; # Create release
gh release list # List releases
gh release view &lt;tag&gt; # View release details
gh release download &lt;tag&gt; # Download release assets
gh release delete &lt;tag&gt; # Delete release
# Secret management
gh secret set &lt;name&gt; # Set secret
gh secret list # List secrets
gh secret delete &lt;name&gt; # Delete secret</code></pre>
<h3>Semantic Versioning Quick Guide</h3>
<pre><code>Version format: MAJOR.MINOR.PATCH
Breaking change: 1.0.0 → 2.0.0
New feature: 1.2.0 → 1.3.0
Bug fix: 1.2.3 → 1.2.4
Pre-release tags:
- alpha: 1.0.0-alpha.1
- beta: 1.0.0-beta.1
- rc: 1.0.0-rc.1</code></pre>
<h3>Branch Protection Checklist</h3>
<pre><code>✅ DO: Protect main/production branches
✅ DO: Require 1-2 approvals for PRs
✅ DO: Require status checks to pass
✅ DO: Dismiss stale reviews on new commits
✅ DO: Require conversation resolution
✅ DO: Require linear history for clean git log
❌ DON&#x27;T: Allow direct pushes to protected branches
❌ DON&#x27;T: Skip status checks for administrators (unless necessary)
❌ DON&#x27;T: Allow force pushes to protected branches</code></pre>
<hr>
<h2>Anti-Patterns</h2>
<h3>❌ No Branch Protection</h3>
<pre><code class="lang-bash"># WRONG: Allow direct pushes to main
# Anyone can push without review
git push origin main</code></pre>
<p><strong>Problems</strong>:</p>
<ul><li>No code review process</li><li>Untested code reaches production</li><li>No audit trail</li></ul>
<pre><code class="lang-bash"># CORRECT: Require PRs and reviews
# Settings → Branches → Add rule for main
# ✅ Require pull request reviews (2 approvals)
# ✅ Require status checks</code></pre>
<h3>❌ Hardcoded Secrets in Repository</h3>
<pre><code class="lang-yaml"># WRONG: Secrets in workflow file
env:
API_KEY: &quot;sk-abc123xyz&quot;
DATABASE_PASSWORD: &quot;password123&quot;</code></pre>
<p><strong>Problems</strong>:</p>
<ul><li>Secrets visible in git history</li><li>Security breach risk</li><li>Difficult to rotate credentials</li></ul>
<pre><code class="lang-yaml"># CORRECT: Use GitHub Secrets
env:
API_KEY: ${{ secrets.API_KEY }}
DATABASE_PASSWORD: ${{ secrets.DATABASE_PASSWORD }}
# Set via CLI
gh secret set API_KEY &lt; api_key.txt</code></pre>
<h3>❌ No Release Process</h3>
<pre><code class="lang-bash"># WRONG: Push tags without documentation
git tag v1.0.0 &amp;&amp; git push origin v1.0.0
# No release notes, no changelog</code></pre>
<p><strong>Problems</strong>:</p>
<ul><li>Users don&#x27;t know what changed</li><li>No downloadable assets</li><li>Difficult to track versions</li></ul>
<pre><code class="lang-bash"># CORRECT: Create proper releases
gh release create v1.0.0 \
--title &quot;Version 1.0.0&quot; \
--notes-file CHANGELOG.md \
dist/*.tar.gz
# Include:
# - Version number (semantic versioning)
# - Release notes (what changed)
# - Downloadable assets (binaries, archives)</code></pre>
<h3>❌ Missing Templates</h3>
<p><strong>Problems</strong>:</p>
<ul><li>Inconsistent issue reports</li><li>Missing information in PRs</li><li>Wasted time asking for details</li></ul>
<pre><code class="lang-bash"># CORRECT: Create templates
mkdir -p .github/ISSUE_TEMPLATE
# Add bug report template
# Add feature request template
# Add pull request template
# Commit templates
git add .github/
git commit -m &quot;Add issue and PR templates&quot;</code></pre>
<h3>❌ Default Branch Named &#x27;master&#x27;</h3>
<pre><code class="lang-bash"># WRONG: Using outdated default branch name
# main branch is called &#x27;master&#x27;</code></pre>
<pre><code class="lang-bash"># CORRECT: Use &#x27;main&#x27; as default branch
# Rename existing repository
git branch -m master main
git push -u origin main
# Update default branch on GitHub
gh repo edit owner/repo --default-branch main
# Delete old remote branch
git push origin --delete master</code></pre>
<hr>
<h2>Related Skills</h2>
<ul><li><code>collaboration/github/github-pull-requests.md</code> - PR workflow and code review process</li><li><code>collaboration/github/github-actions-workflows.md</code> - CI/CD automation with branch protection</li><li><code>collaboration/github/github-security-features.md</code> - Security settings and dependency management</li><li><code>collaboration/github/github-issues-projects.md</code> - Issue templates and project management</li><li><code>cicd/ci-security.md</code> - Secret management best practices</li><li><code>version-control/git-branching-strategies.md</code> - Branch naming and workflow strategies</li></ul>
<hr>
<p><strong>Last Updated</strong>: 2025-10-25</p>
<p><strong>Format Version</strong>: 1.0 (Atomic)</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/collaboration-github-repository-management.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>