feat(product-requirements): introduce PRD and FRD authoring skills - #60

Merged
yordis merged 2 commits into
mainfrom
add-prd
May 26, 2026
Merged

feat(product-requirements): introduce PRD and FRD authoring skills#60
yordis merged 2 commits into
mainfrom
add-prd

Conversation

@yordis

Copy link
Copy Markdown
Member
  • Product and feature authors need a shared structure so engineers, reviewers, and AI agents can pick up requirements work without losing intent or duplicating context.
  • A dedicated plugin keeps PRD and FRD authoring decoupled from blueprints and work orders, matching the rest of the TrogonStack skill catalog.

Authors and reviewers need consistent structure for product-level context and feature-level requirements so engineering can pick up work without losing intent.
Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@cursor

cursorBot commented May 26, 2026

Copy link
Copy Markdown

PR Summary

Low Risk
Additive documentation and agent-skill markdown only; no changes to runtime services, auth, or data paths in existing code.

Overview
Adds a new trogonstack-product-requirements Claude plugin (v0.0.1) and wires it into the marketplace and release-please manifests so it ships like the other TrogonStack plugins.

The plugin introduces agent skills that scaffold and author requirements under .trogonai/project/{projectid}/, with a shared requirements-operating-model that keeps Requirements separate from Blueprints and Work Orders (source of truth, clarification, downstream impact).

Product overview (PRD): six default section skills plus prd-getting-started, prd-custom-overview, and prd-review, each with markdown templates under prd/.

Feature requirements (FRD):frd-getting-started, frd-write, frd-split, and frd-review, including stable REQ- / AC- IDs, nested parent/child FRD layout, and the parent-delivers-value rule.

A README documents the operating model, file layout, and install commands for the marketplace.

Reviewed by Cursor Bugbot for commit 5f85e23. Bugbot is set up for automated code reviews on this repo. Configure here.

@coderabbitai

coderabbitaiBot commented May 26, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@yordis, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 38 minutes and 50 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ffc211dc-4a82-45a2-94cc-5654c9721afa

📥 Commits

Reviewing files that changed from the base of the PR and between 41f0a1f and 5f85e23.

📒 Files selected for processing (14)
  • plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
  • plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md

Walkthrough

This PR introduces trogonstack-product-requirements, a comprehensive Claude plugin that enables structured authoring, review, and management of product requirements artifacts. It includes plugin wiring, foundational operating model guidance, nine PRD authoring skills with templates, four FRD lifecycle skills, and supporting documentation.

Changes

TrogonStack Product Requirements Plugin

Layer / File(s)Summary
Plugin registration and configuration
.claude-plugin/marketplace.json, .github/release-please-*.json, plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
Plugin entry added to marketplace, release-please configuration updated to enable component-tagged releases for the new plugin package.
Plugin overview and Requirements Operating Model
plugins/trogonstack-product-requirements/README.md, plugins/trogonstack-product-requirements/skills/requirements-operating-model/SKILL.md
Plugin README documents the PRD and FRD artifact types, directory structure, and ID conventions. Shared operating model skill defines source-of-truth ownership, skill routing, writing quality rules, and how requirements changes impact downstream Blueprints and Work Orders.
PRD initialization workflow
plugins/trogonstack-product-requirements/skills/prd-getting-started/SKILL.md
Skill for scaffolding the six default Product Overview Documents into a new project with stubs, including quick vs guided pass options and hand-off summary generation.
PRD Business Problem and Current State
plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md, skills/prd-business-problem/assets/business-problem-template.md, skills/prd-current-state/SKILL.md, skills/prd-current-state/assets/current-state-template.md
Skills for drafting Business Problem (market pain, gaps, urgency) and Current State (existing workflows, workarounds, quantified costs) with templates and quality criteria.
PRD Personas, Description, and Metrics
skills/prd-personas/SKILL.md, skills/prd-personas/assets/personas-template.md, skills/prd-product-description/SKILL.md, skills/prd-product-description/assets/product-description-template.md, skills/prd-success-metrics/SKILL.md, skills/prd-success-metrics/assets/success-metrics-template.md
Skills for defining personas (primary/secondary, job-to-be-done, constraints), product description (one-liner, surfaces, components, flows, boundaries), and success metrics (primary outcome, leading indicators, guardrails, per-persona targets) with templates.
PRD Technical Requirements, Custom Overviews, and Review
skills/prd-technical-requirements/SKILL.md, skills/prd-technical-requirements/assets/technical-requirements-template.md, skills/prd-custom-overview/SKILL.md, skills/prd-custom-overview/assets/custom-overview-template.md, skills/prd-review/SKILL.md
Skills for capturing technical constraints (performance, scale, reliability, security, compliance, integrations, platforms, accessibility, localization, observability, cost), authoring custom PRD documents beyond the defaults, and comprehensive PRD review/audit with per-document and cross-document consistency checks.
FRD initialization and authoring
skills/frd-getting-started/SKILL.md, skills/frd-write/SKILL.md, skills/frd-write/assets/frd-template.md
Skills for scaffolding Feature Requirements Documents with parent/child hierarchy and prefix assignment, and for authoring individual FRDs with stable REQ/AC ID schemes, requirements/acceptance criteria discovery, and parent linking.
FRD review and restructuring
skills/frd-review/SKILL.md, skills/frd-split/SKILL.md
Skills for auditing FRDs with per-document checklists and cross-FRD consistency checks, and for refactoring FRDs using parent-delivers-value rule to split parents into children and reassign requirements with ID renumbering.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • TrogonStack/agentskills#45: Documents the scaffold-plugin skill workflow that was used to wire this plugin entry into the marketplace configuration and release system.

Poem

🐇 A product requirements hutch, so neat and organized,
With PRDs and FRDs, all systematized!
From business problems down to feature needs,
Each skill a carrot, each template a seed. 🥕📋

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and specifically summarizes the main change: introducing PRD and FRD authoring skills as a new plugin.
Description check✅ PassedThe description is directly related to the changeset, explaining the motivation for the new product-requirements plugin and its purpose in the TrogonStack ecosystem.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch add-prd

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 15

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@plugins/trogonstack-product-requirements/.claude-plugin/plugin.json`:
- Line 3: Update the "description" value in plugin.json so it mentions both
Product Requirements Documents (PRDs) and Functional Requirements Documents
(FRDs) to match the README/marketplace; locate the "description" property in
plugins/trogonstack-product-requirements/.claude-plugin/plugin.json and change
its text from only referencing PRDs to something inclusive like "Skills for
writing and reviewing Product Requirements Documents (PRDs) and Functional
Requirements Documents (FRDs)" ensuring wording matches other metadata entries.
In `@plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md`:
- Around line 82-88: The fenced code block showing the directory tree (the block
containing ".trogonai/project/{projectid}/frd/{parent-slug}/", "index.frd.md",
"{child-1-slug}.frd.md", etc.) lacks a language specifier and triggers MD040;
fix it by adding a language label (e.g., text) after the opening triple
backticks in SKILL.md so the block begins with ```text and leave the tree
contents unchanged.
In `@plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md`:
- Around line 160-181: The markdown fenced code blocks in SKILL.md around the
REQ-CHK-003 examples are unlabeled and trigger markdownlint MD040; update both
fenced blocks that contain the "REQ-CHK-003: Payment Confirmation" good and "Bad
(reject this shape)" examples to include a language identifier (e.g.,
```markdown) at the opening backticks so the blocks become ```markdown ... ```
and ensure the closing backticks remain unchanged; search for the REQ-CHK-003
code examples in the file to locate the exact blocks to modify.
In
`@plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md`:
- Line 93: Several fenced code blocks in SKILL.md use plain ``` markers without
a language tag (e.g., the examples that start with the "## The Problem"
heading), which triggers MD040; update each triple-backtick fence to include a
language identifier (use "markdown" for these prose examples) so they become
```markdown ... ```, and apply the same change to the other affected fence near
the second "## The Problem" instance; search for plain ``` fences around those
headings and replace them with ```markdown to satisfy markdownlint and keep
tooling consistent.
In
`@plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md`:
- Around line 17-20: Add a blank line between the "## Cost of the status quo"
heading and the table to satisfy MD058; locate the heading text "## Cost of the
status quo" and insert one empty line before the table rows starting with "|
Cost | Measure | Source |".
In `@plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md`:
- Line 83: Two fenced code blocks around the "How the job gets done today"
examples are missing a language tag (triggers markdownlint MD040); update each
opening triple-backtick fence to include a language (e.g., change ``` to
```markdown) for both example blocks so the fences read ```markdown, keeping the
existing block content unchanged and preserving both occurrences of the "How the
job gets done today" example sections.
In
`@plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md`:
- Around line 100-121: The two fenced example blocks in SKILL.md (the one
starting with the "Rollout Strategy" heading and the "Misc Notes" block) are
missing language identifiers which triggers MD040; update both opening
triple-backtick fences to include the markdown language tag (```markdown) so the
linter passes and the examples are explicitly marked as Markdown.
In `@plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md`:
- Line 90: The fenced code blocks in SKILL.md around the headings "## Primary:
Mid-market Account Executive" and "## Primary: Sales user" lack language
identifiers and trigger markdownlint MD040; update the opening triple-backtick
fences for those two examples to include "markdown" (i.e., change ``` to
```markdown) so both example fences are annotated and the linter warning is
resolved.
In
`@plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md`:
- Line 100: Two fenced example blocks around the "One-liner" headings are
missing language identifiers and trigger markdownlint MD040; edit the two fenced
code blocks that contain the "## One-liner" examples and change their opening
fences from ``` to ```markdown so both example blocks explicitly declare the
markdown language (apply this to both occurrences noted in the file).
- Line 57: The markdown heading "Boundaries (what the product is NOT**" has
unbalanced emphasis and a missing closing parenthesis; update the text in
SKILL.md so the bold and parentheses are balanced, e.g., change the fragment to
"Boundaries (what the product is NOT)" and wrap the whole label in bold as
"**Boundaries (what the product is NOT)**" so the emphasis and parentheses are
correctly closed.
In `@plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md`:
- Around line 38-46: The fenced filesystem tree in SKILL.md is missing a
language identifier, causing MD040; update the opening fence for the snippet
that shows ".trogonai/project/{projectid}/prd/" to use a language specifier (use
text) so the block becomes "```text" instead of "```" and keep the closing fence
unchanged; locate the snippet in SKILL.md and add the word "text" immediately
after the opening triple backticks.
In
`@plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md`:
- Around line 6-20: The markdown violates MD058 because the tables are not
surrounded by blank lines; update each section (headers "## Primary outcome
metric", "## Leading indicators", and "## Guardrail metrics (must not regress)")
by inserting a blank line immediately after the heading and another blank line
after the table block so that each table is preceded and followed by an empty
line.
In
`@plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md`:
- Around line 105-148: The MD040 lint is triggered because the fenced code
blocks in SKILL.md lack a language tag; edit the example fences around the
primary outcome/leading/guardrail/decision rules examples and add "md" to each
opening triple-backtick (i.e., change ``` to ```md) so the examples are
explicitly marked as Markdown and the linter no longer flags MD040.
In
`@plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md`:
- Around line 6-37: The markdown linter MD058 complains because the tables under
the "## Performance" and "## Integrations" sections need surrounding blank
lines; modify the template so there is an empty line before and after each table
block (the Performance table starting under "## Performance" and the
Integrations table under "## Integrations") to satisfy MD058 while preserving
the header and table rows.
In
`@plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md`:
- Around line 145-188: Add the language tag "md" to both fenced-code blocks that
start with the "## Performance" headings (the detailed example block and the
"Bad" example block) so they read as ```md ... ```; update the opening backticks
for the first large example and the second "Bad" example to include md to
satisfy the MD040 lint rule and ensure proper rendering.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1fe25eee-8570-4849-8204-2d580dfed1c9

📥 Commits

Reviewing files that changed from the base of the PR and between eace11b and 41f0a1f.

📒 Files selected for processing (27)
  • .claude-plugin/marketplace.json
  • .github/release-please-config.json
  • .github/release-please-manifest.json
  • plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
  • plugins/trogonstack-product-requirements/README.md
  • plugins/trogonstack-product-requirements/skills/frd-getting-started/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/assets/frd-template.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/assets/business-problem-template.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/assets/custom-overview-template.md
  • plugins/trogonstack-product-requirements/skills/prd-getting-started/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/assets/personas-template.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/assets/product-description-template.md
  • plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md
  • plugins/trogonstack-product-requirements/skills/requirements-operating-model/SKILL.md

Comment threadplugins/trogonstack-product-requirements/.claude-plugin/plugin.json Outdated
Comment threadplugins/trogonstack-product-requirements/skills/frd-split/SKILL.md Outdated
Comment threadplugins/trogonstack-product-requirements/skills/frd-write/SKILL.md Outdated
Comment threadplugins/trogonstack-product-requirements/skills/prd-review/SKILL.md Outdated
…larify scope
Lint violations made the plugin look untrustworthy to anyone running standard markdown tooling, and the plugin description omitted FRDs even though the catalog markets both PRD and FRD authoring.
Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@yordis
yordis merged commit 207ddb1 into mainMay 26, 2026
4 checks passed
@yordis
yordis deleted the add-prd branch May 26, 2026 20:18
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@yordis
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

feat(product-requirements): introduce PRD and FRD authoring skills - #60

Merged
yordis merged 2 commits into
mainfrom
add-prd
May 26, 2026
Merged

feat(product-requirements): introduce PRD and FRD authoring skills#60
yordis merged 2 commits into
mainfrom
add-prd

Conversation

@yordis

Copy link
Copy Markdown
Member
  • Product and feature authors need a shared structure so engineers, reviewers, and AI agents can pick up requirements work without losing intent or duplicating context.
  • A dedicated plugin keeps PRD and FRD authoring decoupled from blueprints and work orders, matching the rest of the TrogonStack skill catalog.

Authors and reviewers need consistent structure for product-level context and feature-level requirements so engineering can pick up work without losing intent.
Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@cursor

cursorBot commented May 26, 2026

Copy link
Copy Markdown

PR Summary

Low Risk
Additive documentation and agent-skill markdown only; no changes to runtime services, auth, or data paths in existing code.

Overview
Adds a new trogonstack-product-requirements Claude plugin (v0.0.1) and wires it into the marketplace and release-please manifests so it ships like the other TrogonStack plugins.

The plugin introduces agent skills that scaffold and author requirements under .trogonai/project/{projectid}/, with a shared requirements-operating-model that keeps Requirements separate from Blueprints and Work Orders (source of truth, clarification, downstream impact).

Product overview (PRD): six default section skills plus prd-getting-started, prd-custom-overview, and prd-review, each with markdown templates under prd/.

Feature requirements (FRD):frd-getting-started, frd-write, frd-split, and frd-review, including stable REQ- / AC- IDs, nested parent/child FRD layout, and the parent-delivers-value rule.

A README documents the operating model, file layout, and install commands for the marketplace.

Reviewed by Cursor Bugbot for commit 5f85e23. Bugbot is set up for automated code reviews on this repo. Configure here.

@coderabbitai

coderabbitaiBot commented May 26, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@yordis, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 38 minutes and 50 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ffc211dc-4a82-45a2-94cc-5654c9721afa

📥 Commits

Reviewing files that changed from the base of the PR and between 41f0a1f and 5f85e23.

📒 Files selected for processing (14)
  • plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
  • plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md

Walkthrough

This PR introduces trogonstack-product-requirements, a comprehensive Claude plugin that enables structured authoring, review, and management of product requirements artifacts. It includes plugin wiring, foundational operating model guidance, nine PRD authoring skills with templates, four FRD lifecycle skills, and supporting documentation.

Changes

TrogonStack Product Requirements Plugin

Layer / File(s)Summary
Plugin registration and configuration
.claude-plugin/marketplace.json, .github/release-please-*.json, plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
Plugin entry added to marketplace, release-please configuration updated to enable component-tagged releases for the new plugin package.
Plugin overview and Requirements Operating Model
plugins/trogonstack-product-requirements/README.md, plugins/trogonstack-product-requirements/skills/requirements-operating-model/SKILL.md
Plugin README documents the PRD and FRD artifact types, directory structure, and ID conventions. Shared operating model skill defines source-of-truth ownership, skill routing, writing quality rules, and how requirements changes impact downstream Blueprints and Work Orders.
PRD initialization workflow
plugins/trogonstack-product-requirements/skills/prd-getting-started/SKILL.md
Skill for scaffolding the six default Product Overview Documents into a new project with stubs, including quick vs guided pass options and hand-off summary generation.
PRD Business Problem and Current State
plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md, skills/prd-business-problem/assets/business-problem-template.md, skills/prd-current-state/SKILL.md, skills/prd-current-state/assets/current-state-template.md
Skills for drafting Business Problem (market pain, gaps, urgency) and Current State (existing workflows, workarounds, quantified costs) with templates and quality criteria.
PRD Personas, Description, and Metrics
skills/prd-personas/SKILL.md, skills/prd-personas/assets/personas-template.md, skills/prd-product-description/SKILL.md, skills/prd-product-description/assets/product-description-template.md, skills/prd-success-metrics/SKILL.md, skills/prd-success-metrics/assets/success-metrics-template.md
Skills for defining personas (primary/secondary, job-to-be-done, constraints), product description (one-liner, surfaces, components, flows, boundaries), and success metrics (primary outcome, leading indicators, guardrails, per-persona targets) with templates.
PRD Technical Requirements, Custom Overviews, and Review
skills/prd-technical-requirements/SKILL.md, skills/prd-technical-requirements/assets/technical-requirements-template.md, skills/prd-custom-overview/SKILL.md, skills/prd-custom-overview/assets/custom-overview-template.md, skills/prd-review/SKILL.md
Skills for capturing technical constraints (performance, scale, reliability, security, compliance, integrations, platforms, accessibility, localization, observability, cost), authoring custom PRD documents beyond the defaults, and comprehensive PRD review/audit with per-document and cross-document consistency checks.
FRD initialization and authoring
skills/frd-getting-started/SKILL.md, skills/frd-write/SKILL.md, skills/frd-write/assets/frd-template.md
Skills for scaffolding Feature Requirements Documents with parent/child hierarchy and prefix assignment, and for authoring individual FRDs with stable REQ/AC ID schemes, requirements/acceptance criteria discovery, and parent linking.
FRD review and restructuring
skills/frd-review/SKILL.md, skills/frd-split/SKILL.md
Skills for auditing FRDs with per-document checklists and cross-FRD consistency checks, and for refactoring FRDs using parent-delivers-value rule to split parents into children and reassign requirements with ID renumbering.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • TrogonStack/agentskills#45: Documents the scaffold-plugin skill workflow that was used to wire this plugin entry into the marketplace configuration and release system.

Poem

🐇 A product requirements hutch, so neat and organized,
With PRDs and FRDs, all systematized!
From business problems down to feature needs,
Each skill a carrot, each template a seed. 🥕📋

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and specifically summarizes the main change: introducing PRD and FRD authoring skills as a new plugin.
Description check✅ PassedThe description is directly related to the changeset, explaining the motivation for the new product-requirements plugin and its purpose in the TrogonStack ecosystem.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch add-prd

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 15

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@plugins/trogonstack-product-requirements/.claude-plugin/plugin.json`:
- Line 3: Update the "description" value in plugin.json so it mentions both
Product Requirements Documents (PRDs) and Functional Requirements Documents
(FRDs) to match the README/marketplace; locate the "description" property in
plugins/trogonstack-product-requirements/.claude-plugin/plugin.json and change
its text from only referencing PRDs to something inclusive like "Skills for
writing and reviewing Product Requirements Documents (PRDs) and Functional
Requirements Documents (FRDs)" ensuring wording matches other metadata entries.
In `@plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md`:
- Around line 82-88: The fenced code block showing the directory tree (the block
containing ".trogonai/project/{projectid}/frd/{parent-slug}/", "index.frd.md",
"{child-1-slug}.frd.md", etc.) lacks a language specifier and triggers MD040;
fix it by adding a language label (e.g., text) after the opening triple
backticks in SKILL.md so the block begins with ```text and leave the tree
contents unchanged.
In `@plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md`:
- Around line 160-181: The markdown fenced code blocks in SKILL.md around the
REQ-CHK-003 examples are unlabeled and trigger markdownlint MD040; update both
fenced blocks that contain the "REQ-CHK-003: Payment Confirmation" good and "Bad
(reject this shape)" examples to include a language identifier (e.g.,
```markdown) at the opening backticks so the blocks become ```markdown ... ```
and ensure the closing backticks remain unchanged; search for the REQ-CHK-003
code examples in the file to locate the exact blocks to modify.
In
`@plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md`:
- Line 93: Several fenced code blocks in SKILL.md use plain ``` markers without
a language tag (e.g., the examples that start with the "## The Problem"
heading), which triggers MD040; update each triple-backtick fence to include a
language identifier (use "markdown" for these prose examples) so they become
```markdown ... ```, and apply the same change to the other affected fence near
the second "## The Problem" instance; search for plain ``` fences around those
headings and replace them with ```markdown to satisfy markdownlint and keep
tooling consistent.
In
`@plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md`:
- Around line 17-20: Add a blank line between the "## Cost of the status quo"
heading and the table to satisfy MD058; locate the heading text "## Cost of the
status quo" and insert one empty line before the table rows starting with "|
Cost | Measure | Source |".
In `@plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md`:
- Line 83: Two fenced code blocks around the "How the job gets done today"
examples are missing a language tag (triggers markdownlint MD040); update each
opening triple-backtick fence to include a language (e.g., change ``` to
```markdown) for both example blocks so the fences read ```markdown, keeping the
existing block content unchanged and preserving both occurrences of the "How the
job gets done today" example sections.
In
`@plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md`:
- Around line 100-121: The two fenced example blocks in SKILL.md (the one
starting with the "Rollout Strategy" heading and the "Misc Notes" block) are
missing language identifiers which triggers MD040; update both opening
triple-backtick fences to include the markdown language tag (```markdown) so the
linter passes and the examples are explicitly marked as Markdown.
In `@plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md`:
- Line 90: The fenced code blocks in SKILL.md around the headings "## Primary:
Mid-market Account Executive" and "## Primary: Sales user" lack language
identifiers and trigger markdownlint MD040; update the opening triple-backtick
fences for those two examples to include "markdown" (i.e., change ``` to
```markdown) so both example fences are annotated and the linter warning is
resolved.
In
`@plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md`:
- Line 100: Two fenced example blocks around the "One-liner" headings are
missing language identifiers and trigger markdownlint MD040; edit the two fenced
code blocks that contain the "## One-liner" examples and change their opening
fences from ``` to ```markdown so both example blocks explicitly declare the
markdown language (apply this to both occurrences noted in the file).
- Line 57: The markdown heading "Boundaries (what the product is NOT**" has
unbalanced emphasis and a missing closing parenthesis; update the text in
SKILL.md so the bold and parentheses are balanced, e.g., change the fragment to
"Boundaries (what the product is NOT)" and wrap the whole label in bold as
"**Boundaries (what the product is NOT)**" so the emphasis and parentheses are
correctly closed.
In `@plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md`:
- Around line 38-46: The fenced filesystem tree in SKILL.md is missing a
language identifier, causing MD040; update the opening fence for the snippet
that shows ".trogonai/project/{projectid}/prd/" to use a language specifier (use
text) so the block becomes "```text" instead of "```" and keep the closing fence
unchanged; locate the snippet in SKILL.md and add the word "text" immediately
after the opening triple backticks.
In
`@plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md`:
- Around line 6-20: The markdown violates MD058 because the tables are not
surrounded by blank lines; update each section (headers "## Primary outcome
metric", "## Leading indicators", and "## Guardrail metrics (must not regress)")
by inserting a blank line immediately after the heading and another blank line
after the table block so that each table is preceded and followed by an empty
line.
In
`@plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md`:
- Around line 105-148: The MD040 lint is triggered because the fenced code
blocks in SKILL.md lack a language tag; edit the example fences around the
primary outcome/leading/guardrail/decision rules examples and add "md" to each
opening triple-backtick (i.e., change ``` to ```md) so the examples are
explicitly marked as Markdown and the linter no longer flags MD040.
In
`@plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md`:
- Around line 6-37: The markdown linter MD058 complains because the tables under
the "## Performance" and "## Integrations" sections need surrounding blank
lines; modify the template so there is an empty line before and after each table
block (the Performance table starting under "## Performance" and the
Integrations table under "## Integrations") to satisfy MD058 while preserving
the header and table rows.
In
`@plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md`:
- Around line 145-188: Add the language tag "md" to both fenced-code blocks that
start with the "## Performance" headings (the detailed example block and the
"Bad" example block) so they read as ```md ... ```; update the opening backticks
for the first large example and the second "Bad" example to include md to
satisfy the MD040 lint rule and ensure proper rendering.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1fe25eee-8570-4849-8204-2d580dfed1c9

📥 Commits

Reviewing files that changed from the base of the PR and between eace11b and 41f0a1f.

📒 Files selected for processing (27)
  • .claude-plugin/marketplace.json
  • .github/release-please-config.json
  • .github/release-please-manifest.json
  • plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
  • plugins/trogonstack-product-requirements/README.md
  • plugins/trogonstack-product-requirements/skills/frd-getting-started/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/assets/frd-template.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/assets/business-problem-template.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/assets/custom-overview-template.md
  • plugins/trogonstack-product-requirements/skills/prd-getting-started/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/assets/personas-template.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/assets/product-description-template.md
  • plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md
  • plugins/trogonstack-product-requirements/skills/requirements-operating-model/SKILL.md

Comment threadplugins/trogonstack-product-requirements/.claude-plugin/plugin.json Outdated
Comment threadplugins/trogonstack-product-requirements/skills/frd-split/SKILL.md Outdated
Comment threadplugins/trogonstack-product-requirements/skills/frd-write/SKILL.md Outdated
Comment threadplugins/trogonstack-product-requirements/skills/prd-review/SKILL.md Outdated
…larify scope
Lint violations made the plugin look untrustworthy to anyone running standard markdown tooling, and the plugin description omitted FRDs even though the catalog markets both PRD and FRD authoring.
Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@yordis
yordis merged commit 207ddb1 into mainMay 26, 2026
4 checks passed
@yordis
yordis deleted the add-prd branch May 26, 2026 20:18
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@yordis
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(product-requirements): introduce PRD and FRD authoring skills - #60

Merged
yordis merged 2 commits into
mainfrom
add-prd
May 26, 2026
Merged

feat(product-requirements): introduce PRD and FRD authoring skills#60
yordis merged 2 commits into
mainfrom
add-prd

Conversation

@yordis

Copy link
Copy Markdown
Member
  • Product and feature authors need a shared structure so engineers, reviewers, and AI agents can pick up requirements work without losing intent or duplicating context.
  • A dedicated plugin keeps PRD and FRD authoring decoupled from blueprints and work orders, matching the rest of the TrogonStack skill catalog.

Authors and reviewers need consistent structure for product-level context and feature-level requirements so engineering can pick up work without losing intent.
Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@cursor

cursorBot commented May 26, 2026

Copy link
Copy Markdown

PR Summary

Low Risk
Additive documentation and agent-skill markdown only; no changes to runtime services, auth, or data paths in existing code.

Overview
Adds a new trogonstack-product-requirements Claude plugin (v0.0.1) and wires it into the marketplace and release-please manifests so it ships like the other TrogonStack plugins.

The plugin introduces agent skills that scaffold and author requirements under .trogonai/project/{projectid}/, with a shared requirements-operating-model that keeps Requirements separate from Blueprints and Work Orders (source of truth, clarification, downstream impact).

Product overview (PRD): six default section skills plus prd-getting-started, prd-custom-overview, and prd-review, each with markdown templates under prd/.

Feature requirements (FRD):frd-getting-started, frd-write, frd-split, and frd-review, including stable REQ- / AC- IDs, nested parent/child FRD layout, and the parent-delivers-value rule.

A README documents the operating model, file layout, and install commands for the marketplace.

Reviewed by Cursor Bugbot for commit 5f85e23. Bugbot is set up for automated code reviews on this repo. Configure here.

@coderabbitai

coderabbitaiBot commented May 26, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@yordis, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 38 minutes and 50 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ffc211dc-4a82-45a2-94cc-5654c9721afa

📥 Commits

Reviewing files that changed from the base of the PR and between 41f0a1f and 5f85e23.

📒 Files selected for processing (14)
  • plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
  • plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md

Walkthrough

This PR introduces trogonstack-product-requirements, a comprehensive Claude plugin that enables structured authoring, review, and management of product requirements artifacts. It includes plugin wiring, foundational operating model guidance, nine PRD authoring skills with templates, four FRD lifecycle skills, and supporting documentation.

Changes

TrogonStack Product Requirements Plugin

Layer / File(s)Summary
Plugin registration and configuration
.claude-plugin/marketplace.json, .github/release-please-*.json, plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
Plugin entry added to marketplace, release-please configuration updated to enable component-tagged releases for the new plugin package.
Plugin overview and Requirements Operating Model
plugins/trogonstack-product-requirements/README.md, plugins/trogonstack-product-requirements/skills/requirements-operating-model/SKILL.md
Plugin README documents the PRD and FRD artifact types, directory structure, and ID conventions. Shared operating model skill defines source-of-truth ownership, skill routing, writing quality rules, and how requirements changes impact downstream Blueprints and Work Orders.
PRD initialization workflow
plugins/trogonstack-product-requirements/skills/prd-getting-started/SKILL.md
Skill for scaffolding the six default Product Overview Documents into a new project with stubs, including quick vs guided pass options and hand-off summary generation.
PRD Business Problem and Current State
plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md, skills/prd-business-problem/assets/business-problem-template.md, skills/prd-current-state/SKILL.md, skills/prd-current-state/assets/current-state-template.md
Skills for drafting Business Problem (market pain, gaps, urgency) and Current State (existing workflows, workarounds, quantified costs) with templates and quality criteria.
PRD Personas, Description, and Metrics
skills/prd-personas/SKILL.md, skills/prd-personas/assets/personas-template.md, skills/prd-product-description/SKILL.md, skills/prd-product-description/assets/product-description-template.md, skills/prd-success-metrics/SKILL.md, skills/prd-success-metrics/assets/success-metrics-template.md
Skills for defining personas (primary/secondary, job-to-be-done, constraints), product description (one-liner, surfaces, components, flows, boundaries), and success metrics (primary outcome, leading indicators, guardrails, per-persona targets) with templates.
PRD Technical Requirements, Custom Overviews, and Review
skills/prd-technical-requirements/SKILL.md, skills/prd-technical-requirements/assets/technical-requirements-template.md, skills/prd-custom-overview/SKILL.md, skills/prd-custom-overview/assets/custom-overview-template.md, skills/prd-review/SKILL.md
Skills for capturing technical constraints (performance, scale, reliability, security, compliance, integrations, platforms, accessibility, localization, observability, cost), authoring custom PRD documents beyond the defaults, and comprehensive PRD review/audit with per-document and cross-document consistency checks.
FRD initialization and authoring
skills/frd-getting-started/SKILL.md, skills/frd-write/SKILL.md, skills/frd-write/assets/frd-template.md
Skills for scaffolding Feature Requirements Documents with parent/child hierarchy and prefix assignment, and for authoring individual FRDs with stable REQ/AC ID schemes, requirements/acceptance criteria discovery, and parent linking.
FRD review and restructuring
skills/frd-review/SKILL.md, skills/frd-split/SKILL.md
Skills for auditing FRDs with per-document checklists and cross-FRD consistency checks, and for refactoring FRDs using parent-delivers-value rule to split parents into children and reassign requirements with ID renumbering.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • TrogonStack/agentskills#45: Documents the scaffold-plugin skill workflow that was used to wire this plugin entry into the marketplace configuration and release system.

Poem

🐇 A product requirements hutch, so neat and organized,
With PRDs and FRDs, all systematized!
From business problems down to feature needs,
Each skill a carrot, each template a seed. 🥕📋

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and specifically summarizes the main change: introducing PRD and FRD authoring skills as a new plugin.
Description check✅ PassedThe description is directly related to the changeset, explaining the motivation for the new product-requirements plugin and its purpose in the TrogonStack ecosystem.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch add-prd

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 15

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@plugins/trogonstack-product-requirements/.claude-plugin/plugin.json`:
- Line 3: Update the "description" value in plugin.json so it mentions both
Product Requirements Documents (PRDs) and Functional Requirements Documents
(FRDs) to match the README/marketplace; locate the "description" property in
plugins/trogonstack-product-requirements/.claude-plugin/plugin.json and change
its text from only referencing PRDs to something inclusive like "Skills for
writing and reviewing Product Requirements Documents (PRDs) and Functional
Requirements Documents (FRDs)" ensuring wording matches other metadata entries.
In `@plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md`:
- Around line 82-88: The fenced code block showing the directory tree (the block
containing ".trogonai/project/{projectid}/frd/{parent-slug}/", "index.frd.md",
"{child-1-slug}.frd.md", etc.) lacks a language specifier and triggers MD040;
fix it by adding a language label (e.g., text) after the opening triple
backticks in SKILL.md so the block begins with ```text and leave the tree
contents unchanged.
In `@plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md`:
- Around line 160-181: The markdown fenced code blocks in SKILL.md around the
REQ-CHK-003 examples are unlabeled and trigger markdownlint MD040; update both
fenced blocks that contain the "REQ-CHK-003: Payment Confirmation" good and "Bad
(reject this shape)" examples to include a language identifier (e.g.,
```markdown) at the opening backticks so the blocks become ```markdown ... ```
and ensure the closing backticks remain unchanged; search for the REQ-CHK-003
code examples in the file to locate the exact blocks to modify.
In
`@plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md`:
- Line 93: Several fenced code blocks in SKILL.md use plain ``` markers without
a language tag (e.g., the examples that start with the "## The Problem"
heading), which triggers MD040; update each triple-backtick fence to include a
language identifier (use "markdown" for these prose examples) so they become
```markdown ... ```, and apply the same change to the other affected fence near
the second "## The Problem" instance; search for plain ``` fences around those
headings and replace them with ```markdown to satisfy markdownlint and keep
tooling consistent.
In
`@plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md`:
- Around line 17-20: Add a blank line between the "## Cost of the status quo"
heading and the table to satisfy MD058; locate the heading text "## Cost of the
status quo" and insert one empty line before the table rows starting with "|
Cost | Measure | Source |".
In `@plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md`:
- Line 83: Two fenced code blocks around the "How the job gets done today"
examples are missing a language tag (triggers markdownlint MD040); update each
opening triple-backtick fence to include a language (e.g., change ``` to
```markdown) for both example blocks so the fences read ```markdown, keeping the
existing block content unchanged and preserving both occurrences of the "How the
job gets done today" example sections.
In
`@plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md`:
- Around line 100-121: The two fenced example blocks in SKILL.md (the one
starting with the "Rollout Strategy" heading and the "Misc Notes" block) are
missing language identifiers which triggers MD040; update both opening
triple-backtick fences to include the markdown language tag (```markdown) so the
linter passes and the examples are explicitly marked as Markdown.
In `@plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md`:
- Line 90: The fenced code blocks in SKILL.md around the headings "## Primary:
Mid-market Account Executive" and "## Primary: Sales user" lack language
identifiers and trigger markdownlint MD040; update the opening triple-backtick
fences for those two examples to include "markdown" (i.e., change ``` to
```markdown) so both example fences are annotated and the linter warning is
resolved.
In
`@plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md`:
- Line 100: Two fenced example blocks around the "One-liner" headings are
missing language identifiers and trigger markdownlint MD040; edit the two fenced
code blocks that contain the "## One-liner" examples and change their opening
fences from ``` to ```markdown so both example blocks explicitly declare the
markdown language (apply this to both occurrences noted in the file).
- Line 57: The markdown heading "Boundaries (what the product is NOT**" has
unbalanced emphasis and a missing closing parenthesis; update the text in
SKILL.md so the bold and parentheses are balanced, e.g., change the fragment to
"Boundaries (what the product is NOT)" and wrap the whole label in bold as
"**Boundaries (what the product is NOT)**" so the emphasis and parentheses are
correctly closed.
In `@plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md`:
- Around line 38-46: The fenced filesystem tree in SKILL.md is missing a
language identifier, causing MD040; update the opening fence for the snippet
that shows ".trogonai/project/{projectid}/prd/" to use a language specifier (use
text) so the block becomes "```text" instead of "```" and keep the closing fence
unchanged; locate the snippet in SKILL.md and add the word "text" immediately
after the opening triple backticks.
In
`@plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md`:
- Around line 6-20: The markdown violates MD058 because the tables are not
surrounded by blank lines; update each section (headers "## Primary outcome
metric", "## Leading indicators", and "## Guardrail metrics (must not regress)")
by inserting a blank line immediately after the heading and another blank line
after the table block so that each table is preceded and followed by an empty
line.
In
`@plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md`:
- Around line 105-148: The MD040 lint is triggered because the fenced code
blocks in SKILL.md lack a language tag; edit the example fences around the
primary outcome/leading/guardrail/decision rules examples and add "md" to each
opening triple-backtick (i.e., change ``` to ```md) so the examples are
explicitly marked as Markdown and the linter no longer flags MD040.
In
`@plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md`:
- Around line 6-37: The markdown linter MD058 complains because the tables under
the "## Performance" and "## Integrations" sections need surrounding blank
lines; modify the template so there is an empty line before and after each table
block (the Performance table starting under "## Performance" and the
Integrations table under "## Integrations") to satisfy MD058 while preserving
the header and table rows.
In
`@plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md`:
- Around line 145-188: Add the language tag "md" to both fenced-code blocks that
start with the "## Performance" headings (the detailed example block and the
"Bad" example block) so they read as ```md ... ```; update the opening backticks
for the first large example and the second "Bad" example to include md to
satisfy the MD040 lint rule and ensure proper rendering.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1fe25eee-8570-4849-8204-2d580dfed1c9

📥 Commits

Reviewing files that changed from the base of the PR and between eace11b and 41f0a1f.

📒 Files selected for processing (27)
  • .claude-plugin/marketplace.json
  • .github/release-please-config.json
  • .github/release-please-manifest.json
  • plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
  • plugins/trogonstack-product-requirements/README.md
  • plugins/trogonstack-product-requirements/skills/frd-getting-started/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/assets/frd-template.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/assets/business-problem-template.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/assets/custom-overview-template.md
  • plugins/trogonstack-product-requirements/skills/prd-getting-started/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/assets/personas-template.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/assets/product-description-template.md
  • plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md
  • plugins/trogonstack-product-requirements/skills/requirements-operating-model/SKILL.md

Comment threadplugins/trogonstack-product-requirements/.claude-plugin/plugin.json Outdated
Comment threadplugins/trogonstack-product-requirements/skills/frd-split/SKILL.md Outdated
Comment threadplugins/trogonstack-product-requirements/skills/frd-write/SKILL.md Outdated
Comment threadplugins/trogonstack-product-requirements/skills/prd-review/SKILL.md Outdated
…larify scope
Lint violations made the plugin look untrustworthy to anyone running standard markdown tooling, and the plugin description omitted FRDs even though the catalog markets both PRD and FRD authoring.
Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@yordis
yordis merged commit 207ddb1 into mainMay 26, 2026
4 checks passed
@yordis
yordis deleted the add-prd branch May 26, 2026 20:18
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@yordis
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(product-requirements): introduce PRD and FRD authoring skills - #60

Merged
yordis merged 2 commits into
mainfrom
add-prd
May 26, 2026
Merged

feat(product-requirements): introduce PRD and FRD authoring skills#60
yordis merged 2 commits into
mainfrom
add-prd

Conversation

@yordis

Copy link
Copy Markdown
Member
  • Product and feature authors need a shared structure so engineers, reviewers, and AI agents can pick up requirements work without losing intent or duplicating context.
  • A dedicated plugin keeps PRD and FRD authoring decoupled from blueprints and work orders, matching the rest of the TrogonStack skill catalog.

Authors and reviewers need consistent structure for product-level context and feature-level requirements so engineering can pick up work without losing intent.
Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@cursor

cursorBot commented May 26, 2026

Copy link
Copy Markdown

PR Summary

Low Risk
Additive documentation and agent-skill markdown only; no changes to runtime services, auth, or data paths in existing code.

Overview
Adds a new trogonstack-product-requirements Claude plugin (v0.0.1) and wires it into the marketplace and release-please manifests so it ships like the other TrogonStack plugins.

The plugin introduces agent skills that scaffold and author requirements under .trogonai/project/{projectid}/, with a shared requirements-operating-model that keeps Requirements separate from Blueprints and Work Orders (source of truth, clarification, downstream impact).

Product overview (PRD): six default section skills plus prd-getting-started, prd-custom-overview, and prd-review, each with markdown templates under prd/.

Feature requirements (FRD):frd-getting-started, frd-write, frd-split, and frd-review, including stable REQ- / AC- IDs, nested parent/child FRD layout, and the parent-delivers-value rule.

A README documents the operating model, file layout, and install commands for the marketplace.

Reviewed by Cursor Bugbot for commit 5f85e23. Bugbot is set up for automated code reviews on this repo. Configure here.

@coderabbitai

coderabbitaiBot commented May 26, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@yordis, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 38 minutes and 50 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ffc211dc-4a82-45a2-94cc-5654c9721afa

📥 Commits

Reviewing files that changed from the base of the PR and between 41f0a1f and 5f85e23.

📒 Files selected for processing (14)
  • plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
  • plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md

Walkthrough

This PR introduces trogonstack-product-requirements, a comprehensive Claude plugin that enables structured authoring, review, and management of product requirements artifacts. It includes plugin wiring, foundational operating model guidance, nine PRD authoring skills with templates, four FRD lifecycle skills, and supporting documentation.

Changes

TrogonStack Product Requirements Plugin

Layer / File(s)Summary
Plugin registration and configuration
.claude-plugin/marketplace.json, .github/release-please-*.json, plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
Plugin entry added to marketplace, release-please configuration updated to enable component-tagged releases for the new plugin package.
Plugin overview and Requirements Operating Model
plugins/trogonstack-product-requirements/README.md, plugins/trogonstack-product-requirements/skills/requirements-operating-model/SKILL.md
Plugin README documents the PRD and FRD artifact types, directory structure, and ID conventions. Shared operating model skill defines source-of-truth ownership, skill routing, writing quality rules, and how requirements changes impact downstream Blueprints and Work Orders.
PRD initialization workflow
plugins/trogonstack-product-requirements/skills/prd-getting-started/SKILL.md
Skill for scaffolding the six default Product Overview Documents into a new project with stubs, including quick vs guided pass options and hand-off summary generation.
PRD Business Problem and Current State
plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md, skills/prd-business-problem/assets/business-problem-template.md, skills/prd-current-state/SKILL.md, skills/prd-current-state/assets/current-state-template.md
Skills for drafting Business Problem (market pain, gaps, urgency) and Current State (existing workflows, workarounds, quantified costs) with templates and quality criteria.
PRD Personas, Description, and Metrics
skills/prd-personas/SKILL.md, skills/prd-personas/assets/personas-template.md, skills/prd-product-description/SKILL.md, skills/prd-product-description/assets/product-description-template.md, skills/prd-success-metrics/SKILL.md, skills/prd-success-metrics/assets/success-metrics-template.md
Skills for defining personas (primary/secondary, job-to-be-done, constraints), product description (one-liner, surfaces, components, flows, boundaries), and success metrics (primary outcome, leading indicators, guardrails, per-persona targets) with templates.
PRD Technical Requirements, Custom Overviews, and Review
skills/prd-technical-requirements/SKILL.md, skills/prd-technical-requirements/assets/technical-requirements-template.md, skills/prd-custom-overview/SKILL.md, skills/prd-custom-overview/assets/custom-overview-template.md, skills/prd-review/SKILL.md
Skills for capturing technical constraints (performance, scale, reliability, security, compliance, integrations, platforms, accessibility, localization, observability, cost), authoring custom PRD documents beyond the defaults, and comprehensive PRD review/audit with per-document and cross-document consistency checks.
FRD initialization and authoring
skills/frd-getting-started/SKILL.md, skills/frd-write/SKILL.md, skills/frd-write/assets/frd-template.md
Skills for scaffolding Feature Requirements Documents with parent/child hierarchy and prefix assignment, and for authoring individual FRDs with stable REQ/AC ID schemes, requirements/acceptance criteria discovery, and parent linking.
FRD review and restructuring
skills/frd-review/SKILL.md, skills/frd-split/SKILL.md
Skills for auditing FRDs with per-document checklists and cross-FRD consistency checks, and for refactoring FRDs using parent-delivers-value rule to split parents into children and reassign requirements with ID renumbering.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • TrogonStack/agentskills#45: Documents the scaffold-plugin skill workflow that was used to wire this plugin entry into the marketplace configuration and release system.

Poem

🐇 A product requirements hutch, so neat and organized,
With PRDs and FRDs, all systematized!
From business problems down to feature needs,
Each skill a carrot, each template a seed. 🥕📋

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and specifically summarizes the main change: introducing PRD and FRD authoring skills as a new plugin.
Description check✅ PassedThe description is directly related to the changeset, explaining the motivation for the new product-requirements plugin and its purpose in the TrogonStack ecosystem.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch add-prd

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 15

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@plugins/trogonstack-product-requirements/.claude-plugin/plugin.json`:
- Line 3: Update the "description" value in plugin.json so it mentions both
Product Requirements Documents (PRDs) and Functional Requirements Documents
(FRDs) to match the README/marketplace; locate the "description" property in
plugins/trogonstack-product-requirements/.claude-plugin/plugin.json and change
its text from only referencing PRDs to something inclusive like "Skills for
writing and reviewing Product Requirements Documents (PRDs) and Functional
Requirements Documents (FRDs)" ensuring wording matches other metadata entries.
In `@plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md`:
- Around line 82-88: The fenced code block showing the directory tree (the block
containing ".trogonai/project/{projectid}/frd/{parent-slug}/", "index.frd.md",
"{child-1-slug}.frd.md", etc.) lacks a language specifier and triggers MD040;
fix it by adding a language label (e.g., text) after the opening triple
backticks in SKILL.md so the block begins with ```text and leave the tree
contents unchanged.
In `@plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md`:
- Around line 160-181: The markdown fenced code blocks in SKILL.md around the
REQ-CHK-003 examples are unlabeled and trigger markdownlint MD040; update both
fenced blocks that contain the "REQ-CHK-003: Payment Confirmation" good and "Bad
(reject this shape)" examples to include a language identifier (e.g.,
```markdown) at the opening backticks so the blocks become ```markdown ... ```
and ensure the closing backticks remain unchanged; search for the REQ-CHK-003
code examples in the file to locate the exact blocks to modify.
In
`@plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md`:
- Line 93: Several fenced code blocks in SKILL.md use plain ``` markers without
a language tag (e.g., the examples that start with the "## The Problem"
heading), which triggers MD040; update each triple-backtick fence to include a
language identifier (use "markdown" for these prose examples) so they become
```markdown ... ```, and apply the same change to the other affected fence near
the second "## The Problem" instance; search for plain ``` fences around those
headings and replace them with ```markdown to satisfy markdownlint and keep
tooling consistent.
In
`@plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md`:
- Around line 17-20: Add a blank line between the "## Cost of the status quo"
heading and the table to satisfy MD058; locate the heading text "## Cost of the
status quo" and insert one empty line before the table rows starting with "|
Cost | Measure | Source |".
In `@plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md`:
- Line 83: Two fenced code blocks around the "How the job gets done today"
examples are missing a language tag (triggers markdownlint MD040); update each
opening triple-backtick fence to include a language (e.g., change ``` to
```markdown) for both example blocks so the fences read ```markdown, keeping the
existing block content unchanged and preserving both occurrences of the "How the
job gets done today" example sections.
In
`@plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md`:
- Around line 100-121: The two fenced example blocks in SKILL.md (the one
starting with the "Rollout Strategy" heading and the "Misc Notes" block) are
missing language identifiers which triggers MD040; update both opening
triple-backtick fences to include the markdown language tag (```markdown) so the
linter passes and the examples are explicitly marked as Markdown.
In `@plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md`:
- Line 90: The fenced code blocks in SKILL.md around the headings "## Primary:
Mid-market Account Executive" and "## Primary: Sales user" lack language
identifiers and trigger markdownlint MD040; update the opening triple-backtick
fences for those two examples to include "markdown" (i.e., change ``` to
```markdown) so both example fences are annotated and the linter warning is
resolved.
In
`@plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md`:
- Line 100: Two fenced example blocks around the "One-liner" headings are
missing language identifiers and trigger markdownlint MD040; edit the two fenced
code blocks that contain the "## One-liner" examples and change their opening
fences from ``` to ```markdown so both example blocks explicitly declare the
markdown language (apply this to both occurrences noted in the file).
- Line 57: The markdown heading "Boundaries (what the product is NOT**" has
unbalanced emphasis and a missing closing parenthesis; update the text in
SKILL.md so the bold and parentheses are balanced, e.g., change the fragment to
"Boundaries (what the product is NOT)" and wrap the whole label in bold as
"**Boundaries (what the product is NOT)**" so the emphasis and parentheses are
correctly closed.
In `@plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md`:
- Around line 38-46: The fenced filesystem tree in SKILL.md is missing a
language identifier, causing MD040; update the opening fence for the snippet
that shows ".trogonai/project/{projectid}/prd/" to use a language specifier (use
text) so the block becomes "```text" instead of "```" and keep the closing fence
unchanged; locate the snippet in SKILL.md and add the word "text" immediately
after the opening triple backticks.
In
`@plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md`:
- Around line 6-20: The markdown violates MD058 because the tables are not
surrounded by blank lines; update each section (headers "## Primary outcome
metric", "## Leading indicators", and "## Guardrail metrics (must not regress)")
by inserting a blank line immediately after the heading and another blank line
after the table block so that each table is preceded and followed by an empty
line.
In
`@plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md`:
- Around line 105-148: The MD040 lint is triggered because the fenced code
blocks in SKILL.md lack a language tag; edit the example fences around the
primary outcome/leading/guardrail/decision rules examples and add "md" to each
opening triple-backtick (i.e., change ``` to ```md) so the examples are
explicitly marked as Markdown and the linter no longer flags MD040.
In
`@plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md`:
- Around line 6-37: The markdown linter MD058 complains because the tables under
the "## Performance" and "## Integrations" sections need surrounding blank
lines; modify the template so there is an empty line before and after each table
block (the Performance table starting under "## Performance" and the
Integrations table under "## Integrations") to satisfy MD058 while preserving
the header and table rows.
In
`@plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md`:
- Around line 145-188: Add the language tag "md" to both fenced-code blocks that
start with the "## Performance" headings (the detailed example block and the
"Bad" example block) so they read as ```md ... ```; update the opening backticks
for the first large example and the second "Bad" example to include md to
satisfy the MD040 lint rule and ensure proper rendering.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1fe25eee-8570-4849-8204-2d580dfed1c9

📥 Commits

Reviewing files that changed from the base of the PR and between eace11b and 41f0a1f.

📒 Files selected for processing (27)
  • .claude-plugin/marketplace.json
  • .github/release-please-config.json
  • .github/release-please-manifest.json
  • plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
  • plugins/trogonstack-product-requirements/README.md
  • plugins/trogonstack-product-requirements/skills/frd-getting-started/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/assets/frd-template.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/assets/business-problem-template.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/assets/custom-overview-template.md
  • plugins/trogonstack-product-requirements/skills/prd-getting-started/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/assets/personas-template.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/assets/product-description-template.md
  • plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md
  • plugins/trogonstack-product-requirements/skills/requirements-operating-model/SKILL.md

Comment threadplugins/trogonstack-product-requirements/.claude-plugin/plugin.json Outdated
Comment threadplugins/trogonstack-product-requirements/skills/frd-split/SKILL.md Outdated
Comment threadplugins/trogonstack-product-requirements/skills/frd-write/SKILL.md Outdated
Comment threadplugins/trogonstack-product-requirements/skills/prd-review/SKILL.md Outdated
…larify scope
Lint violations made the plugin look untrustworthy to anyone running standard markdown tooling, and the plugin description omitted FRDs even though the catalog markets both PRD and FRD authoring.
Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@yordis
yordis merged commit 207ddb1 into mainMay 26, 2026
4 checks passed
@yordis
yordis deleted the add-prd branch May 26, 2026 20:18
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@yordis
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

feat(product-requirements): introduce PRD and FRD authoring skills - #60

Merged
yordis merged 2 commits into
mainfrom
add-prd
May 26, 2026
Merged

feat(product-requirements): introduce PRD and FRD authoring skills#60
yordis merged 2 commits into
mainfrom
add-prd

Conversation

@yordis

Copy link
Copy Markdown
Member
  • Product and feature authors need a shared structure so engineers, reviewers, and AI agents can pick up requirements work without losing intent or duplicating context.
  • A dedicated plugin keeps PRD and FRD authoring decoupled from blueprints and work orders, matching the rest of the TrogonStack skill catalog.

Authors and reviewers need consistent structure for product-level context and feature-level requirements so engineering can pick up work without losing intent.
Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@cursor

cursorBot commented May 26, 2026

Copy link
Copy Markdown

PR Summary

Low Risk
Additive documentation and agent-skill markdown only; no changes to runtime services, auth, or data paths in existing code.

Overview
Adds a new trogonstack-product-requirements Claude plugin (v0.0.1) and wires it into the marketplace and release-please manifests so it ships like the other TrogonStack plugins.

The plugin introduces agent skills that scaffold and author requirements under .trogonai/project/{projectid}/, with a shared requirements-operating-model that keeps Requirements separate from Blueprints and Work Orders (source of truth, clarification, downstream impact).

Product overview (PRD): six default section skills plus prd-getting-started, prd-custom-overview, and prd-review, each with markdown templates under prd/.

Feature requirements (FRD):frd-getting-started, frd-write, frd-split, and frd-review, including stable REQ- / AC- IDs, nested parent/child FRD layout, and the parent-delivers-value rule.

A README documents the operating model, file layout, and install commands for the marketplace.

Reviewed by Cursor Bugbot for commit 5f85e23. Bugbot is set up for automated code reviews on this repo. Configure here.

@coderabbitai

coderabbitaiBot commented May 26, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@yordis, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 38 minutes and 50 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ffc211dc-4a82-45a2-94cc-5654c9721afa

📥 Commits

Reviewing files that changed from the base of the PR and between 41f0a1f and 5f85e23.

📒 Files selected for processing (14)
  • plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
  • plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md

Walkthrough

This PR introduces trogonstack-product-requirements, a comprehensive Claude plugin that enables structured authoring, review, and management of product requirements artifacts. It includes plugin wiring, foundational operating model guidance, nine PRD authoring skills with templates, four FRD lifecycle skills, and supporting documentation.

Changes

TrogonStack Product Requirements Plugin

Layer / File(s)Summary
Plugin registration and configuration
.claude-plugin/marketplace.json, .github/release-please-*.json, plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
Plugin entry added to marketplace, release-please configuration updated to enable component-tagged releases for the new plugin package.
Plugin overview and Requirements Operating Model
plugins/trogonstack-product-requirements/README.md, plugins/trogonstack-product-requirements/skills/requirements-operating-model/SKILL.md
Plugin README documents the PRD and FRD artifact types, directory structure, and ID conventions. Shared operating model skill defines source-of-truth ownership, skill routing, writing quality rules, and how requirements changes impact downstream Blueprints and Work Orders.
PRD initialization workflow
plugins/trogonstack-product-requirements/skills/prd-getting-started/SKILL.md
Skill for scaffolding the six default Product Overview Documents into a new project with stubs, including quick vs guided pass options and hand-off summary generation.
PRD Business Problem and Current State
plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md, skills/prd-business-problem/assets/business-problem-template.md, skills/prd-current-state/SKILL.md, skills/prd-current-state/assets/current-state-template.md
Skills for drafting Business Problem (market pain, gaps, urgency) and Current State (existing workflows, workarounds, quantified costs) with templates and quality criteria.
PRD Personas, Description, and Metrics
skills/prd-personas/SKILL.md, skills/prd-personas/assets/personas-template.md, skills/prd-product-description/SKILL.md, skills/prd-product-description/assets/product-description-template.md, skills/prd-success-metrics/SKILL.md, skills/prd-success-metrics/assets/success-metrics-template.md
Skills for defining personas (primary/secondary, job-to-be-done, constraints), product description (one-liner, surfaces, components, flows, boundaries), and success metrics (primary outcome, leading indicators, guardrails, per-persona targets) with templates.
PRD Technical Requirements, Custom Overviews, and Review
skills/prd-technical-requirements/SKILL.md, skills/prd-technical-requirements/assets/technical-requirements-template.md, skills/prd-custom-overview/SKILL.md, skills/prd-custom-overview/assets/custom-overview-template.md, skills/prd-review/SKILL.md
Skills for capturing technical constraints (performance, scale, reliability, security, compliance, integrations, platforms, accessibility, localization, observability, cost), authoring custom PRD documents beyond the defaults, and comprehensive PRD review/audit with per-document and cross-document consistency checks.
FRD initialization and authoring
skills/frd-getting-started/SKILL.md, skills/frd-write/SKILL.md, skills/frd-write/assets/frd-template.md
Skills for scaffolding Feature Requirements Documents with parent/child hierarchy and prefix assignment, and for authoring individual FRDs with stable REQ/AC ID schemes, requirements/acceptance criteria discovery, and parent linking.
FRD review and restructuring
skills/frd-review/SKILL.md, skills/frd-split/SKILL.md
Skills for auditing FRDs with per-document checklists and cross-FRD consistency checks, and for refactoring FRDs using parent-delivers-value rule to split parents into children and reassign requirements with ID renumbering.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • TrogonStack/agentskills#45: Documents the scaffold-plugin skill workflow that was used to wire this plugin entry into the marketplace configuration and release system.

Poem

🐇 A product requirements hutch, so neat and organized,
With PRDs and FRDs, all systematized!
From business problems down to feature needs,
Each skill a carrot, each template a seed. 🥕📋

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and specifically summarizes the main change: introducing PRD and FRD authoring skills as a new plugin.
Description check✅ PassedThe description is directly related to the changeset, explaining the motivation for the new product-requirements plugin and its purpose in the TrogonStack ecosystem.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch add-prd

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 15

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@plugins/trogonstack-product-requirements/.claude-plugin/plugin.json`:
- Line 3: Update the "description" value in plugin.json so it mentions both
Product Requirements Documents (PRDs) and Functional Requirements Documents
(FRDs) to match the README/marketplace; locate the "description" property in
plugins/trogonstack-product-requirements/.claude-plugin/plugin.json and change
its text from only referencing PRDs to something inclusive like "Skills for
writing and reviewing Product Requirements Documents (PRDs) and Functional
Requirements Documents (FRDs)" ensuring wording matches other metadata entries.
In `@plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md`:
- Around line 82-88: The fenced code block showing the directory tree (the block
containing ".trogonai/project/{projectid}/frd/{parent-slug}/", "index.frd.md",
"{child-1-slug}.frd.md", etc.) lacks a language specifier and triggers MD040;
fix it by adding a language label (e.g., text) after the opening triple
backticks in SKILL.md so the block begins with ```text and leave the tree
contents unchanged.
In `@plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md`:
- Around line 160-181: The markdown fenced code blocks in SKILL.md around the
REQ-CHK-003 examples are unlabeled and trigger markdownlint MD040; update both
fenced blocks that contain the "REQ-CHK-003: Payment Confirmation" good and "Bad
(reject this shape)" examples to include a language identifier (e.g.,
```markdown) at the opening backticks so the blocks become ```markdown ... ```
and ensure the closing backticks remain unchanged; search for the REQ-CHK-003
code examples in the file to locate the exact blocks to modify.
In
`@plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md`:
- Line 93: Several fenced code blocks in SKILL.md use plain ``` markers without
a language tag (e.g., the examples that start with the "## The Problem"
heading), which triggers MD040; update each triple-backtick fence to include a
language identifier (use "markdown" for these prose examples) so they become
```markdown ... ```, and apply the same change to the other affected fence near
the second "## The Problem" instance; search for plain ``` fences around those
headings and replace them with ```markdown to satisfy markdownlint and keep
tooling consistent.
In
`@plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md`:
- Around line 17-20: Add a blank line between the "## Cost of the status quo"
heading and the table to satisfy MD058; locate the heading text "## Cost of the
status quo" and insert one empty line before the table rows starting with "|
Cost | Measure | Source |".
In `@plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md`:
- Line 83: Two fenced code blocks around the "How the job gets done today"
examples are missing a language tag (triggers markdownlint MD040); update each
opening triple-backtick fence to include a language (e.g., change ``` to
```markdown) for both example blocks so the fences read ```markdown, keeping the
existing block content unchanged and preserving both occurrences of the "How the
job gets done today" example sections.
In
`@plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md`:
- Around line 100-121: The two fenced example blocks in SKILL.md (the one
starting with the "Rollout Strategy" heading and the "Misc Notes" block) are
missing language identifiers which triggers MD040; update both opening
triple-backtick fences to include the markdown language tag (```markdown) so the
linter passes and the examples are explicitly marked as Markdown.
In `@plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md`:
- Line 90: The fenced code blocks in SKILL.md around the headings "## Primary:
Mid-market Account Executive" and "## Primary: Sales user" lack language
identifiers and trigger markdownlint MD040; update the opening triple-backtick
fences for those two examples to include "markdown" (i.e., change ``` to
```markdown) so both example fences are annotated and the linter warning is
resolved.
In
`@plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md`:
- Line 100: Two fenced example blocks around the "One-liner" headings are
missing language identifiers and trigger markdownlint MD040; edit the two fenced
code blocks that contain the "## One-liner" examples and change their opening
fences from ``` to ```markdown so both example blocks explicitly declare the
markdown language (apply this to both occurrences noted in the file).
- Line 57: The markdown heading "Boundaries (what the product is NOT**" has
unbalanced emphasis and a missing closing parenthesis; update the text in
SKILL.md so the bold and parentheses are balanced, e.g., change the fragment to
"Boundaries (what the product is NOT)" and wrap the whole label in bold as
"**Boundaries (what the product is NOT)**" so the emphasis and parentheses are
correctly closed.
In `@plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md`:
- Around line 38-46: The fenced filesystem tree in SKILL.md is missing a
language identifier, causing MD040; update the opening fence for the snippet
that shows ".trogonai/project/{projectid}/prd/" to use a language specifier (use
text) so the block becomes "```text" instead of "```" and keep the closing fence
unchanged; locate the snippet in SKILL.md and add the word "text" immediately
after the opening triple backticks.
In
`@plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md`:
- Around line 6-20: The markdown violates MD058 because the tables are not
surrounded by blank lines; update each section (headers "## Primary outcome
metric", "## Leading indicators", and "## Guardrail metrics (must not regress)")
by inserting a blank line immediately after the heading and another blank line
after the table block so that each table is preceded and followed by an empty
line.
In
`@plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md`:
- Around line 105-148: The MD040 lint is triggered because the fenced code
blocks in SKILL.md lack a language tag; edit the example fences around the
primary outcome/leading/guardrail/decision rules examples and add "md" to each
opening triple-backtick (i.e., change ``` to ```md) so the examples are
explicitly marked as Markdown and the linter no longer flags MD040.
In
`@plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md`:
- Around line 6-37: The markdown linter MD058 complains because the tables under
the "## Performance" and "## Integrations" sections need surrounding blank
lines; modify the template so there is an empty line before and after each table
block (the Performance table starting under "## Performance" and the
Integrations table under "## Integrations") to satisfy MD058 while preserving
the header and table rows.
In
`@plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md`:
- Around line 145-188: Add the language tag "md" to both fenced-code blocks that
start with the "## Performance" headings (the detailed example block and the
"Bad" example block) so they read as ```md ... ```; update the opening backticks
for the first large example and the second "Bad" example to include md to
satisfy the MD040 lint rule and ensure proper rendering.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1fe25eee-8570-4849-8204-2d580dfed1c9

📥 Commits

Reviewing files that changed from the base of the PR and between eace11b and 41f0a1f.

📒 Files selected for processing (27)
  • .claude-plugin/marketplace.json
  • .github/release-please-config.json
  • .github/release-please-manifest.json
  • plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
  • plugins/trogonstack-product-requirements/README.md
  • plugins/trogonstack-product-requirements/skills/frd-getting-started/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/assets/frd-template.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/assets/business-problem-template.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/assets/custom-overview-template.md
  • plugins/trogonstack-product-requirements/skills/prd-getting-started/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/assets/personas-template.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/assets/product-description-template.md
  • plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md
  • plugins/trogonstack-product-requirements/skills/requirements-operating-model/SKILL.md

Comment threadplugins/trogonstack-product-requirements/.claude-plugin/plugin.json Outdated
Comment threadplugins/trogonstack-product-requirements/skills/frd-split/SKILL.md Outdated
Comment threadplugins/trogonstack-product-requirements/skills/frd-write/SKILL.md Outdated
Comment threadplugins/trogonstack-product-requirements/skills/prd-review/SKILL.md Outdated
…larify scope
Lint violations made the plugin look untrustworthy to anyone running standard markdown tooling, and the plugin description omitted FRDs even though the catalog markets both PRD and FRD authoring.
Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@yordis
yordis merged commit 207ddb1 into mainMay 26, 2026
4 checks passed
@yordis
yordis deleted the add-prd branch May 26, 2026 20:18
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@yordis
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(product-requirements): introduce PRD and FRD authoring skills - #60

Merged
yordis merged 2 commits into
mainfrom
add-prd
May 26, 2026
Merged

feat(product-requirements): introduce PRD and FRD authoring skills#60
yordis merged 2 commits into
mainfrom
add-prd

Conversation

@yordis

Copy link
Copy Markdown
Member
  • Product and feature authors need a shared structure so engineers, reviewers, and AI agents can pick up requirements work without losing intent or duplicating context.
  • A dedicated plugin keeps PRD and FRD authoring decoupled from blueprints and work orders, matching the rest of the TrogonStack skill catalog.

Authors and reviewers need consistent structure for product-level context and feature-level requirements so engineering can pick up work without losing intent.
Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@cursor

cursorBot commented May 26, 2026

Copy link
Copy Markdown

PR Summary

Low Risk
Additive documentation and agent-skill markdown only; no changes to runtime services, auth, or data paths in existing code.

Overview
Adds a new trogonstack-product-requirements Claude plugin (v0.0.1) and wires it into the marketplace and release-please manifests so it ships like the other TrogonStack plugins.

The plugin introduces agent skills that scaffold and author requirements under .trogonai/project/{projectid}/, with a shared requirements-operating-model that keeps Requirements separate from Blueprints and Work Orders (source of truth, clarification, downstream impact).

Product overview (PRD): six default section skills plus prd-getting-started, prd-custom-overview, and prd-review, each with markdown templates under prd/.

Feature requirements (FRD):frd-getting-started, frd-write, frd-split, and frd-review, including stable REQ- / AC- IDs, nested parent/child FRD layout, and the parent-delivers-value rule.

A README documents the operating model, file layout, and install commands for the marketplace.

Reviewed by Cursor Bugbot for commit 5f85e23. Bugbot is set up for automated code reviews on this repo. Configure here.

@coderabbitai

coderabbitaiBot commented May 26, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@yordis, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 38 minutes and 50 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ffc211dc-4a82-45a2-94cc-5654c9721afa

📥 Commits

Reviewing files that changed from the base of the PR and between 41f0a1f and 5f85e23.

📒 Files selected for processing (14)
  • plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
  • plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md

Walkthrough

This PR introduces trogonstack-product-requirements, a comprehensive Claude plugin that enables structured authoring, review, and management of product requirements artifacts. It includes plugin wiring, foundational operating model guidance, nine PRD authoring skills with templates, four FRD lifecycle skills, and supporting documentation.

Changes

TrogonStack Product Requirements Plugin

Layer / File(s)Summary
Plugin registration and configuration
.claude-plugin/marketplace.json, .github/release-please-*.json, plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
Plugin entry added to marketplace, release-please configuration updated to enable component-tagged releases for the new plugin package.
Plugin overview and Requirements Operating Model
plugins/trogonstack-product-requirements/README.md, plugins/trogonstack-product-requirements/skills/requirements-operating-model/SKILL.md
Plugin README documents the PRD and FRD artifact types, directory structure, and ID conventions. Shared operating model skill defines source-of-truth ownership, skill routing, writing quality rules, and how requirements changes impact downstream Blueprints and Work Orders.
PRD initialization workflow
plugins/trogonstack-product-requirements/skills/prd-getting-started/SKILL.md
Skill for scaffolding the six default Product Overview Documents into a new project with stubs, including quick vs guided pass options and hand-off summary generation.
PRD Business Problem and Current State
plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md, skills/prd-business-problem/assets/business-problem-template.md, skills/prd-current-state/SKILL.md, skills/prd-current-state/assets/current-state-template.md
Skills for drafting Business Problem (market pain, gaps, urgency) and Current State (existing workflows, workarounds, quantified costs) with templates and quality criteria.
PRD Personas, Description, and Metrics
skills/prd-personas/SKILL.md, skills/prd-personas/assets/personas-template.md, skills/prd-product-description/SKILL.md, skills/prd-product-description/assets/product-description-template.md, skills/prd-success-metrics/SKILL.md, skills/prd-success-metrics/assets/success-metrics-template.md
Skills for defining personas (primary/secondary, job-to-be-done, constraints), product description (one-liner, surfaces, components, flows, boundaries), and success metrics (primary outcome, leading indicators, guardrails, per-persona targets) with templates.
PRD Technical Requirements, Custom Overviews, and Review
skills/prd-technical-requirements/SKILL.md, skills/prd-technical-requirements/assets/technical-requirements-template.md, skills/prd-custom-overview/SKILL.md, skills/prd-custom-overview/assets/custom-overview-template.md, skills/prd-review/SKILL.md
Skills for capturing technical constraints (performance, scale, reliability, security, compliance, integrations, platforms, accessibility, localization, observability, cost), authoring custom PRD documents beyond the defaults, and comprehensive PRD review/audit with per-document and cross-document consistency checks.
FRD initialization and authoring
skills/frd-getting-started/SKILL.md, skills/frd-write/SKILL.md, skills/frd-write/assets/frd-template.md
Skills for scaffolding Feature Requirements Documents with parent/child hierarchy and prefix assignment, and for authoring individual FRDs with stable REQ/AC ID schemes, requirements/acceptance criteria discovery, and parent linking.
FRD review and restructuring
skills/frd-review/SKILL.md, skills/frd-split/SKILL.md
Skills for auditing FRDs with per-document checklists and cross-FRD consistency checks, and for refactoring FRDs using parent-delivers-value rule to split parents into children and reassign requirements with ID renumbering.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • TrogonStack/agentskills#45: Documents the scaffold-plugin skill workflow that was used to wire this plugin entry into the marketplace configuration and release system.

Poem

🐇 A product requirements hutch, so neat and organized,
With PRDs and FRDs, all systematized!
From business problems down to feature needs,
Each skill a carrot, each template a seed. 🥕📋

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and specifically summarizes the main change: introducing PRD and FRD authoring skills as a new plugin.
Description check✅ PassedThe description is directly related to the changeset, explaining the motivation for the new product-requirements plugin and its purpose in the TrogonStack ecosystem.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch add-prd

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 15

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@plugins/trogonstack-product-requirements/.claude-plugin/plugin.json`:
- Line 3: Update the "description" value in plugin.json so it mentions both
Product Requirements Documents (PRDs) and Functional Requirements Documents
(FRDs) to match the README/marketplace; locate the "description" property in
plugins/trogonstack-product-requirements/.claude-plugin/plugin.json and change
its text from only referencing PRDs to something inclusive like "Skills for
writing and reviewing Product Requirements Documents (PRDs) and Functional
Requirements Documents (FRDs)" ensuring wording matches other metadata entries.
In `@plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md`:
- Around line 82-88: The fenced code block showing the directory tree (the block
containing ".trogonai/project/{projectid}/frd/{parent-slug}/", "index.frd.md",
"{child-1-slug}.frd.md", etc.) lacks a language specifier and triggers MD040;
fix it by adding a language label (e.g., text) after the opening triple
backticks in SKILL.md so the block begins with ```text and leave the tree
contents unchanged.
In `@plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md`:
- Around line 160-181: The markdown fenced code blocks in SKILL.md around the
REQ-CHK-003 examples are unlabeled and trigger markdownlint MD040; update both
fenced blocks that contain the "REQ-CHK-003: Payment Confirmation" good and "Bad
(reject this shape)" examples to include a language identifier (e.g.,
```markdown) at the opening backticks so the blocks become ```markdown ... ```
and ensure the closing backticks remain unchanged; search for the REQ-CHK-003
code examples in the file to locate the exact blocks to modify.
In
`@plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md`:
- Line 93: Several fenced code blocks in SKILL.md use plain ``` markers without
a language tag (e.g., the examples that start with the "## The Problem"
heading), which triggers MD040; update each triple-backtick fence to include a
language identifier (use "markdown" for these prose examples) so they become
```markdown ... ```, and apply the same change to the other affected fence near
the second "## The Problem" instance; search for plain ``` fences around those
headings and replace them with ```markdown to satisfy markdownlint and keep
tooling consistent.
In
`@plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md`:
- Around line 17-20: Add a blank line between the "## Cost of the status quo"
heading and the table to satisfy MD058; locate the heading text "## Cost of the
status quo" and insert one empty line before the table rows starting with "|
Cost | Measure | Source |".
In `@plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md`:
- Line 83: Two fenced code blocks around the "How the job gets done today"
examples are missing a language tag (triggers markdownlint MD040); update each
opening triple-backtick fence to include a language (e.g., change ``` to
```markdown) for both example blocks so the fences read ```markdown, keeping the
existing block content unchanged and preserving both occurrences of the "How the
job gets done today" example sections.
In
`@plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md`:
- Around line 100-121: The two fenced example blocks in SKILL.md (the one
starting with the "Rollout Strategy" heading and the "Misc Notes" block) are
missing language identifiers which triggers MD040; update both opening
triple-backtick fences to include the markdown language tag (```markdown) so the
linter passes and the examples are explicitly marked as Markdown.
In `@plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md`:
- Line 90: The fenced code blocks in SKILL.md around the headings "## Primary:
Mid-market Account Executive" and "## Primary: Sales user" lack language
identifiers and trigger markdownlint MD040; update the opening triple-backtick
fences for those two examples to include "markdown" (i.e., change ``` to
```markdown) so both example fences are annotated and the linter warning is
resolved.
In
`@plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md`:
- Line 100: Two fenced example blocks around the "One-liner" headings are
missing language identifiers and trigger markdownlint MD040; edit the two fenced
code blocks that contain the "## One-liner" examples and change their opening
fences from ``` to ```markdown so both example blocks explicitly declare the
markdown language (apply this to both occurrences noted in the file).
- Line 57: The markdown heading "Boundaries (what the product is NOT**" has
unbalanced emphasis and a missing closing parenthesis; update the text in
SKILL.md so the bold and parentheses are balanced, e.g., change the fragment to
"Boundaries (what the product is NOT)" and wrap the whole label in bold as
"**Boundaries (what the product is NOT)**" so the emphasis and parentheses are
correctly closed.
In `@plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md`:
- Around line 38-46: The fenced filesystem tree in SKILL.md is missing a
language identifier, causing MD040; update the opening fence for the snippet
that shows ".trogonai/project/{projectid}/prd/" to use a language specifier (use
text) so the block becomes "```text" instead of "```" and keep the closing fence
unchanged; locate the snippet in SKILL.md and add the word "text" immediately
after the opening triple backticks.
In
`@plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md`:
- Around line 6-20: The markdown violates MD058 because the tables are not
surrounded by blank lines; update each section (headers "## Primary outcome
metric", "## Leading indicators", and "## Guardrail metrics (must not regress)")
by inserting a blank line immediately after the heading and another blank line
after the table block so that each table is preceded and followed by an empty
line.
In
`@plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md`:
- Around line 105-148: The MD040 lint is triggered because the fenced code
blocks in SKILL.md lack a language tag; edit the example fences around the
primary outcome/leading/guardrail/decision rules examples and add "md" to each
opening triple-backtick (i.e., change ``` to ```md) so the examples are
explicitly marked as Markdown and the linter no longer flags MD040.
In
`@plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md`:
- Around line 6-37: The markdown linter MD058 complains because the tables under
the "## Performance" and "## Integrations" sections need surrounding blank
lines; modify the template so there is an empty line before and after each table
block (the Performance table starting under "## Performance" and the
Integrations table under "## Integrations") to satisfy MD058 while preserving
the header and table rows.
In
`@plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md`:
- Around line 145-188: Add the language tag "md" to both fenced-code blocks that
start with the "## Performance" headings (the detailed example block and the
"Bad" example block) so they read as ```md ... ```; update the opening backticks
for the first large example and the second "Bad" example to include md to
satisfy the MD040 lint rule and ensure proper rendering.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1fe25eee-8570-4849-8204-2d580dfed1c9

📥 Commits

Reviewing files that changed from the base of the PR and between eace11b and 41f0a1f.

📒 Files selected for processing (27)
  • .claude-plugin/marketplace.json
  • .github/release-please-config.json
  • .github/release-please-manifest.json
  • plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
  • plugins/trogonstack-product-requirements/README.md
  • plugins/trogonstack-product-requirements/skills/frd-getting-started/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/assets/frd-template.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/assets/business-problem-template.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/assets/custom-overview-template.md
  • plugins/trogonstack-product-requirements/skills/prd-getting-started/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/assets/personas-template.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/assets/product-description-template.md
  • plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md
  • plugins/trogonstack-product-requirements/skills/requirements-operating-model/SKILL.md

Comment threadplugins/trogonstack-product-requirements/.claude-plugin/plugin.json Outdated
Comment threadplugins/trogonstack-product-requirements/skills/frd-split/SKILL.md Outdated
Comment threadplugins/trogonstack-product-requirements/skills/frd-write/SKILL.md Outdated
Comment threadplugins/trogonstack-product-requirements/skills/prd-review/SKILL.md Outdated
…larify scope
Lint violations made the plugin look untrustworthy to anyone running standard markdown tooling, and the plugin description omitted FRDs even though the catalog markets both PRD and FRD authoring.
Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@yordis
yordis merged commit 207ddb1 into mainMay 26, 2026
4 checks passed
@yordis
yordis deleted the add-prd branch May 26, 2026 20:18
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@yordis
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(product-requirements): introduce PRD and FRD authoring skills - #60

Merged
yordis merged 2 commits into
mainfrom
add-prd
May 26, 2026
Merged

feat(product-requirements): introduce PRD and FRD authoring skills#60
yordis merged 2 commits into
mainfrom
add-prd

Conversation

@yordis

Copy link
Copy Markdown
Member
  • Product and feature authors need a shared structure so engineers, reviewers, and AI agents can pick up requirements work without losing intent or duplicating context.
  • A dedicated plugin keeps PRD and FRD authoring decoupled from blueprints and work orders, matching the rest of the TrogonStack skill catalog.

Authors and reviewers need consistent structure for product-level context and feature-level requirements so engineering can pick up work without losing intent.
Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@cursor

cursorBot commented May 26, 2026

Copy link
Copy Markdown

PR Summary

Low Risk
Additive documentation and agent-skill markdown only; no changes to runtime services, auth, or data paths in existing code.

Overview
Adds a new trogonstack-product-requirements Claude plugin (v0.0.1) and wires it into the marketplace and release-please manifests so it ships like the other TrogonStack plugins.

The plugin introduces agent skills that scaffold and author requirements under .trogonai/project/{projectid}/, with a shared requirements-operating-model that keeps Requirements separate from Blueprints and Work Orders (source of truth, clarification, downstream impact).

Product overview (PRD): six default section skills plus prd-getting-started, prd-custom-overview, and prd-review, each with markdown templates under prd/.

Feature requirements (FRD):frd-getting-started, frd-write, frd-split, and frd-review, including stable REQ- / AC- IDs, nested parent/child FRD layout, and the parent-delivers-value rule.

A README documents the operating model, file layout, and install commands for the marketplace.

Reviewed by Cursor Bugbot for commit 5f85e23. Bugbot is set up for automated code reviews on this repo. Configure here.

@coderabbitai

coderabbitaiBot commented May 26, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@yordis, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 38 minutes and 50 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ffc211dc-4a82-45a2-94cc-5654c9721afa

📥 Commits

Reviewing files that changed from the base of the PR and between 41f0a1f and 5f85e23.

📒 Files selected for processing (14)
  • plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
  • plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md

Walkthrough

This PR introduces trogonstack-product-requirements, a comprehensive Claude plugin that enables structured authoring, review, and management of product requirements artifacts. It includes plugin wiring, foundational operating model guidance, nine PRD authoring skills with templates, four FRD lifecycle skills, and supporting documentation.

Changes

TrogonStack Product Requirements Plugin

Layer / File(s)Summary
Plugin registration and configuration
.claude-plugin/marketplace.json, .github/release-please-*.json, plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
Plugin entry added to marketplace, release-please configuration updated to enable component-tagged releases for the new plugin package.
Plugin overview and Requirements Operating Model
plugins/trogonstack-product-requirements/README.md, plugins/trogonstack-product-requirements/skills/requirements-operating-model/SKILL.md
Plugin README documents the PRD and FRD artifact types, directory structure, and ID conventions. Shared operating model skill defines source-of-truth ownership, skill routing, writing quality rules, and how requirements changes impact downstream Blueprints and Work Orders.
PRD initialization workflow
plugins/trogonstack-product-requirements/skills/prd-getting-started/SKILL.md
Skill for scaffolding the six default Product Overview Documents into a new project with stubs, including quick vs guided pass options and hand-off summary generation.
PRD Business Problem and Current State
plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md, skills/prd-business-problem/assets/business-problem-template.md, skills/prd-current-state/SKILL.md, skills/prd-current-state/assets/current-state-template.md
Skills for drafting Business Problem (market pain, gaps, urgency) and Current State (existing workflows, workarounds, quantified costs) with templates and quality criteria.
PRD Personas, Description, and Metrics
skills/prd-personas/SKILL.md, skills/prd-personas/assets/personas-template.md, skills/prd-product-description/SKILL.md, skills/prd-product-description/assets/product-description-template.md, skills/prd-success-metrics/SKILL.md, skills/prd-success-metrics/assets/success-metrics-template.md
Skills for defining personas (primary/secondary, job-to-be-done, constraints), product description (one-liner, surfaces, components, flows, boundaries), and success metrics (primary outcome, leading indicators, guardrails, per-persona targets) with templates.
PRD Technical Requirements, Custom Overviews, and Review
skills/prd-technical-requirements/SKILL.md, skills/prd-technical-requirements/assets/technical-requirements-template.md, skills/prd-custom-overview/SKILL.md, skills/prd-custom-overview/assets/custom-overview-template.md, skills/prd-review/SKILL.md
Skills for capturing technical constraints (performance, scale, reliability, security, compliance, integrations, platforms, accessibility, localization, observability, cost), authoring custom PRD documents beyond the defaults, and comprehensive PRD review/audit with per-document and cross-document consistency checks.
FRD initialization and authoring
skills/frd-getting-started/SKILL.md, skills/frd-write/SKILL.md, skills/frd-write/assets/frd-template.md
Skills for scaffolding Feature Requirements Documents with parent/child hierarchy and prefix assignment, and for authoring individual FRDs with stable REQ/AC ID schemes, requirements/acceptance criteria discovery, and parent linking.
FRD review and restructuring
skills/frd-review/SKILL.md, skills/frd-split/SKILL.md
Skills for auditing FRDs with per-document checklists and cross-FRD consistency checks, and for refactoring FRDs using parent-delivers-value rule to split parents into children and reassign requirements with ID renumbering.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • TrogonStack/agentskills#45: Documents the scaffold-plugin skill workflow that was used to wire this plugin entry into the marketplace configuration and release system.

Poem

🐇 A product requirements hutch, so neat and organized,
With PRDs and FRDs, all systematized!
From business problems down to feature needs,
Each skill a carrot, each template a seed. 🥕📋

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and specifically summarizes the main change: introducing PRD and FRD authoring skills as a new plugin.
Description check✅ PassedThe description is directly related to the changeset, explaining the motivation for the new product-requirements plugin and its purpose in the TrogonStack ecosystem.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch add-prd

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 15

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@plugins/trogonstack-product-requirements/.claude-plugin/plugin.json`:
- Line 3: Update the "description" value in plugin.json so it mentions both
Product Requirements Documents (PRDs) and Functional Requirements Documents
(FRDs) to match the README/marketplace; locate the "description" property in
plugins/trogonstack-product-requirements/.claude-plugin/plugin.json and change
its text from only referencing PRDs to something inclusive like "Skills for
writing and reviewing Product Requirements Documents (PRDs) and Functional
Requirements Documents (FRDs)" ensuring wording matches other metadata entries.
In `@plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md`:
- Around line 82-88: The fenced code block showing the directory tree (the block
containing ".trogonai/project/{projectid}/frd/{parent-slug}/", "index.frd.md",
"{child-1-slug}.frd.md", etc.) lacks a language specifier and triggers MD040;
fix it by adding a language label (e.g., text) after the opening triple
backticks in SKILL.md so the block begins with ```text and leave the tree
contents unchanged.
In `@plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md`:
- Around line 160-181: The markdown fenced code blocks in SKILL.md around the
REQ-CHK-003 examples are unlabeled and trigger markdownlint MD040; update both
fenced blocks that contain the "REQ-CHK-003: Payment Confirmation" good and "Bad
(reject this shape)" examples to include a language identifier (e.g.,
```markdown) at the opening backticks so the blocks become ```markdown ... ```
and ensure the closing backticks remain unchanged; search for the REQ-CHK-003
code examples in the file to locate the exact blocks to modify.
In
`@plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md`:
- Line 93: Several fenced code blocks in SKILL.md use plain ``` markers without
a language tag (e.g., the examples that start with the "## The Problem"
heading), which triggers MD040; update each triple-backtick fence to include a
language identifier (use "markdown" for these prose examples) so they become
```markdown ... ```, and apply the same change to the other affected fence near
the second "## The Problem" instance; search for plain ``` fences around those
headings and replace them with ```markdown to satisfy markdownlint and keep
tooling consistent.
In
`@plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md`:
- Around line 17-20: Add a blank line between the "## Cost of the status quo"
heading and the table to satisfy MD058; locate the heading text "## Cost of the
status quo" and insert one empty line before the table rows starting with "|
Cost | Measure | Source |".
In `@plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md`:
- Line 83: Two fenced code blocks around the "How the job gets done today"
examples are missing a language tag (triggers markdownlint MD040); update each
opening triple-backtick fence to include a language (e.g., change ``` to
```markdown) for both example blocks so the fences read ```markdown, keeping the
existing block content unchanged and preserving both occurrences of the "How the
job gets done today" example sections.
In
`@plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md`:
- Around line 100-121: The two fenced example blocks in SKILL.md (the one
starting with the "Rollout Strategy" heading and the "Misc Notes" block) are
missing language identifiers which triggers MD040; update both opening
triple-backtick fences to include the markdown language tag (```markdown) so the
linter passes and the examples are explicitly marked as Markdown.
In `@plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md`:
- Line 90: The fenced code blocks in SKILL.md around the headings "## Primary:
Mid-market Account Executive" and "## Primary: Sales user" lack language
identifiers and trigger markdownlint MD040; update the opening triple-backtick
fences for those two examples to include "markdown" (i.e., change ``` to
```markdown) so both example fences are annotated and the linter warning is
resolved.
In
`@plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md`:
- Line 100: Two fenced example blocks around the "One-liner" headings are
missing language identifiers and trigger markdownlint MD040; edit the two fenced
code blocks that contain the "## One-liner" examples and change their opening
fences from ``` to ```markdown so both example blocks explicitly declare the
markdown language (apply this to both occurrences noted in the file).
- Line 57: The markdown heading "Boundaries (what the product is NOT**" has
unbalanced emphasis and a missing closing parenthesis; update the text in
SKILL.md so the bold and parentheses are balanced, e.g., change the fragment to
"Boundaries (what the product is NOT)" and wrap the whole label in bold as
"**Boundaries (what the product is NOT)**" so the emphasis and parentheses are
correctly closed.
In `@plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md`:
- Around line 38-46: The fenced filesystem tree in SKILL.md is missing a
language identifier, causing MD040; update the opening fence for the snippet
that shows ".trogonai/project/{projectid}/prd/" to use a language specifier (use
text) so the block becomes "```text" instead of "```" and keep the closing fence
unchanged; locate the snippet in SKILL.md and add the word "text" immediately
after the opening triple backticks.
In
`@plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md`:
- Around line 6-20: The markdown violates MD058 because the tables are not
surrounded by blank lines; update each section (headers "## Primary outcome
metric", "## Leading indicators", and "## Guardrail metrics (must not regress)")
by inserting a blank line immediately after the heading and another blank line
after the table block so that each table is preceded and followed by an empty
line.
In
`@plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md`:
- Around line 105-148: The MD040 lint is triggered because the fenced code
blocks in SKILL.md lack a language tag; edit the example fences around the
primary outcome/leading/guardrail/decision rules examples and add "md" to each
opening triple-backtick (i.e., change ``` to ```md) so the examples are
explicitly marked as Markdown and the linter no longer flags MD040.
In
`@plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md`:
- Around line 6-37: The markdown linter MD058 complains because the tables under
the "## Performance" and "## Integrations" sections need surrounding blank
lines; modify the template so there is an empty line before and after each table
block (the Performance table starting under "## Performance" and the
Integrations table under "## Integrations") to satisfy MD058 while preserving
the header and table rows.
In
`@plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md`:
- Around line 145-188: Add the language tag "md" to both fenced-code blocks that
start with the "## Performance" headings (the detailed example block and the
"Bad" example block) so they read as ```md ... ```; update the opening backticks
for the first large example and the second "Bad" example to include md to
satisfy the MD040 lint rule and ensure proper rendering.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1fe25eee-8570-4849-8204-2d580dfed1c9

📥 Commits

Reviewing files that changed from the base of the PR and between eace11b and 41f0a1f.

📒 Files selected for processing (27)
  • .claude-plugin/marketplace.json
  • .github/release-please-config.json
  • .github/release-please-manifest.json
  • plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
  • plugins/trogonstack-product-requirements/README.md
  • plugins/trogonstack-product-requirements/skills/frd-getting-started/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/assets/frd-template.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/assets/business-problem-template.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/assets/custom-overview-template.md
  • plugins/trogonstack-product-requirements/skills/prd-getting-started/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/assets/personas-template.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/assets/product-description-template.md
  • plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md
  • plugins/trogonstack-product-requirements/skills/requirements-operating-model/SKILL.md

Comment threadplugins/trogonstack-product-requirements/.claude-plugin/plugin.json Outdated
Comment threadplugins/trogonstack-product-requirements/skills/frd-split/SKILL.md Outdated
Comment threadplugins/trogonstack-product-requirements/skills/frd-write/SKILL.md Outdated
Comment threadplugins/trogonstack-product-requirements/skills/prd-review/SKILL.md Outdated
…larify scope
Lint violations made the plugin look untrustworthy to anyone running standard markdown tooling, and the plugin description omitted FRDs even though the catalog markets both PRD and FRD authoring.
Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@yordis
yordis merged commit 207ddb1 into mainMay 26, 2026
4 checks passed
@yordis
yordis deleted the add-prd branch May 26, 2026 20:18
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@yordis
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

feat(product-requirements): introduce PRD and FRD authoring skills - #60

Merged
yordis merged 2 commits into
mainfrom
add-prd
May 26, 2026
Merged

feat(product-requirements): introduce PRD and FRD authoring skills#60
yordis merged 2 commits into
mainfrom
add-prd

Conversation

@yordis

Copy link
Copy Markdown
Member
  • Product and feature authors need a shared structure so engineers, reviewers, and AI agents can pick up requirements work without losing intent or duplicating context.
  • A dedicated plugin keeps PRD and FRD authoring decoupled from blueprints and work orders, matching the rest of the TrogonStack skill catalog.

Authors and reviewers need consistent structure for product-level context and feature-level requirements so engineering can pick up work without losing intent.
Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@cursor

cursorBot commented May 26, 2026

Copy link
Copy Markdown

PR Summary

Low Risk
Additive documentation and agent-skill markdown only; no changes to runtime services, auth, or data paths in existing code.

Overview
Adds a new trogonstack-product-requirements Claude plugin (v0.0.1) and wires it into the marketplace and release-please manifests so it ships like the other TrogonStack plugins.

The plugin introduces agent skills that scaffold and author requirements under .trogonai/project/{projectid}/, with a shared requirements-operating-model that keeps Requirements separate from Blueprints and Work Orders (source of truth, clarification, downstream impact).

Product overview (PRD): six default section skills plus prd-getting-started, prd-custom-overview, and prd-review, each with markdown templates under prd/.

Feature requirements (FRD):frd-getting-started, frd-write, frd-split, and frd-review, including stable REQ- / AC- IDs, nested parent/child FRD layout, and the parent-delivers-value rule.

A README documents the operating model, file layout, and install commands for the marketplace.

Reviewed by Cursor Bugbot for commit 5f85e23. Bugbot is set up for automated code reviews on this repo. Configure here.

@coderabbitai

coderabbitaiBot commented May 26, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@yordis, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 38 minutes and 50 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ffc211dc-4a82-45a2-94cc-5654c9721afa

📥 Commits

Reviewing files that changed from the base of the PR and between 41f0a1f and 5f85e23.

📒 Files selected for processing (14)
  • plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
  • plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md

Walkthrough

This PR introduces trogonstack-product-requirements, a comprehensive Claude plugin that enables structured authoring, review, and management of product requirements artifacts. It includes plugin wiring, foundational operating model guidance, nine PRD authoring skills with templates, four FRD lifecycle skills, and supporting documentation.

Changes

TrogonStack Product Requirements Plugin

Layer / File(s)Summary
Plugin registration and configuration
.claude-plugin/marketplace.json, .github/release-please-*.json, plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
Plugin entry added to marketplace, release-please configuration updated to enable component-tagged releases for the new plugin package.
Plugin overview and Requirements Operating Model
plugins/trogonstack-product-requirements/README.md, plugins/trogonstack-product-requirements/skills/requirements-operating-model/SKILL.md
Plugin README documents the PRD and FRD artifact types, directory structure, and ID conventions. Shared operating model skill defines source-of-truth ownership, skill routing, writing quality rules, and how requirements changes impact downstream Blueprints and Work Orders.
PRD initialization workflow
plugins/trogonstack-product-requirements/skills/prd-getting-started/SKILL.md
Skill for scaffolding the six default Product Overview Documents into a new project with stubs, including quick vs guided pass options and hand-off summary generation.
PRD Business Problem and Current State
plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md, skills/prd-business-problem/assets/business-problem-template.md, skills/prd-current-state/SKILL.md, skills/prd-current-state/assets/current-state-template.md
Skills for drafting Business Problem (market pain, gaps, urgency) and Current State (existing workflows, workarounds, quantified costs) with templates and quality criteria.
PRD Personas, Description, and Metrics
skills/prd-personas/SKILL.md, skills/prd-personas/assets/personas-template.md, skills/prd-product-description/SKILL.md, skills/prd-product-description/assets/product-description-template.md, skills/prd-success-metrics/SKILL.md, skills/prd-success-metrics/assets/success-metrics-template.md
Skills for defining personas (primary/secondary, job-to-be-done, constraints), product description (one-liner, surfaces, components, flows, boundaries), and success metrics (primary outcome, leading indicators, guardrails, per-persona targets) with templates.
PRD Technical Requirements, Custom Overviews, and Review
skills/prd-technical-requirements/SKILL.md, skills/prd-technical-requirements/assets/technical-requirements-template.md, skills/prd-custom-overview/SKILL.md, skills/prd-custom-overview/assets/custom-overview-template.md, skills/prd-review/SKILL.md
Skills for capturing technical constraints (performance, scale, reliability, security, compliance, integrations, platforms, accessibility, localization, observability, cost), authoring custom PRD documents beyond the defaults, and comprehensive PRD review/audit with per-document and cross-document consistency checks.
FRD initialization and authoring
skills/frd-getting-started/SKILL.md, skills/frd-write/SKILL.md, skills/frd-write/assets/frd-template.md
Skills for scaffolding Feature Requirements Documents with parent/child hierarchy and prefix assignment, and for authoring individual FRDs with stable REQ/AC ID schemes, requirements/acceptance criteria discovery, and parent linking.
FRD review and restructuring
skills/frd-review/SKILL.md, skills/frd-split/SKILL.md
Skills for auditing FRDs with per-document checklists and cross-FRD consistency checks, and for refactoring FRDs using parent-delivers-value rule to split parents into children and reassign requirements with ID renumbering.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

  • TrogonStack/agentskills#45: Documents the scaffold-plugin skill workflow that was used to wire this plugin entry into the marketplace configuration and release system.

Poem

🐇 A product requirements hutch, so neat and organized,
With PRDs and FRDs, all systematized!
From business problems down to feature needs,
Each skill a carrot, each template a seed. 🥕📋

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and specifically summarizes the main change: introducing PRD and FRD authoring skills as a new plugin.
Description check✅ PassedThe description is directly related to the changeset, explaining the motivation for the new product-requirements plugin and its purpose in the TrogonStack ecosystem.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch add-prd

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 15

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@plugins/trogonstack-product-requirements/.claude-plugin/plugin.json`:
- Line 3: Update the "description" value in plugin.json so it mentions both
Product Requirements Documents (PRDs) and Functional Requirements Documents
(FRDs) to match the README/marketplace; locate the "description" property in
plugins/trogonstack-product-requirements/.claude-plugin/plugin.json and change
its text from only referencing PRDs to something inclusive like "Skills for
writing and reviewing Product Requirements Documents (PRDs) and Functional
Requirements Documents (FRDs)" ensuring wording matches other metadata entries.
In `@plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md`:
- Around line 82-88: The fenced code block showing the directory tree (the block
containing ".trogonai/project/{projectid}/frd/{parent-slug}/", "index.frd.md",
"{child-1-slug}.frd.md", etc.) lacks a language specifier and triggers MD040;
fix it by adding a language label (e.g., text) after the opening triple
backticks in SKILL.md so the block begins with ```text and leave the tree
contents unchanged.
In `@plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md`:
- Around line 160-181: The markdown fenced code blocks in SKILL.md around the
REQ-CHK-003 examples are unlabeled and trigger markdownlint MD040; update both
fenced blocks that contain the "REQ-CHK-003: Payment Confirmation" good and "Bad
(reject this shape)" examples to include a language identifier (e.g.,
```markdown) at the opening backticks so the blocks become ```markdown ... ```
and ensure the closing backticks remain unchanged; search for the REQ-CHK-003
code examples in the file to locate the exact blocks to modify.
In
`@plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md`:
- Line 93: Several fenced code blocks in SKILL.md use plain ``` markers without
a language tag (e.g., the examples that start with the "## The Problem"
heading), which triggers MD040; update each triple-backtick fence to include a
language identifier (use "markdown" for these prose examples) so they become
```markdown ... ```, and apply the same change to the other affected fence near
the second "## The Problem" instance; search for plain ``` fences around those
headings and replace them with ```markdown to satisfy markdownlint and keep
tooling consistent.
In
`@plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md`:
- Around line 17-20: Add a blank line between the "## Cost of the status quo"
heading and the table to satisfy MD058; locate the heading text "## Cost of the
status quo" and insert one empty line before the table rows starting with "|
Cost | Measure | Source |".
In `@plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md`:
- Line 83: Two fenced code blocks around the "How the job gets done today"
examples are missing a language tag (triggers markdownlint MD040); update each
opening triple-backtick fence to include a language (e.g., change ``` to
```markdown) for both example blocks so the fences read ```markdown, keeping the
existing block content unchanged and preserving both occurrences of the "How the
job gets done today" example sections.
In
`@plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md`:
- Around line 100-121: The two fenced example blocks in SKILL.md (the one
starting with the "Rollout Strategy" heading and the "Misc Notes" block) are
missing language identifiers which triggers MD040; update both opening
triple-backtick fences to include the markdown language tag (```markdown) so the
linter passes and the examples are explicitly marked as Markdown.
In `@plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md`:
- Line 90: The fenced code blocks in SKILL.md around the headings "## Primary:
Mid-market Account Executive" and "## Primary: Sales user" lack language
identifiers and trigger markdownlint MD040; update the opening triple-backtick
fences for those two examples to include "markdown" (i.e., change ``` to
```markdown) so both example fences are annotated and the linter warning is
resolved.
In
`@plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md`:
- Line 100: Two fenced example blocks around the "One-liner" headings are
missing language identifiers and trigger markdownlint MD040; edit the two fenced
code blocks that contain the "## One-liner" examples and change their opening
fences from ``` to ```markdown so both example blocks explicitly declare the
markdown language (apply this to both occurrences noted in the file).
- Line 57: The markdown heading "Boundaries (what the product is NOT**" has
unbalanced emphasis and a missing closing parenthesis; update the text in
SKILL.md so the bold and parentheses are balanced, e.g., change the fragment to
"Boundaries (what the product is NOT)" and wrap the whole label in bold as
"**Boundaries (what the product is NOT)**" so the emphasis and parentheses are
correctly closed.
In `@plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md`:
- Around line 38-46: The fenced filesystem tree in SKILL.md is missing a
language identifier, causing MD040; update the opening fence for the snippet
that shows ".trogonai/project/{projectid}/prd/" to use a language specifier (use
text) so the block becomes "```text" instead of "```" and keep the closing fence
unchanged; locate the snippet in SKILL.md and add the word "text" immediately
after the opening triple backticks.
In
`@plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md`:
- Around line 6-20: The markdown violates MD058 because the tables are not
surrounded by blank lines; update each section (headers "## Primary outcome
metric", "## Leading indicators", and "## Guardrail metrics (must not regress)")
by inserting a blank line immediately after the heading and another blank line
after the table block so that each table is preceded and followed by an empty
line.
In
`@plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md`:
- Around line 105-148: The MD040 lint is triggered because the fenced code
blocks in SKILL.md lack a language tag; edit the example fences around the
primary outcome/leading/guardrail/decision rules examples and add "md" to each
opening triple-backtick (i.e., change ``` to ```md) so the examples are
explicitly marked as Markdown and the linter no longer flags MD040.
In
`@plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md`:
- Around line 6-37: The markdown linter MD058 complains because the tables under
the "## Performance" and "## Integrations" sections need surrounding blank
lines; modify the template so there is an empty line before and after each table
block (the Performance table starting under "## Performance" and the
Integrations table under "## Integrations") to satisfy MD058 while preserving
the header and table rows.
In
`@plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md`:
- Around line 145-188: Add the language tag "md" to both fenced-code blocks that
start with the "## Performance" headings (the detailed example block and the
"Bad" example block) so they read as ```md ... ```; update the opening backticks
for the first large example and the second "Bad" example to include md to
satisfy the MD040 lint rule and ensure proper rendering.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1fe25eee-8570-4849-8204-2d580dfed1c9

📥 Commits

Reviewing files that changed from the base of the PR and between eace11b and 41f0a1f.

📒 Files selected for processing (27)
  • .claude-plugin/marketplace.json
  • .github/release-please-config.json
  • .github/release-please-manifest.json
  • plugins/trogonstack-product-requirements/.claude-plugin/plugin.json
  • plugins/trogonstack-product-requirements/README.md
  • plugins/trogonstack-product-requirements/skills/frd-getting-started/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-split/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/SKILL.md
  • plugins/trogonstack-product-requirements/skills/frd-write/assets/frd-template.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-business-problem/assets/business-problem-template.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-current-state/assets/current-state-template.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-custom-overview/assets/custom-overview-template.md
  • plugins/trogonstack-product-requirements/skills/prd-getting-started/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-personas/assets/personas-template.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-product-description/assets/product-description-template.md
  • plugins/trogonstack-product-requirements/skills/prd-review/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-success-metrics/assets/success-metrics-template.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/SKILL.md
  • plugins/trogonstack-product-requirements/skills/prd-technical-requirements/assets/technical-requirements-template.md
  • plugins/trogonstack-product-requirements/skills/requirements-operating-model/SKILL.md

Comment threadplugins/trogonstack-product-requirements/.claude-plugin/plugin.json Outdated
Comment threadplugins/trogonstack-product-requirements/skills/frd-split/SKILL.md Outdated
Comment threadplugins/trogonstack-product-requirements/skills/frd-write/SKILL.md Outdated
Comment threadplugins/trogonstack-product-requirements/skills/prd-review/SKILL.md Outdated
…larify scope
Lint violations made the plugin look untrustworthy to anyone running standard markdown tooling, and the plugin description omitted FRDs even though the catalog markets both PRD and FRD authoring.
Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@yordis
yordis merged commit 207ddb1 into mainMay 26, 2026
4 checks passed
@yordis
yordis deleted the add-prd branch May 26, 2026 20:18
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@yordis