@slamb2k/mad-skills 2.0.7 → 2.0.9

package/skills/rig/instructions.md

@@ -1,162 +0,0 @@
-# Rig Instructions
-
-Idempotently bootstrap repositories with standard development infrastructure.
-Prompts and report schemas are in `references/`. Configuration procedures are
-in `references/configuration-steps.md`.
-
-**Key principle:** Prompt user before making changes. Report findings first,
-get approval, then act.
-
----
-
-## Pre-flight
-
-Before starting, check all dependencies in this table:
-
-| Dependency | Type | Check | Required | Resolution | Detail |
-|-----------|------|-------|----------|------------|--------|
-| git | cli | `git --version` | yes | stop | Install from https://git-scm.com |
-| lefthook | npm | `npx lefthook --help` | yes | install | `npm install -g lefthook` |
-| gh | cli | `gh --version` | yes | url | https://cli.github.com |
-
-For each row, in order:
-1. Run the Check command (for cli/npm) or test file existence (for agent/skill)
-2. If found: continue silently
-3. If missing: apply Resolution strategy
-   - **stop**: notify user with Detail, halt execution
-   - **url**: notify user with Detail (install link), halt execution
-   - **install**: notify user, run the command in Detail, continue if successful
-   - **ask**: notify user, offer to run command in Detail, continue either way (or halt if required)
-   - **fallback**: notify user with Detail, continue with degraded behavior
-4. After all checks: summarize what's available and what's degraded
-
----
-
-## Phase 1: System Requirements Check
-
-Launch **Bash subagent** (haiku — simple checks):
-
-```
-Task(
-  subagent_type: "Bash",
-  model: "haiku",
-  description: "Check system requirements",
-  prompt: <read from references/phase-prompts.md#phase-1>
-)
-```
-
-Parse SYSTEM_REPORT. If any requirement fails, use **AskUserQuestion**:
-
-Options for missing git config:
-- "I'll configure it manually"
-- "Configure for me with: [email] / [name]"
-
-**Stop if user chooses manual. Configure if values provided.**
-
----
-
-## Phase 2: Repository Analysis
-
-Launch **Bash subagent** (haiku):
-
-```
-Task(
-  subagent_type: "Bash",
-  model: "haiku",
-  description: "Analyze repository",
-  prompt: <read from references/phase-prompts.md#phase-2>
-)
-```
-
-Parse REPO_REPORT.
-
----
-
-## Phase 3: Present Findings & Get Approval
-
-Present analysis to user with **AskUserQuestion**:
-
-```
-Repository Analysis Complete
-
-Current State:
-  Git initialized: {status}
-  Branch: {branch}
-  Lefthook: {status}
-  Commit template: {status}
-  PR template: {status}
-  CI workflow: {status}
-  {if azdo and unregistered_pipelines:}
-  Azure Pipelines: {N} YAML file(s) found, {M} not yet registered
-
-Detected Stack:
-  Type: {project_type}
-  Components: {detected_components}
-  Available scripts: {available_scripts}
-
-Proposed Changes:
-  {numbered list of what will be added/configured}
-  {if azdo and unregistered_pipelines: "Register Azure Pipelines: {list of YAML paths}"}
-```
-
-Options:
-- "Yes, configure everything"
-- "Let me choose what to configure"
-- "Cancel"
-
-If "Let me choose", present individual options as multi-select.
-
----
-
-## Phase 4: Execute Configuration
-
-For each approved item, follow the procedures in
-`references/configuration-steps.md`.
-
----
-
-## Phase 5: Verification
-
-Launch **Bash subagent** (haiku):
-
-```
-Task(
-  subagent_type: "Bash",
-  model: "haiku",
-  description: "Verify configuration",
-  prompt: <read from references/phase-prompts.md#phase-5>
-)
-```
-
-Parse VERIFY_REPORT.
-
----
-
-## Phase 6: Final Report
-
-Present summary using the template in `references/report-template.md`.
-
----
-
-## Idempotency Rules
-
-- **Skip** items already correctly configured
-- **Update** items that exist but are outdated (prompt user first)
-- **Add** items that are missing
-- **Never delete** user's existing configuration without explicit approval
-- **Merge** rather than replace when possible (e.g., add missing hooks)
-
----
-
-## Error Handling
-
-If any step fails:
-1. Report the specific failure
-2. Offer to skip and continue, or abort
-3. Include troubleshooting suggestions
-
-Common issues:
-- No package manager -> suggest installing npm/bun
-- Permission denied -> check file permissions
-- Lefthook install fails -> try global install
-- Git not initialized -> offer to initialize

package/skills/ship/instructions.md

@@ -1,192 +0,0 @@
-# Ship Instructions
-
-Ship changes through the complete PR lifecycle. Every stage runs in a subagent
-to isolate context from the primary conversation. Prompts for each stage are
-in `references/stage-prompts.md`.
-
-## Flags
-
-Parse optional flags from the request:
-- `--pr-only`: Stop after creating the PR
-- `--no-squash`: Use regular merge instead of squash
-- `--keep-branch`: Don't delete the source branch after merge
-
----
-
-## Pre-flight
-
-Before starting, check all dependencies in this table:
-
-| Dependency | Type | Check | Required | Resolution | Detail |
-|-----------|------|-------|----------|------------|--------|
-| git | cli | `git --version` | yes | stop | Install from https://git-scm.com |
-| gh | cli | `gh --version` | yes | url | https://cli.github.com |
-| ship-analyzer | agent | `~/.claude/agents/ship-analyzer.md` | no | fallback | Uses general-purpose agent |
-
-For each row, in order:
-1. Run the Check command (for cli/npm) or test file existence (for agent/skill)
-2. If found: continue silently
-3. If missing: apply Resolution strategy
-   - **stop**: notify user with Detail, halt execution
-   - **url**: notify user with Detail (install link), halt execution
-   - **install**: notify user, run the command in Detail, continue if successful
-   - **ask**: notify user, offer to run command in Detail, continue either way (or halt if required)
-   - **fallback**: notify user with Detail, continue with degraded behavior
-4. After all checks: summarize what's available and what's degraded
-
-Read `default_branch` and `remote` from Stage 1's SYNC_REPORT. These are
-substituted into all stage prompts as `{REMOTE}` and `{DEFAULT_BRANCH}`.
-
-### Platform Detection
-
-After sync, detect the hosting platform from the remote URL:
-
-```bash
-REMOTE_URL=$(git remote get-url {REMOTE} 2>/dev/null)
-if echo "$REMOTE_URL" | grep -qiE 'dev\.azure\.com|visualstudio\.com'; then
-  PLATFORM="azdo"
-elif echo "$REMOTE_URL" | grep -qi 'github\.com'; then
-  PLATFORM="github"
-else
-  PLATFORM="github"   # default fallback
-fi
-```
-
-Pass `{PLATFORM}` into all stage prompts. Each stage uses the appropriate
-CLI tool: `gh` for GitHub, `az repos`/`az pipelines` for Azure DevOps.
-
-> **Azure DevOps prerequisite:** The `az devops` extension must be installed
-> and configured (`az devops configure --defaults organization=... project=...`).
-> If `az repos` commands fail, report the setup requirement to the user.
-
----
-
-## Stage 1: Sync
-
-Launch **Bash subagent** (haiku — simple git commands):
-
-```
-Task(
-  subagent_type: "Bash",
-  model: "haiku",
-  description: "Sync with default branch",
-  prompt: "Follow ~/.claude/skills/sync/instructions.md subagent prompt. Return SYNC_REPORT."
-)
-```
-
-Parse SYNC_REPORT. Extract `remote` and `default_branch`. Abort if sync failed.
-
----
-
-## Stage 2: Commit, Push & Create PR
-
-This stage needs to **read and understand code** to write good commit messages
-and PR descriptions. Use a code-aware subagent.
-
-Launch **ship-analyzer subagent** (reads diffs + source files):
-
-```
-Task(
-  subagent_type: "ship-analyzer",
-  description: "Analyze, commit, push, and create PR",
-  prompt: <read from references/stage-prompts.md#stage-2>
-)
-```
-
-> **Fallback:** If `ship-analyzer` is not available, use `subagent_type: "general-purpose"`.
-
-Substitute `{USER_INTENT}`, `{FILES_TO_INCLUDE}`, `{FILES_TO_EXCLUDE}`,
-`{REMOTE}`, `{DEFAULT_BRANCH}`, `{PLATFORM}` into the prompt.
-
-Parse SHIP_REPORT. Abort if failed.
-
-**Rollback:** If push succeeds but PR creation fails, report the error and
-suggest the manual PR creation command. Do NOT revert the push.
-- GitHub: `gh pr create --head {branch}`
-- Azure DevOps: `az repos pr create --source-branch {branch} --target-branch {DEFAULT_BRANCH}`
-
-**If `--pr-only` flag: Stop here and report PR URL to user.**
-
----
-
-## Stage 3: Wait for CI
-
-Launch **Bash subagent** in the **background** (haiku — just polling):
-
-```
-Task(
-  subagent_type: "Bash",
-  model: "haiku",
-  run_in_background: true,
-  description: "Monitor CI checks",
-  prompt: <read from references/stage-prompts.md#stage-3>
-)
-```
-
-Substitute `{PR_NUMBER}` into the prompt.
-
-While CI runs in the background, briefly inform the user:
-```
-CI running for PR #{pr_number}... waiting for checks.
-```
-
-When the background task completes, read the output file and parse CHECKS_REPORT.
-
----
-
-## Stage 4: Fix Failing Checks (if needed)
-
-If CHECKS_REPORT shows failures, launch **general-purpose subagent**:
-
-```
-Task(
-  subagent_type: "general-purpose",
-  description: "Fix CI failures",
-  prompt: <read from references/stage-prompts.md#stage-4>
-)
-```
-
-Substitute `{PR_NUMBER}`, `{BRANCH}`, `{FAILING_CHECKS}` into the prompt.
-
-If fixed, return to Stage 3 (run CI watch again).
-If unable to fix after 2 attempts, report to user and stop.
-
----
-
-## Stage 5: Merge & Final Sync
-
-Launch **Bash subagent** (haiku — simple git + platform CLI commands):
-
-```
-Task(
-  subagent_type: "Bash",
-  model: "haiku",
-  description: "Merge PR and sync",
-  prompt: <read from references/stage-prompts.md#stage-5>
-)
-```
-
-Substitute `{PR_NUMBER}`, `{REMOTE}`, `{DEFAULT_BRANCH}`, merge/branch flags.
-
-Parse LAND_REPORT.
-
----
-
-## Final Report to User
-
-Compile all stage reports into a summary:
-
-```
-Ship complete
-
-  Branch:  {branch}
-  PR:      {pr_url}
-  Merged:  {merge_commit} ({merge_type})
-
-  Commits:
-  {list of commit messages, indented}
-
-  Files:   {count} files changed ({diff_summary})
-```
-
-If any stage failed, report the failure point and suggested resolution.

package/skills/sync/instructions.md

@@ -1,178 +0,0 @@
-# Sync Instructions
-
-Synchronize local repository with the remote default branch using a single
-Bash subagent to isolate all git operations from the primary conversation.
-
-## Flags
-
-Parse optional flags from the request:
-- `--no-stash`: Don't auto-stash uncommitted changes
-- `--no-cleanup`: Don't delete stale local branches
-- `--no-rebase`: Use merge instead of rebase when on a feature branch
-
----
-
-## Pre-flight
-
-Before starting, check all dependencies in this table:
-
-| Dependency | Type | Check | Required | Resolution | Detail |
-|-----------|------|-------|----------|------------|--------|
-| git | cli | `git --version` | yes | stop | Install from https://git-scm.com |
-
-For each row, in order:
-1. Run the Check command (for cli/npm) or test file existence (for agent/skill)
-2. If found: continue silently
-3. If missing: apply Resolution strategy
-   - **stop**: notify user with Detail, halt execution
-   - **url**: notify user with Detail (install link), halt execution
-   - **install**: notify user, run the command in Detail, continue if successful
-   - **ask**: notify user, offer to run command in Detail, continue either way (or halt if required)
-   - **fallback**: notify user with Detail, continue with degraded behavior
-4. After all checks: summarize what's available and what's degraded
-
----
-
-## Pre-flight Detection
-
-Before launching the subagent, detect the remote and default branch:
-
-```
-REMOTE=$(git remote | head -1)   # usually "origin"
-DEFAULT_BRANCH=$(git symbolic-ref refs/remotes/$REMOTE/HEAD 2>/dev/null | sed 's|.*/||')
-```
-
-Fallback chain if `symbolic-ref` fails:
-1. Check `git show-ref --verify refs/heads/main` → use `main`
-2. Check `git show-ref --verify refs/heads/master` → use `master`
-3. If neither exists, report error and stop
-
-Pass `{REMOTE}` and `{DEFAULT_BRANCH}` into the subagent prompt.
-
----
-
-## Execution
-
-Launch a **Bash subagent** (haiku — pure git commands, no code analysis needed):
-
-```
-Task(
-  subagent_type: "Bash",
-  model: "haiku",
-  description: "Sync repo with {DEFAULT_BRANCH}",
-  prompt: <see prompt below>
-)
-```
-
-### Subagent Prompt
-
-```
-Synchronize this git repository with {REMOTE}/{DEFAULT_BRANCH}. Execute the
-following steps in order and report results.
-
-Limit SYNC_REPORT to 15 lines maximum.
-
-FLAGS: {flags from request, or "none"}
-
-## Steps
-
-1. **Check state**
-   BRANCH=$(git branch --show-current 2>/dev/null || echo "DETACHED")
-   CHANGES=$(git status --porcelain | head -20)
-   Record: current_branch=$BRANCH, has_changes=(non-empty CHANGES)
-
-   If BRANCH == "DETACHED":
-     Record error: "Detached HEAD — cannot sync. Checkout a branch first."
-     Skip to Output.
-
-2. **Stash changes** (skip if --no-stash or no changes)
-   If has_changes and not --no-stash:
-     git stash push -m "sync-auto-stash-$(date +%Y%m%d-%H%M%S)"
-     Record: stash_created=true
-
-3. **Sync {DEFAULT_BRANCH}**
-   git fetch {REMOTE}
-   If BRANCH != "{DEFAULT_BRANCH}":
-     git checkout {DEFAULT_BRANCH}
-   git pull {REMOTE} {DEFAULT_BRANCH} --ff-only
-   If pull fails (diverged):
-     git pull {REMOTE} {DEFAULT_BRANCH} --rebase
-   Record: main_commit=$(git rev-parse --short HEAD)
-   Record: main_message=$(git log -1 --format=%s)
-
-4. **Return to branch and update** (skip if already on {DEFAULT_BRANCH})
-   If current_branch != "{DEFAULT_BRANCH}":
-     git checkout $BRANCH
-     If --no-rebase:
-       git merge {DEFAULT_BRANCH} --no-edit
-     Else:
-       git rebase {DEFAULT_BRANCH}
-       If rebase fails:
-         git rebase --abort
-         Record: rebase_status="conflict — aborted, branch unchanged"
-
-5. **Restore stash** (if created in step 2)
-   If stash_created:
-     git stash pop
-     If pop fails (conflict):
-       Record: stash="conflict — run 'git stash show' to inspect"
-     Else:
-       Record: stash="restored"
-
-6. **Cleanup branches** (skip if --no-cleanup)
-   git fetch --prune
-
-   # Delete branches whose remote is gone
-   for branch in $(git branch -vv | grep ': gone]' | awk '{print $1}'); do
-     if [ "$branch" != "$BRANCH" ]; then
-       git branch -d "$branch" 2>/dev/null && echo "Deleted: $branch"
-     fi
-   done
-
-   # Delete branches fully merged into {DEFAULT_BRANCH} (except current)
-   for branch in $(git branch --merged {DEFAULT_BRANCH} | grep -v '^\*' | grep -v '{DEFAULT_BRANCH}'); do
-     branch=$(echo "$branch" | xargs)
-     if [ "$branch" != "$BRANCH" ] && [ -n "$branch" ]; then
-       git branch -d "$branch" 2>/dev/null && echo "Deleted: $branch"
-     fi
-   done
-
-   Record: branches_cleaned={list of deleted branches, or "none"}
-
-7. **Final state**
-   echo "Branch: $(git branch --show-current)"
-   echo "HEAD: $(git log -1 --format='%h %s')"
-   echo "Status: $(git status --short | wc -l) modified files"
-
-## Output Format
-
-SYNC_REPORT:
-- status: success|failed
-- remote: {REMOTE}
-- default_branch: {DEFAULT_BRANCH}
-- main_updated_to: {commit} - {message}
-- current_branch: {branch}
-- stash: restored|none|conflict
-- rebase: success|conflict|skipped
-- branches_cleaned: {list or "none"}
-- errors: {any errors encountered}
-```
-
----
-
-## Report to User
-
-Parse the subagent's SYNC_REPORT and present a clean summary:
-
-```
-Sync complete
-  Main:    {commit} - {message}
-  Branch:  {current_branch}
-  Stash:   {status}
-  Cleaned: {branches or "none"}
-```
-
-If errors occurred, report them clearly with suggested resolution:
-- Detached HEAD → suggest `git checkout <branch>`
-- Rebase conflict → suggest `git rebase {DEFAULT_BRANCH}` manually and resolve
-- Stash conflict → suggest `git stash show` and `git stash pop` manually