synaptiai/repo-config

Repository Configuration

Reference skill loaded into agent context via skills: repo-config. Provides patterns for dynamic repository detection so agents never hardcode branch names, repo identifiers, or conventions.

Core Commands

Default Branch

Used by code-reviewer for diff base and convention-checker for commit range:

DEFAULT_BRANCH=$(gh repo view --json defaultBranchRef --jq '.defaultBranchRef.name')

# Usage in agents:
git diff origin/$DEFAULT_BRANCH..HEAD           # code-reviewer
git log --oneline $DEFAULT_BRANCH..HEAD         # convention-checker

Repository Owner/Name

Used by implementation-planner for GitHub API calls:

REPO=$(gh repo view --json nameWithOwner --jq '.nameWithOwner')

# Usage in agents:
gh api repos/$REPO/issues/$ISSUE_NUMBER/comments
gh api repos/$REPO/pulls/$PR_NUMBER/comments

Combined Fetch

When multiple values are needed, minimize API calls:

gh repo view --json nameWithOwner,defaultBranchRef --jq '{
  repo: .nameWithOwner,
  default_branch: .defaultBranchRef.name
}'

Conventions

Used by convention-checker to validate branch names and commit messages. These defaults are configurable via settings.gh-workflow.json (see conventions.* keys in schema.json). Commands may also override with project-specific conventions from CLAUDE.md — check CLAUDE.md first, then settings, then these defaults.

Branch Naming

Configurable via .conventions.branchPatterns and .conventions.additionalBranchTypes in settings.

| Type | Default Pattern | Example | |------|----------------|---------| | Feature | feature/issue-{N}-{desc} | feature/issue-42-add-login | | Fix | fix/issue-{N}-{desc} | fix/issue-13-typo | | Docs | docs/issue-{N}-{desc} | docs/issue-7-readme |

Additional branch types can be added via .conventions.additionalBranchTypes (e.g., {"refactor": "refactor/issue-{N}-{desc}", "chore": "chore/issue-{N}-{desc}"}).

Commit Prefixes

Configurable via .conventions.commitTypes in settings.

| Prefix | Usage | |--------|-------| | feat: | New features | | fix: | Bug fixes | | docs: | Documentation | | refactor: | Code refactoring | | test: | Test changes | | chore: | Maintenance |

Detecting Project-Specific Conventions

# Check CLAUDE.md first (preferred source)
CLAUDE_MD=""
[ -f ".claude/CLAUDE.md" ] && CLAUDE_MD=".claude/CLAUDE.md"
[ -z "$CLAUDE_MD" ] && [ -f "CLAUDE.md" ] && CLAUDE_MD="CLAUDE.md"
[ -n "$CLAUDE_MD" ] && grep -A5 -E "(Branch|Commit|Convention)" "$CLAUDE_MD" 2>/dev/null

# Fall back to inferring from existing patterns
git for-each-ref --sort=-committerdate --format='%(refname:short)' refs/remotes/origin/ | head -10
git log --oneline -20

Agent Integration

This skill is loaded into agent context via skills: repo-config in agent frontmatter:

| Agent | What it needs | Key commands | |-------|--------------|--------------| | code-reviewer | DEFAULT_BRANCH for diff base | git diff origin/$DEFAULT_BRANCH..HEAD | | convention-checker | DEFAULT_BRANCH for commit range, conventions for validation | git log $DEFAULT_BRANCH..HEAD, branch/commit patterns | | implementation-planner | REPO for GitHub API calls | gh api repos/$REPO/issues/... | | test-runner | Declared but not directly used | — |

Error Handling

If gh commands fail:

| Check | Command | Fix | |-------|---------|-----| | Authentication | gh auth status | Run gh auth login | | Git repository | git rev-parse --git-dir | Navigate to a git repo or run git init | | GitHub remote | git remote -v | Add with git remote add origin <url> |