# To Prd

> Turn the current conversation context into a PRD and save it. Use when user wants to create a PRD from the current context.

- **Type:** Skill
- **Install:** `agentstack add skill-adrianfernandezalv-skills-to-prd`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [adrianfernandezalv](https://agentstack.voostack.com/s/adrianfernandezalv)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [adrianfernandezalv](https://github.com/adrianfernandezalv)
- **Source:** https://github.com/adrianfernandezalv/skills/tree/main/skills/engineering/to-prd

## Install

```sh
agentstack add skill-adrianfernandezalv-skills-to-prd
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

This skill takes the current conversation context and codebase understanding and produces a PRD. Do NOT interview the user — just synthesize what you already know.

## Output backends

The PRD is written to one backend, selected by `output:` in the project's `CLAUDE.local.md`:

- **`output: github`** — default when the key is absent. Personal projects. The PRD becomes a **GitHub tracking issue** (the "Epic"), labelled `epic`, with the PRD as the issue body.
- **`output: jira`** — work projects. The PRD becomes the **description** of a Jira ticket.
- **`output: inkdrop`** — the PRD becomes a note in the project's `Spec` notebook.

If `output:` names a backend not listed here, stop and tell the user: `backend  not supported; supported: github, jira, inkdrop`.

## Setup

1. Read `CLAUDE.local.md` at the project root to determine the backend (default `github`).
2. Look for an existing PRD to update instead of duplicating:
   - **github**: `gh issue list --label epic --search ""`.
   - **jira**: check for an existing Jira ticket and fetch it for context.
   - **inkdrop**: `search-notes` for an existing Spec note.

## Process

1. Explore the repo to understand the current state of the codebase, if you haven't already. Use the project's domain glossary vocabulary throughout the PRD, and respect any ADRs in the area you're touching.

2. Sketch out the major modules you will need to build or modify. Actively look for opportunities to extract deep modules that can be tested in isolation.

A deep module (as opposed to a shallow module) is one which encapsulates a lot of functionality in a simple, testable interface which rarely changes.

Check with the user that these modules match their expectations, and which modules they want tests written for.

3. Write the PRD using the template below, then save it following the publish rules.

## Overview

The problem the user is facing and the context, from the user's perspective. 2-4 sentences.

## Goals

- The outcomes this delivers.

## Non-goals

What is explicitly out of scope for this PRD.

## Solution

The solution to the problem, from the user's perspective.

## User Stories

A LONG, numbered list of user stories, in the format:

1. As an , I want a , so that 

This list should be extensive and cover all aspects of the feature.

## Implementation Decisions

Modules to build/modify, their interfaces, technical clarifications, architectural decisions, schema changes, API contracts, specific interactions.

Do NOT include specific file paths or code snippets — they go stale fast. Exception: if a prototype produced a snippet that encodes a decision more precisely than prose can (state machine, reducer, schema, type shape), inline it within the relevant decision and note it came from a prototype. Trim to the decision-rich parts.

## Testing Decisions

What makes a good test (test external behavior, not implementation details), which modules will be tested, and prior art for the tests in the codebase.

## Open questions

- [ ] Anything unresolved.

## Tasks

_(populated by /to-issues after breakdown)_

## References

Links to related issues, PRs, ADRs, or external docs.

## Publish

### github (default)

1. Ensure the `epic` label exists (create on-demand, ignore error if present):
   `gh label create epic --color 5319E7 --description "Tracking issue / PRD" 2>/dev/null || true`
2. Write the PRD body to a temp file. The Epic does **not** get a milestone (it may span releases).
3. If an Epic already exists for this feature: `gh issue edit  --body-file `.
   Otherwise: `gh issue create --label epic --title "" --body-file `.
4. Report the created/updated issue number — `/to-issues` will attach sub-issues to it.

### jira

- If a Jira ticket already exists: update the ticket **description** with the PRD. Never add it as a comment.
- If no ticket exists: create one via the Jira MCP tools with the PRD as the description.
- Do **not** create a parallel note for the PRD.

### inkdrop

- Find the project's `Spec` notebook (under the project notebook in Solo Dev) via `list-notebooks`.
- If a Spec note exists for this feature: update it. Otherwise create one. Title = feature name, no type/release tags, status = `none`.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [adrianfernandezalv](https://github.com/adrianfernandezalv)
- **Source:** [adrianfernandezalv/skills](https://github.com/adrianfernandezalv/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-adrianfernandezalv-skills-to-prd
- Seller: https://agentstack.voostack.com/s/adrianfernandezalv
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
