@phuc1403/musketeer 0.7.0 → 0.9.0

package/template/.claude/skills/git/references/branch-management.md

@@ -1,88 +1,88 @@
-# Branch Management
-
-## Naming Convention
-
-**Format:** `<type>/<descriptive-name>`
-
-| Type | Purpose | Example |
-|------|---------|---------|
-| `feature/` | New features | `feature/oauth-login` |
-| `fix/` | Bug fixes | `fix/db-timeout` |
-| `refactor/` | Code restructure | `refactor/api-cleanup` |
-| `docs/` | Documentation | `docs/api-reference` |
-| `test/` | Test improvements | `test/integration-suite` |
-| `chore/` | Maintenance | `chore/deps-update` |
-| `hotfix/` | Production fixes | `hotfix/payment-crash` |
-
-## Branch Lifecycle
-
-### Create
-```bash
-git checkout main
-git pull origin main
-git checkout -b feature/new-feature
-```
-
-### During Development
-```bash
-# Regular commits
-git add <files> && git commit -m "feat(scope): description"
-
-# Stay current with main
-git fetch origin
-git rebase origin/main
-```
-
-### Before Merge
-```bash
-# Push final state
-git push origin feature/new-feature
-
-# Or after rebase (feature branches only)
-git push -f origin feature/new-feature
-```
-
-### After Merge
-```bash
-# Delete local
-git branch -d feature/new-feature
-
-# Delete remote
-git push origin --delete feature/new-feature
-```
-
-## Branch Strategies
-
-### Simple (small teams)
-```
-main (production)
-  └─ feature/* (development)
-```
-
-### Git Flow (releases)
-```
-main (production)
-develop (staging)
-  ├─ feature/*
-  ├─ bugfix/*
-  ├─ hotfix/*
-  └─ release/*
-```
-
-### Trunk-Based (CI/CD)
-```
-main (always deployable)
-  └─ short-lived feature branches
-```
-
-## Quick Commands
-
-| Task | Command |
-|------|---------|
-| List branches | `git branch -a` |
-| Current branch | `git rev-parse --abbrev-ref HEAD` |
-| Switch branch | `git checkout <branch>` |
-| Create + switch | `git checkout -b <branch>` |
-| Delete local | `git branch -d <branch>` |
-| Delete remote | `git push origin --delete <branch>` |
-| Rename | `git branch -m <old> <new>` |
+# Branch Management
+
+## Naming Convention
+
+**Format:** `<type>/<descriptive-name>`
+
+| Type | Purpose | Example |
+|------|---------|---------|
+| `feature/` | New features | `feature/oauth-login` |
+| `fix/` | Bug fixes | `fix/db-timeout` |
+| `refactor/` | Code restructure | `refactor/api-cleanup` |
+| `docs/` | Documentation | `docs/api-reference` |
+| `test/` | Test improvements | `test/integration-suite` |
+| `chore/` | Maintenance | `chore/deps-update` |
+| `hotfix/` | Production fixes | `hotfix/payment-crash` |
+
+## Branch Lifecycle
+
+### Create
+```bash
+git checkout main
+git pull origin main
+git checkout -b feature/new-feature
+```
+
+### During Development
+```bash
+# Regular commits
+git add <files> && git commit -m "feat(scope): description"
+
+# Stay current with main
+git fetch origin
+git rebase origin/main
+```
+
+### Before Merge
+```bash
+# Push final state
+git push origin feature/new-feature
+
+# Or after rebase (feature branches only)
+git push -f origin feature/new-feature
+```
+
+### After Merge
+```bash
+# Delete local
+git branch -d feature/new-feature
+
+# Delete remote
+git push origin --delete feature/new-feature
+```
+
+## Branch Strategies
+
+### Simple (small teams)
+```
+main (production)
+  └─ feature/* (development)
+```
+
+### Git Flow (releases)
+```
+main (production)
+develop (staging)
+  ├─ feature/*
+  ├─ bugfix/*
+  ├─ hotfix/*
+  └─ release/*
+```
+
+### Trunk-Based (CI/CD)
+```
+main (always deployable)
+  └─ short-lived feature branches
+```
+
+## Quick Commands
+
+| Task | Command |
+|------|---------|
+| List branches | `git branch -a` |
+| Current branch | `git rev-parse --abbrev-ref HEAD` |
+| Switch branch | `git checkout <branch>` |
+| Create + switch | `git checkout -b <branch>` |
+| Delete local | `git branch -d <branch>` |
+| Delete remote | `git push origin --delete <branch>` |
+| Rename | `git branch -m <old> <new>` |

package/template/.claude/skills/git/references/commit-standards.md

@@ -1,46 +1,46 @@
-# Commit Message Standards
-
-## Format
-```
-type(scope): description
-```
-
-## Types (priority order)
-- `feat`: New feature
-- `fix`: Bug fix
-- `docs`: Documentation only
-- `style`: Formatting (no logic change)
-- `refactor`: Restructure without behavior change
-- `test`: Tests
-- `chore`: Maintenance, deps, config
-- `perf`: Performance
-- `build`: Build system
-- `ci`: CI/CD
-
-## Rules
-- **<72 characters**
-- **Present tense, imperative** ("add" not "added")
-- **No period at end**
-- **Scope optional but recommended**
-- **Focus on WHAT, not HOW**
-- Only use `feat`, `fix`, or `perf` prefixes for files in `.claude` directory (do not use `docs`).
-
-## NEVER Include AI Attribution
-- ❌ "Generated with Claude"
-- ❌ "Co-Authored-By: Claude"
-- ❌ Any AI reference
-
-## Good Examples
-- `feat(auth): add login validation`
-- `fix(api): resolve query timeout`
-- `docs(readme): update install guide`
-- `refactor(utils): simplify date logic`
-
-## Bad Examples
-- ❌ `Updated files` (not descriptive)
-- ❌ `feat(auth): added login using bcrypt with salt` (too long, describes HOW)
-- ❌ `Fix bug` (not specific)
-
-## Special Cases
-- `.claude/` skill updates: `perf(skill): improve token efficiency`
-- `.claude/` new skills: `feat(skill): add database-optimizer`
+# Commit Message Standards
+
+## Format
+```
+type(scope): description
+```
+
+## Types (priority order)
+- `feat`: New feature
+- `fix`: Bug fix
+- `docs`: Documentation only
+- `style`: Formatting (no logic change)
+- `refactor`: Restructure without behavior change
+- `test`: Tests
+- `chore`: Maintenance, deps, config
+- `perf`: Performance
+- `build`: Build system
+- `ci`: CI/CD
+
+## Rules
+- **<72 characters**
+- **Present tense, imperative** ("add" not "added")
+- **No period at end**
+- **Scope optional but recommended**
+- **Focus on WHAT, not HOW**
+- Only use `feat`, `fix`, or `perf` prefixes for files in `.claude` directory (do not use `docs`).
+
+## NEVER Include AI Attribution
+- ❌ "Generated with Claude"
+- ❌ "Co-Authored-By: Claude"
+- ❌ Any AI reference
+
+## Good Examples
+- `feat(auth): add login validation`
+- `fix(api): resolve query timeout`
+- `docs(readme): update install guide`
+- `refactor(utils): simplify date logic`
+
+## Bad Examples
+- ❌ `Updated files` (not descriptive)
+- ❌ `feat(auth): added login using bcrypt with salt` (too long, describes HOW)
+- ❌ `Fix bug` (not specific)
+
+## Special Cases
+- `.claude/` skill updates: `perf(skill): improve token efficiency`
+- `.claude/` new skills: `feat(skill): add database-optimizer`

package/template/.claude/skills/git/references/context-efficiency.md

@@ -0,0 +1,54 @@
+# Context Efficiency for Git Workflows
+
+Git and `gh` emit some of the largest output in any workflow: full diffs, log
+walls, PR bodies, CI job logs. Left unfiltered they crowd out the reasoning that
+actually decides the commit or merge. Keep the main context small and high-signal.
+
+## Isolate
+
+Run verbose git/gh work in the `git-manager` subagent and return only what the
+decision needs — the file list, the verdict, the failing line. Never return a raw
+diff, a full `git log`, or a complete CI log to the main context.
+
+For a batch (several PRs), handle one PR per subagent pass so one noisy PR cannot
+crowd out the rest.
+
+## Select before you read
+
+Ask the command for the narrow answer instead of filtering a wide one afterwards:
+
+```bash
+git log --oneline -10              # not: git log
+git diff --name-only               # not: git diff, when you only need the files
+git diff --stat                    # size of change without the body
+gh pr view 123 --json title,mergeStateStatus,statusCheckRollup
+gh run view "$RUN_ID" --log-failed  # not: --log, which returns every job
+```
+
+`gh` has a built-in jq engine — `--json <fields> --jq '<filter>'` — so field
+selection needs no external tool.
+
+## Compress what you must keep
+
+When output has to survive into the main context, summarize it: the failing test
+name and assertion, not the whole runner output; the conflicting paths, not the
+conflict bodies. Cite `file:line` and drop the surrounding text.
+
+## Position what matters
+
+Put the decision-relevant facts at the start or end of a subagent report, never
+buried in the middle — attention degrades in the middle of long context.
+
+## Budget
+
+Watch context utilization: **70% is a warning** to start compacting, **90% is
+critical** — stop expanding scope and summarize what you have. On a long merge
+batch, checkpoint progress (which PRs are merged, which remain) to a file rather
+than carrying the whole history forward.
+
+## Anti-patterns
+
+- Pasting a full diff or CI log into the main context "for reference"
+- Re-running a wide command because the narrow output was discarded
+- One subagent accumulating every PR in a batch
+- Reading a file the command could have filtered for you

package/template/.claude/skills/git/references/gh-cli-guide.md

@@ -1,109 +1,109 @@
-# GitHub CLI Guide
-
-## Authentication
-```bash
-gh auth login        # Interactive login
-gh auth status       # Check auth state
-gh auth logout       # Logout
-```
-
-## Pull Requests
-
-### Create PR
-```bash
-# Basic
-gh pr create --base main --head feature-branch --title "feat: add login" --body "Summary"
-
-# With HEREDOC body
-gh pr create --base main --title "feat(auth): add OAuth" --body "$(cat <<'EOF'
-## Summary
-- Added OAuth2 provider support
-- Implemented token refresh
-
-## Test plan
-- [ ] Unit tests pass
-- [ ] Manual login test
-EOF
-)"
-
-# Draft mode
-gh pr create --draft --title "WIP: new feature"
-
-# Assign reviewers
-gh pr create --reviewer @user1,@user2
-
-# Add labels
-gh pr create --label "bug,priority:high"
-```
-
-### View/Review PR
-```bash
-gh pr list                    # List PRs
-gh pr view 123                # View PR details
-gh pr view 123 --web          # Open in browser
-gh pr checkout 123            # Checkout PR locally
-gh pr diff 123                # View PR diff
-gh pr status                  # Your PRs + reviews
-```
-
-### Merge PR
-```bash
-gh pr merge 123               # Default merge commit
-gh pr merge 123 --squash      # Squash commits
-gh pr merge 123 --rebase      # Rebase merge
-gh pr merge 123 --auto        # Auto-merge when checks pass
-gh pr merge 123 --delete-branch  # Delete branch after
-```
-
-### PR Comments
-```bash
-gh pr comment 123 --body "LGTM!"
-gh api repos/{owner}/{repo}/pulls/123/comments  # View all
-```
-
-## Issues
-
-```bash
-gh issue list                 # List issues
-gh issue view 42              # View issue
-gh issue create --title "Bug" --body "Description"
-gh issue develop 42 -c        # Create branch from issue
-```
-
-## Repository
-
-```bash
-gh repo view                  # Current repo info
-gh repo clone owner/repo      # Clone
-gh browse                     # Open repo in browser
-gh browse path/to/file:42     # Open file at line
-```
-
-## Workflow Runs
-
-```bash
-gh run list                   # List workflow runs
-gh run view <run-id>          # View run details
-gh run watch                  # Watch running workflow
-gh run rerun <run-id>         # Rerun failed workflow
-```
-
-## JSON Output (scripting)
-
-```bash
-gh pr list --json number,title,author
-gh pr view 123 --json commits,reviews
-gh issue list --json number,title --jq '.[].title'
-```
-
-## Common Patterns
-
-### Create PR with auto-merge
-```bash
-gh pr create --fill && gh pr merge --auto --squash
-```
-
-### Close stale PRs
-```bash
-gh pr list --state open --json number -q '.[].number' | xargs -I {} gh pr close {}
-```
+# GitHub CLI Guide
+
+## Authentication
+```bash
+gh auth login        # Interactive login
+gh auth status       # Check auth state
+gh auth logout       # Logout
+```
+
+## Pull Requests
+
+### Create PR
+```bash
+# Basic
+gh pr create --base main --head feature-branch --title "feat: add login" --body "Summary"
+
+# With HEREDOC body
+gh pr create --base main --title "feat(auth): add OAuth" --body "$(cat <<'EOF'
+## Summary
+- Added OAuth2 provider support
+- Implemented token refresh
+
+## Test plan
+- [ ] Unit tests pass
+- [ ] Manual login test
+EOF
+)"
+
+# Draft mode
+gh pr create --draft --title "WIP: new feature"
+
+# Assign reviewers
+gh pr create --reviewer @user1,@user2
+
+# Add labels
+gh pr create --label "bug,priority:high"
+```
+
+### View/Review PR
+```bash
+gh pr list                    # List PRs
+gh pr view 123                # View PR details
+gh pr view 123 --web          # Open in browser
+gh pr checkout 123            # Checkout PR locally
+gh pr diff 123                # View PR diff
+gh pr status                  # Your PRs + reviews
+```
+
+### Merge PR
+```bash
+gh pr merge 123               # Default merge commit
+gh pr merge 123 --squash      # Squash commits
+gh pr merge 123 --rebase      # Rebase merge
+gh pr merge 123 --auto        # Auto-merge when checks pass
+gh pr merge 123 --delete-branch  # Delete branch after
+```
+
+### PR Comments
+```bash
+gh pr comment 123 --body "LGTM!"
+gh api repos/{owner}/{repo}/pulls/123/comments  # View all
+```
+
+## Issues
+
+```bash
+gh issue list                 # List issues
+gh issue view 42              # View issue
+gh issue create --title "Bug" --body "Description"
+gh issue develop 42 -c        # Create branch from issue
+```
+
+## Repository
+
+```bash
+gh repo view                  # Current repo info
+gh repo clone owner/repo      # Clone
+gh browse                     # Open repo in browser
+gh browse path/to/file:42     # Open file at line
+```
+
+## Workflow Runs
+
+```bash
+gh run list                   # List workflow runs
+gh run view <run-id>          # View run details
+gh run watch                  # Watch running workflow
+gh run rerun <run-id>         # Rerun failed workflow
+```
+
+## JSON Output (scripting)
+
+```bash
+gh pr list --json number,title,author
+gh pr view 123 --json commits,reviews
+gh issue list --json number,title --jq '.[].title'
+```
+
+## Common Patterns
+
+### Create PR with auto-merge
+```bash
+gh pr create --fill && gh pr merge --auto --squash
+```
+
+### Close stale PRs
+```bash
+gh pr list --state open --json number -q '.[].number' | xargs -I {} gh pr close {}
+```

package/template/.claude/skills/git/references/safety-protocols.md

@@ -1,69 +1,69 @@
-# Git Safety Protocols
-
-## Secret Detection Patterns
-
-### Scan Command
-```bash
-git diff --cached | grep -iE "(AKIA|api[_-]?key|token|password|secret|credential|private[_-]?key|mongodb://|postgres://|mysql://|redis://|-----BEGIN)"
-```
-
-### Patterns to Detect
-
-| Category | Pattern | Example |
-|----------|---------|---------|
-| API Keys | `api[_-]?key`, `apiKey` | `API_KEY=abc123` |
-| AWS | `AKIA[0-9A-Z]{16}` | `AKIAIOSFODNN7EXAMPLE` |
-| Tokens | `token`, `auth_token`, `jwt` | `AUTH_TOKEN=xyz` |
-| Passwords | `password`, `passwd`, `pwd` | `DB_PASSWORD=secret` |
-| Private Keys | `-----BEGIN PRIVATE KEY-----` | PEM files |
-| DB URLs | `mongodb://`, `postgres://`, `mysql://` | Connection strings |
-| OAuth | `client_secret`, `oauth_token` | `CLIENT_SECRET=abc` |
-
-### Files to Warn About
-- `.env`, `.env.*` (except `.env.example`)
-- `*.key`, `*.pem`, `*.p12`
-- `credentials.json`, `secrets.json`
-- `config/private.*`
-
-### Action on Detection
-1. **BLOCK commit immediately**
-2. Show matching lines: `git diff --cached | grep -B2 -A2 <pattern>`
-3. Suggest: "Add to .gitignore or use environment variables"
-4. Offer to unstage: `git reset HEAD <file>`
-
-## Branch Protection
-
-### Never Force Push To
-- `main`, `master`, `production`, `prod`, `release/*`
-
-### Pre-Merge Checks
-```bash
-# Check for conflicts before merge
-git merge --no-commit --no-ff origin/{branch} && git merge --abort
-```
-
-### Remote-First Operations
-Always use `origin/{branch}` for comparisons:
-- ✅ `git diff origin/main...origin/feature`
-- ❌ `git diff main...HEAD` (includes local uncommitted)
-
-## Error Recovery
-
-### Undo Last Commit (unpushed)
-```bash
-git reset --soft HEAD~1  # Keep changes staged
-git reset HEAD~1         # Keep changes unstaged
-```
-
-### Abort Merge
-```bash
-git merge --abort
-```
-
-### Discard Local Changes
-```bash
-git checkout -- <file>   # Single file
-git reset --hard HEAD    # All files (DANGER)
-```
-
-**Always confirm with user before destructive operations.**
+# Git Safety Protocols
+
+## Secret Detection Patterns
+
+### Scan Command
+```bash
+git diff --cached | grep -iE "(AKIA|api[_-]?key|token|password|secret|credential|private[_-]?key|mongodb://|postgres://|mysql://|redis://|-----BEGIN)"
+```
+
+### Patterns to Detect
+
+| Category | Pattern | Example |
+|----------|---------|---------|
+| API Keys | `api[_-]?key`, `apiKey` | `API_KEY=abc123` |
+| AWS | `AKIA[0-9A-Z]{16}` | `AKIAIOSFODNN7EXAMPLE` |
+| Tokens | `token`, `auth_token`, `jwt` | `AUTH_TOKEN=xyz` |
+| Passwords | `password`, `passwd`, `pwd` | `DB_PASSWORD=secret` |
+| Private Keys | `-----BEGIN PRIVATE KEY-----` | PEM files |
+| DB URLs | `mongodb://`, `postgres://`, `mysql://` | Connection strings |
+| OAuth | `client_secret`, `oauth_token` | `CLIENT_SECRET=abc` |
+
+### Files to Warn About
+- `.env`, `.env.*` (except `.env.example`)
+- `*.key`, `*.pem`, `*.p12`
+- `credentials.json`, `secrets.json`
+- `config/private.*`
+
+### Action on Detection
+1. **BLOCK commit immediately**
+2. Show matching lines: `git diff --cached | grep -B2 -A2 <pattern>`
+3. Suggest: "Add to .gitignore or use environment variables"
+4. Offer to unstage: `git reset HEAD <file>`
+
+## Branch Protection
+
+### Never Force Push To
+- `main`, `master`, `production`, `prod`, `release/*`
+
+### Pre-Merge Checks
+```bash
+# Check for conflicts before merge
+git merge --no-commit --no-ff origin/{branch} && git merge --abort
+```
+
+### Remote-First Operations
+Always use `origin/{branch}` for comparisons:
+- ✅ `git diff origin/main...origin/feature`
+- ❌ `git diff main...HEAD` (includes local uncommitted)
+
+## Error Recovery
+
+### Undo Last Commit (unpushed)
+```bash
+git reset --soft HEAD~1  # Keep changes staged
+git reset HEAD~1         # Keep changes unstaged
+```
+
+### Abort Merge
+```bash
+git merge --abort
+```
+
+### Discard Local Changes
+```bash
+git checkout -- <file>   # Single file
+git reset --hard HEAD    # All files (DANGER)
+```
+
+**Always confirm with user before destructive operations.**