# @sm (River) - Execution Trace

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

## 1. Activation Trace

### 1.1 Files Loaded (in order)

| Order | File | Loader | Purpose |
|-------|------|--------|---------|
| 1 | `.aiox-core/development/agents/sm.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: devStoryLocation, storyBacklog, dataLocation |
| 4 | `.aiox-core/data/workflow-patterns.yaml` | WorkflowNavigator._loadPatterns() | Workflow state detection |
| 5 | `.aiox-core/product/data/mode-selection-best-practices.md` | AgentConfigLoader.loadFile() | Mode selection best practices (always loaded, 10KB) |
| 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:** Direct invocation (STEP 3 calls `GreetingBuilder.buildGreeting()`)

```mermaid
sequenceDiagram
    participant CC as Claude Code
    participant SMd as sm.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->>SMd: Load agent file (STEP 1)
    CC->>SMd: Adopt persona (STEP 2)
    CC->>ACL: loadAgentDefinition('sm')
    ACL-->>CC: { agent: { name: 'River', icon: '🌊' }, commands: [...6], ... }

    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
sm:
  config_sections:
    - devStoryLocation
    - storyBacklog
    - dataLocation
  files_loaded:
    - path: .aiox-core/product/data/mode-selection-best-practices.md
      lazy: false
      size: 10KB
    - path: .aiox-core/data/workflow-patterns.yaml
      lazy: false
      size: 8KB
    - path: docs/framework/coding-standards.md    # Added in Story ACT-8
      lazy: false
      size: 25KB
  lazy_loading: {}
  performance_target: <75ms
```

**Note:** As of Story ACT-8, SM loads `coding-standards.md` during activation to have development standards context when creating and assigning stories.

### 1.4 Context Brought to Session

| Data | Source | Value |
|------|--------|-------|
| Greeting level | `persona_profile.greeting_levels.minimal` | `🌊 sm Agent ready` |
| Greeting level | `persona_profile.greeting_levels.named` | `🌊 River (Facilitator) ready. Let's flow!` |
| Greeting level | `persona_profile.greeting_levels.archetypal` | `🌊 River the Facilitator ready to flow!` |
| Signature | `persona_profile.communication.signature_closing` | `— River, fluindo com o time 🌊` |
| Role | `persona.role` | Agile Process Facilitator & Sprint Coordinator |
| Commands shown | `filterCommandsByVisibility('full')` | 6 commands with `full` visibility |

---

## 2. Command Registry

| Command | Task File | Visibility | Elicit |
|---------|-----------|------------|--------|
| `*help` | (built-in) | full, quick, key | No |
| `*draft` | sm-create-next-story.md + story-tmpl.yaml | full, quick, key | Yes |
| `*story-checklist` | execute-checklist.md + story-draft-checklist.md | full, quick | Optional |
| `*retro` | (built-in) | full | No |
| `*velocity` | (built-in) | full | No |
| `*guide` | (built-in, rendered from agent .md) | full, quick | No |
| `*session-info` | (built-in) | full | No |
| `*exit` | (built-in) | full | No |

---

## 3. Per-Command Execution Traces

### `*draft`

**Task file:** `.aiox-core/development/tasks/sm-create-next-story.md`
**Template:** `.aiox-core/development/templates/story-tmpl.yaml` (MISSING in development/, EXISTS in `.aiox-core/product/templates/story-tmpl.yaml`)

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `sm-create-next-story.md` | Task | EXISTS |
| `story-tmpl.yaml` | Template | MISSING in development/, EXISTS in product/templates/ |
| `.aiox-core/product/data/mode-selection-best-practices.md` | Data | Referenced by sm config |
| `.aiox-core/product/templates/` | Templates dir | Scanned dynamically |

**Execution flow:**

```mermaid
flowchart TD
    A["*draft"] --> B[Load sm-create-next-story.md task]
    B --> C[Load template: story-tmpl.yaml]
    C --> D{Template exists?}
    D -->|yes| E[Parse YAML template structure]
    D -->|no| F[Scan product/templates/ fallback]
    F --> E
    E --> G[Step-by-step elicitation<br/>format: numbered 1-9 options]
    G --> H[Fill template sections with PRD/Architecture input]
    H --> I[Validate story against acceptance criteria]
    I --> J[Populate CodeRabbit Integration section]
    J --> K[Generate story document]
    K --> L["Output: docs/stories/active/{storyId}.md"]
```

**Expected output:** Complete user story with acceptance criteria, implementation tasks, and CodeRabbit quality gates

---

### `*story-checklist`

**Task file:** `.aiox-core/development/tasks/execute-checklist.md`
**Checklist:** `.aiox-core/development/checklists/story-draft-checklist.md` (MISSING in development/, EXISTS in `.aiox-core/product/checklists/story-draft-checklist.md`)

**Dependencies loaded:**
| File | Type | Status |
|------|------|--------|
| `execute-checklist.md` | Task | EXISTS |
| `story-draft-checklist.md` | Checklist | MISSING in development/, EXISTS in product/checklists/ |
| `.aiox-core/scripts/execute-task.js` | Script | Referenced |

**Execution flow:**

```mermaid
flowchart TD
    A["*story-checklist"] --> B[Load execute-checklist.md task]
    B --> C[Resolve checklist file from .aiox-core/product/checklists/]
    C --> D{Checklist exists?}
    D -->|yes| E[Parse checklist items]
    D -->|no| F[Error: checklist not found]
    E --> G{YOLO mode?}
    G -->|yes| H[Auto-validate all items]
    G -->|no| I[Interactive item-by-item validation]
    H --> J[Generate validation report]
    I --> J
    J --> K[Output results with pass/fail per item]
```

---

### `*retro`

**Task file:** (built-in)

**Execution flow:**

```mermaid
flowchart TD
    A["*retro"] --> B[Gather sprint data from project status]
    B --> C[Elicit: What went well?]
    C --> D[Elicit: What could improve?]
    D --> E[Elicit: Action items]
    E --> F[Compile retrospective summary]
    F --> G[Output retrospective report]
```

**Expected output:** Sprint retrospective summary with action items

---

### `*velocity`

**Task file:** (built-in)

**Execution flow:**

```mermaid
flowchart TD
    A["*velocity"] --> B[Scan completed stories in docs/stories/completed/]
    B --> C[Calculate story points per sprint]
    C --> D[Analyze velocity trends]
    D --> E[Generate velocity report]
    E --> F[Output velocity metrics and chart data]
```

**Expected output:** Velocity metrics for current and recent sprints

---

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

---

## 4. Complete Dependency Graph

```mermaid
graph TD
    subgraph "Agent Definition"
        AD[sm.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]
        MSB[mode-selection-best-practices.md]
    end

    subgraph "Task Files"
        T1[sm-create-next-story.md]
        T2[execute-checklist.md]
        T3[correct-course.md]
    end

    subgraph "Templates (MISSING in development/)"
        TM1["story-tmpl.yaml<br/>(EXISTS in product/templates/)"]
    end

    subgraph "Checklists (MISSING in development/)"
        CL1["story-draft-checklist.md<br/>(EXISTS in product/checklists/)"]
    end

    AD --> GB
    AD --> ACL
    GB --> CD
    GB --> GCD
    GB --> PSL
    GB --> GPM
    GB --> WN
    GB --> PM
    ACL --> ACR
    ACL --> CC
    ACL --> MSB
    WN --> WP
    GPM --> CC

    AD -.->|commands| T1
    AD -.->|commands| T2
    AD -.->|commands| T3

    T1 -.->|template| TM1
    T2 -.->|checklist| CL1
```

---

## 5. Cross-Agent Interactions

| Interaction | Direction | Trigger |
|-------------|-----------|---------|
| @po -> @sm | Receives | Backlog prioritization, story validation requests |
| @pm -> @sm | Receives | Epic structure for story breakdown |
| @sm -> @dev | Handoff | Completed stories for implementation |
| @sm -> @devops | Delegate | Git push operations, PR creation after story completion |
| @sm <-> @po | Collaborate | Sprint planning, backlog grooming |

### Delegation Rules (from agent definition)

**Coordinates with @po when:**
- Backlog prioritization and grooming
- Sprint planning
- Story validation (`@po *validate-story-draft`)

**Receives from @pm when:**
- Epic structure is ready for story breakdown
- Strategic direction for sprint goals

**Hands off to @dev when:**
- Story is drafted, validated, and ready for implementation
- Developer receives story via `@dev *develop`

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

**Escalates to @aiox-master when:**
- Course corrections needed (`@aiox-master *correct-course`)

**Git restrictions:**
- ALLOWED: `git status`, `git log`, `git diff`, `git branch`, `git branch -d`, `git checkout -b`, `git checkout`, `git merge`
- BLOCKED: `git push`, `git push --force`, `git push origin --delete`, `gh pr create`

---

## 6. Missing Dependencies

| File | Type | Referenced By | Impact |
|------|------|---------------|--------|
| `story-tmpl.yaml` | Template | `*draft` (sm-create-next-story.md) | MISSING in `.aiox-core/development/templates/`, EXISTS in `.aiox-core/product/templates/story-tmpl.yaml` |
| `story-draft-checklist.md` | Checklist | `*story-checklist` (execute-checklist.md) | MISSING in `.aiox-core/development/checklists/`, EXISTS in `.aiox-core/product/checklists/story-draft-checklist.md` |

---

## 7. Tools

| Tool | Scope | Purpose |
|------|-------|---------|
| `github-cli` | Local | Repository information, issue tracking |
| `context7` | External | Research technical requirements for stories |
| `git` | Local only | Local branch operations (status, log, diff, branch, checkout, merge). NO push -- delegates to @devops |

---

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