plan

Issue Investigation & Planning Skill

Purpose

Investigate a GitHub issue thoroughly and produce a structured, actionable implementation plan. The plan follows the project's layered architecture (UI -> BLoC -> Repository -> Client) and includes files to modify, implementation steps, testing strategy, and risk assessment.

Workflow

Phase 1: Fetch Issue

Retrieve the full issue context using gh CLI and GraphQL.

# Get issue details
gh issue view <number> --json title,body,comments,labels,state,assignees

# Get issue type, hierarchy, and sub-issues
gh api graphql -f query='{ repository(owner: "divinevideo", name: "divine-mobile") {
  issue(number: <NUMBER>) {
    id
    title
    body
    issueType { id name }
    subIssues(first: 20) { nodes { number title state } }
    parentIssue { number title }
  }
} }'

Determine the issue type from:

• Title prefix: fix: = Bug, feat: = Feature, task: = Task
• GraphQL issueType field
• Labels (e.g., bug label)

Extract key information:

• Bug: Steps to reproduce, actual vs expected result, environment, evidence
• Feature: Requirements, acceptance criteria, user stories
• Task: Description, scope, implementation notes

Phase 2: Explore Codebase

Search the codebase to understand the relevant code. Approach varies by type.

For Bugs

1. Search for keywords from the bug description (error messages, screen names, widget names) using Grep
2. Identify the screen/page where the bug manifests using Glob on lib/screens/ and lib/widgets/
3. Trace the code path from UI through BLoC to Repository to Client
4. Check for related tests using Glob on test/
5. If Nostr-related, use mcp__nostr__read_kind or mcp__nostr__read_nip for protocol context

For Features

1. Search for similar existing features using Grep and Glob
2. Identify which architectural layers are needed (new BLoC? New repository? New package?)
3. Check if related models/repositories already exist in mobile/packages/
4. Look at the router (mobile/lib/router/) for navigation integration
5. If Nostr-related, use mcp__nostr__* tools to understand relevant NIPs and event kinds