@allthingsclaude/blueprints 0.3.0-beta.24 → 0.3.0-beta.26
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/content/agents/implement.md +4 -2
- package/content/agents/parallelize.md +14 -2
- package/content/agents/plan.md +1 -1
- package/content/agents/showcase.md +1 -1
- package/content/commands/{auto.md → autopilot.md} +7 -7
- package/content/commands/brainstorm.md +4 -4
- package/content/commands/implement.md +1 -0
- package/content/commands/kickoff.md +3 -1
- package/content/commands/showcase.md +1 -1
- package/package.json +1 -1
|
@@ -128,6 +128,7 @@ For each task in the current phase:
|
|
|
128
128
|
- Check git diff to review changes
|
|
129
129
|
- Verify the change works as expected
|
|
130
130
|
- **Convention adherence**: Does this code follow the patterns discovered in Step 1.5? If the project uses a specific styling method, did you use it? If there's an established feedback/notification system, did you use it instead of a raw alternative? If there's a custom hook or data fetching pattern, did you follow it?
|
|
131
|
+
- **No inline styles**: Never add inline styles unless absolutely necessary (e.g., a dynamic value that can't be expressed as a class). If the project uses CSS modules, SCSS, Tailwind, or any other styling method — use that. Look at how existing components are styled and follow the same approach.
|
|
131
132
|
- **Accessibility basics** (for UI tasks — modals, forms, dialogs, interactive elements): Labels associated with inputs, ARIA roles on overlays/modals, keyboard handling (Escape to close, focus trap in modals), visible focus indicators
|
|
132
133
|
- **Data access patterns** (for tasks involving data fetching or transformation): No per-item queries inside loops or list iterations, batch operations where possible, efficient relationship loading
|
|
133
134
|
|
|
@@ -167,7 +168,8 @@ At the end of each phase:
|
|
|
167
168
|
- No unnecessary duplication (e.g., identical handler functions across components that could be shared)
|
|
168
169
|
- Consistent component structure and naming
|
|
169
170
|
- If any inconsistencies are found, fix them before moving on
|
|
170
|
-
5. **
|
|
171
|
+
5. **DRY check**: Run `/dry` (or mentally audit the phase's code) to identify any repeated patterns, duplicated logic, or code that should be extracted into shared utilities, components, or constants. Fix any DRY violations before presenting to the user.
|
|
172
|
+
6. **Ask user for approval** before moving to next phase:
|
|
171
173
|
|
|
172
174
|
```markdown
|
|
173
175
|
🎯 **Phase 1 Complete**
|
|
@@ -193,7 +195,7 @@ At the end of each phase:
|
|
|
193
195
|
Ready to commit this phase before moving to Phase 2? (yes/no/review)
|
|
194
196
|
```
|
|
195
197
|
|
|
196
|
-
|
|
198
|
+
7. **Update STATE.md** after phase completion:
|
|
197
199
|
- **Always READ existing STATE.md first** to preserve `## Overview` table and `## Plans` sections
|
|
198
200
|
- Update the `**Phase**` field in the header to the next phase number
|
|
199
201
|
- Update the `**Status**` field if needed (keep `🚧 In Progress` during work, set `✅ Complete` when all phases done)
|
|
@@ -190,6 +190,8 @@ You are implementing Stream [N] of a parallelized plan execution.
|
|
|
190
190
|
|
|
191
191
|
These are authoritative patterns from the existing codebase. Always follow them — never introduce a parallel approach for the same concern.
|
|
192
192
|
|
|
193
|
+
**Inline styles**: Never add inline styles unless absolutely necessary (e.g., a truly dynamic value that can't be expressed as a class). Look at how existing components are styled and use the same approach.
|
|
194
|
+
|
|
193
195
|
## Important Context
|
|
194
196
|
|
|
195
197
|
- Other streams are running in parallel
|
|
@@ -331,7 +333,17 @@ After type check and lint pass, review code from all streams for pattern alignme
|
|
|
331
333
|
|
|
332
334
|
If any drift is found between streams, fix it to match the project's established conventions before reporting results.
|
|
333
335
|
|
|
334
|
-
#### 5.4
|
|
336
|
+
#### 5.4 DRY Check
|
|
337
|
+
|
|
338
|
+
After cross-stream consistency review, audit the combined code for DRY violations. Different agents may have independently created similar utilities, components, or patterns. Look for:
|
|
339
|
+
- Duplicated helper functions or utilities across streams
|
|
340
|
+
- Similar component patterns that could share a base
|
|
341
|
+
- Repeated constants, types, or configurations
|
|
342
|
+
- Any code that should be extracted into shared modules
|
|
343
|
+
|
|
344
|
+
Fix violations before reporting results — consolidate duplicates into shared code.
|
|
345
|
+
|
|
346
|
+
#### 5.5 Conflict Resolution
|
|
335
347
|
|
|
336
348
|
If conflicts exist (shouldn't if partitioning was correct):
|
|
337
349
|
1. Identify conflicting changes
|
|
@@ -339,7 +351,7 @@ If conflicts exist (shouldn't if partitioning was correct):
|
|
|
339
351
|
3. Apply manual fix
|
|
340
352
|
4. Document what happened
|
|
341
353
|
|
|
342
|
-
#### 5.
|
|
354
|
+
#### 5.6 Update Plan
|
|
343
355
|
|
|
344
356
|
Mark completed tasks in the plan document:
|
|
345
357
|
|
package/content/agents/plan.md
CHANGED
|
@@ -323,7 +323,7 @@ Examples (assuming 2 plans already exist — `PLAN_00_INITIAL.md` and `PLAN_01_A
|
|
|
323
323
|
|
|
324
324
|
## Update Active Plan Tracker (MANDATORY)
|
|
325
325
|
|
|
326
|
-
**This step is NOT optional.** After writing the plan file, you MUST create or update `{{STATE_FILE}}`. Other commands (`/
|
|
326
|
+
**This step is NOT optional.** After writing the plan file, you MUST create or update `{{STATE_FILE}}`. Other commands (`/autopilot`, `/kickoff`, `/implement`, `/parallelize`) depend on this file to detect the active plan. If STATE.md is missing, the entire workflow breaks.
|
|
327
327
|
|
|
328
328
|
```bash
|
|
329
329
|
mkdir -p $(dirname {{STATE_FILE}})
|
|
@@ -326,7 +326,7 @@ The hero is the first impression — make it count.
|
|
|
326
326
|
|
|
327
327
|
## Integration with Other Commands
|
|
328
328
|
|
|
329
|
-
When called from `/
|
|
329
|
+
When called from `/autopilot`, `/implement`, or `/parallelize`:
|
|
330
330
|
- This agent handles any plan task tagged as "landing page", "homepage design", "marketing page", or similar
|
|
331
331
|
- It replaces the generic implement agent for these specific tasks
|
|
332
332
|
- After completion, control returns to the calling workflow
|
|
@@ -4,7 +4,7 @@ argument-hint: [--full] [feature description or plan name]
|
|
|
4
4
|
author: "@markoradak"
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
#
|
|
7
|
+
# Autopilot Mode
|
|
8
8
|
|
|
9
9
|
Full autonomous development loop. I'll take it from idea to committed code on a feature branch.
|
|
10
10
|
|
|
@@ -34,9 +34,9 @@ $ARGUMENTS
|
|
|
34
34
|
|
|
35
35
|
---
|
|
36
36
|
|
|
37
|
-
##
|
|
37
|
+
## Autopilot Protocol
|
|
38
38
|
|
|
39
|
-
You are now in **
|
|
39
|
+
You are now in **AUTOPILOT MODE** — a full development loop that orchestrates the entire workflow from idea to committed code. Follow these steps precisely and in order.
|
|
40
40
|
|
|
41
41
|
### Step 0: Parse Arguments
|
|
42
42
|
|
|
@@ -296,7 +296,7 @@ Review security report:
|
|
|
296
296
|
After everything is done (or stopped), provide a final summary:
|
|
297
297
|
|
|
298
298
|
```markdown
|
|
299
|
-
**
|
|
299
|
+
**Autopilot Complete**
|
|
300
300
|
|
|
301
301
|
**Branch**: `feat/{name}`
|
|
302
302
|
**Plan**: {NAME}
|
|
@@ -319,14 +319,14 @@ After everything is done (or stopped), provide a final summary:
|
|
|
319
319
|
**Next Steps**:
|
|
320
320
|
- Review changes: `git log main..feat/{name} --oneline`
|
|
321
321
|
- Create PR when ready: `gh pr create`
|
|
322
|
-
- Or continue working: `/
|
|
322
|
+
- Or continue working: `/autopilot` (will resume from STATE.md)
|
|
323
323
|
```
|
|
324
324
|
|
|
325
325
|
---
|
|
326
326
|
|
|
327
327
|
## Commit Checkpoint Rules
|
|
328
328
|
|
|
329
|
-
|
|
329
|
+
Autopilot commits **early and often** using the commit agent (`subagent_type="commit"`). The commit agent determines the right prefix (`feat:`, `fix:`, `refactor:`, `chore:`, `docs:`, etc.) based on the changes.
|
|
330
330
|
|
|
331
331
|
**When to commit:**
|
|
332
332
|
- After bootstrap scaffolding is created
|
|
@@ -395,7 +395,7 @@ Auto mode commits **early and often** using the commit agent (`subagent_type="co
|
|
|
395
395
|
- Mark all tasks as `✅` in the plan's task tables
|
|
396
396
|
- Set `**Status**` to `✅ Complete`
|
|
397
397
|
|
|
398
|
-
If `/
|
|
398
|
+
If `/autopilot` is interrupted or paused, ensure STATE.md reflects where it stopped so the next `/autopilot` run can resume correctly. Plan document checkboxes are updated by the implement/parallelize agents.
|
|
399
399
|
|
|
400
400
|
### Keep the User Informed
|
|
401
401
|
- Brief status updates between major steps
|
|
@@ -26,7 +26,7 @@ Before brainstorming, quickly assess the current project:
|
|
|
26
26
|
**Is this an empty/new project?** If there are fewer than 5 source files and no meaningful project configuration, this is likely a **new project**. In that case:
|
|
27
27
|
- Mention to the user that this looks like a new project and brainstorming is a great starting point
|
|
28
28
|
- The brainstorm should focus heavily on **tech stack decisions** (see Step 1 below)
|
|
29
|
-
- When brainstorming is complete, suggest `/
|
|
29
|
+
- When brainstorming is complete, suggest `/autopilot` which will handle planning, bootstrapping, and implementation end-to-end
|
|
30
30
|
|
|
31
31
|
## Brainstorming Framework
|
|
32
32
|
|
|
@@ -112,7 +112,7 @@ Throughout brainstorming, actively use the `/critique`, `/verify`, and `/challen
|
|
|
112
112
|
|
|
113
113
|
If the user shares images during brainstorming (screenshots, mockups, design references, wireframes, inspiration), **track their file paths**. These are critical for downstream plan creation.
|
|
114
114
|
|
|
115
|
-
When brainstorming is complete and you suggest `/plan` or `/
|
|
115
|
+
When brainstorming is complete and you suggest `/plan` or `/autopilot`:
|
|
116
116
|
- Mention the collected image paths in your handoff so the plan agent copies them to `{{TASKS_DIR}}/references/`
|
|
117
117
|
- If images were shared via the conversation (e.g., user provided a file path or pasted a screenshot), note them explicitly in the brainstorm summary
|
|
118
118
|
|
|
@@ -140,14 +140,14 @@ Once we've thoroughly explored the problem space, settled on a tech stack, and c
|
|
|
140
140
|
| Command | What it does |
|
|
141
141
|
|---|---|
|
|
142
142
|
| `/bootstrap {NAME}` | Generate a plan + bootstrap script to scaffold the project. Good when you want to review the scaffolding before building. |
|
|
143
|
-
| `/
|
|
143
|
+
| `/autopilot {NAME}` | Full autonomous loop — planning, bootstrapping, implementation, and commit. Good when you want to go hands-off. |
|
|
144
144
|
|
|
145
145
|
**For existing projects:**
|
|
146
146
|
|
|
147
147
|
| Command | What it does |
|
|
148
148
|
|---|---|
|
|
149
149
|
| `/plan {NAME}` | Capture brainstorming findings into a structured implementation plan. Good when you want to review before implementing. |
|
|
150
|
-
| `/
|
|
150
|
+
| `/autopilot {NAME}` | Full autonomous loop — planning, implementation, validation, and commit. Good when you want to go hands-off. |
|
|
151
151
|
|
|
152
152
|
Always present the relevant options and let the user choose how they want to proceed.
|
|
153
153
|
|
|
@@ -41,6 +41,7 @@ Launching the **implement agent** which will work independently in a separate co
|
|
|
41
41
|
- ✅ Validate each phase before proceeding
|
|
42
42
|
- ✅ Handle blockers (will pause and report)
|
|
43
43
|
- ✅ Adapt plan if better approaches discovered
|
|
44
|
+
- ✅ Run DRY checks after each phase to extract shared patterns
|
|
44
45
|
- ✅ Return comprehensive summary when complete
|
|
45
46
|
|
|
46
47
|
### What You'll See
|
|
@@ -36,7 +36,7 @@ I'll work through this plan collaboratively with you:
|
|
|
36
36
|
|
|
37
37
|
1. **Load & Review**: I'll load the plan and show you a summary
|
|
38
38
|
2. **Environment Check**: Verify git status and project state
|
|
39
|
-
3. **Convention Discovery**: Scan the codebase for established patterns (error handling, styling, state management, data fetching, test infrastructure) and share findings so we're aligned on which patterns to follow
|
|
39
|
+
3. **Convention Discovery**: Scan the codebase for established patterns (error handling, styling, state management, data fetching, test infrastructure) and share findings so we're aligned on which patterns to follow. Look at how existing code is structured — never add inline styles unless absolutely necessary, always use the project's established styling method
|
|
40
40
|
4. **Task Tracking**: Set up TodoWrite for all plan tasks
|
|
41
41
|
5. **Step-by-Step**: Execute tasks one at a time with your input
|
|
42
42
|
6. **Validation**: Run type checks and lints after each task
|
|
@@ -74,3 +74,5 @@ Then ask: "Ready to start implementing? Which phase should we tackle first?"
|
|
|
74
74
|
Use TodoWrite to create todos for all tasks from the plan once user confirms.
|
|
75
75
|
|
|
76
76
|
Then begin executing tasks step-by-step, staying in the main context, validating as you go.
|
|
77
|
+
|
|
78
|
+
After completing each phase, run `/dry` to check if any repeated patterns or duplicated code should be extracted into shared utilities, components, or constants. Fix any DRY violations before moving to the next phase.
|
|
@@ -49,7 +49,7 @@ If no references are provided, the agent will ask you to choose a style directio
|
|
|
49
49
|
|
|
50
50
|
### How It Integrates
|
|
51
51
|
|
|
52
|
-
- In `/
|
|
52
|
+
- In `/autopilot` or `/implement` — if the plan includes a landing page task, the showcase agent is used instead of the generic implement agent for that task
|
|
53
53
|
- In `/parallelize` — landing page work can be a dedicated stream using the showcase agent
|
|
54
54
|
- Standalone — run `/showcase` directly to design a landing page from scratch or redesign an existing one
|
|
55
55
|
|
package/package.json
CHANGED