Purpose

Investigate Phase 3 tickets (Orchestration, CLI, Scheduling, Monitoring, Testing) to clarify scope and provide implementation recommendation.

When To Use

• •Manager assigns Phase 3 ticket investigation
• •Ticket has empty/unclear body but tags indicate a Phase 3 component
• •Need to decide if ticket should be scoped, deferred, or closed

Procedure

1. Gather Context

• •List all Phase 3 tickets: loom ticket list --tag phase3
• •Read ROADMAP.md to understand Phase 3 goals and components
• •Check each Phase 3 ticket status and body content

2. Check Component Status

For Orchestration (vp-cf95)

• •Check if ExecutionEngine exists in src/vibe_piper/orchestration/
• •Verify orchestration tests in tests/test_orchestration.py
• •Look for implementation commits in git log

For CLI (vp-6cf1)

• •Check CLI commands in src/vibe_piper/cli/
• •Verify CLI tests in tests/cli/
• •Check if commands are registered and working

For Scheduling (vp-7d49)

• •Check scheduling module in src/vibe_piper/scheduling/
• •Verify scheduling tests in tests/scheduling/
• •Check test pass rate

For Monitoring (vp-f17e)

• •Check monitoring module in src/vibe_piper/monitoring/
• •Verify monitoring tests in tests/monitoring/
• •Check implementation status (metrics, logging, health, etc.)

For Testing (vp-0429)

• •List existing testing infrastructure:
  • •Unit tests: ls tests/*.py
  • •Integration tests: ls tests/integration/*.py
  • •Fixtures: check tests/conftest.py
  • •Assertion helpers: check tests/helpers/assertions.py
  • •Factory functions: check tests/helpers/factories.py
  • •Fake data generators: check tests/fixtures/fake_data.py
• •Check for snapshot testing:
  • •tests/helpers/snapshots.py exists?
  • •tests/helpers/test_snapshots.py exists?
  • •tests/snapshots/ directory exists?
• •Check if snapshot-testing skill exists: .opencode/skills/snapshot-testing/SKILL.md

3. Analyze Roadmap Context

• •Check ROADMAP.md Testing Layer section (around line 167-174)
• •Note which components are marked ✅ vs ⏳ vs ⏸️
• •Identify any components marked "in progress" or "missing"

4. Determine Recommendation

Implement If:

• •Component is called out as missing in ROADMAP
• •Skill definition exists but implementation is missing
• •Low effort (2-3 hours estimate)
• •Independent of current sprint work
• •High value (catches regressions, completes phase)

Defer If:

• •Current sprint has higher priority work
• •Component can wait until after current sprint
• •Priority is P2/P3

Close If:

• •Component already implemented elsewhere
• •Component superseded by new approach
• •No clear value add

5. Document Findings

• •Create INVESTIGATION_NOTES.md with:
  • •All Phase 3 ticket statuses
  • •Existing infrastructure checklists
  • •Roadmap context
  • •Decision rationale
  • •Recommended scope (if implementing)
• •Commit investigation notes with clear message
• •Update ticket body with:
  • •Context (what was missing/incomplete)
  • •Objective (what to implement)
  • •Clear scope with tasks
  • •Acceptance criteria checklist
  • •Dependencies
  • •Related tickets

6. Communicate to Manager

• •Use loom team send MiyagiDo manager to summarize:
  • •Investigation findings
  • •Recommendation (implement/defer/close)
  • •Scope (if implementing)
  • •Estimated effort
  • •Suggested timing (now vs. after sprint)
• •Add note to ticket with progress update

Outputs

• •INVESTIGATION_NOTES.md with detailed findings
• •Updated ticket body with clear scope
• •Manager notification with summary
• •Git commit with investigation documentation

Example Investigation

## Phase 3 Status
| Ticket | Component | Status | Notes |
|--------|-----------|--------|-------|
| vp-cf95 | Orchestration | CLOSED | Body empty |
| vp-6cf1 | CLI | CLOSED ✓ | 7 commands implemented |
| vp-7d49 | Scheduling | CLOSED ✓ | 19/25 tests passing |
| vp-f17e | Monitoring | CLOSED ✓ | 76 tests created |
| vp-0429 | Testing | OPEN | Snapshot testing missing |

## Testing Infrastructure
✅ Present: Unit tests, Integration tests, Fixtures, Helpers, Factories, Fake data
❌ Missing: Snapshot testing framework

## Decision
IMPLEMENT - snapshot testing is only missing Phase 3 Testing Layer component

Manual notes

This section is preserved when the skill is updated. Put human notes, caveats, and exceptions here.