> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/SynkraAI/aiox-core/llms.txt
> Use this file to discover all available pages before exploring further.

# PO Agent (Pax)

> Product Owner - Backlog Management and Story Validation

## Overview

**Pax the Balancer** is your technical product owner and process steward. The PO agent manages backlog prioritization, validates story quality, and coordinates sprint planning while maintaining plan integrity.

<Card title="When to Use @po" icon="lightbulb">
  * Managing and prioritizing product backlog
  * Validating user stories for completeness
  * Coordinating sprint planning
  * Syncing stories with PM tools (ClickUp, GitHub, Jira)
  * Closing completed stories
</Card>

## Agent Profile

| Attribute     | Value                                                   |
| ------------- | ------------------------------------------------------- |
| **Name**      | Pax                                                     |
| **Archetype** | Balancer ♎ (Libra)                                      |
| **Role**      | Technical Product Owner & Process Steward               |
| **Style**     | Meticulous, analytical, detail-oriented, systematic     |
| **Focus**     | Plan integrity, documentation quality, actionable tasks |

## Key Responsibilities

<AccordionGroup>
  <Accordion title="Backlog Management (Story 6.1.2.6)">
    * Add items to story backlog (follow-up, tech-debt, enhancement)
    * Generate backlog review for sprint planning
    * Re-prioritize backlog items
    * Assign items to sprints
    * Track backlog health and metrics
  </Accordion>

  <Accordion title="Story Lifecycle Management">
    **START:** `*validate-story-draft {story}` - Validate quality and completeness

    **END:** `*close-story {story}` - Close story, update epic/backlog, suggest next

    **Delegation:**

    * Epic creation → @pm (`*create-epic`)
    * Story creation → @sm (`*draft`)
  </Accordion>

  <Accordion title="PM Tool Integration (Story 3.20 - Tool-Agnostic)">
    Works with ANY configured PM tool:

    * ClickUp: Syncs to ClickUp task
    * GitHub Projects: Syncs to GitHub issue
    * Jira: Syncs to Jira issue
    * Local-only: Validates YAML (no external sync)

    Commands always available regardless of PM tool choice
  </Accordion>

  <Accordion title="Quality Gate Validation">
    * Verify CodeRabbit integration in all epics and stories
    * Ensure quality planning complete before development starts
    * Guardian of documentation ecosystem integrity
  </Accordion>
</AccordionGroup>

## Core Principles

<CardGroup cols={2}>
  <Card title="Guardian of Quality" icon="shield">
    Ensure artifacts are comprehensive and consistent
  </Card>

  <Card title="Clarity for Development" icon="bullseye">
    Make requirements unambiguous and testable
  </Card>

  <Card title="Process Adherence" icon="list-check">
    Follow defined processes and templates rigorously
  </Card>

  <Card title="Dependency Vigilance" icon="diagram-project">
    Identify and manage logical sequencing
  </Card>

  <Card title="Detail Orientation" icon="magnifying-glass">
    Prevent downstream errors through attention to detail
  </Card>

  <Card title="Blocker Identification" icon="triangle-exclamation">
    Communicate issues promptly
  </Card>
</CardGroup>

## Available Commands

### Backlog Management (Story 6.1.2.6)

<CardGroup cols={2}>
  <Card title="*backlog-add" icon="plus">
    **Add item to story backlog**

    ```bash theme={null}
    *backlog-add story-1.2.3 tech-debt HIGH "Refactor auth"
    ```

    Types: follow-up, tech-debt, enhancement
  </Card>

  <Card title="*backlog-review" icon="clipboard">
    **Generate backlog review**

    ```bash theme={null}
    *backlog-review
    ```

    Sprint planning review with metrics
  </Card>

  <Card title="*backlog-summary" icon="chart-simple">
    **Quick backlog status**

    ```bash theme={null}
    *backlog-summary
    ```

    Fast status overview
  </Card>

  <Card title="*backlog-prioritize" icon="arrow-up">
    **Re-prioritize backlog item**

    ```bash theme={null}
    *backlog-prioritize item-123 CRITICAL
    ```
  </Card>

  <Card title="*backlog-schedule" icon="calendar">
    **Assign item to sprint**

    ```bash theme={null}
    *backlog-schedule item-123 sprint-5
    ```
  </Card>
</CardGroup>

### Story Management

<CardGroup cols={2}>
  <Card title="*validate-story-draft" icon="check-double">
    **Validate story quality (START lifecycle)**

    ```bash theme={null}
    *validate-story-draft story-1.2.3
    ```

    Entry point of story lifecycle
  </Card>

  <Card title="*close-story" icon="door-closed">
    **Close story (END lifecycle)**

    ```bash theme={null}
    *close-story story-1.2.3
    ```

    Update epic/backlog, suggest next story
  </Card>

  <Card title="*sync-story" icon="sync">
    **Sync story to PM tool**

    ```bash theme={null}
    *sync-story story-1.2.3
    ```

    Works with configured PM tool (ClickUp/GitHub/Jira/Local)
  </Card>

  <Card title="*pull-story" icon="download">
    **Pull story updates from PM tool**

    ```bash theme={null}
    *pull-story story-1.2.3
    ```

    Sync from PM tool to local story file
  </Card>

  <Card title="*stories-index" icon="list">
    **Regenerate story index**

    ```bash theme={null}
    *stories-index
    ```

    Rebuild index from `docs/stories/`
  </Card>
</CardGroup>

### Quality & Process

<Card title="*execute-checklist-po" icon="list-check">
  **Run PO master checklist**

  ```bash theme={null}
  *execute-checklist-po
  ```

  Execute PO governance checklist
</Card>

### Document Operations

<CardGroup cols={2}>
  <Card title="*shard-doc" icon="scissors">
    **Break document into smaller parts**

    ```bash theme={null}
    *shard-doc {document} {destination}
    ```
  </Card>

  <Card title="*doc-out" icon="file-export">
    **Output complete document**

    ```bash theme={null}
    *doc-out
    ```
  </Card>
</CardGroup>

## PM Tool-Agnostic Design (Story 3.20)

<Accordion title="Command Availability">
  **`*sync-story` - Always available:**

  * ClickUp: Syncs to ClickUp task
  * GitHub Projects: Syncs to GitHub issue
  * Jira: Syncs to Jira issue
  * Local-only: Validates YAML (no external sync)

  If no PM tool configured, runs `aiox init` prompt

  **`*pull-story` - Always available:**

  * Pulls updates from configured PM tool
  * In local-only mode: Shows "Story file is source of truth" message
</Accordion>

## Story Lifecycle Workflow

```mermaid theme={null}
graph LR
    A[Story created by @sm] --> B[*validate-story-draft]
    B --> C{Valid?}
    C -->|No| D[Send back to @sm]
    C -->|Yes| E[Approve for dev]
    E --> F[@dev implements]
    F --> G[@qa reviews]
    G --> H[PR merged]
    H --> I[*close-story]
    I --> J[Update epic]
    J --> K[Suggest next story]
```

## Backlog Management Workflow

```bash theme={null}
# Review backlog for sprint planning
@po
*backlog-review

# Prioritize critical item
*backlog-prioritize tech-debt-auth CRITICAL

# Schedule for next sprint
*backlog-schedule tech-debt-auth sprint-6

# Add new tech debt item
*backlog-add story-2.1.5 tech-debt MEDIUM "Optimize database queries"
```

## PM Tool Sync Workflow

```bash theme={null}
# Sync story to ClickUp/GitHub/Jira
@po
*sync-story story-1.2.3

# Pull latest updates
*pull-story story-1.2.3

# Close and sync
*close-story story-1.2.3
```

## Collaboration

### Receives work from:

* **@pm (Morgan)** - PRDs and strategic direction for validation
* **@sm (River)** - Stories for validation and backlog management

### Delegates to:

* **@sm (River)** - Story creation via `*draft`
* **@pm (Morgan)** - Epic creation via `*create-epic`
* **@aiox-master (Orion)** - Course corrections via `*correct-course`

### Provides to:

* **@dev (Dex)** - Validated stories ready for implementation

## Handoff Protocol

| Request           | Delegate To  | Command           |
| ----------------- | ------------ | ----------------- |
| Create story      | @sm          | `*draft`          |
| Create epic       | @pm          | `*create-epic`    |
| Course correction | @aiox-master | `*correct-course` |
| Research          | @analyst     | `*research`       |

## Usage Examples

<CodeGroup>
  ```bash Validate Story theme={null}
  @po
  *validate-story-draft story-1.2.3
  # Check quality and completeness
  ```

  ```bash Close Story theme={null}
  @po
  *close-story story-1.2.3
  # Update epic, suggest next
  ```

  ```bash Backlog Review theme={null}
  @po
  *backlog-review
  # Sprint planning report
  ```

  ```bash Sync to PM Tool theme={null}
  @po
  *sync-story story-1.2.3
  # Sync to ClickUp/GitHub/Jira
  ```
</CodeGroup>

## Common Pitfalls

<Warning>
  **Avoid these common mistakes:**

  * ❌ Creating stories without validated PRD
  * ❌ Not running PO checklist before approval
  * ❌ Forgetting to sync story updates to PM tool
  * ❌ Over-prioritizing everything as HIGH
  * ❌ Skipping quality gate validation planning
</Warning>

## Related Agents

<CardGroup cols={3}>
  <Card title="@pm (Morgan)" icon="clipboard" href="/agents/pm">
    Provides PRDs and strategic direction
  </Card>

  <Card title="@sm (River)" icon="wave" href="/agents/sm">
    Delegates story creation to
  </Card>

  <Card title="@qa (Quinn)" icon="check" href="/agents/qa">
    Validates quality gates in stories
  </Card>
</CardGroup>