oh-my-customcode 0.44.6 → 0.45.1

package/templates/guides/git-worktree-workflow/README.md

@@ -0,0 +1,134 @@
+# Git Worktree Workflow
+
+## Overview
+
+Git worktrees allow you to check out multiple branches simultaneously in separate directories, each with its own working tree. This eliminates the need to stash changes or commit incomplete work when switching between branches.
+
+**Key benefits:**
+- Work on `develop` and `team-plugin` simultaneously without context switching
+- Keep long-running feature branches open alongside hotfix branches
+- Run tests on one branch while coding on another
+
+## Recommended Directory Structure
+
+```
+~/workspace/projects/
+├── oh-my-customcode/                    # Main worktree (develop)
+├── oh-my-customcode-team-plugin/        # team-plugin branch
+└── oh-my-customcode-release/            # release/* branches
+```
+
+Convention: `{repo-name}-{branch-suffix}` as sibling directories to the main worktree.
+
+## Basic Commands
+
+### Create a worktree
+
+```bash
+# From the main repository directory
+cd ~/workspace/projects/oh-my-customcode
+
+# Attach to an existing remote branch
+git worktree add ../oh-my-customcode-team-plugin team-plugin
+
+# Create a new branch and worktree together
+git worktree add ../oh-my-customcode-release release/v0.43.0
+```
+
+### List worktrees
+
+```bash
+git worktree list
+```
+
+Output:
+```
+/Users/you/workspace/projects/oh-my-customcode                 abc1234 [develop]
+/Users/you/workspace/projects/oh-my-customcode-team-plugin     def5678 [team-plugin]
+/Users/you/workspace/projects/oh-my-customcode-release         ghi9012 [release/v0.43.0]
+```
+
+### Remove a worktree
+
+```bash
+# Remove after branch is merged
+git worktree remove ../oh-my-customcode-release
+
+# Clean up stale worktree references
+git worktree prune
+```
+
+### Move a worktree
+
+```bash
+git worktree move ../oh-my-customcode-release ../oh-my-customcode-hotfix
+```
+
+## Claude Code Integration
+
+### Built-in Worktree Tools
+
+Claude Code provides `EnterWorktree` and `ExitWorktree` tools for session-scoped worktree management:
+
+```
+EnterWorktree(name: "feature-x")
+# Creates .claude/worktrees/feature-x with a new branch based on HEAD
+# Session working directory switches to the worktree
+
+ExitWorktree()
+# Returns to the main repository
+# Prompts to keep or remove the worktree
+```
+
+### Agent Isolation Mode
+
+Agents can use `isolation: worktree` in their frontmatter to run in an isolated git worktree:
+
+```yaml
+---
+name: my-agent
+isolation: worktree
+---
+```
+
+This gives the agent a separate working copy, enabling safe code changes with rollback capability. The worktree is automatically created and cleaned up by the agent lifecycle.
+
+### Superpowers Skill
+
+The `superpowers` plugin includes a `using-git-worktrees` skill with additional patterns for worktree-based workflows. Reference it for advanced use cases like parallel CI testing and multi-branch refactoring.
+
+## Caveats
+
+### Same branch restriction
+
+A branch cannot be checked out in multiple worktrees simultaneously. Attempting this will fail:
+
+```bash
+# ERROR: 'develop' is already checked out at '~/workspace/projects/oh-my-customcode'
+git worktree add ../oh-my-customcode-dev2 develop
+```
+
+### Independent dependencies
+
+Each worktree has its own `node_modules`. Run package installation separately:
+
+```bash
+cd ../oh-my-customcode-team-plugin
+bun install
+```
+
+### Gitignored files
+
+Files under `.claude/` are gitignored in this project. When adding new `.claude/` files, use `git add -f`:
+
+```bash
+git add -f .claude/agents/new-agent.md
+```
+
+### Shared git objects
+
+All worktrees share the same `.git` object store. Operations like `git gc` and `git fetch` affect all worktrees.
+
+### Worktree-local files
+
+Files listed in `.gitignore` (like `node_modules/`, `.env`) are independent per worktree. Configuration files that are not tracked must be set up separately in each worktree.

package/templates/guides/skill-bundle-design/README.md

@@ -0,0 +1,106 @@
+# Domain Skill Bundle Design Guide
+
+## Overview
+
+Domain skill bundles package related skills, agents, and guides for a specific technology or framework. This guide defines the standard pattern based on the Author/Test/Troubleshoot tri-pattern (inspired by Microsoft Copilot Studio Skills).
+
+## The Author/Test/Troubleshoot Pattern
+
+Every domain skill bundle should provide three capability axes:
+
+### Author (Create & Edit)
+Skills and agents that help CREATE artifacts in the domain.
+
+| Component | Example (Spring Boot) | Example (Airflow) |
+|-----------|----------------------|-------------------|
+| Best practices skill | springboot-best-practices | airflow-best-practices |
+| Expert agent | be-springboot-expert | de-airflow-expert |
+| Code generation | Scaffold, boilerplate | DAG authoring |
+
+### Test (Verify & Validate)
+Skills and agents that help VERIFY correctness.
+
+| Component | Example (Spring Boot) | Example (Airflow) |
+|-----------|----------------------|-------------------|
+| Review skill | dev-review | dev-review |
+| QA workflow | qa-lead-routing | qa-lead-routing |
+| Domain-specific checks | Spring actuator health | DAG validation |
+
+### Troubleshoot (Debug & Fix)
+Skills and agents that help DIAGNOSE and FIX issues.
+
+| Component | Example (Spring Boot) | Example (Airflow) |
+|-----------|----------------------|-------------------|
+| Debugging skill | systematic-debugging | systematic-debugging |
+| Domain diagnostics | Spring Boot Actuator | Airflow log analysis |
+| Fix patterns | Common Spring errors | DAG failure patterns |
+
+## Existing Bundle Inventory
+
+Map existing oh-my-customcode skills/agents to the tri-pattern:
+
+| Domain | Author | Test | Troubleshoot | Completeness |
+|--------|--------|------|-------------|-------------|
+| Spring Boot | springboot-best-practices, be-springboot-expert | dev-review | systematic-debugging | ★★★ |
+| FastAPI | fastapi-best-practices, be-fastapi-expert | dev-review | systematic-debugging | ★★★ |
+| Go | go-best-practices, lang-golang-expert, be-go-backend-expert | dev-review | systematic-debugging | ★★★ |
+| Airflow | airflow-best-practices, de-airflow-expert | dev-review | systematic-debugging | ★★★ |
+| React/Next.js | react-best-practices, fe-vercel-agent | web-design-guidelines | systematic-debugging | ★★★ |
+| PostgreSQL | postgres-best-practices, db-postgres-expert | dev-review | systematic-debugging | ★★★ |
+| Docker | docker-best-practices, infra-docker-expert | dev-review | systematic-debugging | ★★☆ |
+| Kafka | kafka-best-practices, de-kafka-expert | dev-review | systematic-debugging | ★★☆ |
+| Redis | redis-best-practices, db-redis-expert | dev-review | systematic-debugging | ★★☆ |
+
+## Creating a New Bundle
+
+### Checklist
+
+1. **Author axis**:
+   - [ ] Best practices skill (`.claude/skills/{domain}-best-practices/SKILL.md`)
+   - [ ] Expert agent (`.claude/agents/{type}-{domain}-expert.md`)
+   - [ ] Reference guide (`guides/{domain}/`)
+
+2. **Test axis**:
+   - [ ] Domain-specific test patterns documented in best practices skill
+   - [ ] Integration with qa-lead-routing or dev-review
+
+3. **Troubleshoot axis**:
+   - [ ] Common error patterns documented in best practices skill
+   - [ ] Integration with systematic-debugging
+
+### Minimum Viable Bundle
+
+At minimum, a domain bundle needs:
+- 1 best practices skill (Author)
+- 1 expert agent (Author + Troubleshoot)
+- Integration with dev-review (Test)
+
+### Template
+
+```
+guides/{domain}/
+├── README.md          # Domain overview and quick reference
+├── patterns.md        # Common patterns and anti-patterns
+└── troubleshooting.md # Common errors and solutions
+
+.claude/skills/{domain}-best-practices/
+└── SKILL.md           # Best practices skill
+
+.claude/agents/{type}-{domain}-expert.md  # Expert agent
+```
+
+## Relationship to Other Skills
+
+| Skill | Role in Bundle Pattern |
+|-------|----------------------|
+| dev-review | Universal Test axis |
+| systematic-debugging | Universal Troubleshoot axis |
+| adversarial-review | Advanced Test axis (security) |
+| qa-lead-routing | Test orchestration |
+| mgr-creator | Bundle creation automation |
+
+## References
+
+- Microsoft Copilot Studio Skills: Author/Test/Troubleshoot pattern
+- oh-my-customcode R006: Agent Design (separation of concerns)
+- oh-my-customcode compilation metaphor: skills = source, agents = build artifacts

package/templates/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.44.6",
+  "version": "0.45.1",
   "lastUpdated": "2026-03-16T00:00:00.000Z",
   "components": [
     {
@@ -18,13 +18,13 @@
       "name": "skills",
       "path": ".claude/skills",
       "description": "Reusable skill modules (includes slash commands)",
-      "files": 77
+      "files": 82
     },
     {
       "name": "guides",
       "path": "guides",
       "description": "Reference documentation",
-      "files": 26
+      "files": 28
     },
     {
       "name": "hooks",