blueprint-init — Skillopedia

Initialize Blueprint Development in this project. When to Use This Skill | Use this skill when... | Use blueprint-upgrade instead when... | |---|---| | The project has no yet | The project already has a manifest at an older format version | | You're bootstrapping a new project's PRD/ADR/PRP directories | You're migrating v1.x→v2, v2→v3, or v3.x→v3.y | | You want to enable feature tracking and decision detection from scratch | Use blueprint-derive-plans to populate PRDs/ADRs/PRPs after init | | You're configuring task scheduling for the first time | Use blueprint-execute instead when you want…

\n ```\n\n **If documentation files found** (e.g., REQUIREMENTS.md, ARCHITECTURE.md, DESIGN.md, docs in non-standard locations):\n ```\n Use AskUserQuestion:\n question: \"Found existing documentation: {file_list}. Migrate these to Blueprint-managed paths? (Strongly recommended)\"\n options:\n - label: \"Yes, migrate documents (Recommended)\"\n description: \"Move docs into docs/prds/, docs/adrs/, docs/prps/ based on content type. Prevents stale and orphaned documents.\"\n - label: \"No, leave them in place\"\n description: \"Warning: unmigrated docs may become stale or duplicated as Blueprint creates its own documents\"\n ```\n\n **If \"Yes\" selected:**\n a. Analyze each file to determine type:\n - Contains requirements, features, user stories → `docs/prds/`\n - Contains architecture decisions, trade-offs → `docs/adrs/`\n - Contains implementation plans → `docs/prps/`\n - General documentation → `docs/`\n b. Move files to appropriate `docs/` subdirectory\n c. Rename to kebab-case if needed (REQUIREMENTS.md → requirements.md)\n d. Report migration results:\n ```\n Migrated documentation:\n - REQUIREMENTS.md → docs/prds/requirements.md\n - ARCHITECTURE.md → docs/adrs/0001-initial-architecture.md\n ```\n\n **If no documentation files found:** Skip this step silently.\n\n4. **Ask about maintenance task scheduling** (use AskUserQuestion):\n ```\n question: \"How should blueprint maintenance tasks run?\"\n options:\n - label: \"Prompt before running (Recommended)\"\n description: \"Always ask before running maintenance tasks like sync, validate\"\n - label: \"Auto-run safe tasks\"\n description: \"Read-only tasks (validate, sync, status) run automatically when due\"\n - label: \"Fully automatic\"\n description: \"All tasks run automatically on schedule, including writes like rule generation\"\n - label: \"Manual only\"\n description: \"Tasks only run when you explicitly invoke them\"\n ```\n\n Store selection for task_registry defaults:\n - **Prompt**: all `auto_run: false`, default schedules\n - **Auto-run safe**: read-only tasks (`adr-validate`, `feature-tracker-sync`, `sync-ids`) get `auto_run: true`; write tasks get `false`\n - **Fully automatic**: all tasks get `auto_run: true`, default schedules\n - **Manual only**: all `auto_run: false`, all schedules set to `on-demand`\n\n4a. **Ask about generated-rules output path** (use AskUserQuestion):\n\n Only prompt when `.claude/rules/` already exists and contains files (i.e., hand-authored rules that pre-date blueprint). Skip silently in fresh repos and use the default.\n\n ```bash\n # Only prompt if .claude/rules/ has any content not created by blueprint\n find .claude/rules -maxdepth 1 -type f -name '*.md'\n ```\n\n ```\n Use AskUserQuestion (only when .claude/rules/ has existing content):\n question: \"Detected existing content in .claude/rules/. Where should blueprint write generated rules?\"\n options:\n - label: \".claude/rules/blueprint/ (Recommended)\"\n description: \"Isolated subdirectory — keeps blueprint-managed and hand-authored rules separate, prevents collisions on regenerate\"\n - label: \".claude/rules/ (flat)\"\n description: \"Write generated rules alongside hand-authored ones; risk of overwrite when filenames collide\"\n ```\n\n Store the chosen path in `structure.generated_rules_path` in the manifest (defaults to `.claude/rules/` when unset). This keeps `blueprint-generate-rules` and `blueprint-derive-rules` from clobbering hand-curated rule files (issue #1043).\n\n5. **Ask about decision detection** (use AskUserQuestion):\n ```\n question: \"Would you like to enable automatic decision detection?\"\n options:\n - label: \"Yes - Detect decisions worth documenting\"\n description: \"Claude will notice when conversations contain architecture decisions, feature requirements, or implementation plans that should be captured as ADR/PRD/PRP documents\"\n - label: \"No - Manual commands only\"\n description: \"Use /blueprint:derive-plans, /blueprint:prp-create explicitly when you want to create documents\"\n ```\n\n Set `has_document_detection` in manifest based on response.\n\n **If enabled:**\n Copy `document-management-rule.md` template to `.claude/rules/document-management.md`.\n This rule instructs Claude to watch for:\n - Architecture decisions being made during discussion → prompt to create ADR\n - Feature requirements being discussed or refined → prompt to create/update PRD\n - Implementation plans being formulated → prompt to create PRP\n\n6. **Create directory structure**:\n\n **Canonical document paths** are at the **top level** of `docs/`, not under `docs/blueprint/`. `docs/blueprint/` holds blueprint machinery only (manifest, feature-tracker, work-orders, ai_docs); `docs/{adrs,prds,prps,trps}/` hold the documents themselves. Every `/blueprint:derive-*` skill writes to the top-level paths — keeping them consistent prevents the dual-corpus bug where init creates one layout and derive-* writes to another.\n\n Execute the creation explicitly so the directories exist even when no document migration happened in Step 3:\n\n ```bash\n mkdir -p docs/blueprint/work-orders/completed\n mkdir -p docs/blueprint/work-orders/archived\n mkdir -p docs/blueprint/ai_docs/libraries\n mkdir -p docs/blueprint/ai_docs/project\n mkdir -p docs/adrs\n mkdir -p docs/prds\n mkdir -p docs/prps\n ```\n\n Note: `docs/trps/` is created on-demand by `/blueprint:derive-tests` only — init does not pre-create it.\n\n The resulting tree:\n ```\n docs/\n ├── blueprint/\n │ ├── manifest.json # Version tracking and configuration\n │ ├── feature-tracker.json # Progress tracking (if enabled)\n │ ├── work-orders/ # Task packages for subagents\n │ │ ├── completed/\n │ │ └── archived/\n │ ├── ai_docs/ # Curated documentation (on-demand)\n │ │ ├── libraries/\n │ │ └── project/\n │ └── README.md # Blueprint documentation\n ├── prds/ # Product Requirements Documents (canonical)\n ├── adrs/ # Architecture Decision Records (canonical)\n ├── prps/ # Product Requirement Prompts (canonical)\n └── trps/ # Test Regression Plans (created on-demand by /blueprint:derive-tests)\n ```\n\n **Claude configuration (in .claude/):**\n ```\n .claude/\n ├── rules/ # Modular rules (including generated)\n │ ├── development.md # Development workflow rules\n │ ├── testing.md # Testing requirements\n │ └── document-management.md # Document organization rules (if detection enabled)\n └── skills/ # Custom skill overrides (optional)\n ```\n\n7. **Create `manifest.json`** (v3.3.0 schema — canonical filename is `docs/blueprint/manifest.json`, no dot prefix):\n ```json\n {\n \"format_version\": \"3.3.0\",\n \"created_at\": \"[ISO timestamp]\",\n \"updated_at\": \"[ISO timestamp]\",\n \"created_by\": {\n \"blueprint_plugin\": \"3.3.0\"\n },\n \"project\": {\n \"name\": \"[detected from package.json/pyproject.toml or directory name]\",\n \"detected_stack\": []\n },\n \"structure\": {\n \"has_prds\": true,\n \"has_adrs\": true,\n \"has_prps\": true,\n \"has_work_orders\": true,\n \"has_ai_docs\": false,\n \"has_modular_rules\": true,\n \"has_feature_tracker\": \"[based on user choice]\",\n \"has_document_detection\": \"[based on user choice]\",\n \"claude_md_mode\": \"both\",\n \"generated_rules_path\": \"[based on Step 4a; defaults to .claude/rules/ when prompt skipped]\"\n },\n \"feature_tracker\": {\n \"file\": \"feature-tracker.json\",\n \"source_document\": \"[auto-detected]\",\n \"sync_targets\": [\"TODO.md\"]\n },\n \"generated\": {\n \"rules\": {},\n \"commands\": {}\n },\n \"custom_overrides\": {\n \"skills\": [],\n \"commands\": []\n },\n \"task_registry\": {\n \"derive-plans\": {\n \"enabled\": true,\n \"auto_run\": false,\n \"last_completed_at\": null,\n \"last_result\": null,\n \"schedule\": \"weekly\",\n \"stats\": {},\n \"context\": {}\n },\n \"derive-rules\": {\n \"enabled\": true,\n \"auto_run\": false,\n \"last_completed_at\": null,\n \"last_result\": null,\n \"schedule\": \"weekly\",\n \"stats\": {},\n \"context\": {}\n },\n \"generate-rules\": {\n \"enabled\": true,\n \"auto_run\": false,\n \"last_completed_at\": null,\n \"last_result\": null,\n \"schedule\": \"on-change\",\n \"stats\": {},\n \"context\": {}\n },\n \"adr-validate\": {\n \"enabled\": true,\n \"auto_run\": \"[based on maintenance task choice: true if auto-run safe, false otherwise]\",\n \"last_completed_at\": null,\n \"last_result\": null,\n \"schedule\": \"weekly\",\n \"stats\": {},\n \"context\": {}\n },\n \"feature-tracker-sync\": {\n \"enabled\": true,\n \"auto_run\": \"[based on maintenance task choice: true if auto-run safe, false otherwise]\",\n \"last_completed_at\": null,\n \"last_result\": null,\n \"schedule\": \"daily\",\n \"stats\": {},\n \"context\": {}\n },\n \"sync-ids\": {\n \"enabled\": true,\n \"auto_run\": \"[based on maintenance task choice: true if auto-run safe, false otherwise]\",\n \"last_completed_at\": null,\n \"last_result\": null,\n \"schedule\": \"on-change\",\n \"stats\": {},\n \"context\": {}\n },\n \"claude-md\": {\n \"enabled\": true,\n \"auto_run\": false,\n \"last_completed_at\": null,\n \"last_result\": null,\n \"schedule\": \"on-change\",\n \"stats\": {},\n \"context\": {}\n },\n \"curate-docs\": {\n \"enabled\": false,\n \"auto_run\": false,\n \"last_completed_at\": null,\n \"last_result\": null,\n \"schedule\": \"on-demand\",\n \"stats\": {},\n \"context\": {}\n }\n }\n }\n ```\n\n Note: Include `feature_tracker` section only if feature tracking is enabled.\n Note: As of v3.2.0, progress tracking is consolidated into feature-tracker.json (work-overview.md removed).\n\n **Monorepo `workspaces` block (v3.3.0+)**, appended to the manifest based on the\n detection from Step 1a:\n\n - **Child** (ancestor blueprint found and user opted in):\n ```json\n \"workspaces\": {\n \"role\": \"child\",\n \"root_relative_path\": \"[relative path from this dir to the root]\"\n }\n ```\n - **Root** (descendant blueprints found):\n ```json\n \"workspaces\": {\n \"role\": \"root\",\n \"discovery_strategy\": \"auto-cache\",\n \"last_scanned_at\": null,\n \"children\": []\n }\n ```\n After writing the manifest, run `/blueprint:workspace-scan` once to\n populate `children[]`.\n - **Standalone**: omit the `workspaces` block entirely.\n\n8. **Create initial rules**:\n - `development.md`: TDD workflow, commit conventions\n - `testing.md`: Test requirements, coverage expectations\n - `document-management.md`: Document organization rules (if decision detection enabled)\n\n9. **Handle `.gitignore`**:\n - Always commit `CLAUDE.md` and `.claude/rules/` (shared project instructions)\n - Add `docs/blueprint/work-orders/` to `.gitignore` (task-specific, may contain sensitive details)\n - If secrets detected in `.claude/`, warn user and suggest `.gitignore` entries\n\n10. **Report**:\n ```\n Blueprint Development initialized! (v3.3.0)\n\n Blueprint structure created:\n - docs/blueprint/manifest.json\n - docs/blueprint/work-orders/\n - docs/blueprint/ai_docs/\n - docs/blueprint/README.md\n [- docs/blueprint/feature-tracker.json (if feature tracking enabled)]\n\n Project documentation (top-level — derive-* skills write here):\n - docs/prds/ (Product Requirements Documents)\n - docs/adrs/ (Architecture Decision Records)\n - docs/prps/ (Product Requirement Prompts)\n - docs/trps/ (Test Regression Plans — created on first /blueprint:derive-tests run)\n\n Claude configuration:\n - .claude/rules/ (modular rules, including generated)\n - .claude/skills/ (custom skill overrides)\n\n Configuration:\n - Rules mode: both (CLAUDE.md + .claude/rules/)\n [- Feature tracking: enabled]\n [- Decision detection: enabled (Claude will prompt when discussions should become ADR/PRD/PRP)]\n [- Task scheduling: {prompt|auto-run safe|fully automatic|manual only}]\n\n [Migrated documentation:]\n [- {original} → {destination} (for each migrated file)]\n\n Architecture:\n - Plugin layer: Generic commands from blueprint-plugin (auto-updated)\n - Generated layer: Rules/commands regeneratable from docs/prds/\n - Custom layer: Your overrides in .claude/skills/\n ```\n\n11. **Prompt for next action** (use AskUserQuestion):\n ```\n question: \"Blueprint initialized. What would you like to do next?\"\n options:\n - label: \"Derive plans from git history (Recommended)\"\n description: \"Analyze commit history, PRs, and issues to build PRDs, ADRs, and PRPs from existing project decisions\"\n - label: \"Derive rules from codebase\"\n description: \"Analyze commit patterns and code conventions to generate .claude/rules/\"\n - label: \"Update CLAUDE.md\"\n description: \"Generate or update CLAUDE.md with project context and blueprint integration\"\n - label: \"I'm done for now\"\n description: \"Exit - you can run /blueprint:status anytime to see options\"\n ```\n\n **Based on selection:**\n - \"Derive plans from git history\" → Run `/blueprint:derive-plans`\n - \"Derive rules from codebase\" → Run `/blueprint:derive-rules`\n - \"Update CLAUDE.md\" → Run `/blueprint:claude-md`\n - \"I'm done for now\" → Show quick reference and exit\n\n**Quick Reference** (show if user selects \"I'm done for now\"):\n```\nManagement commands:\n- /blueprint:status - Check version and configuration\n- /blueprint:upgrade - Upgrade to latest format version\n- /blueprint:derive-plans - Derive PRDs, ADRs, and PRPs from git history\n- /blueprint:derive-rules - Derive rules from git commit decisions\n- /blueprint:prp-create - Create a Product Requirement Prompt\n- /blueprint:generate-rules - Generate rules from PRDs\n- /blueprint:sync - Check for stale generated content\n- /blueprint:promote - Move generated content to custom layer\n- /blueprint:rules - Manage modular rules\n- /blueprint:claude-md - Update CLAUDE.md\n- /blueprint:feature-tracker-status - View feature completion stats\n- /blueprint:feature-tracker-sync - Sync tracker with project files\n```\n---","attachment_filenames":[],"attachments":[],"content_json":{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Initialize Blueprint Development in this project.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"When to Use This Skill","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Use this skill when...","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Use blueprint-upgrade instead when...","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"The project has no ","type":"text"},{"text":"docs/blueprint/manifest.json","type":"text","marks":[{"type":"code_inline"}]},{"text":" yet","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"The project already has a manifest at an older format version","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"You're bootstrapping a new project's PRD/ADR/PRP directories","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"You're migrating v1.x→v2, v2→v3, or v3.x→v3.y","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"You want to enable feature tracking and decision detection from scratch","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Use blueprint-derive-plans to populate PRDs/ADRs/PRPs after init","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"You're configuring task scheduling for the first time","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Use blueprint-execute instead when you want auto-detection of next step","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Steps","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Check if already initialized","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Look for ","type":"text"},{"text":"docs/blueprint/manifest.json","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If exists, read version and ask user:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"Use AskUserQuestion:\nquestion: \"Blueprint already initialized (v{version}). What would you like to do?\"\noptions:\n - \"Check for upgrades\" → run /blueprint:upgrade\n - \"Reinitialize (will reset manifest)\" → continue with step 2\n - \"Cancel\" → exit","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"1a. ","type":"text"},{"text":"Detect monorepo context","type":"text","marks":[{"type":"strong"}]},{"text":" (format_version 3.3.0+):","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Walk upward from the current directory looking for an ancestor ","type":"text"},{"text":"docs/blueprint/manifest.json","type":"text","marks":[{"type":"code_inline"}]},{"text":" (stop at the repo root or ","type":"text"},{"text":"$HOME","type":"text","marks":[{"type":"code_inline"}]},{"text":").","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If an ancestor root manifest exists, this init is creating a ","type":"text"},{"text":"child","type":"text","marks":[{"type":"strong"}]},{"text":" workspace. Capture the relative path from the child back to the root.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Additionally scan descendants (max depth 4, skipping ","type":"text"},{"text":"node_modules","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":".git","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"dist","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"build","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"target","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":".venv","type":"text","marks":[{"type":"code_inline"}]},{"text":") for existing ","type":"text"},{"text":"docs/blueprint/manifest.json","type":"text","marks":[{"type":"code_inline"}]},{"text":". If any are found, this init is creating a ","type":"text"},{"text":"root","type":"text","marks":[{"type":"strong"}]},{"text":" that will own existing children.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Otherwise this is a ","type":"text"},{"text":"standalone","type":"text","marks":[{"type":"strong"}]},{"text":" blueprint (no ","type":"text"},{"text":"workspaces","type":"text","marks":[{"type":"code_inline"}]},{"text":" block written).","type":"text"}]}]}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"Use AskUserQuestion (only when ancestor root detected):\nquestion: \"Found a parent blueprint at {parent_path}. Register this as a child workspace?\"\noptions:\n - label: \"Yes - register as child\"\n description: \"Writes workspaces.role=child + root_relative_path; root picks it up on next /blueprint:workspace-scan\"\n - label: \"No - treat as standalone\"\n description: \"No workspaces block written; this project is independent\"","type":"text"}]},{"type":"ordered_list","attrs":{"order":2,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Ask about feature tracking","type":"text","marks":[{"type":"strong"}]},{"text":" (use AskUserQuestion):","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"question: \"Would you like to enable feature tracking?\"\noptions:\n - label: \"Yes - Track implementation against requirements\"\n description: \"Creates feature-tracker.json to track FR codes from a requirements document\"\n - label: \"No - Skip feature tracking\"\n description: \"Can be added later with /blueprint:feature-tracker-sync\"","type":"text"}]},{"type":"paragraph","content":[{"text":"If \"Yes\" selected:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"lower-alpha"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Search for markdown files in the project that contain requirements, features, or user stories","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Auto-detect the most likely source document based on content analysis","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Create ","type":"text"},{"text":"docs/blueprint/feature-tracker.json","type":"text","marks":[{"type":"code_inline"}]},{"text":" from template using the detected source","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Set ","type":"text"},{"text":"has_feature_tracker: true","type":"text","marks":[{"type":"code_inline"}]},{"text":" in manifest","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Ask about document migration","type":"text","marks":[{"type":"strong"}]},{"text":" (use AskUserQuestion): Search for existing markdown documentation files across the project (excluding standard files like README.md, CHANGELOG.md, CONTRIBUTING.md, LICENSE.md, CODE_OF_CONDUCT.md, SECURITY.md).","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# Find markdown files that look like documentation (not standard repo files)\nfind . -name '*.md' -not -path '*/node_modules/*' -not -path '*/.git/*' | grep -viE '(README|CHANGELOG|CONTRIBUTING|LICENSE|CODE_OF_CONDUCT|SECURITY)\\.md

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

","type":"text"}]},{"type":"paragraph","content":[{"text":"If documentation files found","type":"text","marks":[{"type":"strong"}]},{"text":" (e.g., REQUIREMENTS.md, ARCHITECTURE.md, DESIGN.md, docs in non-standard locations):","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"Use AskUserQuestion:\nquestion: \"Found existing documentation: {file_list}. Migrate these to Blueprint-managed paths? (Strongly recommended)\"\noptions:\n - label: \"Yes, migrate documents (Recommended)\"\n description: \"Move docs into docs/prds/, docs/adrs/, docs/prps/ based on content type. Prevents stale and orphaned documents.\"\n - label: \"No, leave them in place\"\n description: \"Warning: unmigrated docs may become stale or duplicated as Blueprint creates its own documents\"","type":"text"}]},{"type":"paragraph","content":[{"text":"If \"Yes\" selected:","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"lower-alpha"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Analyze each file to determine type:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Contains requirements, features, user stories → ","type":"text"},{"text":"docs/prds/","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Contains architecture decisions, trade-offs → ","type":"text"},{"text":"docs/adrs/","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Contains implementation plans → ","type":"text"},{"text":"docs/prps/","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"General documentation → ","type":"text"},{"text":"docs/","type":"text","marks":[{"type":"code_inline"}]}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Move files to appropriate ","type":"text"},{"text":"docs/","type":"text","marks":[{"type":"code_inline"}]},{"text":" subdirectory","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Rename to kebab-case if needed (REQUIREMENTS.md → requirements.md)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Report migration results:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"Migrated documentation:\n- REQUIREMENTS.md → docs/prds/requirements.md\n- ARCHITECTURE.md → docs/adrs/0001-initial-architecture.md","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If no documentation files found:","type":"text","marks":[{"type":"strong"}]},{"text":" Skip this step silently.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Ask about maintenance task scheduling","type":"text","marks":[{"type":"strong"}]},{"text":" (use AskUserQuestion):","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"question: \"How should blueprint maintenance tasks run?\"\noptions:\n - label: \"Prompt before running (Recommended)\"\n description: \"Always ask before running maintenance tasks like sync, validate\"\n - label: \"Auto-run safe tasks\"\n description: \"Read-only tasks (validate, sync, status) run automatically when due\"\n - label: \"Fully automatic\"\n description: \"All tasks run automatically on schedule, including writes like rule generation\"\n - label: \"Manual only\"\n description: \"Tasks only run when you explicitly invoke them\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Store selection for task_registry defaults:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Prompt","type":"text","marks":[{"type":"strong"}]},{"text":": all ","type":"text"},{"text":"auto_run: false","type":"text","marks":[{"type":"code_inline"}]},{"text":", default schedules","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Auto-run safe","type":"text","marks":[{"type":"strong"}]},{"text":": read-only tasks (","type":"text"},{"text":"adr-validate","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"feature-tracker-sync","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"sync-ids","type":"text","marks":[{"type":"code_inline"}]},{"text":") get ","type":"text"},{"text":"auto_run: true","type":"text","marks":[{"type":"code_inline"}]},{"text":"; write tasks get ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Fully automatic","type":"text","marks":[{"type":"strong"}]},{"text":": all tasks get ","type":"text"},{"text":"auto_run: true","type":"text","marks":[{"type":"code_inline"}]},{"text":", default schedules","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Manual only","type":"text","marks":[{"type":"strong"}]},{"text":": all ","type":"text"},{"text":"auto_run: false","type":"text","marks":[{"type":"code_inline"}]},{"text":", all schedules set to ","type":"text"},{"text":"on-demand","type":"text","marks":[{"type":"code_inline"}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"4a. ","type":"text"},{"text":"Ask about generated-rules output path","type":"text","marks":[{"type":"strong"}]},{"text":" (use AskUserQuestion):","type":"text"}]},{"type":"paragraph","content":[{"text":"Only prompt when ","type":"text"},{"text":".claude/rules/","type":"text","marks":[{"type":"code_inline"}]},{"text":" already exists and contains files (i.e., hand-authored rules that pre-date blueprint). Skip silently in fresh repos and use the default.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# Only prompt if .claude/rules/ has any content not created by blueprint\nfind .claude/rules -maxdepth 1 -type f -name '*.md'","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"Use AskUserQuestion (only when .claude/rules/ has existing content):\nquestion: \"Detected existing content in .claude/rules/. Where should blueprint write generated rules?\"\noptions:\n - label: \".claude/rules/blueprint/ (Recommended)\"\n description: \"Isolated subdirectory — keeps blueprint-managed and hand-authored rules separate, prevents collisions on regenerate\"\n - label: \".claude/rules/ (flat)\"\n description: \"Write generated rules alongside hand-authored ones; risk of overwrite when filenames collide\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Store the chosen path in ","type":"text"},{"text":"structure.generated_rules_path","type":"text","marks":[{"type":"code_inline"}]},{"text":" in the manifest (defaults to ","type":"text"},{"text":".claude/rules/","type":"text","marks":[{"type":"code_inline"}]},{"text":" when unset). This keeps ","type":"text"},{"text":"blueprint-generate-rules","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"blueprint-derive-rules","type":"text","marks":[{"type":"code_inline"}]},{"text":" from clobbering hand-curated rule files (issue #1043).","type":"text"}]},{"type":"ordered_list","attrs":{"order":5,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Ask about decision detection","type":"text","marks":[{"type":"strong"}]},{"text":" (use AskUserQuestion):","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"question: \"Would you like to enable automatic decision detection?\"\noptions:\n - label: \"Yes - Detect decisions worth documenting\"\n description: \"Claude will notice when conversations contain architecture decisions, feature requirements, or implementation plans that should be captured as ADR/PRD/PRP documents\"\n - label: \"No - Manual commands only\"\n description: \"Use /blueprint:derive-plans, /blueprint:prp-create explicitly when you want to create documents\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Set ","type":"text"},{"text":"has_document_detection","type":"text","marks":[{"type":"code_inline"}]},{"text":" in manifest based on response.","type":"text"}]},{"type":"paragraph","content":[{"text":"If enabled:","type":"text","marks":[{"type":"strong"}]},{"text":" Copy ","type":"text"},{"text":"document-management-rule.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" template to ","type":"text"},{"text":".claude/rules/document-management.md","type":"text","marks":[{"type":"code_inline"}]},{"text":". This rule instructs Claude to watch for:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Architecture decisions being made during discussion → prompt to create ADR","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Feature requirements being discussed or refined → prompt to create/update PRD","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Implementation plans being formulated → prompt to create PRP","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Create directory structure","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"paragraph","content":[{"text":"Canonical document paths","type":"text","marks":[{"type":"strong"}]},{"text":" are at the ","type":"text"},{"text":"top level","type":"text","marks":[{"type":"strong"}]},{"text":" of ","type":"text"},{"text":"docs/","type":"text","marks":[{"type":"code_inline"}]},{"text":", not under ","type":"text"},{"text":"docs/blueprint/","type":"text","marks":[{"type":"code_inline"}]},{"text":". ","type":"text"},{"text":"docs/blueprint/","type":"text","marks":[{"type":"code_inline"}]},{"text":" holds blueprint machinery only (manifest, feature-tracker, work-orders, ai_docs); ","type":"text"},{"text":"docs/{adrs,prds,prps,trps}/","type":"text","marks":[{"type":"code_inline"}]},{"text":" hold the documents themselves. Every ","type":"text"},{"text":"/blueprint:derive-*","type":"text","marks":[{"type":"code_inline"}]},{"text":" skill writes to the top-level paths — keeping them consistent prevents the dual-corpus bug where init creates one layout and derive-* writes to another.","type":"text"}]},{"type":"paragraph","content":[{"text":"Execute the creation explicitly so the directories exist even when no document migration happened in Step 3:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"mkdir -p docs/blueprint/work-orders/completed\nmkdir -p docs/blueprint/work-orders/archived\nmkdir -p docs/blueprint/ai_docs/libraries\nmkdir -p docs/blueprint/ai_docs/project\nmkdir -p docs/adrs\nmkdir -p docs/prds\nmkdir -p docs/prps","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: ","type":"text"},{"text":"docs/trps/","type":"text","marks":[{"type":"code_inline"}]},{"text":" is created on-demand by ","type":"text"},{"text":"/blueprint:derive-tests","type":"text","marks":[{"type":"code_inline"}]},{"text":" only — init does not pre-create it.","type":"text"}]},{"type":"paragraph","content":[{"text":"The resulting tree:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"docs/\n├── blueprint/\n│ ├── manifest.json # Version tracking and configuration\n│ ├── feature-tracker.json # Progress tracking (if enabled)\n│ ├── work-orders/ # Task packages for subagents\n│ │ ├── completed/\n│ │ └── archived/\n│ ├── ai_docs/ # Curated documentation (on-demand)\n│ │ ├── libraries/\n│ │ └── project/\n│ └── README.md # Blueprint documentation\n├── prds/ # Product Requirements Documents (canonical)\n├── adrs/ # Architecture Decision Records (canonical)\n├── prps/ # Product Requirement Prompts (canonical)\n└── trps/ # Test Regression Plans (created on-demand by /blueprint:derive-tests)","type":"text"}]},{"type":"paragraph","content":[{"text":"Claude configuration (in .claude/):","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":".claude/\n├── rules/ # Modular rules (including generated)\n│ ├── development.md # Development workflow rules\n│ ├── testing.md # Testing requirements\n│ └── document-management.md # Document organization rules (if detection enabled)\n└── skills/ # Custom skill overrides (optional)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Create ","type":"text","marks":[{"type":"strong"}]},{"text":"manifest.json","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" (v3.3.0 schema — canonical filename is ","type":"text"},{"text":"docs/blueprint/manifest.json","type":"text","marks":[{"type":"code_inline"}]},{"text":", no dot prefix):","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"json"},"content":[{"text":"{\n \"format_version\": \"3.3.0\",\n \"created_at\": \"[ISO timestamp]\",\n \"updated_at\": \"[ISO timestamp]\",\n \"created_by\": {\n \"blueprint_plugin\": \"3.3.0\"\n },\n \"project\": {\n \"name\": \"[detected from package.json/pyproject.toml or directory name]\",\n \"detected_stack\": []\n },\n \"structure\": {\n \"has_prds\": true,\n \"has_adrs\": true,\n \"has_prps\": true,\n \"has_work_orders\": true,\n \"has_ai_docs\": false,\n \"has_modular_rules\": true,\n \"has_feature_tracker\": \"[based on user choice]\",\n \"has_document_detection\": \"[based on user choice]\",\n \"claude_md_mode\": \"both\",\n \"generated_rules_path\": \"[based on Step 4a; defaults to .claude/rules/ when prompt skipped]\"\n },\n \"feature_tracker\": {\n \"file\": \"feature-tracker.json\",\n \"source_document\": \"[auto-detected]\",\n \"sync_targets\": [\"TODO.md\"]\n },\n \"generated\": {\n \"rules\": {},\n \"commands\": {}\n },\n \"custom_overrides\": {\n \"skills\": [],\n \"commands\": []\n },\n \"task_registry\": {\n \"derive-plans\": {\n \"enabled\": true,\n \"auto_run\": false,\n \"last_completed_at\": null,\n \"last_result\": null,\n \"schedule\": \"weekly\",\n \"stats\": {},\n \"context\": {}\n },\n \"derive-rules\": {\n \"enabled\": true,\n \"auto_run\": false,\n \"last_completed_at\": null,\n \"last_result\": null,\n \"schedule\": \"weekly\",\n \"stats\": {},\n \"context\": {}\n },\n \"generate-rules\": {\n \"enabled\": true,\n \"auto_run\": false,\n \"last_completed_at\": null,\n \"last_result\": null,\n \"schedule\": \"on-change\",\n \"stats\": {},\n \"context\": {}\n },\n \"adr-validate\": {\n \"enabled\": true,\n \"auto_run\": \"[based on maintenance task choice: true if auto-run safe, false otherwise]\",\n \"last_completed_at\": null,\n \"last_result\": null,\n \"schedule\": \"weekly\",\n \"stats\": {},\n \"context\": {}\n },\n \"feature-tracker-sync\": {\n \"enabled\": true,\n \"auto_run\": \"[based on maintenance task choice: true if auto-run safe, false otherwise]\",\n \"last_completed_at\": null,\n \"last_result\": null,\n \"schedule\": \"daily\",\n \"stats\": {},\n \"context\": {}\n },\n \"sync-ids\": {\n \"enabled\": true,\n \"auto_run\": \"[based on maintenance task choice: true if auto-run safe, false otherwise]\",\n \"last_completed_at\": null,\n \"last_result\": null,\n \"schedule\": \"on-change\",\n \"stats\": {},\n \"context\": {}\n },\n \"claude-md\": {\n \"enabled\": true,\n \"auto_run\": false,\n \"last_completed_at\": null,\n \"last_result\": null,\n \"schedule\": \"on-change\",\n \"stats\": {},\n \"context\": {}\n },\n \"curate-docs\": {\n \"enabled\": false,\n \"auto_run\": false,\n \"last_completed_at\": null,\n \"last_result\": null,\n \"schedule\": \"on-demand\",\n \"stats\": {},\n \"context\": {}\n }\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: Include ","type":"text"},{"text":"feature_tracker","type":"text","marks":[{"type":"code_inline"}]},{"text":" section only if feature tracking is enabled. Note: As of v3.2.0, progress tracking is consolidated into feature-tracker.json (work-overview.md removed).","type":"text"}]},{"type":"paragraph","content":[{"text":"Monorepo ","type":"text","marks":[{"type":"strong"}]},{"text":"workspaces","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" block (v3.3.0+)","type":"text","marks":[{"type":"strong"}]},{"text":", appended to the manifest based on the detection from Step 1a:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Child","type":"text","marks":[{"type":"strong"}]},{"text":" (ancestor blueprint found and user opted in):","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"json"},"content":[{"text":"\"workspaces\": {\n \"role\": \"child\",\n \"root_relative_path\": \"[relative path from this dir to the root]\"\n}","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Root","type":"text","marks":[{"type":"strong"}]},{"text":" (descendant blueprints found):","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"json"},"content":[{"text":"\"workspaces\": {\n \"role\": \"root\",\n \"discovery_strategy\": \"auto-cache\",\n \"last_scanned_at\": null,\n \"children\": []\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"After writing the manifest, run ","type":"text"},{"text":"/blueprint:workspace-scan","type":"text","marks":[{"type":"code_inline"}]},{"text":" once to populate ","type":"text"},{"text":"children[]","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Standalone","type":"text","marks":[{"type":"strong"}]},{"text":": omit the ","type":"text"},{"text":"workspaces","type":"text","marks":[{"type":"code_inline"}]},{"text":" block entirely.","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Create initial rules","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"development.md","type":"text","marks":[{"type":"code_inline"}]},{"text":": TDD workflow, commit conventions","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"testing.md","type":"text","marks":[{"type":"code_inline"}]},{"text":": Test requirements, coverage expectations","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"document-management.md","type":"text","marks":[{"type":"code_inline"}]},{"text":": Document organization rules (if decision detection enabled)","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Handle ","type":"text","marks":[{"type":"strong"}]},{"text":".gitignore","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Always commit ","type":"text"},{"text":"CLAUDE.md","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":".claude/rules/","type":"text","marks":[{"type":"code_inline"}]},{"text":" (shared project instructions)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Add ","type":"text"},{"text":"docs/blueprint/work-orders/","type":"text","marks":[{"type":"code_inline"}]},{"text":" to ","type":"text"},{"text":".gitignore","type":"text","marks":[{"type":"code_inline"}]},{"text":" (task-specific, may contain sensitive details)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If secrets detected in ","type":"text"},{"text":".claude/","type":"text","marks":[{"type":"code_inline"}]},{"text":", warn user and suggest ","type":"text"},{"text":".gitignore","type":"text","marks":[{"type":"code_inline"}]},{"text":" entries","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Report","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]}]}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"Blueprint Development initialized! (v3.3.0)\n\nBlueprint structure created:\n- docs/blueprint/manifest.json\n- docs/blueprint/work-orders/\n- docs/blueprint/ai_docs/\n- docs/blueprint/README.md\n[- docs/blueprint/feature-tracker.json (if feature tracking enabled)]\n\nProject documentation (top-level — derive-* skills write here):\n- docs/prds/ (Product Requirements Documents)\n- docs/adrs/ (Architecture Decision Records)\n- docs/prps/ (Product Requirement Prompts)\n- docs/trps/ (Test Regression Plans — created on first /blueprint:derive-tests run)\n\nClaude configuration:\n- .claude/rules/ (modular rules, including generated)\n- .claude/skills/ (custom skill overrides)\n\nConfiguration:\n- Rules mode: both (CLAUDE.md + .claude/rules/)\n[- Feature tracking: enabled]\n[- Decision detection: enabled (Claude will prompt when discussions should become ADR/PRD/PRP)]\n[- Task scheduling: {prompt|auto-run safe|fully automatic|manual only}]\n\n[Migrated documentation:]\n[- {original} → {destination} (for each migrated file)]\n\nArchitecture:\n- Plugin layer: Generic commands from blueprint-plugin (auto-updated)\n- Generated layer: Rules/commands regeneratable from docs/prds/\n- Custom layer: Your overrides in .claude/skills/","type":"text"}]},{"type":"ordered_list","attrs":{"order":11,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Prompt for next action","type":"text","marks":[{"type":"strong"}]},{"text":" (use AskUserQuestion):","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"question: \"Blueprint initialized. What would you like to do next?\"\noptions:\n - label: \"Derive plans from git history (Recommended)\"\n description: \"Analyze commit history, PRs, and issues to build PRDs, ADRs, and PRPs from existing project decisions\"\n - label: \"Derive rules from codebase\"\n description: \"Analyze commit patterns and code conventions to generate .claude/rules/\"\n - label: \"Update CLAUDE.md\"\n description: \"Generate or update CLAUDE.md with project context and blueprint integration\"\n - label: \"I'm done for now\"\n description: \"Exit - you can run /blueprint:status anytime to see options\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Based on selection:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"Derive plans from git history\" → Run ","type":"text"},{"text":"/blueprint:derive-plans","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"Derive rules from codebase\" → Run ","type":"text"},{"text":"/blueprint:derive-rules","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"Update CLAUDE.md\" → Run ","type":"text"},{"text":"/blueprint:claude-md","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"I'm done for now\" → Show quick reference and exit","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Quick Reference","type":"text","marks":[{"type":"strong"}]},{"text":" (show if user selects \"I'm done for now\"):","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"Management commands:\n- /blueprint:status - Check version and configuration\n- /blueprint:upgrade - Upgrade to latest format version\n- /blueprint:derive-plans - Derive PRDs, ADRs, and PRPs from git history\n- /blueprint:derive-rules - Derive rules from git commit decisions\n- /blueprint:prp-create - Create a Product Requirement Prompt\n- /blueprint:generate-rules - Generate rules from PRDs\n- /blueprint:sync - Check for stale generated content\n- /blueprint:promote - Move generated content to custom layer\n- /blueprint:rules - Manage modular rules\n- /blueprint:claude-md - Update CLAUDE.md\n- /blueprint:feature-tracker-status - View feature completion stats\n- /blueprint:feature-tracker-sync - Sync tracker with project files","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}}]},"metadata":{"date":"2026-06-05","name":"blueprint-init","author":"@skillopedia","source":{"stars":35,"repo_name":"claude-plugins","origin_url":"https://github.com/laurigates/claude-plugins/blob/HEAD/blueprint-plugin/skills/blueprint-init/SKILL.md","repo_owner":"laurigates","body_sha256":"fc9b9b09e5aff3e971d2f57f1b82e6c595eb7f3a714f9a2def58caeaec631a49","cluster_key":"e4287b4fb7ab3dd2f814797b69d47142c7e3abeb8f7302db28582e7af9757395","clean_bundle":{"format":"clean-skill-bundle-v1","source":"laurigates/claude-plugins/blueprint-plugin/skills/blueprint-init/SKILL.md","bundle_sha256":"3a3c65befdb51f203e4a9230b26075d2b11f4da7f7d8c33f866466e79ba39239","attachment_count":0,"text_attachments":0,"binary_attachments":0},"cluster_size":1,"skill_md_path":"blueprint-plugin/skills/blueprint-init/SKILL.md","import_metadata":{"date":"2026-06-05","author":"@skillopedia","version":"v1","category":"general","category_label":"General"},"exact_dupes_collapsed_into_this":0},"created":"2025-12-16T00:00:00.000Z","version":"v1","category":"general","modified":"2026-05-22T00:00:00.000Z","reviewed":"2026-05-22T00:00:00.000Z","import_tag":"clean-skills-v1","description":"Initialize Blueprint Development structure. Use when bootstrapping docs/blueprint/ with manifest, PRD/ADR/PRP directories, and feature tracking for the first time.","allowed-tools":"Bash, Write, Read, AskUserQuestion, Glob"}},"renderedAt":1782987342233}

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.