Project Management Context

Provides a unified interface for project management operations across different tools. This skill auto-loads when Claude detects work related to project management.

PM Tool Detection

Detect the project's PM tool in this order:

1. CLAUDE.md configuration:

   ## Project Management
   pm_tool: linear
   pm_team: Chronicle
   

2. Settings file (.claude/settings.json):

   {
     "pm": {
       "tool": "jira",
       "project": "PROJ",
       "api_url": "https://company.atlassian.net"
     }
   }
   

3. File detection:

   • .linear/ directory → Linear
   • .jira.d/ or jira.config → Jira
   • .github/ with projects → GitHub Projects
   • BACKLOG.md or backlog.md → Markdown

4. Default: Markdown (no external tool required)

Loading the Appropriate Adapter

Once detected, load the corresponding adapter:

| Tool | Adapter File | CLI | |------|--------------|-----| | Linear | adapters/linear.md | linctl | | Jira | adapters/jira.md | jira | | GitHub | adapters/github.md | gh | | Markdown | adapters/markdown.md | filesystem |

Operations Interface

All adapters implement the operations defined in interface.md. Use these generic operations in skills rather than tool-specific commands.

Terminology

Use generic terminology in all skill interactions:

| Generic Term | Description | |--------------|-------------| | work item | Any trackable unit (issue, ticket, task) | | epic | Large body of work containing features | | feature | Discrete capability within an epic | | task | Atomic implementation unit | | sprint | Time-boxed execution container | | backlog | Prioritized list of work items | | project | Container for related work |

Usage in Skills

Skills should:

1. Call pm-context to detect the active PM tool
2. Load the appropriate adapter
3. Use interface operations, not direct CLI calls
4. Use generic terminology in outputs

Example pattern:

## Step 1: Get Work Item Context
Use pm-context to fetch the work item:
- Detect PM tool from project config
- Load [interface.md](../pm-context/interface.md) for operation spec
- Call `get_item(item_id)` via the appropriate adapter