name: dependency-mapping description: Identifies dependencies between GitHub issues and creates appropriate cross-references. Use when you need to map issue relationships, find blockers, or organize work order based on dependencies.

Issue Dependency Mapping

Project Board

All issues are tracked on the Anubis Issue Tracker project board:

• Project URL: https://github.com/users/forrestthewoods/projects/8
• Project Number: 8
• Owner: forrestthewoods

Board Status Workflow

The project board uses these status columns:

Important: Issues in Backlog should be completely ignored by this skill. These are deferred tasks that are not ready for dependency analysis.

Purpose

This skill analyzes GitHub issues to:

1. Identify issues that depend on other issues
2. Find issues that block other work
3. Create cross-references between related issues
4. Build a dependency graph for planning
5. Update project board status based on blocking relationships

Instructions

Step 1: Fetch All Open Issues

gh issue list --state open --json number,title,body,labels,comments --limit 100

Step 2: Analyze for Dependencies

Look for these dependency types:

Explicit Dependencies:

• Mentions of other issue numbers (#N)
• Phrases like "depends on", "blocked by", "requires", "after"
• References to PRs or commits

Implicit Dependencies:

• Issues touching the same files/modules
• Feature requests that build on other features
• Bug fixes that require refactoring first
• Issues in the same functional area

Technical Dependencies:

• Database schema changes before feature work
• API changes before client updates
• Infrastructure before application features
• Core functionality before extensions

Step 3: Categorize Relationships

Step 4: Update Issues with References

Add blocking reference:

gh issue comment <blocked-issue> --body "## Dependency Note

This issue is blocked by #<blocking-issue>.

**Reason:** [Why this dependency exists]

This will be ready for implementation once #<blocking-issue> is resolved."

Add related reference:

gh issue comment <issue> --body "## Related Issues

This issue is related to:
- #<related-1> - [brief description of relationship]
- #<related-2> - [brief description of relationship]

Consider coordinating these changes together."

Mark duplicates:

gh issue comment <duplicate> --body "This appears to be a duplicate of #<original>. Closing in favor of that issue."
gh issue close <duplicate> --reason "not planned" --comment "Duplicate of #<original>"

Step 5: Update Project Board Status

Blocked issues should be moved to appropriate status on project #8:

• Blocked issues waiting for info: Move to "Needs Human Review"
• Blocked issues with info but waiting on other issues: Keep in "Ready to Implement" with dependency note
• Unblocked issues needing agent review: Move to "Needs Agent Review"
• Unblocked issues with implementation plans: Move to "Ready to Implement"
• Issues with active implementation branches: Move to "Needs Code Review"

# Get project item ID for an issue
gh project item-list 8 --owner forrestthewoods --format json | jq '.items[] | select(.content.number == <issue-number>)'

# Update status
gh project item-edit --project-id <project-id> --id <item-id> --field-id <status-field-id> --single-select-option-id <option-id>

Step 6: Generate Dependency Report

Create a comprehensive dependency map:

## Issue Dependency Map

### Dependency Graph

#15 (Database schema update) └── #18 (User authentication) └── #22 (User preferences) └── #20 (API v2 endpoints)

#12 (Refactor job system) └── #25 (Parallel builds) └── #27 (Build caching)

### Blocking Issues (High Priority)
These issues block other work and should be prioritized:

| Issue | Blocks | Description | Board Status |
|-------|--------|-------------|--------------|
| #15 | #18, #20 | Database schema update | Ready to Implement |
| #12 | #25, #27 | Job system refactor | Needs Agent Review |

### Ready to Start (No Blockers)
These issues have no blockers and are ready for work:
- #10 - Fix typo in README (Ready to Implement)
- #11 - Add --help examples (Ready to Implement)
- #15 - Database schema update (Ready to Implement)

### Waiting on Dependencies
These issues are blocked:
- #18 - Waiting on #15 (Ready to Implement, but blocked)
- #25 - Waiting on #12 (Needs Agent Review)

### Related Issue Clusters
Issues that should be considered together:

**Cluster: Build Performance**
- #12 - Refactor job system
- #25 - Parallel builds
- #27 - Build caching

**Cluster: Documentation**
- #30 - Update README
- #31 - Add API docs
- #32 - Tutorial improvements

### Suggested Work Order
Based on dependencies, here's the recommended sequence:

1. **Phase 1 (No blockers):**
   - #10, #11, #15, #12

2. **Phase 2 (After Phase 1):**
   - #18, #20, #25, #27

3. **Phase 3 (After Phase 2):**
   - #22

Guidelines

• Only mark issues as blocked when there's a real technical dependency
• Be specific about why dependencies exist
• Don't create circular dependencies
• Consider partial dependencies (can start work but not complete)
• Check for implicit dependencies through code analysis
• Update dependency notes when relationships change
• Always reflect blocking status in project board

Detecting Dependencies Through Code

When issues reference the same code areas, investigate further:

1. Find files mentioned in issues:

   # Extract file paths from issue body
   gh issue view <number> --json body
   

2. Check for overlapping changes:

   • If Issue A modifies src/job_system.rs
   • And Issue B adds features to src/job_system.rs
   • They may need coordination (not necessarily blocking)

3. Identify shared abstractions:

   • Changes to traits/interfaces
   • Database schema modifications
   • API contract changes

Example Dependency Analysis

Issue #18: Add user authentication

Analysis:
- References database user table (#15)
- Mentions API endpoints (#20)
- Touches src/auth.rs, src/api.rs

Dependencies found:
- BLOCKED BY #15 (need user table first)
- RELATED TO #20 (both touch API layer)

Board status: Ready to Implement (blocked, waiting on #15)

Resulting comments:

On #18:

Dependency Note

This issue is blocked by #15 (Database schema update).

Reason: User authentication requires the users table which will be created in #15.

Additionally related to #20 (API v2 endpoints) as both modify the API layer.

On #15:

Note

This issue blocks:

• #18 (User authentication) - needs users table
• #20 (API v2 endpoints) - needs updated schema

Please prioritize this issue to unblock dependent work.