oh-my-ag 1.2.0

package/.agent/skills/orchestrator/config/cli-config.yaml

@@ -0,0 +1,78 @@
+# SubAgent CLI Configuration
+# Select your preferred CLI vendor for sub-agent execution
+
+# Default CLI vendor (used as fallback when user-preferences.yaml is not configured)
+# For per-agent CLI mapping, see: .agent/config/user-preferences.yaml
+active_vendor: gemini
+
+# Vendor configurations
+vendors:
+  gemini:
+    command: gemini
+    prompt_flag: "-p"
+    output_format_flag: "--output-format"
+    output_format: "json"
+    auto_approve_flag: "--approval-mode=yolo"
+    model_flag: "-m"
+    default_model: "gemini-2.5-pro"
+    include_dirs_flag: "--include-directories"
+    # JSON output parsing
+    response_jq: ".response"
+    # Isolation: gemini uses current directory context
+    isolation_method: "directory"
+
+  claude:
+    command: claude
+    prompt_flag: "-p"
+    output_format_flag: "--output-format"
+    output_format: "json"
+    auto_approve_flag: "--dangerously-skip-permissions"
+    model_flag: "--model"
+    default_model: "sonnet"
+    # Additional flags to isolate from global settings
+    isolation_flags: "--setting-sources \"\""
+    # JSON output parsing
+    response_jq: ".result"
+    isolation_method: "flags"
+
+  codex:
+    command: codex
+    prompt_flag: "-p"
+    output_format_flag: "--output-format"
+    output_format: "json"
+    auto_approve_flag: "--full-auto"
+    model_flag: "-m"
+    default_model: "codex-3"
+    # Environment variable for isolation
+    isolation_env: "CODEX_HOME=/tmp/codex-subagent-$$"
+    response_jq: ".response"
+    isolation_method: "env"
+
+  qwen:
+    command: qwen
+    prompt_flag: "-p"
+    output_format_flag: "--format"
+    output_format: "json"
+    auto_approve_flag: "--auto"
+    model_flag: "--model"
+    default_model: "qwen3-coder"
+    response_jq: ".output"
+    isolation_method: "directory"
+
+# SubAgent execution settings
+execution:
+  # Directory for subagent results
+  results_dir: ".agent/results"
+  # Timeout in seconds (0 = no timeout)
+  timeout: 600
+  # Log level: debug, info, warn, error
+  log_level: info
+  # Keep intermediate files for debugging
+  keep_temp_files: false
+
+# Workspace configuration for parallel execution
+workspaces:
+  backend: "./backend"
+  frontend: "./frontend"
+  mobile: "./mobile"
+  shared: "./shared"

package/.agent/skills/orchestrator/resources/memory-schema.md

@@ -0,0 +1,212 @@
+# MCP Memory Schema for Multi-Agent Orchestration
+
+## Overview
+
+Each subagent writes only to its own dedicated files. The orchestrator manages session-level files. This ownership model prevents write conflicts between concurrent agents.
+
+## Configuration
+
+Memory base path and tool names are configurable via `mcp.json`:
+```json
+{
+  "memoryConfig": {
+    "basePath": ".serena/memories",
+    "tools": {
+      "read": "read_memory",
+      "write": "write_memory",
+      "edit": "edit_memory"
+    }
+  }
+}
+```
+
+Default base path: `.serena/memories`
+
+## File Structure
+
+```
+{memoryConfig.basePath}/
+  orchestrator-session.md    # Session metadata (orchestrator only)
+  task-board.md              # Master task list (orchestrator writes, agents read)
+  progress-{agent-id}.md    # Per-agent progress log (owning agent only)
+  result-{agent-id}.md      # Per-agent final result (owning agent only)
+```
+
+## orchestrator-session.md
+
+Created by the orchestrator at session start. Updated throughout execution.
+
+```markdown
+# Orchestrator Session
+## ID: session-{YYYYMMDD}-{HHMMSS}
+## Started: {ISO timestamp}
+## Status: running | completed | failed | aborted
+
+## Agents
+| Agent ID | CLI | PID | Status | Task |
+|----------|-----|-----|--------|------|
+| backend  | gemini | 12345 | running | task-1 |
+| frontend | gemini | 12346 | completed | task-2 |
+| mobile   | claude | 12347 | running | task-3 |
+
+## Configuration
+- MAX_PARALLEL: 3
+- MAX_RETRIES: 2
+- POLL_INTERVAL: 30s
+
+## Summary (filled on completion)
+- Total Tasks: X
+- Completed: X
+- Failed: X
+- Files Created: [list]
+- Issues: [list]
+```
+
+## task-board.md
+
+Master task list created by the orchestrator. Subagents read this to understand their assignment but never write to it.
+
+```markdown
+# Task Board
+## Session: session-{YYYYMMDD}-{HHMMSS}
+
+### task-1
+- **Agent**: backend
+- **CLI**: gemini
+- **Title**: JWT authentication API
+- **Status**: pending | in_progress | completed | failed | blocked
+- **Priority**: 1
+- **Dependencies**: none
+- **Description**: Implement user registration and login with JWT tokens
+- **Acceptance Criteria**:
+  - POST /api/auth/register with email + password
+  - POST /api/auth/login returns access + refresh tokens
+  - Password hashing with bcrypt
+  - Rate limiting on auth endpoints
+
+### task-2
+- **Agent**: frontend
+- **CLI**: gemini
+- **Title**: Login and registration UI
+- **Status**: pending
+- **Priority**: 1
+- **Dependencies**: none
+- **Description**: Build login and registration forms with validation
+- **Acceptance Criteria**:
+  - Login form with email + password
+  - Registration form with validation
+  - Error handling for failed auth
+  - JWT token storage and auto-refresh
+
+### task-3
+- **Agent**: qa
+- **CLI**: gemini
+- **Title**: Security and performance review
+- **Status**: blocked
+- **Priority**: 2
+- **Dependencies**: task-1, task-2
+- **Description**: Review all deliverables for security and performance
+- **Acceptance Criteria**:
+  - OWASP Top 10 security check
+  - Performance benchmarks pass
+  - No critical or high severity issues
+```
+
+## progress-{agent-id}.md
+
+Each agent creates this file at start and appends entries every 3-5 turns. Only the owning agent writes to this file.
+
+```markdown
+# Progress: backend
+## Task: task-1
+## Agent ID: backend
+## Started: {ISO timestamp}
+
+### Turn 1 - {ISO timestamp}
+- **Action**: Reading task-board.md and understanding requirements
+- **Status**: in_progress
+- **Details**: Identified 4 acceptance criteria for JWT auth API
+
+### Turn 5 - {ISO timestamp}
+- **Action**: Created user model and auth endpoints
+- **Status**: in_progress
+- **Details**: Implemented POST /api/auth/register and /api/auth/login
+- **Files**: app/models/user.py, app/api/auth.py
+
+### Turn 12 - {ISO timestamp}
+- **Action**: Added tests and rate limiting
+- **Status**: in_progress
+- **Details**: 15 test cases passing, rate limiter configured
+
+### Turn 18 - {ISO timestamp}
+- **Action**: All acceptance criteria met
+- **Status**: completed
+- **Summary**: JWT auth API fully implemented with tests
+```
+
+## result-{agent-id}.md
+
+Each agent creates this file upon completion (success or failure). Only the owning agent writes to this file.
+
+```markdown
+# Result: backend
+## Task: task-1
+## Status: completed
+## Turns Used: 18
+
+## Summary
+Implemented JWT authentication API with user registration, login,
+password hashing (bcrypt), and rate limiting.
+
+## Files Created/Modified
+- `app/models/user.py` (NEW) - User model with password hashing
+- `app/api/auth.py` (NEW) - Auth endpoints
+- `app/middleware/rate_limit.py` (NEW) - Rate limiting middleware
+- `tests/test_auth.py` (NEW) - 15 test cases
+- `alembic/versions/001_create_users.py` (NEW) - Migration
+
+## Acceptance Criteria
+- [x] POST /api/auth/register with email + password
+- [x] POST /api/auth/login returns access + refresh tokens
+- [x] Password hashing with bcrypt
+- [x] Rate limiting on auth endpoints
+
+## Issues Encountered
+- None
+
+## Notes
+- Access token expiry: 15 minutes
+- Refresh token expiry: 7 days
+- Rate limit: 5 requests/minute on login endpoint
+```
+
+### Failed Result Example
+
+```markdown
+# Result: backend
+## Task: task-1
+## Status: failed
+## Turns Used: 20
+
+## Summary
+Unable to complete JWT auth API. Database connection issues prevented testing.
+
+## Files Created/Modified
+- `app/models/user.py` (NEW) - User model (untested)
+- `app/api/auth.py` (NEW) - Auth endpoints (untested)
+
+## Acceptance Criteria
+- [x] POST /api/auth/register with email + password
+- [x] POST /api/auth/login returns access + refresh tokens
+- [x] Password hashing with bcrypt
+- [ ] Rate limiting on auth endpoints (NOT DONE)
+
+## Issues Encountered
+- PostgreSQL connection refused on localhost:5432
+- Could not run integration tests
+- Rate limiting implementation incomplete due to turn limit
+
+## Notes
+- Needs database running to complete testing
+- Rate limiting code is written but untested
+```

package/.agent/skills/orchestrator/resources/subagent-prompt-template.md

@@ -0,0 +1,153 @@
+# Subagent Prompt Template
+
+This template is used by the orchestrator to construct self-contained prompts for CLI subagents launched via `gemini -p "..." --approval-mode=yolo`.
+
+## Template
+
+The orchestrator fills in the `{placeholders}` and passes the assembled prompt to `gemini -p`.
+
+---
+
+```
+You are a {AGENT_ROLE} working as part of an automated multi-agent system.
+You have been assigned a specific task and must complete it autonomously.
+
+## Your Expertise
+
+{AGENT_SKILL_CONTENT}
+
+## Assigned Task
+
+**Task ID**: {TASK_ID}
+**Title**: {TASK_TITLE}
+**Priority**: {TASK_PRIORITY}
+
+### Description
+{TASK_DESCRIPTION}
+
+### Acceptance Criteria
+{ACCEPTANCE_CRITERIA}
+
+## Working Directory
+{WORKSPACE_PATH}
+
+## Turn Limit
+You have a maximum of {MAX_TURNS} turns to complete this task.
+If you are running low on turns, prioritize:
+1. Save your current progress to the result file
+2. Document what remains incomplete
+3. Ensure created files are in a usable state
+
+## MCP Memory Protocol
+
+You have access to MCP memory tools for shared state coordination.
+Tool names are configurable via `mcp.json → memoryConfig.tools`:
+- `[READ]` → default: `read_memory`
+- `[WRITE]` → default: `write_memory`
+- `[EDIT]` → default: `edit_memory`
+
+Follow this protocol exactly:
+
+### On Start (Turn 1)
+1. Read your task assignment:
+   ```
+   [READ]("task-board.md")
+   ```
+2. Create your progress file:
+   ```
+   [WRITE]("progress-{AGENT_ID}.md", initial content)
+   ```
+   Initial content:
+   ```markdown
+   # Progress: {AGENT_ID}
+   ## Task: {TASK_ID}
+   ## Agent ID: {AGENT_ID}
+   ## Started: {current ISO timestamp}
+
+   ### Turn 1 - {current ISO timestamp}
+   - **Action**: Reading task assignment and planning approach
+   - **Status**: in_progress
+   ```
+
+### During Execution (Every 3-5 Turns)
+Update your progress file by appending a new turn entry:
+```
+[EDIT]("progress-{AGENT_ID}.md", append turn entry)
+```
+
+Turn entry format:
+```markdown
+### Turn {N} - {current ISO timestamp}
+- **Action**: {what you did}
+- **Status**: in_progress
+- **Details**: {specifics}
+- **Files**: {files created or modified, if any}
+```
+
+### On Completion
+Create your result file:
+```
+[WRITE]("result-{AGENT_ID}.md", final result)
+```
+
+Result format:
+```markdown
+# Result: {AGENT_ID}
+## Task: {TASK_ID}
+## Status: completed
+## Turns Used: {N}
+
+## Summary
+{Brief summary of what was accomplished}
+
+## Files Created/Modified
+{List each file with NEW or MODIFIED tag and brief description}
+
+## Acceptance Criteria
+{Checklist of acceptance criteria with [x] or [ ]}
+
+## Issues Encountered
+{Any issues, or "None"}
+
+## Notes
+{Any additional notes for the orchestrator or other agents}
+```
+
+### On Failure
+If you cannot complete the task, still create the result file:
+- Set Status to `failed`
+- List what was completed and what remains
+- Describe the error or blocker in Issues Encountered
+
+### On Turn Limit Approaching
+If you reach turn {MAX_TURNS_WARNING} (3 turns before limit):
+1. Immediately update progress with current state
+2. Create result file with whatever is complete
+3. Set Status to `completed` if criteria are met, `failed` if not
+
+## Rules
+
+1. **Stay in scope**: Only work on your assigned task. Do not modify files outside your task's domain.
+2. **No destructive actions without checking**: Before deleting or overwriting files, verify they belong to your task scope.
+3. **Write tests**: Include tests for any code you create.
+4. **Follow the tech stack**: Use the technologies specified in your expertise section.
+5. **Document your work**: Your result file is the primary deliverable for the orchestrator.
+```
+
+---
+
+## Placeholder Reference
+
+| Placeholder | Source | Example |
+|-------------|--------|---------|
+| `{AGENT_ROLE}` | Agent SKILL.md title | "Backend Specialist" |
+| `{AGENT_ID}` | Task assignment | "backend" |
+| `{AGENT_SKILL_CONTENT}` | Agent SKILL.md (tech stack, architecture, checklist sections) | Full markdown content |
+| `{TASK_ID}` | task-board.md | "task-1" |
+| `{TASK_TITLE}` | task-board.md | "JWT authentication API" |
+| `{TASK_PRIORITY}` | task-board.md | "1" |
+| `{TASK_DESCRIPTION}` | task-board.md | Full description text |
+| `{ACCEPTANCE_CRITERIA}` | task-board.md | Bulleted list |
+| `{WORKSPACE_PATH}` | Orchestrator config | "/path/to/project" |
+| `{MAX_TURNS}` | Orchestrator config | "20" |
+| `{MAX_TURNS_WARNING}` | MAX_TURNS - 3 | "17" |