Kiro IDE Integration¶

Use PRD Tool as a Kiro Power for AI-assisted PRD creation in Kiro IDE.

Overview¶

Kiro Powers are capability packages that enhance Kiro IDE with specialized tools. The PRD Tool Power provides:

MCP tools for PRD operations
Steering files for guided workflows
Keyword-based activation for token efficiency

Installation¶

Step 1: Install the MCP Server¶

The MCP server binary must be installed and available in your PATH.

Option A: Install with go install

go install github.com/agentplexus/agent-team-prd/cmd/prdtool-mcp@latest

Option B: Build from source

cd agent-team-prd
go build -o /usr/local/bin/prdtool-mcp ./cmd/prdtool-mcp

Verify installation:

which prdtool-mcp

Step 2: Import the Power¶

Choose one of these methods:

Option A: Import from GitHub (recommended)

In Kiro IDE:

Open the Powers panel
Click Import
Enter the GitHub URL:

https://github.com/agentplexus/agent-team-prd/tree/main/power-prdtool

Option B: Import from local folder

If you've cloned the repo:

Open the Powers panel
Click Import
Select the folder:

/path/to/agent-team-prd/power-prdtool

Option C: Deploy with prdtool CLI

prdtool deploy --target kiro-power --output ~/.kiro/powers/prdtool

This creates:

~/.kiro/powers/prdtool/
├── POWER.md          # Power manifest with keywords
├── mcp.json          # MCP server configuration
└── steering/
    ├── prd-creation.md    # PRD creation workflow
    ├── prd-review.md      # PRD review workflow
    └── exec-summary.md    # Executive summary workflow

Step 3: Verify Installation¶

In Kiro IDE, the Power activates when you mention keywords like:

"PRD"
"product requirements"
"requirements document"
"product spec"
"feature spec"
"problem statement"
"user persona"
"success metrics"

Power Structure¶

POWER.md¶

The manifest file contains:

---
name: "prdtool"
displayName: "PRD Tool"
description: "Create, validate, score, and manage PRDs"
version: "1.0.0"
keywords:
  - "prd"
  - "product requirements"
  - "requirements document"
  # ... more keywords
---

mcp.json¶

MCP server configuration:

{
  "mcpServers": {
    "prdtool": {
      "command": "prdtool-mcp",
      "args": []
    }
  }
}

Steering Files¶

Steering files guide Kiro through specific workflows:

File	Purpose
`prd-creation.md`	Step-by-step PRD creation
`prd-review.md`	Quality review and improvement
`exec-summary.md`	Executive summary generation

Available Tools¶

The Power exposes these MCP tools:

Document Lifecycle¶

Tool	Description
`prd_init`	Initialize a new PRD
`prd_load`	Load PRD contents
`prd_validate`	Validate structure
`prd_score`	Score quality
`prd_view`	Generate views
`prd_update_status`	Update status

Content Addition¶

Tool	Description
`prd_add_problem`	Add problem statement
`prd_add_persona`	Add user persona
`prd_add_goal`	Add goal
`prd_add_nongoal`	Add non-goal
`prd_add_solution`	Add solution option
`prd_add_requirement`	Add functional requirement
`prd_add_nfr`	Add non-functional requirement
`prd_add_metric`	Add success metric
`prd_add_risk`	Add risk
`prd_add_decision`	Add decision record
`prd_select_solution`	Select solution

Workflows¶

PRD Creation Workflow¶

Triggered by prompts like "Help me create a PRD for..."

Problem Discovery: Kiro asks probing questions about the problem
User Definition: Define target personas and their pain points
Scope Setting: Establish goals and explicit non-goals
Solution Exploration: Explore multiple options before selecting
Requirements: Document functional and non-functional requirements
Metrics: Define success criteria with a North Star metric
Risks: Identify risks and mitigation strategies
Validation: Validate and score the final document

PRD Review Workflow¶

Triggered by prompts like "Review this PRD" or "Score my PRD"

Load: Load the existing PRD
Validate: Check structural integrity
Score: Evaluate against quality rubric
Analyze: Identify gaps in each category
Recommend: Provide specific improvement suggestions
Prioritize: Order fixes by impact on score

Executive Summary Workflow¶

Triggered by prompts like "Generate an executive summary"

Score: Get quality assessment
Generate: Create executive view
Summarize: Present decision recommendation
Highlight: Show risks and required actions

Usage Examples¶

Create a New PRD¶

"Help me create a PRD for a user authentication feature"

Kiro will:

Load the PRD Creation steering
Ask about the problem you're solving
Guide you through each section
Validate and score the result

Review and Improve¶

"Review my PRD and tell me how to improve the score"

Kiro will:

Load the PRD Review steering
Score the document
Analyze low-scoring categories
Suggest specific improvements

Prepare for Leadership¶

"Generate an executive summary for leadership review"

Kiro will:

Load the Executive Summary steering
Score the PRD
Generate the exec view
Present decision recommendation

Quality Scoring¶

PRDs are scored across 10 categories:

Category	Weight
Problem Definition	20%
Solution Fit	15%
User Understanding	10%
Market Awareness	10%
Scope Discipline	10%
Requirements Quality	10%
Metrics Quality	10%
UX Coverage	5%
Technical Feasibility	5%
Risk Management	5%

Decision Thresholds:

≥8.0 → Approve (ready for implementation)
≥6.5 → Revise (minor issues)
<6.5 → Human Review (significant gaps)
≤3.0 → Blocker (critical issues)

Customization¶

Adding Keywords¶

Edit POWER.md to add activation keywords:

keywords:
  - "prd"
  - "your-custom-keyword"

Custom Steering Files¶

Add steering files to steering/ for specialized workflows:

steering/
├── prd-creation.md
├── prd-review.md
├── exec-summary.md
└── custom-workflow.md    # Your custom workflow

Reference in POWER.md:

## Workflows

### Custom Workflow
Use for [specific scenario]. Guides through:
1. Step one
2. Step two

Troubleshooting¶

Power Not Activating¶

Verify Power is installed: ls ~/.kiro/powers/prdtool/
Check keywords match your prompt
Restart Kiro IDE

MCP Server Not Found¶

Ensure prdtool-mcp is in your PATH:

which prdtool-mcp
# If not found, add to PATH or use absolute path in mcp.json

Tools Not Available¶

Check mcp.json has correct configuration:

cat ~/.kiro/powers/prdtool/mcp.json

Verify server works standalone:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | prdtool-mcp