---
name: blueprint-audit
description: "Audits a PRD against implementation status and guides lifecycle decisions."
metadata:
  category: planning
  is_workflow: false
  version: 1.0.0
  tags:
    - blueprint
    - prd
    - audit
    - lifecycle
    - housekeeping
  created: 2026-01-27
  updated: 2026-02-26
  author: cloud-on-prem/rp1
  arguments:
    - name: PRD_NAME
      type: string
      required: true
      description: "PRD filename without extension"
---

# Blueprint Audit

Audits PRD documents against implementation evidence, identifies stale or completed blueprints, and guides disposition decisions (archive, modify scope, defer).

## Usage

```
/rp1-dev:blueprint-audit <prd-name>
```

## Behavior

- Extracts phases/milestones from PRD document
- Checks archives and features directories for evidence
- Searches codebase when archive/feature evidence insufficient
- Classifies each phase as Complete/Partial/Not Started
- Presents audit results with evidence summary
- Guides user through disposition decision

## Execution

### Step 1: Run Audit

{% dispatch_agent "rp1-dev:blueprint-auditor" %}
MODE: audit
PRD_NAME: {PRD_NAME}
KB_ROOT: {kbRoot}
WORK_ROOT: {workRoot}
{% enddispatch_agent %}

### Step 2: Handle Audit Response

**Error Response**:
```json
{"type":"error","message":"...","available_prds":["..."]}
```
Output error message with available PRDs, then STOP.

**Needs User Input** (audit complete):
```json
{"type":"needs_user_input","question":"relevance","phases":[...],"summary":{...}}
```

Display the audit table from agent output, then continue to Step 3.

### Step 3: Ask Relevance Question

{% ask_user "Is this PRD still relevant to your work?", options: "Archive", "Add scope", "Remove scope", "Continue", "Defer" %}

### Step 4: Handle User Choice

**"Archive"**:
1. Invoke agent with MODE=action, USER_CHOICE=archive
2. Agent returns `needs_user_input` with question="closure_status"
3. Ask user:
   ```
   Question: "What is the closure status?"
   Options:
   - "Complete" - All planned work finished
   - "Partial" - Some work deferred or abandoned
   ```
4. If "Partial", ask for gap documentation (freeform text)
5. Invoke agent with MODE=action, USER_CHOICE=archive_confirm, SCOPE_INPUT={status}|{gaps}

**"Add scope"**:
1. Ask user for new scope description (freeform text)
2. Invoke agent with MODE=action, USER_CHOICE=add_scope, SCOPE_INPUT={description}

**"Remove scope"**:
1. Present list of Not Started/Partial phases from audit
2. Ask user which phase IDs to remove (multi-select or comma-separated)
3. Invoke agent with MODE=action, USER_CHOICE=remove_scope, SCOPE_INPUT={phase_ids}

**"Continue"**:
- Invoke agent with MODE=action, USER_CHOICE=continue

**"Defer"**:
- Invoke agent with MODE=action, USER_CHOICE=defer

### Step 5: Report

Display agent's final output. Include:
- Disposition taken
- Next steps if applicable