feat(openprd): implement the OpenPRD standard — engine, CLI, conformance bundle (#100)

OpenPRD has existed as a document (docs/openprd.md), a front-matter schema, a
template, and this repo's prd/ collection. Nothing enforced it. This adds the
reference implementation.

@logicsrc/openprd
  - parser: front-matter + the eight `##` sections + numbered requirements.
    `###` stays content so a long Requirements section can be organized, and
    headings or R#-shaped lines inside code fences are ignored
  - validation splits the standard's four conformance rules (filename,
    front-matter schema, id-matches-prefix, eight sections in order) from
    lint (empty section, missing priority tag, numbering gaps, duplicate R#,
    date order, one-sided supersession, stale index). Conformance failures are
    errors; --strict promotes the rest. Stable codes, file, line, hint
  - collection rules the per-file view cannot see: unique ids, monotonic
    numbering with no gaps, 0000 reserved for the template, cross-references
    that resolve
  - lifecycle enforced rather than advisory: Draft cannot jump to Final,
    terminal statuses do not resume, Superseded must name its replacement
  - deterministic index generation, so `prd index` is idempotent and CI can
    diff it
  - front-matter rewriting that leaves the body byte-identical
  - the optional LogicSRC task bridge the standard describes: each R# becomes
    one logicsrc.task, validated against logicsrc-task.schema.json before it
    is emitted; creator DID derived from the author email

CLI: logicsrc prd init|new|list|show|validate|lint|index|status|next|tasks|
export. Exit codes stable for CI (0 ok, 1 invalid, 2 usage, 3 not found).

Conformance bundle: packages/schemas/fixtures/openprd/ — 6 documents that must
validate and 12 that must fail, each naming the error code it must produce.
Several rules depend on the filename, so every fixture records the name it is
validated as.

Docs: an Implementation section in docs/openprd.md (CLI, validation model,
task bridge, conformance bundle), the spec added to the site's docs surface,
nav and sitemap entries, and a README section.

Verification: 76 new tests; full monorepo build and all 451 workspace tests
pass. The suite dogfoods this repo — prd/ validates with zero errors and zero
warnings, the embedded template is byte-identical to docs/openprd/0000-
template.md, and all 210 requirements in PRD 0001 map to schema-valid tasks.
prd/README.md is regenerated by the tool it now ships.

Refs: docs/openprd.md

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: ralyodio

README.md

@@ -15,6 +15,7 @@ apps/
 packages/
   cli                logicsrc OpenSpec CLI
   openontology       OpenOntology reference engine (entities, claims, queries, change sets)
+  openprd            OpenPRD reference implementation (numbered PRDs, lifecycle, task bridge)
   logicsrc-mcp       @profullstack/logicsrc-mcp standards MCP server
   sdk                SDK contract types and helpers
   tui                terminal UI
@@ -52,6 +53,24 @@ npm --workspace @profullstack/logicsrc-mcp run build
 node packages/logicsrc-mcp/dist/index.js
 ```
 
+## OpenPRD
+
+[OpenPRD](docs/openprd.md) is a lightweight standard for product requirements documents: a repo
+keeps a numbered, committed collection under `prd/`, one Markdown file each, with front-matter, a
+fixed set of eight sections, and a lifecycle. `@logicsrc/openprd` implements it.
+
+```bash
+npm --workspace @logicsrc/cli run dev -- prd new "Expand the parked-domain service"
+npm --workspace @logicsrc/cli run dev -- prd validate ./prd --strict
+npm --workspace @logicsrc/cli run dev -- prd status 0001 Review
+npm --workspace @logicsrc/cli run dev -- prd tasks 0001 --priority P0
+```
+
+Conformance failures (filename, front-matter, id match, the eight sections in order) are errors;
+lint findings are warnings that `--strict` promotes. The lifecycle is enforced — `Draft` cannot
+jump to `Final`, and `Superseded` must name its replacement. `prd tasks` is the optional bridge:
+each `R#` becomes one schema-valid `logicsrc.task`.
+
 ## OpenOntology
 
 [LogicSRC OpenOntology](docs/openontology.md) is an open contract for durable, source-backed domain

apps/logicsrc-web/src/app/sitemap.ts

@@ -17,6 +17,7 @@ const STATIC_ROUTES: Array<{
   { path: "/", changeFrequency: "weekly", priority: 1.0 },
   { path: "/docs", changeFrequency: "weekly", priority: 0.9 },
   { path: "/openontology", changeFrequency: "weekly", priority: 0.9 },
+  { path: "/docs/openprd", changeFrequency: "weekly", priority: 0.8 },
   { path: "/openspec", changeFrequency: "weekly", priority: 0.8 },
   { path: "/agent-swarm", changeFrequency: "weekly", priority: 0.8 },
   { path: "/agentbyte", changeFrequency: "weekly", priority: 0.8 },

apps/logicsrc-web/src/components/site-shell.tsx

@@ -9,6 +9,7 @@ const NAV: Array<{ href: string; label: string; external?: boolean }> = [
   { href: "/agentbyte", label: "AgentByte" },
   { href: "/credential-sharing", label: "Credentials" },
   { href: "/openontology", label: "OpenOntology" },
+  { href: "/docs/openprd", label: "OpenPRD" },
   { href: "/#cli", label: "CLI" },
   { href: "/docs", label: "Docs" },
   { href: "/blog", label: "Blog" },

apps/logicsrc-web/src/lib/docs.ts

@@ -8,6 +8,7 @@ const DOCS_DIR = resolve(process.cwd(), "../../docs");
 // Curated, public-facing reference docs. Internal notes (roadmap, positioning,
 // arcade) are intentionally excluded.
 export const DOC_SLUGS = [
+  "openprd",
   "openontology",
   "openontology-governance",
   "openontology-interoperability",

apps/logicsrc-web/src/lib/page-markup.ts

@@ -126,6 +126,7 @@ export function renderPageMarkup(): string {
         <a href="/agentbyte">AgentByte</a>
         <a href="/credential-sharing">Credentials</a>
         <a href="/openontology">OpenOntology</a>
+        <a href="/docs/openprd">OpenPRD</a>
         <a href="#cli">CLI</a>
         <a href="/docs">Docs</a>
         <a href="/blog">Blog</a>

docs/openprd.md

@@ -4,7 +4,7 @@ OpenPRD is a lightweight, open standard for **product requirements documents** a
 
 It borrows the shape of a BIP/EIP/DIP process: a repo keeps a **numbered, committed collection** of PRDs under `prd/`, each one a single Markdown file with a fixed set of sections and a lifecycle. Where [OpenSpec](./openspec-comparison.md) models a *change* as a multi-file bundle, OpenPRD models a *product decision* as **one numbered file** you can read a year from now to recover the *why*.
 
-Tools such as the moshcode CLI consume this standard to publish PRDs into whatever repo you're working in.
+Tools such as the moshcode CLI consume this standard to publish PRDs into whatever repo you're working in. LogicSRC ships its own reference implementation — see [Implementation](#implementation).
 
 ## When to write one
 
@@ -87,6 +87,54 @@ See [`0000-template.md`](./openprd/0000-template.md) for the copy-paste template
 
 OpenPRD is intentionally decoupled from the rest of LogicSRC: a PRD is just a file and needs no service to exist. When coordination is wanted, a PRD's `Requirements` map cleanly onto LogicSRC `task` documents (each `R#` → one task), and `owner`/`repo` reuse LogicSRC identity and repo conventions. That bridge is optional and lives in tooling, not in this standard.
 
+## Implementation
+
+`@logicsrc/openprd` is the reference implementation, exposed through the LogicSRC CLI. A PRD is
+still just a file: nothing below is required for a document to conform.
+
+```bash
+logicsrc prd init                      # create prd/ with the template and an index
+logicsrc prd new "Expand the service"  # next free number, filled front-matter, eight stub sections
+logicsrc prd list                       # id, title, status, tags, requirement count
+logicsrc prd show 0001                  # front-matter, sections, and parsed requirements
+logicsrc prd validate --strict          # conformance + lint, exit 1 on error
+logicsrc prd index --write              # regenerate prd/README.md from what is on disk
+logicsrc prd status 0001 Review         # lifecycle move, refusing illegal transitions
+logicsrc prd tasks 0001                 # the optional LogicSRC task bridge
+```
+
+Validation separates the four conformance rules below from lint. Conformance failures are errors;
+everything else — an empty section, a requirement with no priority tag, numbering that skips, a
+stale index, a one-sided supersession link — is a warning or a note, and `--strict` promotes them.
+Findings carry stable codes (`OP-C-SECTION-ORDER`, `OP-L-REQ-DUPLICATE`, …), the file, the line,
+and a remediation hint. Exit codes: `0` ok, `1` invalid, `2` usage, `3` not found.
+
+The lifecycle is enforced rather than advisory: `Draft` cannot jump to `Final`, terminal statuses
+do not resume, and moving to `Superseded` requires naming the PRD that replaces it.
+
+Requirement numbering, id uniqueness, and "no gaps" are checked across the whole collection, not
+just per file — a repo with `0001` and `0003` and no `0002` fails.
+
+### Task bridge
+
+The optional mapping described above lives in tooling:
+
+```bash
+logicsrc prd tasks 0001 --priority P0 --format ndjson
+```
+
+Each `R#` becomes one `logicsrc.task` document, validated against `logicsrc-task.schema.json`
+before it is emitted. The board defaults to `/prd/<id>`, `repo` carries over to `github_repo`, and
+the creator DID is derived from the first author (`anthony@profullstack.com` →
+`anthony.profullstack`) unless `--creator` says otherwise.
+
+### Conformance bundle
+
+`packages/schemas/fixtures/openprd/` holds fixtures a third-party implementation can run:
+`conformance.json` lists documents that must validate and documents that must fail, each with the
+error code it must produce. Because several rules depend on the filename, each fixture records the
+name it must be validated as.
+
 ## Conformance
 
 A document conforms to OpenPRD `0.2` when:

package-lock.json

@@ -12,14 +12,14 @@
     "apps/*"
   ],
   "scripts": {
-    "build": "npm --workspace @logicsrc/schemas run build && npm --workspace @logicsrc/validators run build && npm --workspace @logicsrc/sdk run build && npm --workspace @logicsrc/agentad run build && npm --workspace @logicsrc/ans run build && npm --workspace @logicsrc/plugin-core run build && npm --workspace @logicsrc/agentstack run build && npm --workspace @logicsrc/agentswarm run build && npm --workspace @logicsrc/account-core run build && npm --workspace @logicsrc/plugin-coinpay run build && npm --workspace @logicsrc/plugin-ugig run build && npm --workspace @logicsrc/plugin-sh1pt run build && npm --workspace @logicsrc/plugin-c0mpute run build && npm --workspace @logicsrc/plugin-feed-discovery run build && npm --workspace @logicsrc/plugin-social-accounts run build && npm --workspace @logicsrc/plugin-email-accounts run build && npm --workspace @logicsrc/plugin-agentgit run build && npm --workspace @logicsrc/plugin-agentmail run build && npm --workspace @logicsrc/plugin-credential-sharing run build && npm --workspace @logicsrc/openontology run build && npm --workspace @logicsrc/tui run build && npm --workspace @logicsrc/cli run build && npm --workspace @profullstack/logicsrc-mcp run build && npm --workspace @logicsrc/commandboard-api run build && npm --workspace @logicsrc/commandboard-web run build && npm --workspace @logicsrc/web run build",
+    "build": "npm --workspace @logicsrc/schemas run build && npm --workspace @logicsrc/validators run build && npm --workspace @logicsrc/sdk run build && npm --workspace @logicsrc/agentad run build && npm --workspace @logicsrc/ans run build && npm --workspace @logicsrc/plugin-core run build && npm --workspace @logicsrc/agentstack run build && npm --workspace @logicsrc/agentswarm run build && npm --workspace @logicsrc/account-core run build && npm --workspace @logicsrc/plugin-coinpay run build && npm --workspace @logicsrc/plugin-ugig run build && npm --workspace @logicsrc/plugin-sh1pt run build && npm --workspace @logicsrc/plugin-c0mpute run build && npm --workspace @logicsrc/plugin-feed-discovery run build && npm --workspace @logicsrc/plugin-social-accounts run build && npm --workspace @logicsrc/plugin-email-accounts run build && npm --workspace @logicsrc/plugin-agentgit run build && npm --workspace @logicsrc/plugin-agentmail run build && npm --workspace @logicsrc/plugin-credential-sharing run build && npm --workspace @logicsrc/openontology run build && npm --workspace @logicsrc/openprd run build && npm --workspace @logicsrc/tui run build && npm --workspace @logicsrc/cli run build && npm --workspace @profullstack/logicsrc-mcp run build && npm --workspace @logicsrc/commandboard-api run build && npm --workspace @logicsrc/commandboard-web run build && npm --workspace @logicsrc/web run build",
     "start": "npm --workspace @logicsrc/web run start",
     "test": "npm run test --workspaces --if-present",
     "check": "npm run build && npm run test",
     "schemas:validate": "npm --workspace @logicsrc/validators run validate:fixtures",
     "test:contract": "npm --workspace @logicsrc/commandboard-api run test:contract && npm --workspace @logicsrc/web run test:contract",
     "test:e2e": "npm --workspace @logicsrc/commandboard-web run test:e2e && npm --workspace @logicsrc/web run test:e2e",
-    "build:cli": "npm --workspace @logicsrc/schemas run build && npm --workspace @logicsrc/validators run build && npm --workspace @logicsrc/plugin-core run build && npm --workspace @logicsrc/account-core run build && npm --workspace @logicsrc/plugin-coinpay run build && npm --workspace @logicsrc/plugin-ugig run build && npm --workspace @logicsrc/plugin-feed-discovery run build && npm --workspace @logicsrc/plugin-social-accounts run build && npm --workspace @logicsrc/plugin-email-accounts run build && npm --workspace @logicsrc/plugin-credential-sharing run build && npm --workspace @logicsrc/openontology run build && npm --workspace @logicsrc/tui run build && npm --workspace @logicsrc/cli run build"
+    "build:cli": "npm --workspace @logicsrc/schemas run build && npm --workspace @logicsrc/validators run build && npm --workspace @logicsrc/plugin-core run build && npm --workspace @logicsrc/account-core run build && npm --workspace @logicsrc/plugin-coinpay run build && npm --workspace @logicsrc/plugin-ugig run build && npm --workspace @logicsrc/plugin-feed-discovery run build && npm --workspace @logicsrc/plugin-social-accounts run build && npm --workspace @logicsrc/plugin-email-accounts run build && npm --workspace @logicsrc/plugin-credential-sharing run build && npm --workspace @logicsrc/openontology run build && npm --workspace @logicsrc/openprd run build && npm --workspace @logicsrc/tui run build && npm --workspace @logicsrc/cli run build"
   },
   "devDependencies": {
     "@types/node": "^24.10.1",

package.json

@@ -16,6 +16,7 @@
   "dependencies": {
     "@logicsrc/account-core": "file:../account-core",
     "@logicsrc/openontology": "file:../openontology",
+    "@logicsrc/openprd": "file:../openprd",
     "@logicsrc/plugin-coinpay": "file:../../plugins/coinpay",
     "@logicsrc/plugin-core": "file:../plugin-core",
     "@logicsrc/plugin-credential-sharing": "file:../../plugins/credential-sharing",

packages/cli/package.json

@@ -28,6 +28,7 @@ import { print, type OutputFormat } from "./format.js";
 import { parsePositiveInteger } from "./numeric-options.js";
 import { exportOpenSpecSummary, importOpenSpec, writeOpenSpecChange } from "./openspec.js";
 import { registerOntologyCommands } from "./ontology.js";
+import { registerPrdCommands } from "./prd.js";
 import { defaultPluginRegistry } from "./registry.js";
 
 process.stdout.on("error", (error: NodeJS.ErrnoException) => {
@@ -831,6 +832,7 @@ async function runYoloArcade(game: string, repo?: string) {
 }
 
 registerOntologyCommands(program);
+registerPrdCommands(program);
 
 program.parseAsync(process.argv).catch((error: unknown) => {
   console.error(error instanceof Error ? error.message : String(error));