# Repo Harness Prd

> Repo Harness Prd is an Agent Skill for productivity published in the Ancienttwo/repo-harness repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Generates an AI-implementation-friendly PRD from a product idea into plans/prds/, with tiered sections, evidence rules, and sprint-consumable structure.

- Skill name: `repo-harness-prd`
- Category: [Productivity](https://www.openparable.com/skill/productivity/1)
- Source: https://github.com/Ancienttwo/repo-harness/blob/HEAD/assets/skill-commands/repo-harness-prd/SKILL.md
- Repository: Ancienttwo/repo-harness (392 GitHub stars when collected)

## SKILL.md

# repo-harness-prd

Use this command to generate an upper-layer PRD under `plans/prds/`. The PRD is product intent and implementation guidance; it is not a Sprint backlog and does not start task execution. Activate `$geju` before drafting so the PRD starts from a high-altitude direction judgment. Prefer Claude CLI (`claude -p --model opus`) for PRD drafting; use Codex only as a fallback when Claude is unavailable, fails, or the user explicitly asks for Codex.

## Protocol

1. Confirm the working repo with `git rev-parse --show-toplevel`; read `docs/spec.md`, `.ai/harness/policy.json`, and the PRD template from `.prds.template_file` when present, otherwise `.claude/templates/prd.template.md`.
2. Accept a one-line or vague product idea and default to writing the PRD. Ask only when the answer would materially change platform, safety, legal risk, budget, data ownership, or scope tier.
3. Choose `compact` by default. Use `standard` only for multi-module products, explicit user request, commercialization, or frontend/backend deepening.
4. Activate `$geju` for a direction pass before PRD drafting. Produce a compact geju framing with Thesis, High-格局 Direction, Bold Takes, What Not To Do, First Proof Point, and Falsifier. This framing is input to the PRD, not a replacement for the PRD.
5. Apply the prior-art trigger rule before assembling the prompt: triggers are UI/taste decisions, market-convention patterns, library/framework selection, architecture precedent, or any `[UNVERIFIED]` external assumption. On a hit, `## Adjacent Patterns` becomes required for this PRD — name concrete mature components or projects with an adopt/port/wrap-vs-build reason, or cite an existing `docs/researches/<file>` report — and route new research through the existing `sidecar_research` mechanism (policy default true). Exempt pure bugfix ideas, pure internal-refactor ideas, and ideas where no trigger condition hits.
6. Apply the negative-scenario rule for every P0 module: `## Acceptance Scenarios` must carry at least one negative or non-goal scenario per P0 module — a Given/When/Then that asserts what must NOT happen — tied to an entry in `## Non-goals`.
7. Prepare a Claude prompt that includes the product idea, repo path, relevant `docs/spec.md` excerpt, PRD template path/content, selected tier, output language, evidence rules, non-goals, target filename, the `$geju` framing, and the prior-art/negative-scenario decisions from steps 5-6. Tell Claude to apply that framing and return complete PRD Markdown only, not implementation code.
8. Prefer Claude for PRD drafting: if `command -v claude` succeeds, run `claude -p --model opus "$(<prompt-file>)"` or an equivalent safely quoted prompt invocation. Capture stdout as the PRD draft. The current agent still owns writing the file, fixing validation failures, and reporting the result.
9. Use Codex fallback only when Claude CLI is missing, exits non-zero, returns an unusable PRD, or the user explicitly asks for Codex. Reuse the same `$geju` framing and prompt, and disclose the fallback reason in the final response.
10. Write a new `plans/prds/<YYYYMMDD>-<HHMM>-<slug>.prd.md`. Fill every core section; include optional sections only when tier or user request requires them, or when the prior-art trigger rule (step 5) makes `## Adjacent Patterns` required. Keep section headings in English and write body content in the user's language.
11. Use evidence rules: do not invent competitor facts, API behavior, platform limits, model capabilities, package sizes, or current market facts. Mark unverifiable details as `[UNKNOWN]` or `[UNVERIFIED]`.
12. Apply five canonical-term disciplines while drafting and reviewing the draft: challenge user or PRD terms against `docs/spec.md` `## Canonical Terms` and flag conflicts (for example, "spec defines X as A, this usage means B — which is correct?"); sharpen fuzzy or overloaded words into one canonical term before writing the section that depends on them; stress-test concept boundaries with concrete edge scenarios; cross-reference claimed behavior against existing code and cite the paths; record each newly resolved term inline into `docs/spec.md` `## Canonical Terms` as a one-line glossary entry, never implementation detail.
13. Inline response should include only the AI Quick-Read Card, the PRD file path, whether Claude or Codex fallback drafted the PRD, and the one-sentence `$geju` thesis; do not paste the full document.
14. Verify with `repo-harness run check-task-workflow --strict`. If verification fails, stop and fix the PRD instead of bypassing the check.
15. When the PRD carries a `## Frontend Perspective` section or the downstream work is expected to execute under the `frontend` task profile, first read `repo-harness docs show ux-feature-guard` and produce `docs/design/DESIGN-<slug>.md` from `.claude/templates/design-brief.template.md`. Fill the template's UX Feature Guard completely, including stable IDs for its positive, negative/non-goal, and authority-failure scenarios; do not restate or replace that field schema in the PRD. Then get explicit human confirmation against every Confirmation Checklist item before suggesting Sprint or contract execution — this gate carries the same weight as plan approval. imagegen-type skills (for example `imagegen-frontend-web`, `design-taste-frontend`) are optional preview enhancers for the brief, never a substitute for the checklist.
16. Suggest `repo-harness-sprint plan from-prd <prd-file>` only after the PRD exists and the user wants an ordered Sprint backlog.

## Failure Modes

- If `plans/prds/` is missing, report the missing catalog and route the user to `repo-harness-init` or `repo-harness-repair`.
- If the idea is a single ambiguous word with no product category, ask for one clarifying sentence before writing.
- If `$geju` is unavailable, still perform the same compact geju-style direction pass in the current agent and report the missing skill as a fallback condition.
- If `claude -p --model opus` fails or hangs, retry at most once with a smaller prompt; then fall back to Codex and report the fallback reason.
- If Claude returns prose, implementation steps, or an incomplete PRD instead of PRD Markdown, repair the draft locally or rerun once before falling back.
- If strict workflow verification rejects the PRD, stop and revise the PRD file before suggesting Sprint generation.
- If a matching PRD filename already exists, preserve it and create a new timestamped file.

## Boundaries

- Does not create or approve a Sprint backlog; that belongs to `repo-harness-sprint`.
- Does not edit `docs/spec.md` beyond appending resolved terms to `## Canonical Terms`; does not otherwise reinterpret repo product truth.
- Does not set `> **Status**: Approved`; the user must review and approve the PRD.
- Does not write outside `plans/prds/` except for verification artifacts produced by existing workflow checks or appending resolved terms to `docs/spec.md` `## Canonical Terms` per step 12.
- Does not skip the `$geju` direction pass; the PRD must carry a clear target model before section writing starts.
- Does not treat the `$geju` framing captured here as delegation authority: once this PRD's direction is delegated through a task contract, freeze the thesis/high-level direction into that contract's `## Why` and the falsifier/first proof point into `## Falsifier`; live geju is pre-contract exploration only, and the frozen contract governs after that.
- Does not make Codex the primary PRD author when Claude CLI is available and usable.
- Never fabricates facts for `Adjacent Patterns`; use adjacent workflow patterns or mark claims `[UNVERIFIED]`.

---

Source: https://www.openparable.com/skill/productivity/repo-harness-prd (OpenParable). Cite the canonical URL above.
