aidevops 2.52.1 → 2.53.2

package/.agent/workflows/session-manager.md

@@ -1,254 +0,0 @@
----
-description: Session lifecycle management and parallel work coordination
-mode: subagent
-tools:
-  read: true
-  write: false
-  edit: false
-  bash: true
-  glob: true
-  grep: true
----
-
-# Session Manager
-
-<!-- AI-CONTEXT-START -->
-
-## Quick Reference
-
-- **Purpose**: Detect session completion, suggest new sessions, spawn parallel work
-- **Triggers**: PR merge, release, topic shift, context limits
-- **Actions**: Suggest @agent-review, new session, worktree + spawn
-
-**Key signals for session completion:**
-- All session tasks marked `[x]` in TODO.md
-- PR merged (`gh pr view --json state`)
-- Release published (`gh release view`)
-- User gratitude phrases
-- Topic shift to unrelated work
-
-<!-- AI-CONTEXT-END -->
-
-## Session Completion Detection
-
-### Automatic Signals
-
-| Signal | Detection Method | Confidence |
-|--------|------------------|------------|
-| Tasks complete | `grep -c '^\s*- \[ \]' TODO.md` returns 0 | High |
-| PR merged | `gh pr view --json state` returns "MERGED" | High |
-| Release published | `gh release view` succeeds for new version | High |
-| User gratitude | "thanks", "done", "that's all", "finished" | Medium |
-| Topic shift | New unrelated task requested | Medium |
-
-### Check Script
-
-```bash
-# Check session completion status
-check_session_status() {
-    echo "=== Session Status ==="
-    
-    # Check incomplete tasks
-    local incomplete
-    incomplete=$(grep -c '^\s*- \[ \]' TODO.md 2>/dev/null || echo "0")
-    echo "Incomplete tasks: $incomplete"
-    
-    # Check recent PR
-    local pr_state
-    pr_state=$(gh pr view --json state --jq '.state' 2>/dev/null || echo "none")
-    echo "Current PR state: $pr_state"
-    
-    # Check latest release vs VERSION
-    local version latest_tag
-    version=$(cat VERSION 2>/dev/null || echo "unknown")
-    latest_tag=$(git describe --tags --abbrev=0 2>/dev/null || echo "none")
-    echo "VERSION: $version, Latest tag: $latest_tag"
-    
-    # Suggest if complete
-    if [[ "$incomplete" == "0" && "$pr_state" == "MERGED" ]]; then
-        echo ""
-        echo "Session appears complete. Consider:"
-        echo "  1. Run @agent-review"
-        echo "  2. Start new session"
-    fi
-}
-```
-
-## Suggestion Templates
-
-### After PR Merge + Release
-
-```text
----
-Session goals achieved:
-- [x] {PR title} (PR #{number} merged)
-- [x] v{version} released
-
-Suggestions:
-1. Run @agent-review to capture learnings
-2. Start new session for next task (clean context)
-3. Continue in current session
-
-For parallel work on related feature:
-  worktree-helper.sh add feature/{next-feature}
----
-```
-
-### Topic Shift Detected
-
-```text
----
-Topic shift detected: {new topic} differs from {current focus}
-
-Suggestions:
-1. Start new session for {new topic} (recommended)
-2. Create worktree for parallel work
-3. Continue in current session (context may become unfocused)
----
-```
-
-### Context Window Warning
-
-When conversation becomes very long:
-
-```text
----
-This session has been running for a while with significant context.
-
-Suggestions:
-1. Run @agent-review to capture session learnings
-2. Start new session with fresh context
-3. Continue (risk of context degradation)
----
-```
-
-## Spawning New Sessions
-
-### Option 1: New Terminal Tab (macOS)
-
-```bash
-# macOS Terminal.app
-spawn_terminal_tab() {
-    local dir="${1:-$(pwd)}"
-    local cmd="${2:-opencode}"
-    osascript -e "tell application \"Terminal\" to do script \"cd '$dir' && $cmd\""
-}
-
-# iTerm
-spawn_iterm_tab() {
-    local dir="${1:-$(pwd)}"
-    local cmd="${2:-opencode}"
-    osascript -e "tell application \"iTerm\" to tell current window to create tab with default profile command \"cd '$dir' && $cmd\""
-}
-
-# Usage
-spawn_terminal_tab ~/Git/project-feature-auth
-```
-
-### Option 2: Background Session
-
-```bash
-# Non-interactive execution
-opencode run "Continue with task X" --agent Build+ &
-
-# Persistent server for multiple sessions
-opencode serve --port 4097 &
-opencode run --attach http://localhost:4097 "Task description" --agent Build+
-```
-
-### Option 3: Worktree + New Session (Recommended)
-
-Best for parallel branch work:
-
-```bash
-# Create worktree
-~/.aidevops/agents/scripts/worktree-helper.sh add feature/parallel-task
-# Output: ~/Git/project-feature-parallel-task/
-
-# Spawn session in worktree (macOS)
-osascript -e 'tell application "Terminal" to do script "cd ~/Git/project-feature-parallel-task && opencode"'
-```
-
-### Linux Terminal Spawning
-
-```bash
-# GNOME Terminal
-gnome-terminal --tab -- bash -c "cd ~/Git/project && opencode; exec bash"
-
-# Konsole
-konsole --new-tab -e bash -c "cd ~/Git/project && opencode"
-
-# Kitty
-kitty @ launch --type=tab --cwd=~/Git/project opencode
-```
-
-## Session Handoff Pattern
-
-When spawning a continuation session:
-
-```bash
-# Export context for new session
-cat > .session-handoff.md << EOF
-# Session Handoff
-
-**Previous session**: $(date)
-**Branch**: $(git branch --show-current)
-**Last commit**: $(git log -1 --oneline)
-
-## Completed
-- {list completed items}
-
-## Continue With
-- {next task description}
-
-## Context
-- {relevant context for continuation}
-EOF
-
-# Spawn with handoff
-opencode run "Read .session-handoff.md and continue the work" --agent Build+
-```
-
-## When to Suggest @agent-review
-
-Agents should suggest `@agent-review` at these points:
-
-1. **After PR merge** - Capture what worked in the PR process
-2. **After release** - Capture release learnings
-3. **After fixing multiple issues** - Pattern recognition opportunity
-4. **After user correction** - Immediate improvement opportunity
-5. **Before starting unrelated work** - Clean context boundary
-6. **After long session** - Capture accumulated learnings
-
-## Integration with Loop Agents
-
-Loop agents (`/preflight-loop`, `/pr-loop`, `/postflight-loop`) should:
-
-1. **Detect completion** - When loop succeeds (all checks pass, PR merged, etc.)
-2. **Suggest next steps** - Offer @agent-review or new session
-3. **Offer spawning** - For parallel work on next task
-
-Example loop completion:
-
-```text
-<promise>PR_MERGED</promise>
-
----
-Loop complete. PR #123 merged successfully.
-
-Suggestions:
-1. Run @agent-review to capture PR process learnings
-2. Start new session for next task
-3. Spawn parallel session: worktree-helper.sh add feature/next-feature
----
-```
-
-## Related
-
-**AGENTS.md is the single source of truth for agent behavior.** This document is supplementary and defers to AGENTS.md where they differ.
-
-- `AGENTS.md` - Root agent instructions (authoritative)
-- `workflows/worktree.md` - Parallel branch development
-- `workflows/ralph-loop.md` - Iterative development loops
-- `tools/build-agent/agent-review.md` - Session review process
-- `tools/opencode/opencode.md` - OpenCode CLI reference

package/.agent/workflows/session-review.md

@@ -1,311 +0,0 @@
----
-description: Review session for completeness, best practices, and knowledge capture
-mode: subagent
-tools:
-  read: true
-  write: false
-  edit: false
-  bash: true
-  glob: true
-  grep: true
-  task: true
----
-
-# Session Review - Completeness and Best Practices Audit
-
-<!-- AI-CONTEXT-START -->
-
-## Quick Reference
-
-- **Purpose**: Review current session for completeness, workflow adherence, and knowledge capture
-- **Trigger**: `/session-review` command, end of significant work, before ending session
-- **Output**: Structured assessment with actionable next steps
-
-**Review Categories**:
-1. Objective completion - all goals achieved?
-2. Workflow adherence - aidevops best practices followed?
-3. Knowledge capture - learnings documented?
-4. Session health - time to end or continue?
-
-**Key Outputs**:
-- Completion score (0-100%)
-- Outstanding items list
-- Knowledge capture recommendations
-- Session continuation advice
-
-<!-- AI-CONTEXT-END -->
-
-## Command Usage
-
-```bash
-/session-review [focus]
-```
-
-**Arguments**:
-- `focus` (optional): Specific area to review (objectives, workflow, knowledge, all)
-
-**Examples**:
-
-```bash
-/session-review              # Full review
-/session-review objectives   # Focus on goal completion
-/session-review workflow     # Focus on best practices
-/session-review knowledge    # Focus on learnings capture
-```
-
-## Review Process
-
-### Step 1: Gather Session Context
-
-Collect information about the current session:
-
-```bash
-# Check current branch and recent commits
-git branch --show-current
-git log --oneline -10
-
-# Check TODO.md for session tasks
-grep -A 20 "## In Progress" TODO.md 2>/dev/null || echo "No TODO.md"
-
-# Check for uncommitted changes
-git status --short
-
-# Check for active Ralph loop (new location, then legacy)
-test -f .agent/loop-state/ralph-loop.local.md && cat .agent/loop-state/ralph-loop.local.md | head -10 || \
-test -f .claude/ralph-loop.local.md && cat .claude/ralph-loop.local.md | head -10
-
-# Check recent PR activity
-gh pr list --state open --limit 5 2>/dev/null || echo "No open PRs"
-```
-
-### Step 2: Objective Completion Assessment
-
-Evaluate what was accomplished:
-
-| Check | Method | Weight |
-|-------|--------|--------|
-| Initial request fulfilled | Compare first message to current state | 40% |
-| TODO items completed | Count `[x]` vs `[ ]` in session scope | 20% |
-| Branch purpose achieved | Compare branch name to commits | 20% |
-| Tests passing (if applicable) | Run test suite | 10% |
-| No blocking errors | Check for unresolved issues | 10% |
-
-**Output format**:
-
-```text
-## Objective Completion: {score}%
-
-### Completed
-- [x] {objective 1}
-- [x] {objective 2}
-
-### Outstanding
-- [ ] {remaining item 1} - {reason/blocker}
-- [ ] {remaining item 2} - {next step needed}
-
-### Scope Changes
-- {any scope additions or reductions during session}
-```
-
-### Step 3: Workflow Adherence Check
-
-Verify aidevops best practices were followed:
-
-| Practice | Check | Status |
-|----------|-------|--------|
-| Pre-edit git check | On feature branch, not main | Required |
-| TODO tracking | Tasks logged in TODO.md | Recommended |
-| Commit hygiene | Atomic commits, clear messages | Required |
-| Quality checks | Linters run before commit | Recommended |
-| Documentation | Changes documented where needed | Situational |
-
-**Check commands**:
-
-```bash
-# Verify not on main
-[[ "$(git branch --show-current)" != "main" ]] && echo "OK: Feature branch" || echo "WARN: On main"
-
-# Check commit message quality
-git log --oneline -5 | while read line; do
-    [[ ${#line} -gt 10 ]] && echo "OK: $line" || echo "WARN: Short message"
-done
-
-# Check for TODO.md updates
-git diff --name-only HEAD~5 | grep -q "TODO.md" && echo "OK: TODO.md updated" || echo "INFO: No TODO.md changes"
-```
-
-**Output format**:
-
-```text
-## Workflow Adherence
-
-### Followed
-- [x] Working on feature branch: {branch-name}
-- [x] Commits are atomic and descriptive
-- [x] {other practices followed}
-
-### Missed
-- [ ] {practice missed} - {recommendation}
-
-### Recommendations
-- {specific improvement for next session}
-```
-
-### Step 4: Knowledge Capture Assessment
-
-Identify learnings that should be preserved:
-
-| Knowledge Type | Capture Location | Priority |
-|----------------|------------------|----------|
-| Bug patterns discovered | Code comments, docs | High |
-| Workflow improvements | Agent files, AGENTS.md | High |
-| Tool discoveries | Relevant subagent | Medium |
-| User preferences | memory/ files | Medium |
-| Temporary workarounds | TODO.md, code comments | Low |
-
-**Questions to assess**:
-
-1. Did the AI make any mistakes that were corrected?
-2. Were any new patterns or approaches discovered?
-3. Did any tools or commands not work as expected?
-4. Were there any "aha" moments worth preserving?
-5. Did the user express preferences worth remembering?
-
-**Output format**:
-
-```text
-## Knowledge Capture
-
-### Should Document
-- {learning 1}: Suggest adding to {location}
-- {learning 2}: Suggest adding to {location}
-
-### Already Captured
-- {item already in code/docs}
-
-### User Preferences Noted
-- {preference to remember for future sessions}
-```
-
-### Step 5: Session Health Assessment
-
-Determine if session should continue or end:
-
-| Signal | Indicates | Recommendation |
-|--------|-----------|----------------|
-| All objectives complete | Session success | End session |
-| PR merged | Major milestone | End or new session |
-| Context becoming stale | Long session | End session |
-| Topic shift requested | New focus needed | New session |
-| Blocked on external | Waiting required | End session |
-| More work in scope | Continuation | Continue |
-
-**Output format**:
-
-```text
-## Session Health
-
-**Status**: {Continue | End Recommended | End Required}
-**Reason**: {explanation}
-
-### If Ending Session
-1. {final action 1 - e.g., commit remaining changes}
-2. {final action 2 - e.g., update TODO.md}
-3. {final action 3 - e.g., run @agent-review}
-
-### If Continuing
-- Next focus: {what to work on next}
-- Estimated remaining: {time estimate}
-
-### For New Sessions
-- {topic 1}: {brief description} - suggest branch: {type}/{name}
-- {topic 2}: {brief description} - suggest branch: {type}/{name}
-```
-
-## Complete Review Output Template
-
-```text
-# Session Review
-
-**Branch**: {branch-name}
-**Duration**: {approximate session length}
-**Date**: {YYYY-MM-DD}
-
----
-
-## Objective Completion: {score}%
-
-### Completed
-{list}
-
-### Outstanding
-{list}
-
----
-
-## Workflow Adherence
-
-### Followed
-{list}
-
-### Improvements Needed
-{list}
-
----
-
-## Knowledge Capture
-
-### Should Document
-{list with locations}
-
-### Action Items
-{specific documentation tasks}
-
----
-
-## Session Recommendation
-
-**Verdict**: {Continue | End Session | Start New Session}
-
-### Immediate Actions
-1. {action 1}
-2. {action 2}
-3. {action 3}
-
-### For Future Sessions
-{list of topics/tasks to start fresh}
-
----
-
-*Review generated by /session-review*
-```
-
-## Integration with Other Workflows
-
-### Before PR Creation
-
-Run `/session-review` before creating a PR to ensure:
-- All intended changes are committed
-- No outstanding items forgotten
-- Documentation is complete
-
-### Before Ending Session
-
-Run `/session-review` to:
-- Capture learnings via `@agent-review`
-- Update TODO.md with any discovered tasks
-- Ensure clean handoff for future sessions
-
-### After Ralph Loop Completion
-
-When a Ralph loop completes, `/session-review` helps:
-- Verify the completion promise was truly met
-- Identify any cleanup needed
-- Suggest next steps
-
-## Related
-
-- `workflows/session-manager.md` - Session lifecycle management
-- `tools/build-agent/agent-review.md` - Agent improvement process
-- `workflows/preflight.md` - Pre-commit quality checks
-- `workflows/postflight.md` - Post-release verification