@devo-bmad-custom/agent-orchestration 1.0.15 → 1.0.17

package/lib/installer.js

@@ -234,6 +234,19 @@ async function install(opts) {
     console.log(chalk.green(`  ✓ .agents/skills/ (${skillFiles.length} files)`));
   }
 
+  // ── Orchestration template ─────────────────────────────────────────────────
+  const pkgOrchSrc = path.join(SRC_DIR, '.agents', 'orchestration', 'session-template.md');
+  if (await fs.pathExists(pkgOrchSrc)) {
+    const destOrch = path.join(projectRoot, '.agents', 'orchestration');
+    await fs.ensureDir(destOrch);
+    const destFile = path.join(destOrch, 'session-template.md');
+    await fs.copy(pkgOrchSrc, destFile, { overwrite: true });
+    const content = await fs.readFile(pkgOrchSrc);
+    newFileEntries.push({ relPath: '.agents/orchestration/session-template.md', hash: sha256(content) });
+    installedCount++;
+    console.log(chalk.green('  ✓ .agents/orchestration/session-template.md'));
+  }
+
   // ── Orphan removal (update only) ──────────────────────────────────────────
   if (isUpdate) {
     const oldEntries = await readFilesManifest(bmadDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devo-bmad-custom/agent-orchestration",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "description": "BMAD Method — AI-native agile workflow system for Claude Code and compatible AI assistants",
   "keywords": [
     "bmad",

package/src/.agents/orchestration/session-template.md

@@ -0,0 +1,94 @@
+# Agent Session: {{session_id}}
+<!-- Fill all {{placeholders}} on creation. Do not leave unfilled placeholders in an active session. -->
+
+## Context
+| Field | Value |
+|-------|-------|
+| **Session ID** | `{{session_id}}` |
+| **Created** | {{iso_timestamp}} |
+| **Creator** | {{creator_role}} (pane `{{creator_pane_id}}`) |
+| **Project Root** | `{{project_root}}` |
+| **Branch** | `{{git_branch}}` |
+| **Base Branch** | `{{base_branch}}` |
+| **Track** | {{track}} <!-- Nano / Small / Compact / Medium / Extended / Large / Review / General --> |
+| **Execution Mode** | {{execution_mode}} <!-- inline / command-blocks / scripts / agent-teams --> |
+| **Session File** | `{{session_file_path}}` |
+
+## Git Snapshot
+<!-- Captured at session start. Refresh with `git status` if session runs long. -->
+
+**Uncommitted files:**
+```
+{{git_status_output}}
+```
+
+**Recent commits (last 5):**
+```
+{{git_log_output}}
+```
+
+**Diff summary (base..HEAD):**
+```
+{{git_diff_stat}}
+```
+
+---
+
+## Track Progress
+<!-- Master agent updates this at the START of each step and marks done when complete. -->
+<!-- Step status: ⬜ pending · 🔄 in-progress · ✅ done · ⛔ blocked · ⏭ skipped -->
+
+**Current Step:** {{current_step_name}} ({{current_step_number, or 1 if General track}} / {{total_steps, or ? if General track}})
+
+| # | Step | Status | Started | Notes |
+|---|------|--------|---------|-------|
+<!-- Master fills this table as the track runs. One row per step. -->
+<!-- Example: | 1 | Target Definition | ✅ done | 14:02 | Targeted depth, branch feature/x | -->
+
+---
+
+## Active Agents
+<!-- Register on startup. Update Status as work progresses. -->
+
+| Pane ID | Role | Status | CWD | Claude Session ID |
+|---------|------|--------|-----|-------------------|
+| {{creator_pane_id}} | {{creator_role}} | active | `{{project_root}}` | — |
+
+**Status values:** `active` · `busy` · `idle` · `ready-to-close` · `closed`
+
+---
+
+## Pane Lifecycle
+<!-- Coordinator checks after every task. Close any pane showing `ready-to-close`. -->
+
+| Pane ID | Role | Task | Status | Agent ✓ | Coord ✓ |
+|---------|------|------|--------|---------|---------|
+<!-- Agent ✓ columns: rb=report-back · sid=session-id · done=task-done -->
+<!-- Coord ✓ columns: exit=/exit sent · kill=kill-pane · closed=status updated · rebal=layout rebalanced -->
+
+---
+
+## Tasks
+<!-- Format: ### TASK-NNN · {status} · {assigned_role} -->
+<!-- Status values: pending · in-progress · blocked · done -->
+
+<!-- Add tasks below. Example:
+### TASK-001 · pending · dev
+- **Description:** Fix the user profile API endpoint
+- **Status:** pending
+- **Acceptance:** API returns 200 with correct user data
+-->
+
+---
+
+## Decisions & Notes
+<!-- Running log of decisions made during this session. Append, never overwrite. -->
+
+- `{{iso_timestamp}}` — Session created. Branch: `{{git_branch}}`.
+
+---
+
+## Blockers
+<!-- Items requiring user input before work can continue. -->
+
+<!-- | ID | Description | Needs | Since | -->

package/src/.agents/skills/tmux-commands/SKILL.md

@@ -212,7 +212,7 @@ case "$MASTER_POS" in
     tmux select-layout main-horizontal
     ;;
   *)
-    tmux select-layout tiled
+    tmux select-layout main-vertical
     ;;
 esac
 sleep 10
@@ -254,7 +254,11 @@ SESSION_NAME=$(tmux display-message -p "#{session_name}")
 WINDOW_ID=$(tmux display-message -p "#{window_id}")
 PROJECT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo "$PWD")
 
-# 3. Find session file
+# 2. Determine role (passed via spawn context — $ROLE should be set)
+ROLE="${ROLE:-unknown}"
+
+# 3. Find session file — SESSION_FILE should be passed explicitly in spawn context.
+#    Fall back to most recent only if not provided (fragile — prefer explicit pass).
 if [ -n "$BMAD_SESSION_ID" ]; then
   SESSION_FILE="$PROJECT_ROOT/_bmad-output/sessions/$BMAD_SESSION_ID/agent-sessions.md"
 else
@@ -336,16 +340,22 @@ SPAWNER_PANE=$(tmux display-message -p "#{pane_id}")
 sleep 10
 tmux split-window -h -c "$PROJECT_ROOT" \
   "claude --dangerously-skip-permissions 'You are the $ROLE agent. \
-FIRST: run /color $ROLE_COLOR then /rename $ROLE-agent. \
 Spawner pane: $SPAWNER_PANE. Session file: $SESSION_FILE. \
+Always use -l flag for message content in tmux send-keys. \
 Always sleep 10 before and after every tmux command. \
 Always append Enter to every tmux send-keys call. \
 Always verify pane exists before targeting it. \
 $TASK_CONTEXT'"
-sleep 10
+sleep 15
 
 # Capture ID
 NEW_PANE_ID=$(tmux list-panes -F "#{pane_id}" | tail -1)
+
+# Set agent identity — spawner sends /color and /rename as separate commands
+sleep 10
+tmux send-keys -t "$NEW_PANE_ID" "/color $ROLE_COLOR" Enter
+sleep 10
+tmux send-keys -t "$NEW_PANE_ID" "/rename ${ROLE}-agent" Enter
 sleep 10
 
 # Set tmux pane title (border label)
@@ -475,7 +485,7 @@ fi
 
 1. **Killing own pane** — always check `TARGET_PANE_ID != $(tmux display-message -p "#{pane_id}")` AND `TARGET_PANE_ID != MASTER_PANE` before `kill-pane`
 2. **No `Enter` on send-keys** — message typed but never submitted
-2. **No sleep between tmux commands** — race conditions, stale pane lists
+3. **No sleep between tmux commands** — race conditions, stale pane lists
 3. **Combining `/color` and `/rename` in one send-keys call** — only the first command runs; send each as a separate call with `sleep 10` between
 4. **Using OSC 2 / `select-pane -T` for naming** — Claude Code overwrites these
 5. **Killing pane without `/exit` first** — leaves partial writes, git locks