Skip to content

Commit e65fe19

Browse files
laurigatesclaude
andauthored
docs: initialize blueprint development structure (#171)
## Summary - Initialize Blueprint Development v3.2.0 with manifest, task registry, and directory structure - Migrate 13 existing ADRs from `docs/adr/` to `docs/adrs/` (blueprint convention) - Derive PRD-001 (project overview) from README, CLAUDE.md, and component docs - Derive 3 new ADRs from git history: profile-based packages (0014), gitleaks (0015), shell completions (0016) - Create 3 PRPs for future work: Fish shell, NixOS, Sketchybar - Generate 5 new Claude rules: development, testing, document-management, chezmoi-conventions, dependency-management - Update CLAUDE.md with blueprint references ## Test plan - [ ] `chezmoi diff ~/.claude` shows no changes (rules synced) - [ ] `chezmoi apply --dry-run` runs clean - [ ] `pre-commit run --all-files` passes (actionlint warnings are pre-existing) - [ ] `docs/adrs/README.md` index includes all 16 ADRs - [ ] `docs/blueprint/manifest.json` is valid JSON with v3.2.0 format ## Follow-up - [ ] Run `/configure:select` for infrastructure standards audit (separate PR) - [ ] Run `/blueprint:adr-validate` after merge to check cross-references - [ ] Create GitHub issues for PRD-001 and PRPs (GitHub MCP auth was unavailable) 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 545ac08 commit e65fe19

30 files changed

Lines changed: 815 additions & 1 deletion

.gitignore

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,9 @@ settings.local.json
1818

1919
tmp/
2020

21+
# Blueprint work orders (task-specific, may contain sensitive details)
22+
docs/blueprint/work-orders/
23+
2124
# Security: prevent accidental commit of secrets/credentials
2225
.env
2326
.env.*

CLAUDE.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -72,6 +72,16 @@ pre-commit run detect-secrets --all-files
7272
- **smoke.yml** — Multi-platform (Ubuntu/macOS) linting and build
7373
- **claude.yml** — AI-assisted dev with auto plugin install from [laurigates/claude-plugins](https://github.com/laurigates/claude-plugins)
7474

75+
## Blueprint Documentation
76+
77+
Blueprint v3.2.0 manages project documentation and rules.
78+
79+
- **PRD**: `docs/prds/project-overview.md` — Feature requirements and scope
80+
- **ADRs**: `docs/adrs/` — 16 Architecture Decision Records ([index](docs/adrs/README.md))
81+
- **PRPs**: `docs/prps/` — Implementation plans (fish, NixOS, sketchybar)
82+
- **Manifest**: `docs/blueprint/manifest.json` — Configuration and task registry
83+
- **Commands**: `/blueprint:status`, `/blueprint:execute`, `/blueprint:derive-plans`
84+
7585
## Sub-documentation
7686

7787
- `exact_dot_claude/CLAUDE.md` — Claude Code design and directory structure
@@ -80,6 +90,7 @@ pre-commit run detect-secrets --all-files
8090
- `private_dot_config/CLAUDE.md` — Application configuration
8191
- `private_dot_config/nvim/CLAUDE.md` — Neovim configuration
8292
- `scripts/CLAUDE.md` — Maintenance scripts
93+
- `docs/blueprint/README.md` — Blueprint structure overview
8394

8495
## Security & Release
8596

File renamed without changes.

docs/adr/0002-unified-tool-version-management-mise.md renamed to docs/adrs/0002-unified-tool-version-management-mise.md

File renamed without changes.
File renamed without changes.
File renamed without changes.

docs/adr/0005-namespace-based-command-organization.md renamed to docs/adrs/0005-namespace-based-command-organization.md

File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)