# @qa (Quinn) - Execution Trace

> Traced from source code, not documentation.
> Agent definition: `.aiox-core/development/agents/qa.md`

## 1. Activation Trace

### 1.1 Files Loaded (in order)

| Order | File | Loader | Purpose |
|-------|------|--------|---------|
| 1 | `.aiox-core/development/agents/qa.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: qaLocation, dataLocation, storyBacklog |
| 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-core/product/data/test-levels-framework.md` | AgentConfigLoader.loadFile() | Test levels framework (always loaded, 8KB) |
| 7 | `.aiox-core/product/data/test-priorities-matrix.md` | AgentConfigLoader.loadFile() | Test priorities matrix (always loaded, 6KB) |
| 8 | `.aiox/session-state.json` | ContextDetector._detectFromFile() | Session type detection (if no conversation history) |
| 9 | `.aiox/project-status.yaml` | ProjectStatusLoader.loadCache() | Cached project status (60s TTL) |

### 1.2 Greeting Construction

**Activation path:** Direct invocation (STEP 3 calls `GreetingBuilder.buildGreeting()`)

```mermaid
sequenceDiagram
    participant CC as Claude Code
    participant QMd as qa.md
    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

    CC->>QMd: Load agent file (STEP 1)
    CC->>QMd: Adopt persona (STEP 2)
    CC->>ACL: loadAgentDefinition('qa')
    ACL-->>CC: { agent: { name: 'Quinn', icon: '✅' }, commands: [...27], ... }

    CC->>GB: new GreetingBuilder()
    Note over GB: Loads ContextDetector, GitConfigDetector,<br/>WorkflowNavigator, GreetingPreferenceManager,<br/>core-config.yaml

    CC->>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-->>CC: Formatted greeting
    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
qa:
  config_sections:
    - qaLocation
    - dataLocation
    - storyBacklog
  files_loaded:
    - path: .aiox-core/data/technical-preferences.md
      lazy: false
      size: 15KB
    - path: .aiox-core/product/data/test-levels-framework.md
      lazy: false
      size: 8KB
    - path: .aiox-core/product/data/test-priorities-matrix.md
      lazy: false
      size: 6KB
  lazy_loading:
    test_frameworks: false    # Always load
  performance_target: <50ms
```

### 1.4 Context Brought to Session

| Data | Source | Value |
|------|--------|-------|
| Greeting level | `persona_profile.greeting_levels.archetypal` | `✅ Quinn the Guardian ready to perfect!` |
| Signature | `persona_profile.communication.signature_closing` | `— Quinn, guardiao da qualidade 🛡️` |
| Role | `persona.role` | Test Architect with Quality Advisory Authority |
| Commands shown | `filterCommandsByVisibility('full')` | 27 commands with `full` visibility |

---

## 2. Command Registry

| Command | Task File | Visibility | Elicit |
|---------|-----------|------------|--------|
| `*help` | (built-in) | full, quick, key | No |
| `*code-review {scope}` | qa-run-tests.md | full, quick | No |
| `*review {story}` | qa-review-story.md | full, quick, key | No |
| `*review-build {story}` | qa-review-build.md | full, quick, key | No |
| `*gate {story}` | qa-gate.md + qa-gate-tmpl.yaml | full, quick, key | No |
| `*nfr-assess {story}` | qa-nfr-assess.md | full | No |
| `*risk-profile {story}` | qa-risk-profile.md | full | No |
| `*create-fix-request {story}` | qa-create-fix-request.md | full | No |
| `*validate-libraries {story}` | qa-library-validation.md | full | No |
| `*security-check {story}` | qa-security-checklist.md | full | No |
| `*validate-migrations {story}` | qa-migration-validation.md | full | No |
| `*evidence-check {story}` | qa-evidence-requirements.md | full | No |
| `*false-positive-check {story}` | qa-false-positive-detection.md | full | No |
| `*console-check {story}` | qa-browser-console-check.md | full | No |
| `*test-design {story}` | qa-test-design.md | full, quick | Yes |
| `*trace {story}` | qa-trace-requirements.md | full | No |
| `*create-suite {story}` | create-suite.md | full | Yes |
| `*critique-spec {story}` | spec-critique.md | full | No |
| `*backlog-add {story} {type} {priority} {title}` | manage-story-backlog.md (MISSING) | full | No |
| `*backlog-update {item_id} {status}` | manage-story-backlog.md (MISSING) | full | No |
| `*backlog-review` | manage-story-backlog.md (MISSING) | full | No |
| `*session-info` | (built-in) | full | No |
| `*guide` | (built-in, rendered from agent .md) | full, quick | No |
| `*exit` | (built-in) | full | No |

**Note:** 27 commands total. The 3 backlog commands all depend on `manage-story-backlog.md` which does NOT exist on disk. The PO agent has `po-manage-story-backlog.md` but no QA-specific variant exists.

---

## 3. Per-Command Execution Traces

### `*code-review {scope}`

**Task file:** `.aiox-core/development/tasks/qa-run-tests.md`

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `qa-run-tests.md` | Task | EXISTS |

**Execution flow:**

```mermaid
flowchart TD
    A["*code-review {scope}"] --> B[Load qa-run-tests.md task]
    B --> C{Scope?}
    C -->|uncommitted| D[Run CodeRabbit on uncommitted changes]
    C -->|committed| E[Run CodeRabbit on committed changes vs main]
    D --> F[Parse findings by severity]
    E --> F
    F --> G[Report: CRITICAL / HIGH / MEDIUM / LOW counts]
    G --> H[Output review summary]
```

**Tools used:** coderabbit (WSL), git (read-only: diff, status)

---

### `*review {story}`

**Task file:** `.aiox-core/development/tasks/qa-review-story.md`

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `qa-review-story.md` | Task | EXISTS |
| `docs/stories/{storyId}` | Input | Required (story file) |
| `.aiox-core/product/data/test-levels-framework.md` | Data | Loaded at activation |
| `.aiox-core/product/data/test-priorities-matrix.md` | Data | Loaded at activation |

**Execution flow:**

```mermaid
flowchart TD
    A["*review {story}"] --> B[Load qa-review-story.md task]
    B --> C[Load story file from docs/stories/]
    C --> D[Run CodeRabbit pre-scan on committed changes]
    D --> E[Analyze acceptance criteria completeness]
    E --> F[Verify test coverage against requirements]
    F --> G[Check non-functional requirements]
    G --> H[Assess risk profile]
    H --> I[Generate review findings]
    I --> J{Update story QA Results section}
    J --> K[Output comprehensive review report]
```

**Story file permissions:** ONLY authorized to update "QA Results" section.

---

### `*review-build {story}`

**Task file:** `.aiox-core/development/tasks/qa-review-build.md`

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `qa-review-build.md` | Task | EXISTS |
| `docs/stories/{storyId}` | Input | Required |
| `.aiox-core/product/data/test-levels-framework.md` | Data | Loaded at activation |
| `.aiox-core/product/data/test-priorities-matrix.md` | Data | Loaded at activation |

**Execution flow:**

```mermaid
flowchart TD
    A["*review-build {story}"] --> B[Load qa-review-build.md task]
    B --> C[Phase 1: Story & Acceptance Criteria Analysis]
    C --> D[Phase 2: CodeRabbit Automated Scan]
    D --> E[Phase 3: Code Quality Assessment]
    E --> F[Phase 4: Test Coverage Verification]
    F --> G[Phase 5: Security Vulnerability Check]
    G --> H[Phase 6: Performance Anti-Pattern Detection]
    H --> I[Phase 7: NFR Validation]
    I --> J[Phase 8: Risk Assessment Matrix]
    J --> K[Phase 9: Evidence-Based Verification]
    K --> L[Phase 10: Gate Decision & Report Generation]
    L --> M["Output: qa_report.md"]
```

**Note:** 10-phase structured QA review (Epic 6). Outputs `qa_report.md`.

---

### `*gate {story}`

**Task file:** `.aiox-core/development/tasks/qa-gate.md`
**Template:** `.aiox-core/product/templates/qa-gate-tmpl.yaml` (EXISTS in product/templates)

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `qa-gate.md` | Task | EXISTS |
| `qa-gate-tmpl.yaml` | Template | EXISTS (in `.aiox-core/product/templates/`) |
| `docs/stories/{storyId}` | Input | Required |

**Execution flow:**

```mermaid
flowchart TD
    A["*gate {story}"] --> B[Load qa-gate.md task]
    B --> C[Load qa-gate-tmpl.yaml template]
    C --> D[Evaluate story against gate criteria]
    D --> E[Check CodeRabbit findings]
    E --> F[Verify acceptance criteria coverage]
    F --> G[Assess outstanding risks]
    G --> H{Gate Decision}
    H -->|PASS| I[Approve: all criteria met]
    H -->|CONCERNS| J[Approve with documented concerns]
    H -->|FAIL| K[Block: critical issues remain]
    H -->|WAIVED| L[Override with documented rationale]
    I --> M["Output: docs/qa/gates/{storyId}-gate.md"]
    J --> M
    K --> M
    L --> M
```

**Expected output:** Gate decision document with PASS/CONCERNS/FAIL/WAIVED verdict.

---

### `*nfr-assess {story}`

**Task file:** `.aiox-core/development/tasks/qa-nfr-assess.md`

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `qa-nfr-assess.md` | Task | EXISTS |
| `docs/stories/{storyId}` | Input | Required |

**Execution flow:**

```mermaid
flowchart TD
    A["*nfr-assess {story}"] --> B[Load qa-nfr-assess.md task]
    B --> C[Identify NFR categories in story]
    C --> D[Evaluate security requirements]
    D --> E[Evaluate performance requirements]
    E --> F[Evaluate reliability requirements]
    F --> G[Evaluate scalability requirements]
    G --> H[Generate NFR assessment matrix]
    H --> I[Output NFR validation report]
```

---

### `*risk-profile {story}`

**Task file:** `.aiox-core/development/tasks/qa-risk-profile.md`

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `qa-risk-profile.md` | Task | EXISTS |
| `docs/stories/{storyId}` | Input | Required |

**Execution flow:**

```mermaid
flowchart TD
    A["*risk-profile {story}"] --> B[Load qa-risk-profile.md task]
    B --> C[Identify risk categories]
    C --> D[Assess probability for each risk]
    D --> E[Assess impact for each risk]
    E --> F[Calculate risk score: probability x impact]
    F --> G[Prioritize by risk score]
    G --> H[Generate risk assessment matrix]
    H --> I[Output risk profile report]
```

---

### `*create-fix-request {story}`

**Task file:** `.aiox-core/development/tasks/qa-create-fix-request.md`

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `qa-create-fix-request.md` | Task | EXISTS |
| `docs/stories/{storyId}` | Input | Required |

**Execution flow:**

```mermaid
flowchart TD
    A["*create-fix-request {story}"] --> B[Load qa-create-fix-request.md task]
    B --> C[Collect all QA findings from review]
    C --> D[Categorize issues by severity]
    D --> E[Generate actionable fix descriptions]
    E --> F[Map fixes to specific files/lines]
    F --> G["Output: QA_FIX_REQUEST.md for @dev"]
    G --> H[Handoff to @dev for resolution]
```

**Cross-agent:** Generates `QA_FIX_REQUEST.md` consumed by @dev (Epic 6 - QA Loop).

---

### `*validate-libraries {story}`

**Task file:** `.aiox-core/development/tasks/qa-library-validation.md`

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `qa-library-validation.md` | Task | EXISTS |

**Execution flow:**

```mermaid
flowchart TD
    A["*validate-libraries {story}"] --> B[Load qa-library-validation.md task]
    B --> C[Identify third-party libraries in story changes]
    C --> D[Lookup each library via Context7]
    D --> E[Verify correct API usage]
    E --> F[Check for known vulnerabilities]
    F --> G[Validate version compatibility]
    G --> H[Output library validation report]
```

**Tools used:** context7 (library documentation lookup)

---

### `*security-check {story}`

**Task file:** `.aiox-core/development/tasks/qa-security-checklist.md`

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `qa-security-checklist.md` | Task | EXISTS |

**Execution flow:**

```mermaid
flowchart TD
    A["*security-check {story}"] --> B[Load qa-security-checklist.md task]
    B --> C[Point 1: SQL Injection Detection]
    C --> D[Point 2: XSS Vulnerability Scan]
    D --> E[Point 3: Hardcoded Secrets Check]
    E --> F[Point 4: Authentication Pattern Review]
    F --> G[Point 5: Authorization/RBAC Validation]
    G --> H[Point 6: Input Validation Assessment]
    H --> I[Point 7: Dependency Vulnerability Scan]
    I --> J[Point 8: Sensitive Data Exposure Check]
    J --> K[Output 8-point security report]
```

**Note:** 8-point security vulnerability scan (absorbed from Auto-Claude).

---

### `*validate-migrations {story}`

**Task file:** `.aiox-core/development/tasks/qa-migration-validation.md`

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `qa-migration-validation.md` | Task | EXISTS |

**Execution flow:**

```mermaid
flowchart TD
    A["*validate-migrations {story}"] --> B[Load qa-migration-validation.md task]
    B --> C[Identify migration files in story changes]
    C --> D[Validate schema change safety]
    D --> E[Check rollback capability]
    E --> F[Verify data integrity constraints]
    F --> G[Test migration ordering]
    G --> H[Output migration validation report]
```

**Tools used:** supabase (database testing and data validation)

---

### `*evidence-check {story}`

**Task file:** `.aiox-core/development/tasks/qa-evidence-requirements.md`

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `qa-evidence-requirements.md` | Task | EXISTS |

**Execution flow:**

```mermaid
flowchart TD
    A["*evidence-check {story}"] --> B[Load qa-evidence-requirements.md task]
    B --> C[Identify evidence-based QA requirements]
    C --> D[Verify test execution artifacts exist]
    D --> E[Check screenshot/recording evidence]
    E --> F[Validate log-based evidence]
    F --> G[Output evidence verification report]
```

---

### `*false-positive-check {story}`

**Task file:** `.aiox-core/development/tasks/qa-false-positive-detection.md`

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `qa-false-positive-detection.md` | Task | EXISTS |

**Execution flow:**

```mermaid
flowchart TD
    A["*false-positive-check {story}"] --> B[Load qa-false-positive-detection.md task]
    B --> C[Collect all reported issues/bugs]
    C --> D[Apply critical thinking verification]
    D --> E[Cross-reference with actual behavior]
    E --> F{Is finding valid?}
    F -->|yes| G[Confirm as true positive]
    F -->|no| H[Flag as false positive with rationale]
    G --> I[Output verified findings report]
    H --> I
```

---

### `*console-check {story}`

**Task file:** `.aiox-core/development/tasks/qa-browser-console-check.md`

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `qa-browser-console-check.md` | Task | EXISTS |

**Execution flow:**

```mermaid
flowchart TD
    A["*console-check {story}"] --> B[Load qa-browser-console-check.md task]
    B --> C[Open application in browser]
    C --> D[Navigate through story-affected pages]
    D --> E[Capture console errors]
    E --> F[Capture console warnings]
    F --> G[Categorize by severity]
    G --> H[Output browser console report]
```

**Tools used:** browser (end-to-end testing and UI validation)

---

### `*test-design {story}`

**Task file:** `.aiox-core/development/tasks/qa-test-design.md`

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `qa-test-design.md` | Task | EXISTS |
| `.aiox-core/product/data/test-levels-framework.md` | Data | Loaded at activation |
| `.aiox-core/product/data/test-priorities-matrix.md` | Data | Loaded at activation |

**Execution flow:**

```mermaid
flowchart TD
    A["*test-design {story}"] --> B[Load qa-test-design.md task]
    B --> C[Elicit: test scope and priority areas]
    C --> D[Analyze acceptance criteria]
    D --> E[Apply test-levels-framework.md]
    E --> F[Apply test-priorities-matrix.md]
    F --> G[Generate test scenarios per level]
    G --> H[Map scenarios to Given-When-Then format]
    H --> I[Output comprehensive test design document]
```

---

### `*trace {story}`

**Task file:** `.aiox-core/development/tasks/qa-trace-requirements.md`

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `qa-trace-requirements.md` | Task | EXISTS |
| `docs/stories/{storyId}` | Input | Required |

**Execution flow:**

```mermaid
flowchart TD
    A["*trace {story}"] --> B[Load qa-trace-requirements.md task]
    B --> C[Extract all requirements from story]
    C --> D[Identify existing test cases]
    D --> E[Map requirements to tests using Given-When-Then]
    E --> F{Full coverage?}
    F -->|yes| G[Report: all requirements traced]
    F -->|no| H[Report: gaps with missing test scenarios]
    G --> I[Output traceability matrix]
    H --> I
```

---

### `*create-suite {story}`

**Task file:** `.aiox-core/development/tasks/create-suite.md`

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `create-suite.md` | Task | EXISTS |
| `.aiox-core/product/data/test-levels-framework.md` | Data | Loaded at activation |

**Execution flow:**

```mermaid
flowchart TD
    A["*create-suite {story}"] --> B[Load create-suite.md task]
    B --> C[Elicit: test suite scope and framework]
    C --> D[Analyze story requirements]
    D --> E[Generate test file structure]
    E --> F[Create test cases with Given-When-Then]
    F --> G[Apply test-levels-framework categorization]
    G --> H["Output: tests/ directory with suite files"]
```

**Authority:** QA owns test suites.

---

### `*critique-spec {story}`

**Task file:** `.aiox-core/development/tasks/spec-critique.md`

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `spec-critique.md` | Task | EXISTS |
| `docs/stories/{storyId}/spec/spec.md` | Input | Required |

**Execution flow:**

```mermaid
flowchart TD
    A["*critique-spec {story}"] --> B[Load spec-critique.md task]
    B --> C[Read specification for story]
    C --> D[Evaluate completeness]
    D --> E[Evaluate clarity and ambiguity]
    E --> F[Evaluate testability]
    F --> G[Evaluate edge case coverage]
    G --> H[Generate critique with recommendations]
    H --> I[Output spec critique report]
```

**Note:** Part of Spec Pipeline (Epic 3 - ADE). QA can critique but cannot gather, assess, research, or write specs.

---

### `*backlog-add`, `*backlog-update`, `*backlog-review`

**Task file:** `.aiox-core/development/tasks/manage-story-backlog.md` (MISSING)

**Note:** All 3 backlog commands reference `manage-story-backlog.md` which does not exist on disk. The PO agent has `po-manage-story-backlog.md` but no QA-specific variant exists. These commands are non-functional.

---

### `*help`, `*guide`, `*session-info`, `*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 `## ✅ QA Guide` section from agent .md |
| `*session-info` | Shows session context (agent history, commands, project status) |
| `*exit` | Exits QA mode, returns to base Claude Code |

---

## 4. Complete Dependency Graph

```mermaid
graph TD
    subgraph "Agent Definition"
        AD[qa.md]
    end

    subgraph "Activation Pipeline"
        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]
        TLF[test-levels-framework.md]
        TPM[test-priorities-matrix.md]
    end

    subgraph "Task Files - Code Review"
        T1[qa-run-tests.md]
        T2[qa-review-story.md]
        T3[qa-review-build.md]
    end

    subgraph "Task Files - Quality Gates"
        T4[qa-gate.md]
        T5[qa-nfr-assess.md]
        T6[qa-risk-profile.md]
    end

    subgraph "Task Files - Fix Requests"
        T7[qa-create-fix-request.md]
    end

    subgraph "Task Files - Enhanced Validation"
        T8[qa-library-validation.md]
        T9[qa-security-checklist.md]
        T10[qa-migration-validation.md]
        T11[qa-evidence-requirements.md]
        T12[qa-false-positive-detection.md]
        T13[qa-browser-console-check.md]
    end

    subgraph "Task Files - Test Strategy"
        T14[qa-test-design.md]
        T15[qa-trace-requirements.md]
        T16[create-suite.md]
    end

    subgraph "Task Files - Spec Pipeline"
        T17[spec-critique.md]
    end

    subgraph "Task Files - Backlog"
        T18[qa-generate-tests.md]
        T19[qa-review-proposal.md]
    end

    subgraph "Task File (MISSING)"
        TM1[manage-story-backlog.md]
    end

    subgraph "Templates"
        TMPL1[qa-gate-tmpl.yaml]
        TMPL2[story-tmpl.yaml]
    end

    subgraph "Tools"
        TOOL1[browser]
        TOOL2[coderabbit]
        TOOL3[git read-only]
        TOOL4[context7]
        TOOL5[supabase]
    end

    AD --> GB
    AD --> ACL
    GB --> CD
    GB --> GCD
    GB --> PSL
    GB --> GPM
    GB --> WN
    GB --> PM
    ACL --> ACR
    ACL --> CC
    ACL --> TP
    ACL --> TLF
    ACL --> TPM
    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 -.->|commands MISSING| TM1

    T4 -.->|template| TMPL1
    T4 -.->|template| TMPL2

    T1 -.->|tool| TOOL2
    T1 -.->|tool| TOOL3
    T2 -.->|tool| TOOL2
    T2 -.->|tool| TOOL3
    T3 -.->|tool| TOOL2
    T3 -.->|tool| TOOL3
    T8 -.->|tool| TOOL4
    T10 -.->|tool| TOOL5
    T13 -.->|tool| TOOL1
```

---

## 5. Cross-Agent Interactions

| Interaction | Direction | Trigger |
|-------------|-----------|---------|
| @dev -> @qa | Receives | Story marked "Ready for Review" triggers QA review |
| @qa -> @dev | Handoff | `*create-fix-request` generates `QA_FIX_REQUEST.md` for @dev |
| @coderabbit -> @qa | Receives | Automated code review findings consumed by QA analysis |
| @qa -> @github-devops | Delegate | Git push operations, PR creation after QA approval |
| @sm -> @qa | Receives | Sprint risk profiling requests |
| @po -> @qa | Receives | Spec critique requests via `*critique-spec` |

### Delegation Rules (from agent definition)

**Receives from @dev when:**
- Story is marked "Ready for Review"
- Code is committed (not pushed yet)
- @dev requests code quality feedback

**Delegates to @dev when:**
- QA findings require code fixes (`*create-fix-request`)
- Self-healing loop identifies CRITICAL/HIGH issues needing fix

**Delegates to @github-devops when:**
- Git push operations to remote repository
- Pull request creation and management

**Retains (Advisory Authority):**
- Quality gate decisions (PASS/CONCERNS/FAIL/WAIVED)
- Test architecture and strategy
- Risk assessment and NFR validation
- Story QA Results section updates

### CodeRabbit Self-Healing Integration

```yaml
self_healing:
  enabled: true
  type: full
  max_iterations: 3
  timeout_minutes: 30
  trigger: review_start
  severity_filter:
    - CRITICAL
    - HIGH
  behavior:
    CRITICAL: auto_fix    # 3 attempts max
    HIGH: auto_fix        # 3 attempts max
    MEDIUM: document_as_debt
    LOW: ignore
```

**Git restrictions:**
- ALLOWED: `git status`, `git log`, `git diff`, `git branch -a`
- BLOCKED: `git push`, `git commit`, `gh pr create`
- Redirect: QA reviews, doesn't commit. Use @dev for commits, @github-devops for push.

**Story file permissions:**
- ONLY authorized to update "QA Results" section of story files
- DO NOT modify Status, Acceptance Criteria, Tasks, Dev Notes, or any other sections

---

## 6. Missing Dependencies

| File | Type | Referenced By | Impact |
|------|------|---------------|--------|
| `manage-story-backlog.md` | Task | `*backlog-add`, `*backlog-update`, `*backlog-review` | 3 commands non-functional |
| `qa-gate-tmpl.yaml` | Template | `*gate` (in `dependencies.templates`) | EXISTS in `.aiox-core/product/templates/` but NOT in `.aiox-core/development/templates/` per IDE-FILE-RESOLUTION |
| `story-tmpl.yaml` | Template | (in `dependencies.templates`) | EXISTS in `.aiox-core/product/templates/` but NOT in `.aiox-core/development/templates/` per IDE-FILE-RESOLUTION |
| `test-levels-framework.md` | Data | `agent-config-requirements.yaml` | EXISTS at `.aiox-core/product/data/` (NOT in `.aiox-core/data/` where `dependencies.data` resolves) |
| `test-priorities-matrix.md` | Data | `agent-config-requirements.yaml` | EXISTS at `.aiox-core/product/data/` (NOT in `.aiox-core/data/` where `dependencies.data` resolves) |

**Path Resolution Note:** The `IDE-FILE-RESOLUTION` rule in the agent definition maps `dependencies` to `.aiox-core/development/{type}/{name}`. However, 2 templates and 2 data files exist under `.aiox-core/product/` instead. The `agent-config-requirements.yaml` correctly references the full paths under `.aiox-core/product/data/`, but the agent definition's `dependencies` block uses short names that resolve to `.aiox-core/development/templates/` and `.aiox-core/development/data/` respectively, where these files do not exist. Actual runtime loading uses `agent-config-requirements.yaml` paths, so functionality is preserved.

---

*Traced from source on 2026-02-05 | Story AIOX-TRACE-001*