GitHub Project Setup Skill

Automatisch GitHub Issues configureren voor elk nieuw project met labels, templates en decision log.

Trigger (AUTOMATIC)

Claude MOET dit automatisch doen wanneer:

• User begint te werken aan een project (bijv. "ik ga aan X werken", "help me met Y")
• Claude opent een repo/project voor het eerst in een sessie

Stap 1: Check of decision log bestaat

gh issue list --label "decision" --search "[LOG]" --json number -q '.[0].number'

Stap 2: Als LEEG (geen log) → setup uitvoeren

~/bin/setup-project.sh

Stap 3: Decision log lezen voor context

gh issue view [nummer] --json body -q '.body'

Manual Triggers

User kan ook expliciet vragen:

• "setup dit project"
• "maak project klaar"
• "/project-setup"

Wat deze skill doet

1. Labels aanmaken - Task management labels (in-progress, priority:high/low, blocked, etc.)
2. Issue templates kopiëren - Decision, Feature, Bug templates
3. Decision log aanmaken - Lopend logboek issue voor context tussen sessies

Uitvoering

Stap 1: Bepaal repo

# Huidige repo
REPO=$(gh repo view --json nameWithOwner -q '.nameWithOwner')

# Of specifieke repo
REPO="owner/repo-name"

Stap 2: Labels aanmaken

# Task management
gh label create "in-progress" --color "FFA500" --description "Currently working on" --force --repo "$REPO"
gh label create "priority:high" --color "FF0000" --description "Do first" --force --repo "$REPO"
gh label create "priority:low" --color "0E8A16" --description "When time permits" --force --repo "$REPO"
gh label create "blocked" --color "D93F0B" --description "Waiting on something" --force --repo "$REPO"

# Types
gh label create "bug" --color "D73A4A" --description "Something broken" --force --repo "$REPO"
gh label create "feature" --color "0075CA" --description "New functionality" --force --repo "$REPO"
gh label create "decision" --color "7057FF" --description "Architecture/design decision" --force --repo "$REPO"
gh label create "docs" --color "0052CC" --description "Documentation" --force --repo "$REPO"
gh label create "refactor" --color "FBCA04" --description "Code improvement" --force --repo "$REPO"

Stap 3: Issue templates kopiëren

Kopieer van ~/.github-templates/ISSUE_TEMPLATE/ naar .github/ISSUE_TEMPLATE/ in de repo:

• decision.md
• feature.md
• bug.md

Stap 4: Decision log aanmaken

Maak een issue aan met titel [LOG] {Project Name} Development Log en label decision.

Template voor decision log body:

# {Project Name} Development Log

Dit issue is een lopend logboek van beslissingen, voortgang en context.
**Niet afsluiten** - dit blijft open als referentie.

---

## Huidige Status
- **Laatste sessie:** {datum}
- **Focus:** ...

---

## Architectuur Beslissingen
<!-- Belangrijke keuzes en waarom -->

---

## Lopende Taken
- [ ] ...

---

## Sessie Log
<!-- Voeg toe per sessie, nieuwste bovenaan -->

### {datum}
- Project setup voltooid
- GitHub Issues geconfigureerd

Quick Commands

Na setup kan de user deze commands gebruiken:

Command	Wat het doet
gh issue list	Lijst open taken
gh issue create	Nieuwe taak (met template keuze)
gh issue view 1	Lees decision log
gh issue edit 1 --body "..."	Update decision log

Session Workflow

Start sessie:

User: "Ik ga werken aan {project}, lees het log"
Claude: gh issue view {log-nummer} --repo {repo}

Einde sessie:

User: "Update het log"
Claude: Voegt sessie entry toe aan decision log issue

Bestaande Scripts

• ~/bin/setup-github-issues.sh - Labels aanmaken
• ~/bin/copy-issue-templates.sh - Templates kopiëren