prizmkit 1.1.39 → 1.1.41
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/bundled/VERSION.json +3 -3
- package/bundled/dev-pipeline/SCHEMA_ANALYSIS.md +1 -1
- package/bundled/dev-pipeline/run-bugfix.sh +74 -0
- package/bundled/dev-pipeline/run-feature.sh +74 -0
- package/bundled/dev-pipeline/run-refactor.sh +74 -0
- package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py +0 -6
- package/bundled/dev-pipeline/scripts/generate-bugfix-prompt.py +118 -1
- package/bundled/dev-pipeline/scripts/generate-refactor-prompt.py +123 -8
- package/bundled/dev-pipeline/templates/bootstrap-tier1.md +0 -23
- package/bundled/dev-pipeline/templates/bootstrap-tier2.md +0 -23
- package/bundled/dev-pipeline/templates/bootstrap-tier3.md +0 -23
- package/bundled/dev-pipeline/templates/bug-fix-list-schema.json +22 -3
- package/bundled/dev-pipeline/templates/bugfix-bootstrap-prompt.md +56 -0
- package/bundled/dev-pipeline/templates/refactor-bootstrap-prompt.md +64 -4
- package/bundled/dev-pipeline/templates/refactor-list-schema.json +22 -3
- package/bundled/dev-pipeline/tests/test-deploy-safety.sh +223 -0
- package/bundled/skills/_metadata.json +3 -3
- package/bundled/skills/app-planner/SKILL.md +0 -3
- package/bundled/skills/bugfix-pipeline-launcher/SKILL.md +34 -6
- package/bundled/skills/feature-pipeline-launcher/SKILL.md +42 -18
- package/bundled/skills/prizmkit-committer/SKILL.md +0 -1
- package/bundled/skills/prizmkit-deploy/SKILL.md +491 -209
- package/bundled/skills/prizmkit-deploy/references/cloud-platform-deploy.md +93 -0
- package/bundled/skills/prizmkit-deploy/references/deploy-config-schema.md +147 -0
- package/bundled/skills/prizmkit-deploy/references/deploy-history-schema.md +62 -0
- package/bundled/skills/prizmkit-deploy/references/docker-deploy.md +31 -0
- package/bundled/skills/prizmkit-deploy/references/nginx-blue-green.md +59 -0
- package/bundled/skills/prizmkit-init/SKILL.md +0 -2
- package/bundled/skills/prizmkit-plan/SKILL.md +0 -3
- package/bundled/skills/recovery-workflow/SKILL.md +96 -7
- package/bundled/skills/refactor-pipeline-launcher/SKILL.md +40 -9
- package/package.json +1 -1
- package/bundled/dev-pipeline/templates/sections/phase-deploy-verification.md +0 -31
- package/bundled/skills/prizmkit-deploy/assets/deploy-template.md +0 -187
|
@@ -1,31 +0,0 @@
|
|
|
1
|
-
### Local Deploy Verification
|
|
2
|
-
|
|
3
|
-
You just implemented this feature — you know the project's tech stack and build tools.
|
|
4
|
-
|
|
5
|
-
1. **Build**: Run the project's build/compile commands. If a required tool is missing, install it first.
|
|
6
|
-
2. **Fix**: If build fails with code errors (type errors, missing imports, config issues), fix them (max 2 rounds), then re-verify.
|
|
7
|
-
3. **Assess and record** — append to context-snapshot.md:
|
|
8
|
-
- **ALL builds pass** → `## Deploy Verification: PASS` — proceed to commit
|
|
9
|
-
- **Some builds fail with fixable errors** → fix and re-verify (already handled in step 2)
|
|
10
|
-
- **Cannot build locally** (missing system-level deps you cannot install) → Record: `## Deploy Verification: PARTIAL — missing system deps (see below)`
|
|
11
|
-
|
|
12
|
-
Deploy verification does NOT block the commit, but you MUST attempt it.
|
|
13
|
-
|
|
14
|
-
**Smoke test** (only if build passed and project can be started):
|
|
15
|
-
1. Start the project locally (e.g., `make dev`, `npm start`, `go run .`, etc.)
|
|
16
|
-
2. Verify basic functionality: hit key endpoints, check health routes, confirm the UI loads
|
|
17
|
-
3. Stop the server process you started — do NOT leave it running
|
|
18
|
-
4. Record smoke test results in `## Deploy Verification` section
|
|
19
|
-
|
|
20
|
-
If the project cannot be started locally (e.g., requires external services, databases, credentials), skip the smoke test and note why.
|
|
21
|
-
|
|
22
|
-
**Deploy documentation update** — Run `/prizmkit-deploy` ONLY if this feature introduced new infrastructure or deployment-affecting changes:
|
|
23
|
-
- New database, cache, message queue, or external service dependency
|
|
24
|
-
- New environment variables required
|
|
25
|
-
- New build steps or deployment configuration (Dockerfile, CI/CD, cloud config)
|
|
26
|
-
- Changed ports, protocols, or service topology
|
|
27
|
-
|
|
28
|
-
If none of the above apply (pure application logic change), skip `/prizmkit-deploy`.
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
**Checkpoint update**: Update `workflow-checkpoint.json` — set step `deploy-verification` to `"completed"`.
|
|
@@ -1,187 +0,0 @@
|
|
|
1
|
-
# Deployment Guide: [PROJECT_NAME]
|
|
2
|
-
<!-- Replace [PROJECT_NAME] with: name from package.json, or the project root directory name -->
|
|
3
|
-
|
|
4
|
-
> Generated by PrizmKit Deploy
|
|
5
|
-
|
|
6
|
-
## Prerequisites
|
|
7
|
-
|
|
8
|
-
| Tool | Version | Install |
|
|
9
|
-
|------|---------|---------|
|
|
10
|
-
| [tool] | [version] | [install command or link] |
|
|
11
|
-
|
|
12
|
-
## Environment Variables
|
|
13
|
-
|
|
14
|
-
| Variable | Required | Description | Default | Example |
|
|
15
|
-
|----------|----------|-------------|---------|---------|
|
|
16
|
-
| [VAR_NAME] | yes/no | [Purpose] | [default or n/a] | [example value] |
|
|
17
|
-
|
|
18
|
-
**Setup:**
|
|
19
|
-
```bash
|
|
20
|
-
cp .env.example .env
|
|
21
|
-
# Edit .env with your values
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
## Local Development
|
|
25
|
-
|
|
26
|
-
### First-time Setup
|
|
27
|
-
```bash
|
|
28
|
-
# [Clone + install steps]
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
### Run Locally
|
|
32
|
-
```bash
|
|
33
|
-
# [Start command]
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
### Local Services
|
|
37
|
-
<!-- If docker-compose or similar is used for local dependencies -->
|
|
38
|
-
```bash
|
|
39
|
-
# [Local services startup]
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
## Database Setup
|
|
43
|
-
<!-- Skip if project does not use a database -->
|
|
44
|
-
|
|
45
|
-
### Database Type
|
|
46
|
-
[PostgreSQL / MySQL / MongoDB / SQLite / etc.]
|
|
47
|
-
|
|
48
|
-
### Initial Setup
|
|
49
|
-
```bash
|
|
50
|
-
# [Database creation commands]
|
|
51
|
-
# [Initial migration or schema setup]
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
### Run Migrations
|
|
55
|
-
```bash
|
|
56
|
-
# [Migration command, e.g., npx prisma migrate deploy, alembic upgrade head]
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
### Seed Data
|
|
60
|
-
```bash
|
|
61
|
-
# [Seed command if applicable, or "No seed data configured"]
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
### Database Conventions
|
|
65
|
-
<!-- Auto-populated from CLAUDE.md ### Infrastructure → #### Database -->
|
|
66
|
-
<!-- Filled progressively: basic info from prizmkit-init, detailed conventions from app-planner, verified by prizmkit-deploy -->
|
|
67
|
-
- Table naming: [convention]
|
|
68
|
-
- Migration directory: [path]
|
|
69
|
-
- Migration naming: [rule]
|
|
70
|
-
|
|
71
|
-
## Testing
|
|
72
|
-
|
|
73
|
-
### Run Tests
|
|
74
|
-
```bash
|
|
75
|
-
# [Test commands]
|
|
76
|
-
```
|
|
77
|
-
|
|
78
|
-
### Staging / Pre-production
|
|
79
|
-
<!-- How to test against a staging environment -->
|
|
80
|
-
- Staging URL: [URL or "not configured"]
|
|
81
|
-
- Deploy to staging: [command or process]
|
|
82
|
-
|
|
83
|
-
## Build
|
|
84
|
-
|
|
85
|
-
```bash
|
|
86
|
-
# [Build command]
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
**Output:** [where build artifacts go, e.g. `dist/`, `build/`, binary path]
|
|
90
|
-
|
|
91
|
-
## Production Deployment
|
|
92
|
-
|
|
93
|
-
### Deployment Method
|
|
94
|
-
<!-- Filled from deploy_strategy in config -->
|
|
95
|
-
[Description of production deployment approach]
|
|
96
|
-
|
|
97
|
-
### Step-by-step
|
|
98
|
-
1. [Step 1]
|
|
99
|
-
2. [Step 2]
|
|
100
|
-
3. [Step 3]
|
|
101
|
-
|
|
102
|
-
### Post-deployment Verification
|
|
103
|
-
```bash
|
|
104
|
-
# [Health check or smoke test command]
|
|
105
|
-
```
|
|
106
|
-
|
|
107
|
-
## CI/CD
|
|
108
|
-
<!-- Skip if no CI/CD config detected -->
|
|
109
|
-
|
|
110
|
-
| Pipeline | Trigger | Action |
|
|
111
|
-
|----------|---------|--------|
|
|
112
|
-
| [pipeline name] | [trigger event] | [what it does] |
|
|
113
|
-
|
|
114
|
-
## Rollback
|
|
115
|
-
|
|
116
|
-
### How to Rollback
|
|
117
|
-
1. [Rollback step 1]
|
|
118
|
-
2. [Rollback step 2]
|
|
119
|
-
|
|
120
|
-
### When to Rollback
|
|
121
|
-
- [Criteria that warrant a rollback]
|
|
122
|
-
|
|
123
|
-
## Health Check
|
|
124
|
-
|
|
125
|
-
| Check | Endpoint / Command | Expected Result |
|
|
126
|
-
|-------|-------------------|-----------------|
|
|
127
|
-
| [check name] | [endpoint or command] | [expected output] |
|
|
128
|
-
|
|
129
|
-
## Platform-Specific Deploy Commands
|
|
130
|
-
<!-- Auto-populated based on deployment target from CLAUDE.md ### Infrastructure → #### Deployment -->
|
|
131
|
-
<!-- Filled progressively: basic target from prizmkit-init, detailed config from app-planner, verified by prizmkit-deploy -->
|
|
132
|
-
|
|
133
|
-
### [Platform Name]
|
|
134
|
-
```bash
|
|
135
|
-
# Pre-flight
|
|
136
|
-
[version check command]
|
|
137
|
-
[auth check command]
|
|
138
|
-
|
|
139
|
-
# Deploy
|
|
140
|
-
[deploy command]
|
|
141
|
-
|
|
142
|
-
# Verify
|
|
143
|
-
[post-deploy verification command]
|
|
144
|
-
```
|
|
145
|
-
|
|
146
|
-
## AI Deploy Playbook
|
|
147
|
-
<!-- Used by prizmkit-deploy Phase 4 when AI-assisted deploy is enabled -->
|
|
148
|
-
<!-- This section is auto-generated — do not edit manually unless you want to customize the sequence -->
|
|
149
|
-
|
|
150
|
-
### Pre-flight Checklist
|
|
151
|
-
- [ ] CLI tool installed: [tool name + version command]
|
|
152
|
-
- [ ] Authentication verified: [auth check command or "logged in via [method]"]
|
|
153
|
-
- [ ] Environment variables set: [list of required env vars for deployment]
|
|
154
|
-
- [ ] Build successful: [build command]
|
|
155
|
-
|
|
156
|
-
### Command Sequence
|
|
157
|
-
<!-- Ordered list of commands AI will execute step-by-step with user confirmation -->
|
|
158
|
-
1. `[command 1]` — [what it does]
|
|
159
|
-
2. `[command 2]` — [what it does]
|
|
160
|
-
3. `[command 3]` — [what it does]
|
|
161
|
-
|
|
162
|
-
### Post-Deploy Verification
|
|
163
|
-
- [ ] Health check: [command or URL]
|
|
164
|
-
- [ ] Smoke test: [manual or automated check]
|
|
165
|
-
|
|
166
|
-
### Rollback (if deploy fails)
|
|
167
|
-
```bash
|
|
168
|
-
# [Rollback command specific to the platform]
|
|
169
|
-
```
|
|
170
|
-
|
|
171
|
-
## Deployment Credentials Reference
|
|
172
|
-
<!-- This information is stored in CLAUDE.md / CODEBUDDY.md ### Infrastructure → #### Deployment Credentials Reference -->
|
|
173
|
-
<!-- Listed here for quick reference during deployment execution -->
|
|
174
|
-
|
|
175
|
-
| Platform | Auth Method | Location |
|
|
176
|
-
|----------|------------|----------|
|
|
177
|
-
| [platform] | [method, e.g., API token, SSH key, CLI login] | [where stored, e.g., VERCEL_TOKEN env var] |
|
|
178
|
-
|
|
179
|
-
## Troubleshooting
|
|
180
|
-
|
|
181
|
-
| Symptom | Cause | Fix |
|
|
182
|
-
|---------|-------|-----|
|
|
183
|
-
| [symptom] | [likely cause] | [resolution steps] |
|
|
184
|
-
|
|
185
|
-
## TODO
|
|
186
|
-
<!-- Auto-generated: items that need manual attention -->
|
|
187
|
-
- [ ] [items prizmkit-deploy could not auto-fill]
|