prizmkit 1.1.40 → 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/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/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 +8 -2
- package/bundled/skills/feature-pipeline-launcher/SKILL.md +8 -2
- 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/refactor-pipeline-launcher/SKILL.md +8 -2
- 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,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]
|