prd-learner

Classify implementation learnings and draft PRD amendments with identifiers.

2|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/yesplease-studio/prd-please --skill prd-learner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prd-learner
Source: https://github.com/yesplease-studio/prd-please/tree/main/skills/prd-learner
Command: npx skills add https://github.com/yesplease-studio/prd-please --skill prd-learner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Captures implementation learnings and codifies them back into the Strategic PRD so future agents and team members inherit the knowledge. This closes the feedback loop after builds, validations, bug fixes, or sprint retrospectives.

Core Features & Use Cases

  • Gather context from validation reports, implementation agent notes, and session transcripts; classify each learning and propose PRD amendments.
  • Draft inline amendments for Sections 5-6, and update Section 8 with new learnings; prepare a concise learning report for human approval.
  • Institutionalize retroactive improvements to prevent repeating mistakes in future projects.

Quick Start

Turn on the skill and say "capture learnings" to begin.

Frequently Asked Questions about prd-learner

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

FAQPage Schema
How do I capture implementation learnings and update my PRD after a sprint retrospective?

Capture implementation learnings by classifying validation failures and bug fixes, then drafting exact PRD amendments with identifiers to update the Strategic PRD. This codifies retrospective insights into permanent rules so future agents and team members inherit the knowledge.

What is the best way to prevent repeated mistakes by codifying bug fixes into requirements documentation?

Codifying bug fixes into requirements documentation involves classifying each learning, referencing validation reports, and drafting inline amendments for Strategic PRD sections. This institutionalizes retroactive improvements to prevent repeating mistakes in future projects.

Can I add amendments to my Strategic PRD automatically after validation failures?

Yes, you can add amendments after validation failures by gathering context from validation reports and implementation notes. The process drafts inline amendments for specific PRD sections and prepares a concise learning report for human approval before finalizing.

How do I classify learnings from session transcripts into permanent PRD guardrails?

Classify learnings from session transcripts by extracting context, categorizing each learning type, and proposing precise PRD amendments with unique identifiers. This updates the Strategic PRD sections and logs new learnings to create permanent guardrails for future work.

Does capturing learnings into a PRD require human approval before updating requirements?

Yes, capturing learnings into a PRD requires human approval. The process prepares a concise learning report containing classified learnings and drafted amendments, which must be reviewed and approved before the Strategic PRD is officially updated.

What sections of a Strategic PRD are updated when codifying implementation learnings?

When codifying implementation learnings, the process drafts inline amendments for Sections 5-6 and updates Section 8 with new learnings. This ensures the Strategic PRD accurately reflects the latest guardrails and rules derived from validation reports.