@deimoscloud/coreai 0.1.0

package/commands/optional/worktree-cleanup.md

@@ -0,0 +1,167 @@
+---
+description: Use when a PR has been merged, a ticket is complete, or development work is finished. Cleans up the git worktree created for parallel agent work. Typically used by the Engineering Manager after merge.
+argument-hint: TICKET-XX or worktree path
+---
+
+# Worktree Cleanup
+
+You are cleaning up the worktree for: **$ARGUMENTS**
+
+## When to Use
+
+- PR has been merged to main
+- Ticket is marked as Done
+- Development work is complete and no longer needed
+
+## Cleanup Steps
+
+### 1. Identify Worktree to Remove
+
+List all active worktrees:
+```bash
+cd {{PROJECT_ROOT}}
+git worktree list
+```
+
+**Expected output:**
+```
+{{PROJECT_ROOT}}                                              abc1234 [main]
+{{PROJECT_ROOT}}/../{{PROJECT_NAME}}-agent1-{{JIRA_PROJECT}}-123  def5678 [feature/{{JIRA_PROJECT}}-123-description]
+{{PROJECT_ROOT}}/../{{PROJECT_NAME}}-agent2-{{JIRA_PROJECT}}-456  ghi9012 [feature/{{JIRA_PROJECT}}-456-description]
+```
+
+### 2. Verify PR is Merged
+
+Before removing, confirm the PR is merged:
+```bash
+gh pr list --state merged --search "{{JIRA_PROJECT}}-XX"
+```
+
+Or check if the branch exists on remote:
+```bash
+git ls-remote --heads origin feature/{{JIRA_PROJECT}}-XX-description
+# Empty output = branch deleted (PR merged)
+```
+
+### 3. Remove Worktree
+
+```bash
+# From the main repository
+cd {{PROJECT_ROOT}}
+
+# Remove the worktree
+git worktree remove ../{{PROJECT_NAME}}-[agent-name]-{{JIRA_PROJECT}}-XX
+```
+
+### 4. Delete Local Branch (if exists)
+
+```bash
+git branch -d feature/{{JIRA_PROJECT}}-XX-description
+```
+
+If branch wasn't merged (force delete with caution):
+```bash
+git branch -D feature/{{JIRA_PROJECT}}-XX-description
+```
+
+### 5. Prune Stale Worktrees
+
+Clean up any stale worktree references:
+```bash
+git worktree prune
+```
+
+### 6. Verify Cleanup
+
+```bash
+git worktree list
+```
+
+Confirm the worktree no longer appears.
+
+## Batch Cleanup
+
+To clean up multiple worktrees at once:
+
+```bash
+# List all worktrees
+git worktree list
+
+# Remove each one
+git worktree remove ../{{PROJECT_NAME}}-agent1-{{JIRA_PROJECT}}-XXX
+git worktree remove ../{{PROJECT_NAME}}-agent2-{{JIRA_PROJECT}}-YYY
+
+# Prune all stale references
+git worktree prune
+```
+
+## Error Handling
+
+**If worktree has uncommitted changes:**
+```
+error: '<path>' contains modified or untracked files, use --force to delete it
+```
+
+Options:
+1. **If changes are needed:** Commit and push first, then remove
+2. **If changes can be discarded:** `git worktree remove --force ../path`
+
+**If worktree directory doesn't exist but git tracks it:**
+```bash
+git worktree prune
+```
+
+**If branch is not fully merged:**
+```bash
+# Check if branch was merged
+git branch --merged main | grep feature/{{JIRA_PROJECT}}-XX
+
+# If not merged but PR is closed/merged on GitHub, force delete
+git branch -D feature/{{JIRA_PROJECT}}-XX-description
+```
+
+## Update Jira (Optional)
+
+If the ticket isn't already Done, transition it:
+- Use `/jira-transition` to move to "Done"
+- Or use Atlassian MCP directly
+
+## Completion
+
+After cleanup, report:
+```
+Worktree Cleanup Complete
+
+Removed:
+- Worktree: {{PROJECT_ROOT}}/../{{PROJECT_NAME}}-[agent-name]-{{JIRA_PROJECT}}-XX
+- Branch: feature/{{JIRA_PROJECT}}-XX-description
+
+Active Worktrees:
+<output of git worktree list>
+
+Ticket {{JIRA_PROJECT}}-XX is ready to be marked as Done (if not already).
+```
+
+## Bulk Cleanup After Sprint
+
+To clean up all worktrees from a completed sprint:
+
+```bash
+# List all worktrees
+git worktree list
+
+# Remove all agent worktrees (keep main)
+for dir in ../{{PROJECT_NAME}}-*-{{JIRA_PROJECT}}-*; do
+  if [ -d "$dir" ]; then
+    git worktree remove "$dir" --force
+  fi
+done
+
+# Prune
+git worktree prune
+
+# Clean up merged branches
+git branch --merged main | grep -E "feature/{{JIRA_PROJECT}}-" | xargs -r git branch -d
+```
+
+Now proceed with the worktree cleanup.

package/commands/optional/worktree-setup.md

@@ -0,0 +1,110 @@
+---
+description: Use when starting work on a ticket, implementing a feature, fixing a bug, or beginning any development task. Sets up an isolated git worktree for parallel agent work, preventing conflicts when multiple agents work simultaneously.
+argument-hint: TICKET-XX [short-description]
+---
+
+# Worktree Setup for Parallel Development
+
+You are setting up an isolated git worktree to work on: **$ARGUMENTS**
+
+## Why Worktrees?
+
+Multiple agents can work on different tickets simultaneously without conflicts. Each agent gets its own working directory with its own branch, completely isolated from other agents.
+
+## Setup Steps
+
+### 1. Parse Arguments
+
+Extract from `$ARGUMENTS`:
+- **Ticket ID:** {{JIRA_PROJECT}}-XX (required)
+- **Description:** Short description for branch name (optional, derive from ticket if not provided)
+
+### 2. Determine Your Agent Name
+
+Identify which agent you are (e.g., `backend-engineer`, `frontend-engineer`). This is used in the worktree path.
+
+### 3. Fetch Latest Main
+
+```bash
+cd {{PROJECT_ROOT}}
+git fetch origin main
+```
+
+### 4. Create Worktree
+
+```bash
+# Pattern: ../{{PROJECT_NAME}}-[agent-name]-{{JIRA_PROJECT}}-XX
+git worktree add ../{{PROJECT_NAME}}-[agent-name]-{{JIRA_PROJECT}}-XX -b feature/{{JIRA_PROJECT}}-XX-[description] origin/main
+```
+
+**Example:**
+```bash
+git worktree add ../{{PROJECT_NAME}}-backend-engineer-{{JIRA_PROJECT}}-123 -b feature/{{JIRA_PROJECT}}-123-feature-name origin/main
+```
+
+### 5. Verify Worktree
+
+```bash
+git worktree list
+```
+
+Confirm your new worktree appears in the list.
+
+### 6. Set Working Directory
+
+**CRITICAL:** All subsequent work must happen in the worktree directory:
+
+```
+{{PROJECT_ROOT}}/../{{PROJECT_NAME}}-[agent-name]-{{JIRA_PROJECT}}-XX/
+```
+
+Announce to the user:
+```
+Worktree created. Working directory is now:
+{{PROJECT_ROOT}}/../{{PROJECT_NAME}}-[agent-name]-{{JIRA_PROJECT}}-XX
+
+All code changes will be made in this isolated directory.
+```
+
+### 7. Update Jira (if not already done)
+
+If the ticket is not already "In Progress":
+- Transition ticket to "In Progress"
+- Add comment: "Starting work. Branch: `feature/{{JIRA_PROJECT}}-XX-[description]`"
+
+## Important Notes
+
+- **Never work in the main repository** when a worktree is active for your ticket
+- **One worktree per ticket** - if you already have a worktree for this ticket, use it instead of creating a new one
+- **Worktree cleanup** is handled by the Engineering Manager after PR merge via `/worktree-cleanup`
+
+## Error Handling
+
+**If worktree already exists:**
+```bash
+# Check existing worktrees
+git worktree list
+
+# If your worktree exists, just use it
+cd ../{{PROJECT_NAME}}-[agent-name]-{{JIRA_PROJECT}}-XX
+```
+
+**If branch already exists:**
+```bash
+# Use existing branch in new worktree
+git worktree add ../{{PROJECT_NAME}}-[agent-name]-{{JIRA_PROJECT}}-XX feature/{{JIRA_PROJECT}}-XX-[description]
+```
+
+## Completion
+
+After setup, announce:
+```
+Worktree ready for {{JIRA_PROJECT}}-XX
+
+Directory: {{PROJECT_ROOT}}/../{{PROJECT_NAME}}-[agent-name]-{{JIRA_PROJECT}}-XX
+Branch: feature/{{JIRA_PROJECT}}-XX-[description]
+
+Ready to begin implementation.
+```
+
+Now proceed with the worktree setup.