# @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*