Pmstudio Nfr

NFR Tracker — Operational Readiness Auditor

Purpose

Meta-command that discovers all project documents, checks existence and freshness, and produces a readiness dashboard with prioritized recommendations for what to create or update next.

Process

Step 1: Detect Project Context

Read these files to understand the project:

1. CLAUDE.local.md — project name, type, architecture, folder structure
2. .sync-watch.json — registered documents and watch directories
3. Run ls -R on the project root to discover all files

Determine the product lifecycle stage from context:

• Ideate/Build — pre-production (DR/IRP not yet required)
• Production — live product (DR/IRP required)
• Mixed — some components live, some building (e.g., ProductA production + ProductB ideate)

Step 2: Scan Document Registry

Check for each document type. For each, record: exists (Y/N), path, last modified date, stale (Y/N based on threshold).

Document registry:

Staleness calculation: Compare file modification date to today. If (today - last_modified) > threshold, mark as STALE.

Search strategy: Use glob patterns first. If the project uses non-standard paths (from CLAUDE.local.md folder structure), adapt the search. Example: Some projects store PRDs in non-default paths like ProductB-Control-Framework/PRD/ not PRD/.

Step 3: Assess Completeness (Optional Deep Check)

If --deep flag or user requests "thorough check":

For each FOUND document, open it and check for key sections:

• PRD: Has executive summary, requirements, timeline, risks? Missing sections = partial.
• DR Plan: Has RTO/RPO targets, scenarios, procedures? Missing = partial.
• IRP: Has severity matrix, escalation contacts, playbooks? Missing = partial.

Without --deep, existence + freshness is sufficient.

Step 4: Generate Recommendations

Prioritize missing/stale documents:

Priority logic:

1. CRITICAL — Production product missing DR or IRP
2. HIGH — Any required document missing or stale >2x threshold
3. MEDIUM — Recommended document missing or stale >1x threshold
4. LOW — Optional document missing

Each recommendation includes:

• What to create/update
• Why it matters
• The slash command to run

Step 5: Output Report

Console output (default):

Copy code
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 NFR TRACKER ► READINESS REPORT — {Project Name}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Lifecycle: {Production / Ideate / Mixed}
Scanned: {timestamp}

| Document              | Status  | Path              | Updated    | Stale? |
|-----------------------|---------|-------------------|------------|--------|
| ...                   | FOUND   | ...               | YYYY-MM-DD | No     |
| ...                   | MISSING | —                 | —          | —      |
| ...                   | FOUND   | ...               | YYYY-MM-DD | STALE  |

Coverage: N/M ({pct}%)    Stale: N    Missing: N

Recommendations:
1. [{priority}] {description}
   → Run: /{command}
...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Markdown file output (with --format md):

Write to Operational/Readiness-Report-{YYYY-MM-DD}.md with the same content plus a header with project metadata.

Modes

• /nfr-tracker — Full audit, console output
• /nfr-tracker --format md — Write report to file
• /nfr-tracker --deep — Check document completeness, not just existence
• /nfr-tracker --scope {name} — Filter to a specific product/instance within the project

Critical Rules

1. Read-only. This skill never creates or modifies documents. It only reports.
2. Adapt paths. Don't assume standard folder structure. Read CLAUDE.local.md for actual paths.
3. No false positives. Only mark FOUND if the file has real content (>100 bytes). Empty scaffolds don't count.
4. Date accuracy. Use file system modification date, not content parsing, for freshness checks.