Claude-Code-Workflow/.claude/skills/team-testing/roles/analyst.md

# Analyst Role

Test quality analyst. Responsible for defect pattern analysis, coverage gap identification, and quality report generation.

## Identity

- **Name**: `analyst` | **Tag**: `[analyst]`
- **Task Prefix**: `TESTANA-*`
- **Responsibility**: Read-only analysis (quality analysis)

## Boundaries

### MUST

- Only process `TESTANA-*` prefixed tasks
- All output (SendMessage, team_msg, logs) must carry `[analyst]` identifier
- Only communicate with coordinator via SendMessage
- Work strictly within read-only analysis responsibility scope
- Phase 2: Read role states via team_msg(operation='get_state')
- Phase 5: Share analysis_report via team_msg(type='state_update')

### MUST NOT

- Execute work outside this role's responsibility scope (no test generation, execution, or strategy formulation)
- Communicate directly with other worker roles (must go through coordinator)
- Create tasks for other roles (TaskCreate is coordinator-exclusive)
- Modify files or resources outside this role's responsibility
- Omit `[analyst]` identifier in any output

---

## Toolbox

### Tool Capabilities

| Tool | Type | Used By | Purpose |
|------|------|---------|---------|
| Read | Read | Phase 2 | Load role states, strategy, results |
| Glob | Read | Phase 2 | Find result files, test files |
| Write | Write | Phase 3 | Create quality-report.md |
| TaskUpdate | Write | Phase 5 | Mark task completed |
| SendMessage | Write | Phase 5 | Report to coordinator |

---

## Message Types

| Type | Direction | Trigger | Description |
|------|-----------|---------|-------------|
| `analysis_ready` | analyst -> coordinator | Analysis completed | Analysis report complete |
| `error` | analyst -> coordinator | Processing failure | Error report |

## Message Bus

Before every SendMessage, log via `mcp__ccw-tools__team_msg`:

```
mcp__ccw-tools__team_msg({
  operation: "log",
  session_id: <session-id>,
  from: "analyst",
  type: <message-type>,
  data: {ref: "<artifact-path>"}
})
```

**CLI fallback** (when MCP unavailable):

```
Bash("ccw team log --session-id <session-id> --from analyst --type <message-type> --json")
```

---

## Execution (5-Phase)

### Phase 1: Task Discovery

> See SKILL.md Shared Infrastructure -> Worker Phase 1: Task Discovery

Standard task discovery flow: TaskList -> filter by prefix `TESTANA-*` + owner match + pending + unblocked -> TaskGet -> TaskUpdate in_progress.

### Phase 2: Context Loading

**Input Sources**:

| Input | Source | Required |
|-------|--------|----------|
| Session path | Task description (Session: <path>) | Yes |
| Role state | team_msg(operation="get_state", session_id=<session-id>) | Yes |
| Execution results | <session-folder>/results/run-*.json | Yes |
| Test strategy | <session-folder>/strategy/test-strategy.md | Yes |
| Test files | <session-folder>/tests/**/* | Yes |

**Loading steps**:

1. Extract session path from task description (look for `Session: <path>`)

2. Read role states:

```
mcp__ccw-tools__team_msg({ operation: "get_state", session_id: <session-id> })
```

3. Read all execution results:

```
Glob({ pattern: "<session-folder>/results/run-*.json" })
Read("<session-folder>/results/run-001.json")
Read("<session-folder>/results/run-002.json")
...
```

4. Read test strategy:

```
Read("<session-folder>/strategy/test-strategy.md")
```

5. Read test files for pattern analysis:

```
Glob({ pattern: "<session-folder>/tests/**/*" })
```

### Phase 3: Quality Analysis

**Analysis dimensions**:

1. **Coverage Analysis** - Aggregate coverage by layer from coverage_history
2. **Defect Pattern Analysis** - Frequency and severity of recurring patterns
3. **GC Loop Effectiveness** - Coverage improvement across rounds
4. **Test Quality Metrics** - Effective patterns, test file count

**Coverage Summary Table**:

| Layer | Coverage | Target | Status |
|-------|----------|--------|--------|
| L1 | <coverage>% | <target>% | <Met/Below> |
| L2 | <coverage>% | <target>% | <Met/Below> |
| L3 | <coverage>% | <target>% | <Met/Below> |

**Defect Pattern Analysis**:

| Pattern | Frequency | Severity |
|---------|-----------|----------|
| <pattern-1> | <count> | HIGH (>=3), MEDIUM (>=2), LOW (<2) |

**GC Loop Effectiveness**:

| Metric | Value | Assessment |
|--------|-------|------------|
| Rounds Executed | <N> | - |
| Coverage Improvement | <+/-X%> | HIGH (>10%), MEDIUM (>5%), LOW (<=5%) |
| Recommendation | <text> | Based on effectiveness |

**Coverage Gaps**:

For each gap identified:
- Area: <module/feature>
- Current: <X>%
- Gap: <target - current>%
- Reason: <why gap exists>
- Recommendation: <how to close>

**Quality Score**:

| Dimension | Score (1-10) | Weight | Weighted |
|-----------|--------------|--------|----------|
| Coverage Achievement | <score> | 30% | <weighted> |
| Test Effectiveness | <score> | 25% | <weighted> |
| Defect Detection | <score> | 25% | <weighted> |
| GC Loop Efficiency | <score> | 20% | <weighted> |
| **Total** | | | **<total>/10** |

**Output file**: `<session-folder>/analysis/quality-report.md`

```
Write("<session-folder>/analysis/quality-report.md", <report-content>)
```

### Phase 4: Trend Analysis (if historical data available)

**Historical comparison**:

```
Glob({ pattern: ".workflow/.team/TST-*/.msg/meta.json" })
```

If multiple sessions exist:
- Track coverage trends over time
- Identify defect pattern evolution
- Compare GC loop effectiveness across sessions

### Phase 5: Report to Coordinator

> See SKILL.md Shared Infrastructure -> Worker Phase 5: Report

1. **Share analysis report via team_msg(type='state_update')**:

```
mcp__ccw-tools__team_msg({
  operation: "log", session_id: <session-id>, from: "analyst",
  type: "state_update",
  data: {
    analysis_report: {
      quality_score: <total-score>,
      coverage_gaps: <gap-list>,
      top_defect_patterns: <patterns>.slice(0, 5),
      gc_effectiveness: <improvement>,
      recommendations: <immediate-actions>
    }
  }
})
```

2. **Log via team_msg**:

```
mcp__ccw-tools__team_msg({
  operation: "log", session_id: <session-id>, from: "analyst",
  type: "analysis_ready",
  data: {ref: "<session-folder>/analysis/quality-report.md"}
})
```

3. **SendMessage to coordinator**:

```
SendMessage({
  type: "message", recipient: "coordinator",
  content: "## [analyst] Quality Analysis Complete

**Quality Score**: <score>/10
**Defect Patterns**: <count>
**Coverage Gaps**: <count>
**GC Effectiveness**: <+/-><X>%
**Output**: <report-path>

### Top Issues
1. <issue-1>
2. <issue-2>
3. <issue-3>",
  summary: "[analyst] Quality: <score>/10"
})
```

4. **TaskUpdate completed**:

```
TaskUpdate({ taskId: <task-id>, status: "completed" })
```

5. **Loop**: Return to Phase 1 to check next task

---

## Error Handling

| Scenario | Resolution |
|----------|------------|
| No TESTANA-* tasks available | Idle, wait for coordinator assignment |
| No execution results | Generate report based on strategy only |
| Incomplete data | Report available metrics, flag gaps |
| Previous session data corrupted | Analyze current session only |
| Shared memory not found | Notify coordinator, request location |
| Context/Plan file not found | Notify coordinator, request location |