Skills Audit: Worktree Compatibility, Branch Workflow, MCP Requirements

[michael-newsrx]

Summary

• Enforce worktree compatibility by filtering incompatible tools (PyCharm MCP)
• Establish 3-branch workflow default (feature → dev → production)
• Gate spec/plan creation on MCP availability (halt if unavailable)
• Migrate existing file-based specs/plans to issues
• Auto-detect production branch from origin/HEAD
• Enforce integration branch as PR target

Files Modified:

• skills/platform-detection.md - Branch workflow detection + file migration + session init contract
• skills/using-superpowers/SKILL.md - Branch workflow config parsing
• skills/using-git-worktrees/SKILL.md - Worktree compatibility guard
• skills/brainstorming/SKILL.md - MCP gate before spec creation
• skills/writing-plans/SKILL.md - MCP gate before plan creation
• skills/finishing-a-development-branch/SKILL.md - Enforce integration branch
• skills/subagent-driven-development/SKILL.md - Add GIT_CONTEXT usage
• skills/executing-plans/SKILL.md - Add branch workflow context

Spec: #3
Code Review: Passed (no Critical/Important issues)

Changes from Code Review Feedback

1. Added session initialization contract to platform-detection.md
2. Extracted MCP error message to shared location
3. Clarified tool detection mechanism for worktrees
4. Added GIT_CONTEXT usage to subagent-driven-development and executing-plans
5. Added gitignore verification for archive directory
6. Fixed malformed markdown code blocks

Test Plan

• Platform detection reads GIT_PLATFORM, GITBUCKET_HAS_CREDENTIALS
• Branch workflow defaults to feature|dev|<production>
• dev branch created from detected production branch
• MCP gate halts on missing GitHub/GitBucket MCP
• Worktree compatibility filters PyCharm MCP tools
• Finishing skill uses integration branch as PR target
• File migration logic documented for specs/plans
• Session init contract documented
• Archive gitignore verification included