Skip to content
cccskills
FreePublished on GitHub

draft-prd

Draft or refine the project's PRD from the description and conversation

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md3.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Your task: Draft PRD

Produce or refine the project's PRD at .workhorse/projects/{hash}-{slug}/prd.md. The agent already knows the project's hash and slug from the workspace context.

This is the PRD-level equivalent of card-level Implement this — go straight to drafting from the project description and conversation history. Do not start by asking questions; produce a sensible structure even when no conversation has yet occurred.

Default scaffolding

Pick one starting shape based on the project's material:

  • Component-led — the project clearly contains multiple workstreams or sub-systems. Use ## headings per component, each with a short overview and bullets
  • Feature-led — the project is a single workflow or surface. Use ## headings per phase or area of the workflow
  • Mixed — components with sub-features. Top-level ## per component, ### per sub-feature

The opening section is always Overview — state the operator, workflow, technical, or user problem and the desired simplification. Two or three sentences, not a corporate paragraph.

Conventions

  • Sparse and concrete — write close to the shape of future cards. Bullets and sub-bullets, not long explanatory prose
  • Phrasing for unfilled detail — where the next layer of thinking belongs in card shaping, leave a direct line such as "detailed shape can be filled in during card shaping" rather than over-specifying
  • Optional sections only when supported — Permissions, Expected outcomes, Open questions appear only when the project material gives you something concrete to put under them. They are not default sections
  • Don't invent — no requirements, rollout notes, or prioritisation that weren't actually discussed
  • Real terminology — use the system's actual names and reference real workflows the conversation surfaced
  • Direct tone — no generic product-management phrasing or corporate-template language
  • Australian/NZ English spelling

How to run

  1. Read the project's description and any conversation history. Read the existing PRD content at .workhorse/projects/{hash}-{slug}/prd.md (it may be empty, mid-draft, or substantive)
  2. If the PRD already has substantive content, edit in place — refine, fill in gaps, tighten phrasing. Don't replace work that still applies
  3. If the PRD is empty or sparse, write a fresh draft using the appropriate scaffolding shape
  4. Briefly summarise what you produced and any open questions you couldn't resolve from the available material

Restrictions on this surface

You are working on the project surface, not a card workspace. Edits in this conversation may only touch the project's artefacts, all on the project branch:

  • .workhorse/projects/{hash}-{slug}/prd.md
  • .workhorse/projects/{hash}-{slug}/mockups/
  • .workhorse/projects/{hash}-{slug}/breakdown.md

Do not edit specs, per-card plans, test cases, card working docs, or any code. If the user asks for any of those, explain that the work belongs at card level — the user can either spawn a card via the breakdown and continue there, or open an existing card and work on it.

You may read anything from the workspace's main branch for context.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Check whether this card's code meets the acceptance criteria

The English summary is being prepared. Showing the original description.

beyondessential/tamanu9Updated Oct 20, 2026

Summarise the unit and e2e tests a branch/PR adds, run only those, and produce a paste-ready report (e.g. for a Linear card). Use when asked to 'summarise added tests', 'run the new tests', 'what tests did this PR add', or to prove a card's test coverage.

The English summary is being prepared. Showing the original description.

beyondessential/tamanu9Updated Oct 20, 2026

Run a quick UX/UI workshop using ASCII-art sketches

The English summary is being prepared. Showing the original description.

beyondessential/tamanu9Updated Oct 20, 2026

Write automated tests for unticked scenarios in this card's test cases

The English summary is being prepared. Showing the original description.

beyondessential/tamanu9Updated Oct 20, 2026

Review code changes on this card for likely bugs, regressions, and missed edges

The English summary is being prepared. Showing the original description.

beyondessential/tamanu9Updated Oct 20, 2026

Maintain a support docs pack — dedup, length budgets, and no splintering — and land changes as a reviewed pull request. Use when a support thread, or a hand-off from Support assist, surfaces a new resolution, a correction to an existing one, or a deployment quirk worth recording. Not for ordinary code changes.

The English summary is being prepared. Showing the original description.

beyondessential/tamanu9Updated Oct 20, 2026

See all skills by beyondessential

Report a problem with this skill