discovery-plan

Compiles discovery evidence into agent-facing and research planning documents.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/subvisual/the-a-team --skill discovery-plan-subvisual
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: discovery-plan
Source: https://github.com/subvisual/the-a-team/tree/main/.claude/skills/discovery-plan
Command: npx skills add https://github.com/subvisual/the-a-team --skill discovery-plan-subvisual

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Discovery work often dies in chat logs: unvalidated assumptions, open questions, and research findings never become durable plans, so teams commit scope on shaky ground. This Skill turns the Know/Don't-Know ledger and synthesis runs into two live planning artifacts that cannot drift apart. ## Core Features & Use Cases - Dual plan compilation: Writes docs/product/ateam-plan.md (goals and deliverables to reach v0, traced to jobs) and docs/product/research-plan.md (open questions, assumptions with confidence and disproof, technical research with integration costs) in one pass. - Post-v0 project plan: At the pr phase only, also writes docs/product/project-plan.md describing what comes after v0 for the human team. - Live refresh: Re-runnable at any phase to fold new ledger entries, verdicts, and assumptions into both plans with update-only, read-back-before-write rules. - Use Case: After research synthesis confirms a job but leaves compliance and accuracy unknowns, run this Skill to produce a plan with initiatives, owners, decision criteria, and a research plan that ships with the v0. ## Quick Start Use the discovery-plan skill to compile the context.md ledger and research synthesis into the ateam-plan and research-plan documents.

Frequently Asked Questions about discovery-plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn product discovery findings into a research plan?▼

Run the discovery-plan skill after research synthesis: it reads the context.md ledger, research runs, and active jobs, then writes research-plan.md with cited evidence, open questions, assumptions with confidence and disproof, and technical research with integration costs.

What is the difference between ateam-plan.md and research-plan.md?▼

ateam-plan.md holds what the team will do: job-traced goals, deliverables to reach v0, initiatives with owners and dates, and decision criteria. research-plan.md holds what is unknown or assumed: open questions, assumptions with confidence, and technical research. Both are written together so they cannot drift.

When should I use discovery-plan versus prd-writer?▼

Use discovery-plan when unvalidated assumptions or open questions still block confident scope decisions. Once requirements are validated and delivery is underway, use prd-writer instead; discovery-plan hands off to wireflow, page-brief, then prd-writer.

Can discovery-plan run without a human reviewer present?▼

No durable writes occur without a human. The read-back gate requires review, so with nobody present the skill delivers drafts in its report only, writes nothing, and states the run awaits review. An unreviewed research plan is never committed.

When is project-plan.md written?▼

project-plan.md is written only at the pr phase's plan refresh, once a v0 exists and is integrated. It covers what comes after v0 for the human team. On every other invocation it is omitted entirely, since planning past a nonexistent v0 is fiction.

What are the limitations of discovery-plan?▼

It never synthesizes raw evidence (research-synthesis must run first) and never creates or rewrites job statements (jobs-to-be-done owns those). Plans built on unsynthesized evidence plan the wrong unknowns, so the skill stops and routes upstream.