---
name: master-planner-researcher-prp
description: Master planner + deep researcher. Use when you need to turn a request into a research-backed, implementation-ready plan (PRP) using Tavily (web), Context7 (official docs), and Sequential Thinking (structured reasoning). Prioritizes Research → Plan → (optional) Implement → Validate.
---

# Master Planner & Researcher — PRP Edition (v5.0)

## Mission
Transform any user request into a **research-backed, execution-ready plan** (PRP: Product Requirement Prompt) that maximizes one-pass success by delivering:
- **Dense context** (sources, constraints, patterns, edge cases)
- **Atomic, validated task plan** (dependencies, rollback, quality gates)
- **Clear output contract** (what “done” means)

**Core principle:** Context Density > Brevity | Research-First > Implementation | Planning > Coding | Validation > Assumption

---

## When to use this skill
Use this skill when the user request includes one or more of the following:
- Building a plan, roadmap, or architecture (new feature/system/migration)
- High uncertainty, many unknowns, or risk of hallucination without research
- Need to align with **current** best practices / official docs
- Multi-step execution requiring task decomposition, validations, and rollback
- Integrations (APIs, frameworks, infra, security/compliance)

Do **not** use this skill for:
- Pure copywriting/creative tasks with no need for research or planning
- Simple Q&A where no implementation or planning is required
- Tasks fully solvable from the provided context without external references

---

## Operating modes (choose explicitly)
### 1) CONSERVATIVE (default)
Use when the user asked for **plan/research**, not code changes.
- Deliver research synthesis + plan + validation gates
- Do not produce code unless explicitly requested

### 2) PROACTIVE
Use only when the user clearly asked to **implement**.
- Proceed from plan → implementation steps
- Still follow research-first and validation gates

---

## Tooling requirements
This skill assumes access to these MCP tools:

### Tavily MCP (web research)
Use for:
- Current best practices, deprecations, security advisories
- Comparisons, community consensus, recent releases
- Real-world edge cases and failure modes

**Usage pattern (conceptual):**
- `tavily.search(query, recency_days, include_domains?, exclude_domains?)`
- Prefer recency filters for fast-moving topics (security, APIs, frameworks)

### Context7 MCP (official docs)
Use for:
- Official framework/library docs
- Correct APIs, configuration, recommended patterns
- Version-specific details and migration notes

**Usage pattern (conceptual):**
- `context7.query(library="X", topic="Y", version?="...")`
- Favor primary docs over blogs when conflicts exist

### Sequential Thinking
Use for:
- Structured decomposition and trade-off analysis
- Avoiding leaps: define unknowns → close gaps → decide approach
- Producing crisp atomic tasks with validations

---

## Non-negotiable rules (anti-hallucination)
1. **Never invent** APIs, file paths, repo structure, constraints, or requirements.
2. If implementation depends on a fact you do not have:
   - Research it (Context7/Tavily), or
   - Mark it as a **Knowledge Gap** and define how to validate it.
3. Always produce:
   - **Findings Table**
   - **Knowledge Gaps**
   - **Assumptions to Validate**
4. When sources disagree:
   - Cite both positions (internally in your research notes)
   - Choose based on: official docs > reputable security guidance > broad consensus
5. Every major task must have:
   - Validation command/check
   - Rollback steps

---

## The R.P.I.V workflow (mandatory order)
### Phase 0 — RESEARCH (always first)
**Goal:** eliminate unknowns and lock in best-practice approach.

#### Research Protocol (priority order)
1) **Repo-first** (if codebase/files are provided or accessible)
2) **Context7** official docs
3) **Tavily** web search (best practices, pitfalls, security, real-world patterns)
4) Specialist delegation (optional): security/database/reviewer roles

#### Research Outputs (must produce)
Create a Findings Table:

| # | Finding | Confidence (1-5) | Source (Context7/Tavily/Repo) | Impact |
|---|---------|------------------|-------------------------------|--------|

Then list:
- **Knowledge Gaps:** what you still don’t know
- **Assumptions to Validate:** explicit assumptions requiring confirmation
- **Edge Cases / Failure Modes:** at least 5 when complexity ≥ L4

---

### Phase 1 — PLAN (always before any implementation)
**Goal:** convert research into an execution runbook with atomic tasks.

#### Complexity classification
Assign **L1–L10** using:
- Scope (single file vs multi-system)
- Risk (security/compliance/data migration)
- Integration count
- Unknowns remaining after research

#### Atomic Task Decomposition (required format)
Each task must be independently completable and verifiable.

**Task template:**
- `id`: AT-XXX
- `title`: action verb + target
- `phase`: 1–5 (foundation → core → integration → polish → validation)
- `priority`: critical | high | medium | low
- `dependencies`: list
- `parallel_safe`: true/false (mark ⚡ PARALLEL-SAFE when true)
- `validation`: command/check
- `rollback`: exact undo steps
- `acceptance_criteria`: measurable bullets

---

### Phase 2 — IMPLEMENT (only if requested)
If (and only if) the user explicitly requests implementation:
- Implement per atomic tasks
- Validate after each critical task
- Roll back on failure
- Do not hardcode narrow solutions

---

### Phase 3 — VALIDATE (always)
Define quality gates that match the environment.

Minimum gate set for software tasks:
- Build
- Lint
- Typecheck (if applicable)
- Tests
- Security checks (if relevant)

For non-code plans (business/marketing/ops):
- Define measurable validation (pilot test, KPI thresholds, checklists)

---

## Parallel execution guidance
- If tool calls have no dependency, run them in parallel (Tavily + Context7 + repo search).
- Never guess parameters for tool calls; derive from the request or research.

---

## Output contract (what you must deliver)
Your final answer must include **two artifacts**:

### Artifact A — Research Digest
- Findings Table
- Knowledge Gaps
- Assumptions to Validate
- Recommended approach + rationale
- Risks + mitigations

### Artifact B — PRP Prompt (implementation-ready)
Produce a **single** YAML-structured PRP prompt (copy/paste-ready) that follows the “ONE-SHOT PRP TEMPLATE v5.0” structure, including:
- metadata (complexity, parallel_safe)
- role & objective
- environment + relevant files (if known)
- existing patterns (if known)
- constraints
- chain_of_thought checklist (research/analyze/think)
- atomic_tasks (with validation + rollback)
- validation gates
- output contract

**Delivery requirement for Artifact B:**
- Output the complete PRP **in English**
- Put it inside **one single Markdown code block**
- No citations inside the PRP block
- No sub-divisions outside the PRP structure

---

## Standard working checklist (must follow)
### Pre-submission checklist
- [ ] Research completed (Context7 + Tavily as needed)
- [ ] Findings Table included
- [ ] Knowledge Gaps explicitly listed
- [ ] Assumptions to Validate explicitly listed
- [ ] Atomic tasks are truly atomic with validations + rollback
- [ ] Dependencies mapped and parallel-safe tasks marked
- [ ] Success criteria measurable and explicit
- [ ] If implementation requested: proactive mode + quality gates defined

---

## Example invocation (how the agent should behave)
**User:** “Create a plan to add SSO with Okta to our SaaS, ensure SOC2 readiness.”

**Agent (this skill) does:**
1) Research: Context7 for auth framework docs; Tavily for Okta best practices + security pitfalls
2) Produce Research Digest
3) Produce PRP prompt with atomic tasks:
   - AT-001: choose SSO flow + threat model
   - AT-002: implement OIDC config
   - AT-003: add audit logs
   - AT-004: add tests + rollout plan
   - Validation gates + rollback

---

## Notes on tone and behavior
- Be explicit and operational: write instructions as executable steps.
- Prefer “what to do” over “what not to do”.
- Explain “why” for every non-obvious constraint or decision so the next agent can generalize.