aiox-core 5.0.0

package/docs/guides/agents/traces/devops-execution-trace.md

@@ -0,0 +1,764 @@
+# @devops (Gage) - Execution Trace
+
+> Traced from source code, not documentation.
+> Agent definition: `.aiox-core/development/agents/devops.md`
+
+## 1. Activation Trace
+
+### 1.1 Files Loaded (in order)
+
+| Order | File | Loader | Purpose |
+|-------|------|--------|---------|
+| 1 | `.aiox-core/development/agents/devops.md` | AgentConfigLoader.loadAgentDefinition() | Agent definition (YAML block) |
+| 2 | `.aiox-core/core-config.yaml` | GreetingBuilder._loadConfig() | Core configuration |
+| 3 | `.aiox-core/data/agent-config-requirements.yaml` | AgentConfigLoader.loadRequirements() | Config sections: dataLocation, cicdLocation |
+| 4 | `.aiox-core/data/workflow-patterns.yaml` | WorkflowNavigator._loadPatterns() | Workflow state detection |
+| 5 | `.aiox-core/data/technical-preferences.md` | AgentConfigLoader.loadFile() | Technical preferences (always loaded, 15KB) |
+| 6 | `.aiox/session-state.json` | ContextDetector._detectFromFile() | Session type detection (if no conversation history) |
+| 7 | `.aiox/project-status.yaml` | ProjectStatusLoader.loadCache() | Cached project status (60s TTL) |
+
+### 1.2 Greeting Construction
+
+**Activation path:** CLI wrapper (`generate-greeting.js` calls `GreetingBuilder.buildGreeting()`)
+
+```mermaid
+sequenceDiagram
+    participant CC as Claude Code
+    participant DMd as devops.md
+    participant GG as generate-greeting.js
+    participant ACL as AgentConfigLoader
+    participant GB as GreetingBuilder
+    participant GPM as GreetingPreferenceManager
+    participant CD as ContextDetector
+    participant GCD as GitConfigDetector
+    participant PSL as ProjectStatusLoader
+    participant PM as PermissionMode
+    participant RD as repository-detector.js
+
+    CC->>DMd: Load agent file (STEP 1)
+    CC->>DMd: Adopt persona (STEP 2)
+    CC->>ACL: loadAgentDefinition('devops')
+    ACL-->>CC: { agent: { name: 'Gage', icon: '⚡' }, commands: [...30], ... }
+
+    CC->>GG: execute generate-greeting.js (CLI wrapper)
+    GG->>GB: new GreetingBuilder()
+    Note over GB: Loads ContextDetector, GitConfigDetector,<br/>WorkflowNavigator, GreetingPreferenceManager,<br/>core-config.yaml
+
+    GG->>GB: buildGreeting(agentDef, context)
+    GB->>GPM: getPreference()
+    GPM-->>GB: 'auto' (default)
+
+    GB->>GB: _buildContextualGreeting()
+    GB->>CD: detectSessionType([])
+    CD-->>GB: 'new' (first activation)
+    GB->>PSL: loadProjectStatus()
+    PSL-->>GB: { branch, modifiedFiles, currentStory, ... }
+    GB->>GCD: get()
+    GCD-->>GB: { configured: true, type: 'github', branch: '...' }
+    GB->>PM: load() → getBadge()
+    PM-->>GB: '[Ask]'
+
+    Note over GB: Assemble sections:<br/>1. Presentation (archetypal + badge)<br/>2. Role Description (new session)<br/>3. Project Status<br/>4. Commands (full visibility)<br/>5. Footer + signature
+
+    GB-->>GG: Formatted greeting
+    GG-->>CC: Return greeting string
+    CC->>RD: repository-detector.js (detect repo context)
+    RD-->>CC: { mode: 'framework-dev'|'project-dev', remote: '...' }
+    CC->>CC: Display greeting (STEP 4)
+    CC->>CC: HALT and await input (STEP 5)
+```
+
+### 1.3 Agent-Specific Config
+
+From `agent-config-requirements.yaml`:
+
+```yaml
+devops:
+  config_sections:
+    - dataLocation
+    - cicdLocation
+  files_loaded:
+    - path: .aiox-core/data/technical-preferences.md
+      lazy: false
+      size: 15KB
+  lazy_loading: {}
+  performance_target: <50ms
+```
+
+### 1.4 Context Brought to Session
+
+| Data | Source | Value |
+|------|--------|-------|
+| Greeting level | `persona_profile.greeting_levels.archetypal` | `⚡ Gage the Operator ready to deploy!` |
+| Signature | `persona_profile.communication.signature_closing` | `— Gage, deployando com confianca 🚀` |
+| Role | `persona.role` | GitHub Repository Guardian & Release Manager |
+| Commands shown | `filterCommandsByVisibility('full')` | 30 commands with `full` visibility |
+
+---
+
+## 2. Command Registry
+
+| Command | Task File | Category | Elicit |
+|---------|-----------|----------|--------|
+| `*help` | (built-in) | Core | No |
+| `*detect-repo` | (built-in, uses repository-detector.js) | Core | No |
+| `*version-check` | github-devops-version-management.md | Quality & Push | No |
+| `*pre-push` | github-devops-pre-push-quality-gate.md | Quality & Push | No |
+| `*push` | (built-in, orchestrates quality gates + git push) | Quality & Push | Yes |
+| `*create-pr` | github-devops-github-pr-automation.md | GitHub | Yes |
+| `*configure-ci` | ci-cd-configuration.md | GitHub | Yes |
+| `*release` | release-management.md | GitHub | Yes |
+| `*cleanup` | github-devops-repository-cleanup.md | Repository | Yes |
+| `*init-project-status` | init-project-status.md | Repository | No |
+| `*environment-bootstrap` | environment-bootstrap.md | Environment | Yes |
+| `*setup-github` | setup-github.md | Environment | Yes |
+| `*search-mcp` | search-mcp.md | MCP Management | No |
+| `*add-mcp` | add-mcp.md | MCP Management | Yes |
+| `*list-mcps` | list-mcps.md | MCP Management | No |
+| `*remove-mcp` | remove-mcp.md | MCP Management | Yes |
+| `*setup-mcp-docker` | setup-mcp-docker.md | MCP Management | Yes |
+| `*check-docs` | check-docs-links.md | Documentation | No |
+| `*create-worktree` | create-worktree.md | Worktree | Yes |
+| `*list-worktrees` | list-worktrees.md | Worktree | No |
+| `*remove-worktree` | remove-worktree.md | Worktree | Yes |
+| `*cleanup-worktrees` | cleanup-worktrees.md | Worktree | Yes |
+| `*merge-worktree` | merge-worktree.md | Worktree | Yes |
+| `*inventory-assets` | (uses asset-inventory.js) | Migration | No |
+| `*analyze-paths` | (uses path-analyzer.js) | Migration | No |
+| `*migrate-agent` | (uses migrate-agent.js) | Migration | Yes |
+| `*migrate-batch` | (uses migrate-agent.js in batch mode) | Migration | Yes |
+| `*session-info` | (built-in) | Utilities | No |
+| `*guide` | (built-in, rendered from agent .md) | Utilities | No |
+| `*exit` | (built-in) | Utilities | No |
+
+---
+
+## 3. Per-Command Execution Traces
+
+### `*pre-push`
+
+**Task file:** `.aiox-core/development/tasks/github-devops-pre-push-quality-gate.md`
+
+**Dependencies loaded:**
+| File | Type | Status |
+|------|------|--------|
+| `github-devops-pre-push-quality-gate.md` | Task | EXISTS |
+| `pre-push-checklist.md` | Checklist | EXISTS (at `.aiox-core/product/checklists/`) |
+
+**Execution flow:**
+
+```mermaid
+flowchart TD
+    A["*pre-push"] --> B[Load github-devops-pre-push-quality-gate.md]
+    B --> C[Check for uncommitted changes]
+    C --> D{Clean working tree?}
+    D -->|no| E[Error: commit or stash changes first]
+    D -->|yes| F["Run: npm run lint"]
+    F --> G["Run: npm test"]
+    G --> H["Run: npm run typecheck"]
+    H --> I["Run: npm run build"]
+    I --> J["Run: CodeRabbit --prompt-only --base main"]
+    J --> K{All gates PASS?}
+    K -->|yes| L[Present quality gate summary to user]
+    K -->|no| M[Report failures, block push]
+    L --> N[Ready for *push or *create-pr]
+```
+
+**Tools used:** git (status check), coderabbit (code review), npm (lint/test/typecheck/build)
+
+---
+
+### `*push`
+
+**Task file:** Built-in (orchestrates quality gates + git push)
+
+**Dependencies loaded:**
+| File | Type | Status |
+|------|------|--------|
+| `github-devops-pre-push-quality-gate.md` | Task | EXISTS |
+| `repository-detector.js` | Script | EXISTS (at `.aiox-core/infrastructure/scripts/`) |
+
+**Execution flow:**
+
+```mermaid
+flowchart TD
+    A["*push"] --> B[Detect repository context]
+    B --> C[Run *pre-push quality gates]
+    C --> D{All gates PASS?}
+    D -->|no| E[Report failures, abort push]
+    D -->|yes| F[Present summary to user]
+    F --> G{User confirms?}
+    G -->|no| H[Abort push]
+    G -->|yes| I["Execute: git push origin {branch}"]
+    I --> J{Push successful?}
+    J -->|yes| K[Report success with remote URL]
+    J -->|no| L[Report error, suggest resolution]
+    K --> M{Feature branch?}
+    M -->|yes| N[Suggest *create-pr]
+    M -->|no| O[Done]
+```
+
+**EXCLUSIVE AUTHORITY:** This is the ONLY agent authorized to execute `git push`.
+
+---
+
+### `*create-pr`
+
+**Task file:** `.aiox-core/development/tasks/github-devops-github-pr-automation.md`
+
+**Dependencies loaded:**
+| File | Type | Status |
+|------|------|--------|
+| `github-devops-github-pr-automation.md` | Task | EXISTS |
+| `github-pr-template.md` | Template | EXISTS (at `.aiox-core/product/templates/`) |
+
+**Execution flow:**
+
+```mermaid
+flowchart TD
+    A["*create-pr"] --> B[Load github-devops-github-pr-automation.md]
+    B --> C[Detect repository and current branch]
+    C --> D[Run CodeRabbit pre-PR review]
+    D --> E{CRITICAL issues?}
+    E -->|yes| F[Block PR creation, report issues]
+    E -->|no| G[Generate PR description from commits]
+    G --> H[Load github-pr-template.md]
+    H --> I[Fill template with story context]
+    I --> J[Elicit: confirm PR title and description]
+    J --> K["Execute: gh pr create"]
+    K --> L[Report PR URL]
+    L --> M[Post CodeRabbit summary as PR comment]
+```
+
+**Tools used:** github-cli (PR creation), coderabbit (pre-PR review), git (commit analysis)
+
+---
+
+### `*version-check`
+
+**Task file:** `.aiox-core/development/tasks/github-devops-version-management.md`
+
+**Dependencies loaded:**
+| File | Type | Status |
+|------|------|--------|
+| `github-devops-version-management.md` | Task | EXISTS |
+
+**Execution flow:**
+
+```mermaid
+flowchart TD
+    A["*version-check"] --> B[Load github-devops-version-management.md]
+    B --> C[Read current version from package.json]
+    C --> D[Analyze git diff since last tag]
+    D --> E[Check for breaking change keywords]
+    E --> F[Count features vs fixes in commits]
+    F --> G{Determine version bump}
+    G -->|Breaking changes| H["Recommend MAJOR (v5.0.0)"]
+    G -->|New features| I["Recommend MINOR (v4.32.0)"]
+    G -->|Bug fixes only| J["Recommend PATCH (v4.31.1)"]
+    H --> K[Present recommendation to user]
+    I --> K
+    J --> K
+```
+
+---
+
+### `*release`
+
+**Task file:** `.aiox-core/development/tasks/release-management.md`
+
+**Dependencies loaded:**
+| File | Type | Status |
+|------|------|--------|
+| `release-management.md` | Task | EXISTS |
+| `changelog-template.md` | Template | EXISTS (at `.aiox-core/product/templates/`) |
+| `release-checklist.md` | Checklist | EXISTS (at `.aiox-core/product/checklists/`) |
+
+**Execution flow:**
+
+```mermaid
+flowchart TD
+    A["*release {version}"] --> B[Load release-management.md]
+    B --> C[Run *version-check to validate version]
+    C --> D[Run *pre-push quality gates]
+    D --> E{All gates PASS?}
+    E -->|no| F[Abort release]
+    E -->|yes| G[Generate changelog from commits]
+    G --> H[Load changelog-template.md]
+    H --> I[Elicit: confirm release notes]
+    I --> J["Create git tag v{version}"]
+    J --> K["Execute: git push origin --tags"]
+    K --> L["Execute: gh release create v{version}"]
+    L --> M[Report release URL and changelog]
+```
+
+**Tools used:** git (tagging), github-cli (release creation)
+
+---
+
+### `*configure-ci`
+
+**Task file:** `.aiox-core/development/tasks/ci-cd-configuration.md`
+
+**Dependencies loaded:**
+| File | Type | Status |
+|------|------|--------|
+| `ci-cd-configuration.md` | Task | EXISTS |
+| `github-actions-ci.yml` | Template | EXISTS (at `.aiox-core/product/templates/`) |
+| `github-actions-cd.yml` | Template | EXISTS (at `.aiox-core/product/templates/`) |
+
+**Execution flow:**
+
+```mermaid
+flowchart TD
+    A["*configure-ci"] --> B[Load ci-cd-configuration.md]
+    B --> C[Detect project type and tech stack]
+    C --> D[Elicit: CI/CD requirements]
+    D --> E[Load github-actions-ci.yml template]
+    E --> F[Load github-actions-cd.yml template]
+    F --> G[Customize workflows for project]
+    G --> H["Output: .github/workflows/ci.yml"]
+    H --> I["Output: .github/workflows/cd.yml"]
+    I --> J[Report configuration summary]
+```
+
+---
+
+### `*cleanup`
+
+**Task file:** `.aiox-core/development/tasks/github-devops-repository-cleanup.md`
+
+**Dependencies loaded:**
+| File | Type | Status |
+|------|------|--------|
+| `github-devops-repository-cleanup.md` | Task | EXISTS |
+| `branch-manager.js` | Script | EXISTS (at `.aiox-core/infrastructure/scripts/`) |
+
+**Execution flow:**
+
+```mermaid
+flowchart TD
+    A["*cleanup"] --> B[Load github-devops-repository-cleanup.md]
+    B --> C[Detect repository context]
+    C --> D[Identify merged branches >30 days old]
+    D --> E[Identify stale temporary files]
+    E --> F[Present cleanup candidates to user]
+    F --> G{User confirms?}
+    G -->|no| H[Abort cleanup]
+    G -->|yes| I["Execute: git push origin --delete {branches}"]
+    I --> J[Remove local stale branches]
+    J --> K[Report cleanup summary]
+```
+
+---
+
+### `*environment-bootstrap`
+
+**Task file:** `.aiox-core/development/tasks/environment-bootstrap.md`
+
+**Dependencies loaded:**
+| File | Type | Status |
+|------|------|--------|
+| `environment-bootstrap.md` | Task | EXISTS |
+
+**Execution flow:**
+
+```mermaid
+flowchart TD
+    A["*environment-bootstrap"] --> B[Load environment-bootstrap.md]
+    B --> C[Elicit: project type and requirements]
+    C --> D[Verify CLIs installed: node, npm, gh, git]
+    D --> E[Verify GitHub CLI authentication]
+    E --> F[Configure Git settings for project]
+    F --> G[Setup branch protection rules]
+    G --> H[Initialize project structure]
+    H --> I[Report environment readiness]
+```
+
+---
+
+### `*setup-github`
+
+**Task file:** `.aiox-core/development/tasks/setup-github.md`
+
+**Dependencies loaded:**
+| File | Type | Status |
+|------|------|--------|
+| `setup-github.md` | Task | EXISTS |
+| `github-actions-ci.yml` | Template | EXISTS (at `.aiox-core/product/templates/`) |
+| `github-actions-cd.yml` | Template | EXISTS (at `.aiox-core/product/templates/`) |
+
+**Execution flow:**
+
+```mermaid
+flowchart TD
+    A["*setup-github"] --> B[Load setup-github.md]
+    B --> C[Elicit: repository and DevOps requirements]
+    C --> D[Configure GitHub Actions workflows]
+    D --> E[Setup CodeRabbit integration]
+    E --> F[Configure branch protection rules]
+    F --> G[Setup repository secrets]
+    G --> H[Report DevOps infrastructure status]
+```
+
+---
+
+### `*search-mcp`, `*add-mcp`, `*list-mcps`, `*remove-mcp`, `*setup-mcp-docker`
+
+**Task files:** `search-mcp.md`, `add-mcp.md`, `list-mcps.md`, `remove-mcp.md`, `setup-mcp-docker.md`
+
+**All tasks:** EXISTS
+
+**Execution flow (representative -- `*add-mcp`):**
+
+```mermaid
+flowchart TD
+    A["*add-mcp {name}"] --> B[Load add-mcp.md]
+    B --> C[Search Docker MCP Toolkit catalog]
+    C --> D{MCP found?}
+    D -->|no| E[Error: MCP not available]
+    D -->|yes| F[Elicit: confirm MCP and credentials]
+    F --> G[Add MCP to Docker MCP config]
+    G --> H[Verify MCP tools are available]
+    H --> I[Report MCP installation status]
+```
+
+**Tools used:** docker-gateway (Docker MCP Toolkit management)
+
+---
+
+### `*check-docs`
+
+**Task file:** `.aiox-core/development/tasks/check-docs-links.md`
+
+**Dependencies loaded:**
+| File | Type | Status |
+|------|------|--------|
+| `check-docs-links.md` | Task | EXISTS |
+
+**Execution flow:**
+
+```mermaid
+flowchart TD
+    A["*check-docs"] --> B[Load check-docs-links.md]
+    B --> C[Scan documentation files for links]
+    C --> D[Verify internal links resolve to existing files]
+    D --> E[Check for broken external URLs]
+    E --> F[Identify incorrect link markings]
+    F --> G[Report link integrity results]
+```
+
+---
+
+### `*create-worktree`, `*list-worktrees`, `*remove-worktree`, `*cleanup-worktrees`, `*merge-worktree`
+
+**Task files:** `create-worktree.md`, `list-worktrees.md`, `remove-worktree.md`, `cleanup-worktrees.md`, `merge-worktree.md`
+
+**All tasks:** EXISTS
+
+**Workflow file:** `.aiox-core/development/workflows/auto-worktree.yaml` (EXISTS)
+
+**Execution flow (representative -- `*create-worktree`):**
+
+```mermaid
+flowchart TD
+    A["*create-worktree {story-id}"] --> B[Load create-worktree.md]
+    B --> C[Elicit: base branch and story context]
+    C --> D["Create branch: feat/{story-id}"]
+    D --> E["Execute: git worktree add ../{story-id} feat/{story-id}"]
+    E --> F[Initialize worktree with story context]
+    F --> G[Report worktree path and status]
+```
+
+**Execution flow (`*merge-worktree`):**
+
+```mermaid
+flowchart TD
+    A["*merge-worktree {story-id}"] --> B[Load merge-worktree.md]
+    B --> C[Verify worktree exists]
+    C --> D[Run quality gates on worktree branch]
+    D --> E{Gates pass?}
+    E -->|no| F[Report failures, abort merge]
+    E -->|yes| G[Elicit: confirm merge target]
+    G --> H["Execute: git merge feat/{story-id}"]
+    H --> I[Remove worktree after merge]
+    I --> J[Report merge result]
+```
+
+---
+
+### `*inventory-assets`, `*analyze-paths`, `*migrate-agent`, `*migrate-batch`
+
+**Scripts:** `.aiox-core/infrastructure/scripts/asset-inventory.js`, `path-analyzer.js`, `migrate-agent.js`
+
+**All scripts:** EXISTS
+
+**Execution flow (representative -- `*migrate-agent`):**
+
+```mermaid
+flowchart TD
+    A["*migrate-agent {agent-name}"] --> B[Load migrate-agent.js]
+    B --> C[Read V2 agent definition]
+    C --> D[Analyze V2 structure and dependencies]
+    D --> E[Transform to V3 format]
+    E --> F[Elicit: confirm migration changes]
+    F --> G[Write V3 agent definition]
+    G --> H[Validate migrated agent]
+    H --> I[Report migration result]
+```
+
+---
+
+### `*init-project-status`
+
+**Task file:** `.aiox-core/development/tasks/init-project-status.md`
+
+**Dependencies loaded:**
+| File | Type | Status |
+|------|------|--------|
+| `init-project-status.md` | Task | EXISTS |
+
+**Execution flow:**
+
+```mermaid
+flowchart TD
+    A["*init-project-status"] --> B[Load init-project-status.md]
+    B --> C[Detect project structure]
+    C --> D[Scan for stories, branches, open PRs]
+    D --> E["Create: .aiox/project-status.yaml"]
+    E --> F[Report project status initialized]
+```
+
+---
+
+### `*help`, `*guide`, `*session-info`, `*detect-repo`, `*exit`
+
+These are built-in commands handled by the agent framework, not external task files.
+
+| Command | Behavior |
+|---------|----------|
+| `*help` | Renders full command list from `commands[]` in agent definition |
+| `*guide` | Renders the `## ⚡ DevOps Guide` section from agent .md |
+| `*session-info` | Shows session context (agent history, commands, project status) |
+| `*detect-repo` | Calls `repository-detector.js` to identify repo URL and installation mode |
+| `*exit` | Exits devops mode, returns to base Claude Code |
+
+---
+
+## 4. Complete Dependency Graph
+
+```mermaid
+graph TD
+    subgraph "Agent Definition"
+        AD[devops.md]
+    end
+
+    subgraph "Activation Pipeline"
+        GG[generate-greeting.js]
+        GB[greeting-builder.js]
+        ACL[agent-config-loader.js]
+        CD[context-detector.js]
+        GCD[git-config-detector.js]
+        PSL[project-status-loader.js]
+        GPM[greeting-preference-manager.js]
+        WN[workflow-navigator.js]
+        PM[permissions/index.js]
+    end
+
+    subgraph "Config Files"
+        CC[core-config.yaml]
+        ACR[agent-config-requirements.yaml]
+        WP[workflow-patterns.yaml]
+        TP[technical-preferences.md]
+    end
+
+    subgraph "Task Files (19/19 EXIST)"
+        T1[environment-bootstrap.md]
+        T2[setup-github.md]
+        T3[github-devops-version-management.md]
+        T4[github-devops-pre-push-quality-gate.md]
+        T5[github-devops-github-pr-automation.md]
+        T6[ci-cd-configuration.md]
+        T7[github-devops-repository-cleanup.md]
+        T8[release-management.md]
+        T9[search-mcp.md]
+        T10[add-mcp.md]
+        T11[list-mcps.md]
+        T12[remove-mcp.md]
+        T13[setup-mcp-docker.md]
+        T14[check-docs-links.md]
+        T15[create-worktree.md]
+        T16[list-worktrees.md]
+        T17[remove-worktree.md]
+        T18[cleanup-worktrees.md]
+        T19[merge-worktree.md]
+    end
+
+    subgraph "Workflow (1/1 EXISTS)"
+        W1[auto-worktree.yaml]
+    end
+
+    subgraph "Templates (0/4 at declared path)"
+        TM1["github-pr-template.md<br/>(EXISTS at product/templates/)"]
+        TM2["github-actions-ci.yml<br/>(EXISTS at product/templates/)"]
+        TM3["github-actions-cd.yml<br/>(EXISTS at product/templates/)"]
+        TM4["changelog-template.md<br/>(EXISTS at product/templates/)"]
+    end
+
+    subgraph "Checklists (0/2 at declared path)"
+        CL1["pre-push-checklist.md<br/>(EXISTS at product/checklists/)"]
+        CL2["release-checklist.md<br/>(EXISTS at product/checklists/)"]
+    end
+
+    subgraph "Infrastructure Scripts (3/3 EXIST)"
+        S1[asset-inventory.js]
+        S2[path-analyzer.js]
+        S3[migrate-agent.js]
+    end
+
+    subgraph "Utils (3/5 EXIST)"
+        U1[branch-manager.js]
+        U2[repository-detector.js]
+        U3[git-wrapper.js]
+    end
+
+    subgraph "Utils MISSING"
+        UM1[gitignore-manager]
+        UM2[version-tracker]
+    end
+
+    subgraph "Tools"
+        TOOL1[coderabbit]
+        TOOL2[github-cli]
+        TOOL3["git (EXCLUSIVE push)"]
+        TOOL4[docker-gateway]
+    end
+
+    AD --> GG
+    GG --> GB
+    AD --> ACL
+    GB --> CD
+    GB --> GCD
+    GB --> PSL
+    GB --> GPM
+    GB --> WN
+    GB --> PM
+    ACL --> ACR
+    ACL --> CC
+    ACL --> TP
+    WN --> WP
+    GPM --> CC
+
+    AD -.->|commands| T1
+    AD -.->|commands| T2
+    AD -.->|commands| T3
+    AD -.->|commands| T4
+    AD -.->|commands| T5
+    AD -.->|commands| T6
+    AD -.->|commands| T7
+    AD -.->|commands| T8
+    AD -.->|commands| T9
+    AD -.->|commands| T10
+    AD -.->|commands| T11
+    AD -.->|commands| T12
+    AD -.->|commands| T13
+    AD -.->|commands| T14
+    AD -.->|commands| T15
+    AD -.->|commands| T16
+    AD -.->|commands| T17
+    AD -.->|commands| T18
+    AD -.->|commands| T19
+
+    AD -.->|workflow| W1
+
+    T5 -.->|template| TM1
+    T6 -.->|template| TM2
+    T6 -.->|template| TM3
+    T8 -.->|template| TM4
+    T4 -.->|checklist| CL1
+    T8 -.->|checklist| CL2
+
+    AD -.->|script| S1
+    AD -.->|script| S2
+    AD -.->|script| S3
+
+    AD -.->|util| U1
+    AD -.->|util| U2
+    AD -.->|util| U3
+    AD -.->|util| UM1
+    AD -.->|util| UM2
+
+    AD -.->|tool| TOOL1
+    AD -.->|tool| TOOL2
+    AD -.->|tool| TOOL3
+    AD -.->|tool| TOOL4
+```
+
+---
+
+## 5. Cross-Agent Interactions
+
+| Interaction | Direction | Trigger |
+|-------------|-----------|---------|
+| @dev -> @devops | Delegate | Git push and PR creation after story completion |
+| @sm -> @devops | Delegate | Push operations during sprint workflow |
+| @architect -> @devops | Delegate | Repository operations, PR creation |
+| @devops -> @dev | Redirect | Code development tasks (not in scope) |
+| @devops -> @sm | Redirect | Story management tasks (not in scope) |
+| @devops -> @architect | Redirect | Architecture design tasks (not in scope) |
+
+### Delegation Rules (from agent definition)
+
+**Receives delegation from @dev (Dex) when:**
+- Story implementation is complete and needs pushing
+- Pull request creation is required
+- Release tagging is needed after merge
+
+**Receives delegation from @sm (River) when:**
+- Sprint push workflow is triggered
+- Coordinated multi-story push is needed
+
+**Receives delegation from @architect (Aria) when:**
+- Architecture documents need pushing to remote
+- CI/CD pipeline configuration is required
+- Repository structure changes need deployment
+
+**EXCLUSIVE git push authority:**
+- ALLOWED (only @devops): `git push`, `git push --force`, `git push origin --delete`, `gh pr create`, `gh pr merge`, `gh release create`
+- ALL OTHER AGENTS BLOCKED: Must delegate push operations to @devops
+
+**Quality gates are mandatory before any push:**
+- CodeRabbit review (0 CRITICAL issues)
+- `npm run lint` (must PASS)
+- `npm test` (must PASS)
+- `npm run typecheck` (must PASS)
+- `npm run build` (must PASS)
+- Story status = "Done" or "Ready for Review"
+- No uncommitted changes
+- No merge conflicts
+
+**Enforcement mechanism:**
+- Git pre-push hook at `.git/hooks/pre-push`
+- Checks `$AIOX_ACTIVE_AGENT` environment variable
+- Blocks push if agent != "github-devops"
+
+---
+
+## 6. Missing Dependencies
+
+| File | Type | Declared Location | Actual Location | Impact |
+|------|------|-------------------|-----------------|--------|
+| `github-pr-template.md` | Template | `.aiox-core/development/templates/` | `.aiox-core/product/templates/` | Path mismatch -- file exists but at different path |
+| `github-actions-ci.yml` | Template | `.aiox-core/development/templates/` | `.aiox-core/product/templates/` | Path mismatch -- file exists but at different path |
+| `github-actions-cd.yml` | Template | `.aiox-core/development/templates/` | `.aiox-core/product/templates/` | Path mismatch -- file exists but at different path |
+| `changelog-template.md` | Template | `.aiox-core/development/templates/` | `.aiox-core/product/templates/` | Path mismatch -- file exists but at different path |
+| `pre-push-checklist.md` | Checklist | `.aiox-core/development/checklists/` | `.aiox-core/product/checklists/` | Path mismatch -- file exists but at different path |
+| `release-checklist.md` | Checklist | `.aiox-core/development/checklists/` | `.aiox-core/product/checklists/` | Path mismatch -- file exists but at different path |
+| `gitignore-manager` | Util | `.aiox-core/development/utils/` | (not found anywhere) | MISSING -- command may fall back to manual gitignore handling |
+| `version-tracker` | Util | `.aiox-core/development/utils/` | (not found anywhere) | MISSING -- version tracking relies on git tags and package.json |
+
+**Note on path resolution:** The `dependencies.templates` and `dependencies.checklists` in the agent YAML resolve via `IDE-FILE-RESOLUTION` to `.aiox-core/development/{type}/{name}`. However, all 4 templates and 2 checklists actually reside in `.aiox-core/product/{type}/`. The 3 infrastructure scripts (`asset-inventory.js`, `path-analyzer.js`, `migrate-agent.js`) and 3 utils (`branch-manager.js`, `repository-detector.js`, `git-wrapper.js`) exist at `.aiox-core/infrastructure/scripts/`, not at the declared path.
+
+---
+
+*Traced from source on 2026-02-05 | Story AIOX-TRACE-001*