prizmkit 1.0.153 → 1.1.0
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/bin/create-prizmkit.js +27 -2
- package/bundled/VERSION.json +3 -3
- package/bundled/adapters/claude/paths.js +1 -1
- package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py +482 -57
- package/bundled/dev-pipeline/scripts/parse-stream-progress.py +2 -6
- package/bundled/dev-pipeline/templates/bootstrap-tier1.md +6 -0
- package/bundled/dev-pipeline/templates/bootstrap-tier2.md +6 -0
- package/bundled/dev-pipeline/templates/bootstrap-tier3.md +7 -1
- package/bundled/dev-pipeline/templates/sections/context-budget-rules.md +11 -0
- package/bundled/dev-pipeline/templates/sections/critical-paths-agent.md +9 -0
- package/bundled/dev-pipeline/templates/sections/critical-paths-full.md +12 -0
- package/bundled/dev-pipeline/templates/sections/critical-paths-lite.md +7 -0
- package/bundled/dev-pipeline/templates/sections/directory-convention-agent.md +8 -0
- package/bundled/dev-pipeline/templates/sections/directory-convention-full.md +9 -0
- package/bundled/dev-pipeline/templates/sections/directory-convention-lite.md +6 -0
- package/bundled/dev-pipeline/templates/sections/failure-capture.md +21 -0
- package/bundled/dev-pipeline/templates/sections/failure-log-check.md +8 -0
- package/bundled/dev-pipeline/templates/sections/feature-context.md +23 -0
- package/bundled/dev-pipeline/templates/sections/phase-analyze-agent.md +15 -0
- package/bundled/dev-pipeline/templates/sections/phase-analyze-full.md +15 -0
- package/bundled/dev-pipeline/templates/sections/phase-browser-verification.md +31 -0
- package/bundled/dev-pipeline/templates/sections/phase-commit-full.md +36 -0
- package/bundled/dev-pipeline/templates/sections/phase-commit.md +26 -0
- package/bundled/dev-pipeline/templates/sections/phase-context-snapshot-agent-suffix.md +14 -0
- package/bundled/dev-pipeline/templates/sections/phase-context-snapshot-base.md +20 -0
- package/bundled/dev-pipeline/templates/sections/phase-context-snapshot-lite-suffix.md +3 -0
- package/bundled/dev-pipeline/templates/sections/phase-critic-code.md +24 -0
- package/bundled/dev-pipeline/templates/sections/phase-critic-plan-full.md +45 -0
- package/bundled/dev-pipeline/templates/sections/phase-critic-plan.md +24 -0
- package/bundled/dev-pipeline/templates/sections/phase-deploy-verification.md +36 -0
- package/bundled/dev-pipeline/templates/sections/phase-implement-agent.md +24 -0
- package/bundled/dev-pipeline/templates/sections/phase-implement-full.md +41 -0
- package/bundled/dev-pipeline/templates/sections/phase-implement-lite.md +32 -0
- package/bundled/dev-pipeline/templates/sections/phase-plan-agent.md +17 -0
- package/bundled/dev-pipeline/templates/sections/phase-plan-lite.md +16 -0
- package/bundled/dev-pipeline/templates/sections/phase-review-agent.md +28 -0
- package/bundled/dev-pipeline/templates/sections/phase-review-full.md +36 -0
- package/bundled/dev-pipeline/templates/sections/phase-specify-plan-full.md +82 -0
- package/bundled/dev-pipeline/templates/sections/phase0-init.md +4 -0
- package/bundled/dev-pipeline/templates/sections/phase0-test-baseline.md +12 -0
- package/bundled/dev-pipeline/templates/sections/resume-header.md +2 -0
- package/bundled/dev-pipeline/templates/sections/session-context.md +6 -0
- package/bundled/dev-pipeline/templates/sections/subagent-timeout-recovery.md +6 -0
- package/bundled/skills/_metadata.json +21 -177
- package/bundled/skills/app-planner/SKILL.md +22 -3
- package/bundled/skills/app-planner/references/project-brief-guide.md +110 -0
- package/bundled/skills/bug-fix-workflow/SKILL.md +4 -0
- package/bundled/skills/bug-planner/SKILL.md +2 -2
- package/bundled/skills/dev-pipeline-launcher/SKILL.md +1 -1
- package/bundled/skills/prizm-kit/SKILL.md +18 -47
- package/bundled/skills/prizm-kit/assets/project-memory-template.md +1 -1
- package/bundled/skills/prizmkit-analyze/SKILL.md +4 -4
- package/bundled/skills/prizmkit-init/SKILL.md +4 -4
- package/bundled/skills/prizmkit-plan/SKILL.md +126 -108
- package/bundled/skills/prizmkit-plan/assets/plan-template.md +1 -2
- package/bundled/skills/refactor-workflow/SKILL.md +142 -124
- package/bundled/team/prizm-dev-team.json +2 -8
- package/package.json +1 -1
- package/src/clean.js +8 -0
- package/src/gitignore-template.js +12 -0
- package/src/index.js +3 -22
- package/src/scaffold.js +20 -11
- package/src/upgrade.js +6 -31
- package/bundled/skills/prizmkit-clarify/SKILL.md +0 -93
- package/bundled/skills/prizmkit-specify/SKILL.md +0 -118
- package/bundled/skills/prizmkit-specify/assets/spec-template.md +0 -56
- package/bundled/skills/prizmkit-tool-adr-manager/SKILL.md +0 -67
- package/bundled/skills/prizmkit-tool-adr-manager/assets/adr-template.md +0 -26
- package/bundled/skills/prizmkit-tool-api-doc-generator/SKILL.md +0 -55
- package/bundled/skills/prizmkit-tool-bug-reproducer/SKILL.md +0 -61
- package/bundled/skills/prizmkit-tool-ci-cd-generator/SKILL.md +0 -53
- package/bundled/skills/prizmkit-tool-db-migration/SKILL.md +0 -64
- package/bundled/skills/prizmkit-tool-dependency-health/SKILL.md +0 -122
- package/bundled/skills/prizmkit-tool-deployment-strategy/SKILL.md +0 -57
- package/bundled/skills/prizmkit-tool-error-triage/SKILL.md +0 -54
- package/bundled/skills/prizmkit-tool-log-analyzer/SKILL.md +0 -54
- package/bundled/skills/prizmkit-tool-monitoring-setup/SKILL.md +0 -74
- package/bundled/skills/prizmkit-tool-onboarding-generator/SKILL.md +0 -69
- package/bundled/skills/prizmkit-tool-perf-profiler/SKILL.md +0 -54
- package/bundled/skills/prizmkit-tool-security-audit/SKILL.md +0 -129
- package/bundled/skills/prizmkit-tool-tech-debt-tracker/SKILL.md +0 -138
|
@@ -1,53 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: "prizmkit-tool-ci-cd-generator"
|
|
3
|
-
description: [Tier 2] Generate CI/CD pipeline config templates for GitHub Actions/GitLab CI/Jenkins. Cannot validate or test pipelines. (project)
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# PrizmKit CI/CD Generator
|
|
7
|
-
|
|
8
|
-
Generate production-ready CI/CD pipeline configurations derived from your project's tech stack context.
|
|
9
|
-
|
|
10
|
-
## Commands
|
|
11
|
-
|
|
12
|
-
### `/prizmkit-ci`-cd
|
|
13
|
-
|
|
14
|
-
Generate a CI/CD pipeline configuration for the project.
|
|
15
|
-
|
|
16
|
-
**STEPS:**
|
|
17
|
-
|
|
18
|
-
1. Read `.prizm-docs/root.prizm` for tech stack context (LANG, FRAMEWORK, BUILD, TEST)
|
|
19
|
-
2. Ask user: target platform
|
|
20
|
-
- GitHub Actions
|
|
21
|
-
- GitLab CI
|
|
22
|
-
- Jenkins
|
|
23
|
-
- Other (specify)
|
|
24
|
-
3. Ask user: environments to configure (dev, staging, production)
|
|
25
|
-
4. Generate pipeline config with stages:
|
|
26
|
-
- **Install dependencies**: Use project's package manager (npm, pip, cargo, etc.)
|
|
27
|
-
- **Lint/format check**: Run linter and formatter configured in project
|
|
28
|
-
- **Run tests**: Execute test suite with coverage reporting
|
|
29
|
-
- **Build artifact**: Compile/bundle project output
|
|
30
|
-
- **Deploy**: Per-environment deployment steps
|
|
31
|
-
5. Include in generated config:
|
|
32
|
-
- Dependency caching (language-appropriate cache keys)
|
|
33
|
-
- Artifact management (build outputs, test reports)
|
|
34
|
-
- Environment variable placeholders with descriptive comments
|
|
35
|
-
6. Write config to standard location:
|
|
36
|
-
- GitHub Actions: `.github/workflows/ci.yml` and `.github/workflows/deploy.yml`
|
|
37
|
-
- GitLab CI: `.gitlab-ci.yml`
|
|
38
|
-
- Jenkins: `Jenkinsfile`
|
|
39
|
-
7. Add environment-specific secrets as placeholders with `# TODO: Configure in CI/CD settings` comments
|
|
40
|
-
8. Generate a README section documenting the CI/CD setup:
|
|
41
|
-
- Pipeline overview
|
|
42
|
-
- Required secrets and environment variables
|
|
43
|
-
- How to trigger deployments
|
|
44
|
-
- How to add new stages
|
|
45
|
-
|
|
46
|
-
## Path References
|
|
47
|
-
|
|
48
|
-
All internal asset paths MUST use `.claude/commands/prizmkit-ci-cd-generator` placeholder for cross-IDE compatibility.
|
|
49
|
-
|
|
50
|
-
## Output
|
|
51
|
-
|
|
52
|
-
- Pipeline configuration file(s) in the appropriate standard location
|
|
53
|
-
- README section or standalone CI/CD documentation
|
|
@@ -1,64 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: "prizmkit-tool-db-migration"
|
|
3
|
-
description: [Tier 2] Database migration script generation with rollback plans. Cannot validate against actual database. (project)
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# PrizmKit Database Migration
|
|
7
|
-
|
|
8
|
-
Plan safe database schema changes with forward and backward migration scripts, risk assessment, and verification queries.
|
|
9
|
-
|
|
10
|
-
## Commands
|
|
11
|
-
|
|
12
|
-
### `/prizmkit-db`-migrate
|
|
13
|
-
|
|
14
|
-
Generate a database migration plan with scripts and rollback procedures.
|
|
15
|
-
|
|
16
|
-
**STEPS:**
|
|
17
|
-
|
|
18
|
-
1. Read current data model from `.prizmkit/specs/` or `.prizm-docs/` (entity definitions, relationships, constraints)
|
|
19
|
-
2. Ask user: describe the schema change needed
|
|
20
|
-
- What tables/collections are affected
|
|
21
|
-
- What is the desired end state
|
|
22
|
-
- Any data transformation requirements
|
|
23
|
-
3. Analyze change type:
|
|
24
|
-
- **Additive** (safe): New tables, new nullable columns, new indexes
|
|
25
|
-
- **Destructive** (risky): Drop tables, drop columns, change types with data loss
|
|
26
|
-
- **Transformative** (complex): Rename columns, split/merge tables, data backfill
|
|
27
|
-
4. Generate migration plan:
|
|
28
|
-
- **Pre-migration**:
|
|
29
|
-
- Backup command for affected tables
|
|
30
|
-
- List of affected tables and estimated row counts
|
|
31
|
-
- Estimated downtime (if any)
|
|
32
|
-
- **Forward migration**: SQL or ORM migration script
|
|
33
|
-
- Schema DDL statements
|
|
34
|
-
- Data migration DML statements (if applicable)
|
|
35
|
-
- Index creation (CONCURRENTLY where supported)
|
|
36
|
-
- **Backward migration (rollback)**: Reverse SQL or ORM script
|
|
37
|
-
- Reverse DDL statements
|
|
38
|
-
- Data restoration approach
|
|
39
|
-
- MUST be tested before deploying forward migration
|
|
40
|
-
- **Data verification**: Queries to validate migration success
|
|
41
|
-
- Row count comparisons
|
|
42
|
-
- Data integrity checks
|
|
43
|
-
- Constraint validation
|
|
44
|
-
5. Risk assessment:
|
|
45
|
-
- **Data loss potential**: NONE / LOW / MEDIUM / HIGH
|
|
46
|
-
- **Downtime estimate**: Zero / Seconds / Minutes / Hours
|
|
47
|
-
- **Recommended deployment strategy**: Online migration vs offline migration
|
|
48
|
-
- **Lock contention risk**: Which tables will be locked and for how long
|
|
49
|
-
6. Write migration files to project's migration directory convention (detect from existing migrations or ask user)
|
|
50
|
-
7. Generate `migration-plan.md` with complete procedure:
|
|
51
|
-
- Step-by-step execution guide
|
|
52
|
-
- Monitoring queries to run during migration
|
|
53
|
-
- Success criteria
|
|
54
|
-
- Abort conditions
|
|
55
|
-
|
|
56
|
-
## Path References
|
|
57
|
-
|
|
58
|
-
All internal asset paths MUST use `.claude/commands/prizmkit-db-migration` placeholder for cross-IDE compatibility.
|
|
59
|
-
|
|
60
|
-
## Output
|
|
61
|
-
|
|
62
|
-
- Migration script file(s) in the project's migration directory
|
|
63
|
-
- Rollback script file(s) alongside migration scripts
|
|
64
|
-
- `migration-plan.md`: Complete migration procedure with risk assessment
|
|
@@ -1,122 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: "prizmkit-tool-dependency-health"
|
|
3
|
-
description: [Tier 2] Dependency review based on manifest files. Analyzes version patterns; cannot query package registries for real-time vulnerability data. (project)
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# PrizmKit Dependency Health
|
|
7
|
-
|
|
8
|
-
Audit project dependencies across all supported ecosystems. Identifies outdated packages, known vulnerabilities, license conflicts, and abandoned projects. Generates a health report with prioritized upgrade recommendations.
|
|
9
|
-
|
|
10
|
-
### When to Use
|
|
11
|
-
- User says "check dependencies", "dependency audit", "are my packages up to date"
|
|
12
|
-
- Before a major release or deployment
|
|
13
|
-
- Periodically as part of maintenance workflow
|
|
14
|
-
- After security advisories are published
|
|
15
|
-
|
|
16
|
-
### `/prizmkit-dependency`-health
|
|
17
|
-
|
|
18
|
-
### Steps
|
|
19
|
-
|
|
20
|
-
#### Step 1: Detect Dependency Files
|
|
21
|
-
Scan project root and subdirectories for:
|
|
22
|
-
- **Node.js**: package.json + package-lock.json / yarn.lock / pnpm-lock.yaml
|
|
23
|
-
- **Python**: requirements.txt / Pipfile / pyproject.toml / setup.py
|
|
24
|
-
- **Go**: go.mod / go.sum
|
|
25
|
-
- **Rust**: Cargo.toml / Cargo.lock
|
|
26
|
-
- **Java**: pom.xml / build.gradle / build.gradle.kts
|
|
27
|
-
- **Ruby**: Gemfile / Gemfile.lock
|
|
28
|
-
- **PHP**: composer.json / composer.lock
|
|
29
|
-
- **.NET**: *.csproj / packages.config
|
|
30
|
-
|
|
31
|
-
#### Step 2: Analyze Each Dependency
|
|
32
|
-
For each dependency found:
|
|
33
|
-
- Current version pinned in manifest
|
|
34
|
-
- Latest available version (if determinable from lock files or version patterns)
|
|
35
|
-
- Major/minor/patch version delta
|
|
36
|
-
- Known security advisories (if detectable from version ranges)
|
|
37
|
-
- License type and compatibility
|
|
38
|
-
|
|
39
|
-
#### Step 3: Classify Health Status
|
|
40
|
-
- **HEALTHY**: Up to date or within 1 minor version, no known issues
|
|
41
|
-
- **STALE**: 1+ major version behind latest
|
|
42
|
-
- **VULNERABLE**: Known security advisory for current version
|
|
43
|
-
- **ABANDONED**: No updates in 2+ years (based on available metadata)
|
|
44
|
-
- **INCOMPATIBLE**: License conflict with project license
|
|
45
|
-
|
|
46
|
-
#### Step 4: Generate Recommendations
|
|
47
|
-
Prioritized by risk:
|
|
48
|
-
|
|
49
|
-
**Safe Updates** (low risk):
|
|
50
|
-
- Patch version bumps (bug fixes only)
|
|
51
|
-
- Minor version bumps within same major (backward compatible)
|
|
52
|
-
|
|
53
|
-
**Breaking Updates** (medium risk):
|
|
54
|
-
- Major version bumps — list known breaking changes where identifiable
|
|
55
|
-
- Suggest migration steps if available
|
|
56
|
-
|
|
57
|
-
**Replacements** (high effort):
|
|
58
|
-
- For abandoned packages — suggest actively maintained alternatives
|
|
59
|
-
- For packages with unresolved vulnerabilities — suggest secure alternatives
|
|
60
|
-
|
|
61
|
-
#### Step 5: Generate Report
|
|
62
|
-
Output health report to conversation (READ-ONLY):
|
|
63
|
-
|
|
64
|
-
```markdown
|
|
65
|
-
# Dependency Health Report
|
|
66
|
-
Date: YYYY-MM-DD
|
|
67
|
-
Project: <project-name>
|
|
68
|
-
|
|
69
|
-
## Summary
|
|
70
|
-
- Total dependencies: N
|
|
71
|
-
- Healthy: N | Stale: N | Vulnerable: N | Abandoned: N
|
|
72
|
-
|
|
73
|
-
## Ecosystem: <Node.js / Python / etc.>
|
|
74
|
-
|
|
75
|
-
### Vulnerable (Action Required)
|
|
76
|
-
| Package | Current | Latest | Advisory | Severity |
|
|
77
|
-
|---------|---------|--------|----------|----------|
|
|
78
|
-
| example | 1.2.3 | 1.2.5 | CVE-XXX | HIGH |
|
|
79
|
-
|
|
80
|
-
### Stale (Upgrade Recommended)
|
|
81
|
-
| Package | Current | Latest | Versions Behind |
|
|
82
|
-
|---------|---------|--------|-----------------|
|
|
83
|
-
| example | 2.0.0 | 4.1.0 | 2 major |
|
|
84
|
-
|
|
85
|
-
### Abandoned (Consider Replacing)
|
|
86
|
-
| Package | Last Update | Suggested Alternative |
|
|
87
|
-
|---------|-------------|----------------------|
|
|
88
|
-
| example | 2021-01-01 | better-example |
|
|
89
|
-
|
|
90
|
-
### Healthy
|
|
91
|
-
N packages up to date.
|
|
92
|
-
|
|
93
|
-
## Recommended Actions
|
|
94
|
-
1. Run: <package-manager-specific update commands>
|
|
95
|
-
2. Review breaking changes for: <packages>
|
|
96
|
-
3. Evaluate replacements for: <packages>
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
#### Step 6: Suggest Update Commands
|
|
100
|
-
Provide copy-paste commands for the project's package manager:
|
|
101
|
-
|
|
102
|
-
**Node.js**:
|
|
103
|
-
```bash
|
|
104
|
-
npm update # safe updates
|
|
105
|
-
npm install <pkg>@latest # major updates (one at a time)
|
|
106
|
-
npx npm-check-updates -u # update all to latest
|
|
107
|
-
```
|
|
108
|
-
|
|
109
|
-
**Python**:
|
|
110
|
-
```bash
|
|
111
|
-
pip install --upgrade <pkg> # upgrade specific
|
|
112
|
-
pip install -r requirements.txt --upgrade # upgrade all
|
|
113
|
-
```
|
|
114
|
-
|
|
115
|
-
**Go**:
|
|
116
|
-
```bash
|
|
117
|
-
go get -u ./... # update all
|
|
118
|
-
go get <pkg>@latest # update specific
|
|
119
|
-
go mod tidy # clean up
|
|
120
|
-
```
|
|
121
|
-
|
|
122
|
-
Adapt commands to the detected package manager.
|
|
@@ -1,57 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: "prizmkit-tool-deployment-strategy"
|
|
3
|
-
description: [Tier 2] Deployment planning with rollback procedures for blue-green/canary/rolling strategies. Planning only, cannot execute. (project)
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# PrizmKit Deployment Strategy
|
|
7
|
-
|
|
8
|
-
Plan comprehensive deployment strategies with rollback procedures tailored to your project's infrastructure.
|
|
9
|
-
|
|
10
|
-
## Commands
|
|
11
|
-
|
|
12
|
-
### `/prizmkit-deploy`-plan
|
|
13
|
-
|
|
14
|
-
Generate a deployment plan with rollback procedures.
|
|
15
|
-
|
|
16
|
-
**STEPS:**
|
|
17
|
-
|
|
18
|
-
1. Read project context from `.prizm-docs/` (architecture, tech stack, infrastructure references)
|
|
19
|
-
2. Ask user: deployment target
|
|
20
|
-
- Cloud provider (AWS, GCP, Azure)
|
|
21
|
-
- Container orchestration (Kubernetes, Docker Swarm, ECS)
|
|
22
|
-
- Bare metal / VM-based
|
|
23
|
-
- Serverless (Lambda, Cloud Functions, Vercel)
|
|
24
|
-
3. Ask user: strategy preference
|
|
25
|
-
- **Blue-green**: Zero-downtime with full environment swap
|
|
26
|
-
- **Canary**: Gradual traffic shift to new version
|
|
27
|
-
- **Rolling**: Incremental instance replacement
|
|
28
|
-
- **Recreate**: Stop old, start new (accepts brief downtime)
|
|
29
|
-
4. Generate `deployment-plan.md` containing:
|
|
30
|
-
- **Pre-deployment checklist**:
|
|
31
|
-
- All tests passing on target branch
|
|
32
|
-
- Database migrations prepared and tested
|
|
33
|
-
- Backups completed (database, config, artifacts)
|
|
34
|
-
- Monitoring and alerting confirmed operational
|
|
35
|
-
- Communication sent to stakeholders
|
|
36
|
-
- **Deployment steps**: Specific commands for the chosen strategy and target
|
|
37
|
-
- **Health check configuration**: Endpoints, thresholds, intervals
|
|
38
|
-
- **Rollback procedure**: Step-by-step commands to revert to previous version
|
|
39
|
-
- **Monitoring points**: What to watch during and after deployment
|
|
40
|
-
- **Post-deployment verification**:
|
|
41
|
-
- Smoke test endpoints
|
|
42
|
-
- Key metric baselines to compare
|
|
43
|
-
- User-facing feature verification
|
|
44
|
-
5. Generate rollback script (`rollback.sh`) if applicable:
|
|
45
|
-
- Automated rollback with safety checks
|
|
46
|
-
- Confirmation prompts before destructive operations
|
|
47
|
-
- Logging of rollback actions
|
|
48
|
-
6. Write to `.prizmkit/deployment-plan.md`
|
|
49
|
-
|
|
50
|
-
## Path References
|
|
51
|
-
|
|
52
|
-
All internal asset paths MUST use `.claude/commands/prizmkit-deployment-strategy` placeholder for cross-IDE compatibility.
|
|
53
|
-
|
|
54
|
-
## Output
|
|
55
|
-
|
|
56
|
-
- `.prizmkit/deployment-plan.md`: Complete deployment procedure
|
|
57
|
-
- `rollback.sh` (if applicable): Executable rollback script
|
|
@@ -1,54 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: "prizmkit-tool-error-triage"
|
|
3
|
-
description: [Tier 2] Error categorization and root cause analysis via pattern matching. Checks Prizm TRAPS for known issues; no runtime debugger. (project)
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# PrizmKit Error Triage
|
|
7
|
-
|
|
8
|
-
Systematically categorize errors, perform root cause analysis, and check Prizm docs TRAPS for known patterns.
|
|
9
|
-
|
|
10
|
-
## Commands
|
|
11
|
-
|
|
12
|
-
### `/prizmkit-error`-triage \<error-description-or-log\>
|
|
13
|
-
|
|
14
|
-
Triage an error by classifying it, identifying root cause, and suggesting fixes.
|
|
15
|
-
|
|
16
|
-
**STEPS:**
|
|
17
|
-
|
|
18
|
-
1. Parse error input (stack trace, error message, log snippet, or user description)
|
|
19
|
-
2. Classify error category:
|
|
20
|
-
- **Runtime**: null reference, type error, out of bounds, division by zero
|
|
21
|
-
- **Network**: timeout, DNS resolution, connection refused, SSL/TLS handshake
|
|
22
|
-
- **Auth**: 401/403 responses, token expired, permission denied, CORS
|
|
23
|
-
- **Data**: validation failure, serialization error, encoding mismatch, corruption
|
|
24
|
-
- **Resource**: OOM, disk full, connection pool exhausted, file handle leak
|
|
25
|
-
- **Logic**: incorrect output, race condition, deadlock, infinite loop
|
|
26
|
-
- **Config**: missing env var, wrong endpoint, version mismatch, malformed config
|
|
27
|
-
- **External**: third-party API failure, dependency bug, upstream service degradation
|
|
28
|
-
3. Check `.prizm-docs/` for known issues:
|
|
29
|
-
- Read TRAPS sections of affected modules for documented pitfalls
|
|
30
|
-
- Check DECISIONS sections for prior choices that may relate to the error
|
|
31
|
-
4. If known trap matches:
|
|
32
|
-
- Suggest documented solution from TRAPS
|
|
33
|
-
- Reference the specific `.prizm-docs/` file and entry
|
|
34
|
-
5. If no match: analyze root cause from first principles:
|
|
35
|
-
a. Identify the error origin (file, line, function) from stack trace or context
|
|
36
|
-
b. Trace the call chain to find the triggering condition
|
|
37
|
-
c. Identify the most likely root cause
|
|
38
|
-
d. Suggest fix approach with specific code pointers
|
|
39
|
-
6. Generate structured triage report:
|
|
40
|
-
- **Category and subcategory**: e.g., Runtime > NullReference
|
|
41
|
-
- **Root cause**: confirmed or suspected, with reasoning
|
|
42
|
-
- **Affected files/modules**: list of files involved in the error path
|
|
43
|
-
- **Suggested fix**: concrete steps or code changes to resolve
|
|
44
|
-
- **Prevention**: what check, test, or guard would have caught this earlier
|
|
45
|
-
7. Suggest updating `.prizm-docs/` TRAPS section with newly discovered pitfalls to prevent recurrence
|
|
46
|
-
|
|
47
|
-
## Path References
|
|
48
|
-
|
|
49
|
-
All internal asset paths MUST use `.claude/commands/prizmkit-error-triage` placeholder for cross-IDE compatibility.
|
|
50
|
-
|
|
51
|
-
## Output
|
|
52
|
-
|
|
53
|
-
- Structured triage report printed to console
|
|
54
|
-
- Suggestion to update `.prizm-docs/` TRAPS with new findings
|
|
@@ -1,54 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: "prizmkit-tool-log-analyzer"
|
|
3
|
-
description: [Tier 2] Log pattern recognition via text analysis. Identifies error frequencies and correlations from provided log content. (project)
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# PrizmKit Log Analyzer
|
|
7
|
-
|
|
8
|
-
Analyze log files to identify anomaly patterns, frequency trends, and error correlations for production issue investigation.
|
|
9
|
-
|
|
10
|
-
## Commands
|
|
11
|
-
|
|
12
|
-
### `/prizmkit-analyze`-logs \<log-file-or-directory\>
|
|
13
|
-
|
|
14
|
-
Analyze log files and produce a structured report of findings.
|
|
15
|
-
|
|
16
|
-
**STEPS:**
|
|
17
|
-
|
|
18
|
-
1. Read and parse log files (auto-detect format):
|
|
19
|
-
- JSON structured logs
|
|
20
|
-
- Structured text (key=value pairs)
|
|
21
|
-
- Syslog format
|
|
22
|
-
- Custom formats (infer delimiter and field positions)
|
|
23
|
-
2. Extract entries with normalized fields:
|
|
24
|
-
- **Timestamp**: parse to comparable datetime
|
|
25
|
-
- **Level**: DEBUG, INFO, WARN, ERROR, FATAL
|
|
26
|
-
- **Source**: service name, module, class, or file
|
|
27
|
-
- **Message**: the log message body
|
|
28
|
-
- **Metadata**: request ID, user ID, trace ID (if present)
|
|
29
|
-
3. Analyze patterns:
|
|
30
|
-
- **Error frequency**: count by type and time window (per minute, per hour)
|
|
31
|
-
- **Correlation**: errors that consistently appear together or in sequence
|
|
32
|
-
- **Anomaly detection**: sudden spikes in error rate, new error types not seen before
|
|
33
|
-
- **Timeline**: when did behavior change relative to deployments or config changes
|
|
34
|
-
- **Request tracing**: follow request IDs across log entries to reconstruct flows
|
|
35
|
-
4. Identify top issues:
|
|
36
|
-
- Most frequent errors (by count)
|
|
37
|
-
- Most recent new errors (not seen in earlier log entries)
|
|
38
|
-
- Errors with increasing trend (getting worse over time)
|
|
39
|
-
- Errors correlated with specific endpoints, users, or time windows
|
|
40
|
-
5. Generate analysis report:
|
|
41
|
-
- **Timeline of events**: chronological summary of significant changes
|
|
42
|
-
- **Top 10 error patterns**: with frequency, first/last occurrence, and sample messages
|
|
43
|
-
- **Correlation findings**: errors that co-occur or cascade
|
|
44
|
-
- **Anomaly alerts**: unusual patterns that warrant investigation
|
|
45
|
-
- **Recommended investigation priorities**: ranked list of what to look at first
|
|
46
|
-
|
|
47
|
-
## Path References
|
|
48
|
-
|
|
49
|
-
All internal asset paths MUST use `.claude/commands/prizmkit-log-analyzer` placeholder for cross-IDE compatibility.
|
|
50
|
-
|
|
51
|
-
## Output
|
|
52
|
-
|
|
53
|
-
- Structured analysis report printed to console
|
|
54
|
-
- Summary suitable for sharing with team or pasting into incident reports
|
|
@@ -1,74 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: "prizmkit-tool-monitoring-setup"
|
|
3
|
-
description: [Tier 2] Generate monitoring config templates for Prometheus/Grafana/CloudWatch/etc. Cannot test or validate actual metrics collection. (project)
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# PrizmKit Monitoring Setup
|
|
7
|
-
|
|
8
|
-
Generate comprehensive monitoring, alerting, and log collection configurations for your project's observability stack.
|
|
9
|
-
|
|
10
|
-
## Commands
|
|
11
|
-
|
|
12
|
-
### `/prizmkit-monitoring`
|
|
13
|
-
|
|
14
|
-
Generate monitoring and observability configurations.
|
|
15
|
-
|
|
16
|
-
**STEPS:**
|
|
17
|
-
|
|
18
|
-
1. Read `.prizm-docs/root.prizm` for tech stack and architecture (services, databases, external dependencies)
|
|
19
|
-
2. Ask user: monitoring stack
|
|
20
|
-
- Prometheus + Grafana
|
|
21
|
-
- ELK (Elasticsearch, Logstash, Kibana)
|
|
22
|
-
- CloudWatch (AWS)
|
|
23
|
-
- Datadog
|
|
24
|
-
- Other (specify)
|
|
25
|
-
3. Identify key metrics to monitor:
|
|
26
|
-
- **Application (RED metrics)**:
|
|
27
|
-
- Request **R**ate: requests per second by endpoint
|
|
28
|
-
- **E**rror rate: 4xx/5xx responses, exception counts
|
|
29
|
-
- **D**uration: latency percentiles (p50, p95, p99)
|
|
30
|
-
- **System**:
|
|
31
|
-
- CPU utilization and saturation
|
|
32
|
-
- Memory usage and swap
|
|
33
|
-
- Disk I/O and space
|
|
34
|
-
- Network throughput and errors
|
|
35
|
-
- **Business**:
|
|
36
|
-
- Feature-specific metrics derived from spec (signups, transactions, etc.)
|
|
37
|
-
- SLA/SLO compliance indicators
|
|
38
|
-
- **Database**:
|
|
39
|
-
- Connection pool utilization
|
|
40
|
-
- Query latency by type (read/write)
|
|
41
|
-
- Replication lag
|
|
42
|
-
- Slow query count
|
|
43
|
-
4. Generate monitoring configs:
|
|
44
|
-
- **Metrics collection**: Scrape configs, exporters, or agent configurations
|
|
45
|
-
- **Alert rules** with severity levels:
|
|
46
|
-
- Critical: immediate page (service down, data loss risk)
|
|
47
|
-
- Warning: investigate soon (degraded performance, approaching limits)
|
|
48
|
-
- Info: awareness (deployment events, scaling events)
|
|
49
|
-
- **Dashboard definition**: JSON/YAML for Grafana or equivalent
|
|
50
|
-
- Overview dashboard: service health at a glance
|
|
51
|
-
- Detail dashboard: per-service deep dive
|
|
52
|
-
- **Log format and collection config**:
|
|
53
|
-
- Structured log format recommendation
|
|
54
|
-
- Log shipping configuration
|
|
55
|
-
- Log retention policy
|
|
56
|
-
5. Generate health check endpoint code if not existing:
|
|
57
|
-
- Liveness probe: process is running
|
|
58
|
-
- Readiness probe: dependencies are available
|
|
59
|
-
- Startup probe: initialization complete
|
|
60
|
-
6. Write configs to standard locations:
|
|
61
|
-
- Prometheus: `monitoring/prometheus.yml`, `monitoring/alerts.yml`
|
|
62
|
-
- Grafana: `monitoring/dashboards/`
|
|
63
|
-
- Application: health check endpoint in source code
|
|
64
|
-
|
|
65
|
-
## Path References
|
|
66
|
-
|
|
67
|
-
All internal asset paths MUST use `.claude/commands/prizmkit-monitoring-setup` placeholder for cross-IDE compatibility.
|
|
68
|
-
|
|
69
|
-
## Output
|
|
70
|
-
|
|
71
|
-
- Monitoring configuration files in `monitoring/` directory
|
|
72
|
-
- Alert rule definitions
|
|
73
|
-
- Dashboard JSON/YAML files
|
|
74
|
-
- Health check endpoint code (if generated)
|
|
@@ -1,69 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: "prizmkit-tool-onboarding-generator"
|
|
3
|
-
description: [Tier 2] Generate onboarding documentation from Prizm docs context. Quality depends on existing .prizm-docs/ completeness. (project)
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# PrizmKit Onboarding Generator
|
|
7
|
-
|
|
8
|
-
Generate a comprehensive developer onboarding guide from project context, covering everything a new team member needs to be productive.
|
|
9
|
-
|
|
10
|
-
## Commands
|
|
11
|
-
|
|
12
|
-
### `/prizmkit-onboarding`
|
|
13
|
-
|
|
14
|
-
Generate a complete onboarding guide for new developers.
|
|
15
|
-
|
|
16
|
-
**STEPS:**
|
|
17
|
-
|
|
18
|
-
1. Read `.prizm-docs/root.prizm` for complete project overview (tech stack, architecture, conventions)
|
|
19
|
-
2. Read `.prizm-docs/` L1 module docs for detailed module information
|
|
20
|
-
3. Read existing `README.md`, `CONTRIBUTING.md` if present (avoid duplicating existing docs; reference them instead)
|
|
21
|
-
4. Generate `ONBOARDING.md` covering:
|
|
22
|
-
- **Environment Setup**:
|
|
23
|
-
- Prerequisites (language runtimes, tools, accounts)
|
|
24
|
-
- Step-by-step install commands (copy-paste ready)
|
|
25
|
-
- Configuration files to create or modify
|
|
26
|
-
- Verification commands to confirm setup works
|
|
27
|
-
- **Architecture Overview**:
|
|
28
|
-
- High-level system description (from root.prizm ARCHITECTURE and LAYERS)
|
|
29
|
-
- Key services/modules and their responsibilities
|
|
30
|
-
- Data flow between components
|
|
31
|
-
- External dependencies and integrations
|
|
32
|
-
- **Key Directories**:
|
|
33
|
-
- What each top-level directory contains
|
|
34
|
-
- Where to find specific types of code (models, controllers, tests, configs)
|
|
35
|
-
- **Build and Test Commands**:
|
|
36
|
-
- How to build the project
|
|
37
|
-
- How to run the full test suite
|
|
38
|
-
- How to run specific tests
|
|
39
|
-
- How to run linters and formatters
|
|
40
|
-
- **Development Workflow**:
|
|
41
|
-
- Branch naming convention
|
|
42
|
-
- Development cycle: branch, develop, test, commit, PR
|
|
43
|
-
- Code review expectations
|
|
44
|
-
- CI/CD pipeline overview
|
|
45
|
-
- **Key Concepts and Domain Terminology**:
|
|
46
|
-
- Domain-specific terms and their meanings
|
|
47
|
-
- Acronyms used in the codebase
|
|
48
|
-
- **Common Tasks** (step-by-step guides):
|
|
49
|
-
- Adding a new API endpoint
|
|
50
|
-
- Adding a new database migration
|
|
51
|
-
- Creating a new test
|
|
52
|
-
- Deploying to staging
|
|
53
|
-
- **Debugging Tips and Common Pitfalls**:
|
|
54
|
-
- Known gotchas from TRAPS sections
|
|
55
|
-
- Common setup issues and solutions
|
|
56
|
-
- Useful debugging commands
|
|
57
|
-
- **Where to Find Help**:
|
|
58
|
-
- Documentation locations
|
|
59
|
-
- Team contacts or channels
|
|
60
|
-
- Issue tracker and how to file bugs
|
|
61
|
-
5. Write to `ONBOARDING.md` in project root
|
|
62
|
-
|
|
63
|
-
## Path References
|
|
64
|
-
|
|
65
|
-
All internal asset paths MUST use `.claude/commands/prizmkit-onboarding-generator` placeholder for cross-IDE compatibility.
|
|
66
|
-
|
|
67
|
-
## Output
|
|
68
|
-
|
|
69
|
-
- `ONBOARDING.md` in project root: complete onboarding guide for new developers
|
|
@@ -1,54 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: "prizmkit-tool-perf-profiler"
|
|
3
|
-
description: [Tier 2] Static analysis for potential performance issues with profiling tool recommendations. Does not measure actual runtime performance. (project)
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# PrizmKit Performance Profiler
|
|
7
|
-
|
|
8
|
-
Identify performance bottlenecks through static code analysis and profiling guidance. Suggests targeted optimizations with expected impact.
|
|
9
|
-
|
|
10
|
-
## Commands
|
|
11
|
-
|
|
12
|
-
### `/prizmkit-perf`-profile [module-or-file]
|
|
13
|
-
|
|
14
|
-
Analyze code for performance bottlenecks and generate optimization recommendations.
|
|
15
|
-
|
|
16
|
-
**STEPS:**
|
|
17
|
-
|
|
18
|
-
1. Read `.prizm-docs/` for architecture and module relationships (dependencies, data flow, hot paths)
|
|
19
|
-
2. If specific file/module given: focus analysis on that scope; otherwise analyze project-wide critical paths
|
|
20
|
-
3. Analyze for common bottleneck patterns:
|
|
21
|
-
- **N+1 queries**: ORM/database calls inside loops
|
|
22
|
-
- **Missing indexes**: queries filtering or sorting on unindexed columns
|
|
23
|
-
- **Synchronous blocking in async code**: blocking I/O in async handlers, missing await
|
|
24
|
-
- **Unnecessary serialization/deserialization**: repeated JSON parse/stringify, redundant marshaling
|
|
25
|
-
- **Memory leaks**: growing collections without bounds, unclosed resources, event listener accumulation
|
|
26
|
-
- **Inefficient algorithms**: O(n^2) where O(n) or O(n log n) is possible, nested loops over large datasets
|
|
27
|
-
- **Missing caching opportunities**: repeated expensive computations or external calls with stable inputs
|
|
28
|
-
- **Excessive logging in hot paths**: string formatting and I/O in tight loops
|
|
29
|
-
- **Large payload transfers**: over-fetching from database, sending unnecessary fields to client
|
|
30
|
-
- **Connection management**: not reusing connections, missing connection pooling
|
|
31
|
-
4. Generate profiling recommendations:
|
|
32
|
-
- Suggest profiling tools appropriate for the project's tech stack:
|
|
33
|
-
- Node.js: `--prof`, `clinic.js`, `0x`
|
|
34
|
-
- Python: `cProfile`, `py-spy`, `line_profiler`
|
|
35
|
-
- Java: JFR, async-profiler, VisualVM
|
|
36
|
-
- Go: `pprof`, `trace`
|
|
37
|
-
- Rust: `perf`, `flamegraph`, `criterion`
|
|
38
|
-
- Provide specific commands to run the profiler against the identified hot paths
|
|
39
|
-
- Identify measurement baselines to establish before optimizing
|
|
40
|
-
5. Output performance report:
|
|
41
|
-
- **Suspected bottlenecks**: ranked by likely impact (HIGH / MEDIUM / LOW)
|
|
42
|
-
- **Suggested optimizations**: for each bottleneck, concrete code changes or architectural adjustments
|
|
43
|
-
- **Profiling commands**: copy-paste ready commands to validate each suspicion
|
|
44
|
-
- **Expected impact**: qualitative assessment of improvement (e.g., "Eliminates N+1, expect ~10x query reduction for list endpoints")
|
|
45
|
-
6. Suggest updating `.prizm-docs/` TRAPS section with discovered performance pitfalls for future reference
|
|
46
|
-
|
|
47
|
-
## Path References
|
|
48
|
-
|
|
49
|
-
All internal asset paths MUST use `.claude/commands/prizmkit-perf-profiler` placeholder for cross-IDE compatibility.
|
|
50
|
-
|
|
51
|
-
## Output
|
|
52
|
-
|
|
53
|
-
- Performance analysis report printed to console
|
|
54
|
-
- Profiling command suggestions ready to execute
|