blueprint-sync-idslisted

Scan all PRDs, ADRs, PRPs, and work-orders, assign IDs to documents missing them, and update the manifest registry. ## When to Use This Skill | Use this skill when... | Use blueprint-sync instead when... | |---|---| | You're assigning PRD-NNN / ADR-NNNN / PRP-NNN / WO-NNN to docs missing them | You want to detect modified or stale generated content (not IDs) | | You're previewing ID assignments with `--dry-run` | You're reconciling drift between `.claude/rules/` and the manifest | | You want to create GitHub issues for orphan docs via `--link-issues` | Use document-linking instead for runtime cross-doc traceability | ## Flags | Flag | Description | |------|-------------| | `--dry-run` | Preview changes without modifying files | | `--link-issues` | Also create GitHub issues for orphan documents | ## Prerequisites - Blueprint initialized (`docs/blueprint/manifest.json` exists) - At least one document exists in `docs/prds/`, `docs/adrs/`, `docs/prps/`, or `docs/blueprint/work-orders/` ## Steps ### Step 1: Initialize ID Registry Check if `id_registry` exists in manifest: ```bash jq -e '.id_registry' docs/blueprint/manifest.json >/dev/null 2>&1 ``` If not, initialize it: ```json { "id_registry": { "last_prd": 0, "last_prp": 0, "documents": {}, "github_issues": {} } } ``` ### Step 2: Run the read-only ID audit Run the helper. It owns the read-only scan: frontmatter `id:` extraction across PRDs/ADRs/PRPs/work-orders, deriving the expected `ADR-NNNN`