claude-blueprint 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +1 -1
- package/README.md +27 -4
- package/commands/status.md +36 -7
- package/package.json +1 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "blueprint",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"description": "Architecture Decision Records with teeth — lifecycle management, devil's advocate review, architecture evaluation team, post-fix retrospectives, and compliance auditing. All with a cranky senior engineer persona.",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "pragnition"
|
package/README.md
CHANGED
|
@@ -8,6 +8,19 @@ Architecture Decision Records with teeth. A Claude Code plugin that treats archi
|
|
|
8
8
|
|
|
9
9
|
Every agent speaks with the voice of a senior engineer who has watched too many "temporary" decisions become permanent load-bearing walls.
|
|
10
10
|
|
|
11
|
+
## Table of Contents
|
|
12
|
+
|
|
13
|
+
- [The Problem Blueprint Solves](#the-problem-blueprint-solves)
|
|
14
|
+
- [Philosophical Foundations](#philosophical-foundations)
|
|
15
|
+
- [How Blueprint Works](#how-blueprint-works)
|
|
16
|
+
- [Commands](#commands)
|
|
17
|
+
- [The Five Dimensions of Architectural Health](#the-five-dimensions-of-architectural-health)
|
|
18
|
+
- [Continuous Governance: Beyond Point-in-Time](#continuous-governance-beyond-point-in-time)
|
|
19
|
+
- [The Retrospective: Closing the Loop](#the-retrospective-closing-the-loop)
|
|
20
|
+
- [Installation](#installation)
|
|
21
|
+
- [Architecture of Blueprint Itself](#architecture-of-blueprint-itself)
|
|
22
|
+
- [Intellectual Heritage](#intellectual-heritage)
|
|
23
|
+
|
|
11
24
|
## The Problem Blueprint Solves
|
|
12
25
|
|
|
13
26
|
> "We shape our buildings; thereafter they shape us." — Winston Churchill
|
|
@@ -292,14 +305,24 @@ The output is a verdict: **SYSTEMIC** (the fix addressed the root cause, move on
|
|
|
292
305
|
## Installation
|
|
293
306
|
|
|
294
307
|
```bash
|
|
295
|
-
#
|
|
308
|
+
# Via Claude Code plugin marketplace (recommended)
|
|
309
|
+
/plugin marketplace add pragnition/claude-plugins
|
|
310
|
+
/plugin install blueprint@pragnition-plugins
|
|
311
|
+
|
|
312
|
+
# Via npm
|
|
313
|
+
npx claude-blueprint install --global
|
|
314
|
+
|
|
315
|
+
# Verify
|
|
316
|
+
npx claude-blueprint verify
|
|
317
|
+
```
|
|
318
|
+
|
|
319
|
+
Or from source:
|
|
320
|
+
|
|
321
|
+
```bash
|
|
296
322
|
cd ~/pragnition/blueprint
|
|
297
323
|
npm install
|
|
298
324
|
npm link
|
|
299
325
|
claude-blueprint install --global
|
|
300
|
-
|
|
301
|
-
# Verify
|
|
302
|
-
claude-blueprint verify
|
|
303
326
|
```
|
|
304
327
|
|
|
305
328
|
The installer deploys 24 commands, 12 agents, and 4 config files to `~/.claude/commands/blueprint/`, and inserts a managed section into `CLAUDE.md` with the command reference.
|
package/commands/status.md
CHANGED
|
@@ -102,15 +102,44 @@ Always display this first:
|
|
|
102
102
|
|
|
103
103
|
### Step 3: Generate Interactive HTML Dashboard
|
|
104
104
|
|
|
105
|
-
After the terminal display, generate
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
105
|
+
After the terminal display, generate the dashboard by:
|
|
106
|
+
|
|
107
|
+
1. Read the template from `assets/dashboard.html` in the blueprint plugin directory
|
|
108
|
+
(find it via: the plugin's install location, or `~/pragnition/blueprint/assets/dashboard.html`)
|
|
109
|
+
2. Build the `DATA` object from the metrics gathered in Step 1
|
|
110
|
+
3. Replace the placeholder `__BLUEPRINT_DATA__` in the template with the JSON data
|
|
111
|
+
4. Write to `/tmp/blueprint-dashboard-{timestamp}.html`
|
|
112
|
+
5. Open in browser
|
|
113
|
+
|
|
114
|
+
**The DATA object structure:**
|
|
115
|
+
|
|
116
|
+
```javascript
|
|
117
|
+
{
|
|
118
|
+
generated: "2026-03-30",
|
|
119
|
+
health_score: "ADEQUATE", // STRONG / ADEQUATE / CONCERNING / CRITICAL
|
|
120
|
+
debt_score: 14,
|
|
121
|
+
triggers_met: 1,
|
|
122
|
+
operations: {
|
|
123
|
+
audit: "2026-03-18", // ISO date or null
|
|
124
|
+
evaluation: null,
|
|
125
|
+
retro: "2026-03-27",
|
|
126
|
+
drift: null,
|
|
127
|
+
status: "2026-03-30"
|
|
128
|
+
},
|
|
129
|
+
adrs: [
|
|
130
|
+
{ number: "ADR-0001", title: "Use ADRs...", status: "Accepted",
|
|
131
|
+
category: "Process", date: "2026-03-30", severity: "Medium",
|
|
132
|
+
trigger: null, trigger_met: false, debt_score: 0 },
|
|
133
|
+
// ... one entry per ADR
|
|
134
|
+
],
|
|
135
|
+
edges: [
|
|
136
|
+
{ from: "ADR-0003", to: "ADR-0008", type: "DEPENDS_ON" },
|
|
137
|
+
// ... from relationships.toml
|
|
138
|
+
]
|
|
139
|
+
}
|
|
111
140
|
```
|
|
112
141
|
|
|
113
|
-
**The HTML dashboard includes:**
|
|
142
|
+
**The HTML dashboard includes (4 tabs, matching the wireframe design system):**
|
|
114
143
|
|
|
115
144
|
**Tab 1: Knowledge Graph (main view)**
|
|
116
145
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "claude-blueprint",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "Architecture Decision Records with teeth — lifecycle management, devil's advocate review, architecture evaluation team, post-fix retrospectives, and compliance auditing for Claude Code.",
|
|
6
6
|
"bin": {
|