# Prompts / Commands

Reusable prompt templates for AI agent workflows — compatible with **GitHub Copilot** (VS Code), **Claude Code**, and **Codex**.

## Overview

This package provides a collection of modular, reusable prompts for common development workflows. Each prompt integrates with Jira via the Atlassian MCP.

- **GitHub Copilot**: files live in `.github/prompts/` with `.prompt.md` extension
- **Claude Code**: files live in `.claude/commands/` with `.md` extension (auto-converted by the CLI)
- **Codex**: prompts live in `.github/prompts/` as reusable workflow references

## Structure

```
prompts/
├── README.md                    # This documentation
├── _partials/                   # Shared prompt fragments
│   ├── README.md               # Partials documentation
│   ├── validations.md          # Code quality validation steps
│   ├── git-operations.md       # Git workflow operations
│   ├── jira-integration.md     # Jira/Atlassian MCP operations
│   ├── documentation.md        # Documentation standards
│   └── pr-template.md          # Pull request templates
│
├── # Workflow Prompts
├── analyze-ticket.prompt.md         # Analyze a Jira ticket
├── analyze-github-issue.prompt.md   # Analyze a GitHub issue
├── create-plan.prompt.md            # Create implementation plan
├── work-ticket.prompt.md            # Start working on a Jira ticket
├── work-github-issue.prompt.md      # Start working on a GitHub issue
├── prepare-pr.prompt.md             # Prepare code for PR
├── create-pr.prompt.md              # Create a pull request (Jira)
├── create-github-pr.prompt.md       # Create a pull request (GitHub)
├── finalize-pr.prompt.md            # Finalize and merge PR (Jira)
├── finalize-github-pr.prompt.md     # Finalize and merge PR (GitHub)
├── prepare-github-release.prompt.md # Prepare a GitHub release
│
├── # Utility Prompts
├── review-code.prompt.md            # Quick code review
├── fix-issues.prompt.md             # Fix lint/type/test errors
├── add-tests.prompt.md              # Add tests for components
├── audit-ai-seo.prompt.md           # Audit a page for AI Search / agent-friendliness
├── resolve-github-reviews.prompt.md # Fetch/reply/resolve GitHub PR review threads
│
└── # WordPress Prompts
    ├── new-wp-component.prompt.md    # Scaffold a WordPress plugin component
    ├── new-wp-plugin.prompt.md       # Scaffold a WordPress plugin
    └── quality-check.prompt.md       # Run PHPCS / PHPStan / PHPUnit
```

## Workflow Stages

```
┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  1. Analyze     │────▶│  2. Plan        │────▶│  3. Work        │
│  analyze-ticket │     │  create-plan    │     │  work-ticket    │
└─────────────────┘     └─────────────────┘     └─────────────────┘
                                                        │
                                                        ▼
┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  6. Finalize    │◀────│  5. Create PR   │◀────│  4. Prepare     │
│  finalize-pr    │     │  create-pr      │     │  prepare-pr     │
└─────────────────┘     └─────────────────┘     └─────────────────┘
```

## Usage

### GitHub Copilot (VS Code)

1. Open the Command Palette (`Cmd+Shift+P`)
2. Search for "GitHub Copilot: Run Prompt"
3. Select the desired prompt
4. Fill in the required variables (e.g., `{ticket-id}`)

### Claude Code

Type `/` in the chat to open the command palette and select the desired command:

```
/analyze-ticket
/work-ticket
/create-pr
```

### Codex

Run Codex from the project root after installing with `--codex`. Use prompts in `.github/prompts/` as workflow templates and task checklists.

### Variables

Each prompt may require input variables:

| Variable | Description | Example |
|----------|-------------|---------|
| `{ticket-id}` | Jira ticket identifier | `WEB-726` |
| `{feature-description}` | Brief feature description | `Add font size controls` |
| `{feature-name}` | Kebab-case feature name | `font-accessibility` |

## Customization

### Adding Custom Prompts

1. Create a new `.prompt.md` file
2. Use the frontmatter format:

   ```markdown
   ---
   agent: agent
   description: Brief description of the prompt
   ---
   
   Your prompt content here...
   ```

### Frontmatter Options

| Field | Description |
|-------|-------------|
| `description` | A short description of the prompt |
| `name` | The name shown after typing `/` in chat (defaults to filename) |
| `agent` | The agent to use: `ask`, `edit`, `agent`, or custom agent name |
| `model` | Language model to use (defaults to selected model) |
| `tools` | List of tools available for this prompt |

### Using Partials

Reference shared fragments in your prompts:

```markdown
## Prerequisites
- Reference: `.github/prompts/_partials/validations.md`
```

## Integration

### Required Tools/MCPs

- **Atlassian MCP**: For Jira ticket operations
- **Git**: For version control operations
- **npm/Node.js**: For running validations