prizmkit 1.0.153 → 1.1.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.
Files changed (84) hide show
  1. package/bin/create-prizmkit.js +27 -2
  2. package/bundled/VERSION.json +3 -3
  3. package/bundled/adapters/claude/paths.js +1 -1
  4. package/bundled/dev-pipeline/scripts/generate-bootstrap-prompt.py +482 -57
  5. package/bundled/dev-pipeline/scripts/parse-stream-progress.py +2 -6
  6. package/bundled/dev-pipeline/templates/bootstrap-tier1.md +6 -0
  7. package/bundled/dev-pipeline/templates/bootstrap-tier2.md +6 -0
  8. package/bundled/dev-pipeline/templates/bootstrap-tier3.md +7 -1
  9. package/bundled/dev-pipeline/templates/sections/context-budget-rules.md +11 -0
  10. package/bundled/dev-pipeline/templates/sections/critical-paths-agent.md +9 -0
  11. package/bundled/dev-pipeline/templates/sections/critical-paths-full.md +12 -0
  12. package/bundled/dev-pipeline/templates/sections/critical-paths-lite.md +7 -0
  13. package/bundled/dev-pipeline/templates/sections/directory-convention-agent.md +8 -0
  14. package/bundled/dev-pipeline/templates/sections/directory-convention-full.md +9 -0
  15. package/bundled/dev-pipeline/templates/sections/directory-convention-lite.md +6 -0
  16. package/bundled/dev-pipeline/templates/sections/failure-capture.md +21 -0
  17. package/bundled/dev-pipeline/templates/sections/failure-log-check.md +8 -0
  18. package/bundled/dev-pipeline/templates/sections/feature-context.md +23 -0
  19. package/bundled/dev-pipeline/templates/sections/phase-analyze-agent.md +15 -0
  20. package/bundled/dev-pipeline/templates/sections/phase-analyze-full.md +15 -0
  21. package/bundled/dev-pipeline/templates/sections/phase-browser-verification.md +31 -0
  22. package/bundled/dev-pipeline/templates/sections/phase-commit-full.md +36 -0
  23. package/bundled/dev-pipeline/templates/sections/phase-commit.md +26 -0
  24. package/bundled/dev-pipeline/templates/sections/phase-context-snapshot-agent-suffix.md +14 -0
  25. package/bundled/dev-pipeline/templates/sections/phase-context-snapshot-base.md +20 -0
  26. package/bundled/dev-pipeline/templates/sections/phase-context-snapshot-lite-suffix.md +3 -0
  27. package/bundled/dev-pipeline/templates/sections/phase-critic-code.md +24 -0
  28. package/bundled/dev-pipeline/templates/sections/phase-critic-plan-full.md +45 -0
  29. package/bundled/dev-pipeline/templates/sections/phase-critic-plan.md +24 -0
  30. package/bundled/dev-pipeline/templates/sections/phase-deploy-verification.md +36 -0
  31. package/bundled/dev-pipeline/templates/sections/phase-implement-agent.md +24 -0
  32. package/bundled/dev-pipeline/templates/sections/phase-implement-full.md +41 -0
  33. package/bundled/dev-pipeline/templates/sections/phase-implement-lite.md +32 -0
  34. package/bundled/dev-pipeline/templates/sections/phase-plan-agent.md +17 -0
  35. package/bundled/dev-pipeline/templates/sections/phase-plan-lite.md +16 -0
  36. package/bundled/dev-pipeline/templates/sections/phase-review-agent.md +28 -0
  37. package/bundled/dev-pipeline/templates/sections/phase-review-full.md +36 -0
  38. package/bundled/dev-pipeline/templates/sections/phase-specify-plan-full.md +82 -0
  39. package/bundled/dev-pipeline/templates/sections/phase0-init.md +4 -0
  40. package/bundled/dev-pipeline/templates/sections/phase0-test-baseline.md +12 -0
  41. package/bundled/dev-pipeline/templates/sections/resume-header.md +2 -0
  42. package/bundled/dev-pipeline/templates/sections/session-context.md +6 -0
  43. package/bundled/dev-pipeline/templates/sections/subagent-timeout-recovery.md +6 -0
  44. package/bundled/skills/_metadata.json +21 -177
  45. package/bundled/skills/app-planner/SKILL.md +22 -3
  46. package/bundled/skills/app-planner/references/project-brief-guide.md +110 -0
  47. package/bundled/skills/bug-fix-workflow/SKILL.md +4 -0
  48. package/bundled/skills/bug-planner/SKILL.md +2 -2
  49. package/bundled/skills/dev-pipeline-launcher/SKILL.md +1 -1
  50. package/bundled/skills/prizm-kit/SKILL.md +18 -47
  51. package/bundled/skills/prizm-kit/assets/project-memory-template.md +1 -1
  52. package/bundled/skills/prizmkit-analyze/SKILL.md +4 -4
  53. package/bundled/skills/prizmkit-init/SKILL.md +4 -4
  54. package/bundled/skills/prizmkit-plan/SKILL.md +126 -108
  55. package/bundled/skills/prizmkit-plan/assets/plan-template.md +1 -2
  56. package/bundled/skills/prizmkit-plan/references/clarify-guide.md +67 -0
  57. package/bundled/skills/refactor-workflow/SKILL.md +142 -124
  58. package/bundled/team/prizm-dev-team.json +2 -8
  59. package/package.json +1 -1
  60. package/src/clean.js +8 -0
  61. package/src/config.js +504 -0
  62. package/src/gitignore-template.js +12 -0
  63. package/src/index.js +3 -22
  64. package/src/prompts.js +210 -0
  65. package/src/scaffold.js +20 -11
  66. package/src/upgrade.js +6 -31
  67. package/bundled/skills/prizmkit-clarify/SKILL.md +0 -93
  68. package/bundled/skills/prizmkit-specify/SKILL.md +0 -118
  69. package/bundled/skills/prizmkit-tool-adr-manager/SKILL.md +0 -67
  70. package/bundled/skills/prizmkit-tool-adr-manager/assets/adr-template.md +0 -26
  71. package/bundled/skills/prizmkit-tool-api-doc-generator/SKILL.md +0 -55
  72. package/bundled/skills/prizmkit-tool-bug-reproducer/SKILL.md +0 -61
  73. package/bundled/skills/prizmkit-tool-ci-cd-generator/SKILL.md +0 -53
  74. package/bundled/skills/prizmkit-tool-db-migration/SKILL.md +0 -64
  75. package/bundled/skills/prizmkit-tool-dependency-health/SKILL.md +0 -122
  76. package/bundled/skills/prizmkit-tool-deployment-strategy/SKILL.md +0 -57
  77. package/bundled/skills/prizmkit-tool-error-triage/SKILL.md +0 -54
  78. package/bundled/skills/prizmkit-tool-log-analyzer/SKILL.md +0 -54
  79. package/bundled/skills/prizmkit-tool-monitoring-setup/SKILL.md +0 -74
  80. package/bundled/skills/prizmkit-tool-onboarding-generator/SKILL.md +0 -69
  81. package/bundled/skills/prizmkit-tool-perf-profiler/SKILL.md +0 -54
  82. package/bundled/skills/prizmkit-tool-security-audit/SKILL.md +0 -129
  83. package/bundled/skills/prizmkit-tool-tech-debt-tracker/SKILL.md +0 -138
  84. /package/bundled/skills/{prizmkit-specify → prizmkit-plan}/assets/spec-template.md +0 -0
@@ -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
@@ -1,129 +0,0 @@
1
- ---
2
- name: "prizmkit-tool-security-audit"
3
- description: [Tier 2] AI-assisted security review checklist via static code analysis. Identifies common vulnerability patterns and hardcoded secrets. Not an automated scanner. (project)
4
- ---
5
-
6
- # PrizmKit Security Audit
7
-
8
- Comprehensive security scanner that identifies vulnerabilities, hardcoded secrets, and insecure patterns across the codebase. Generates a severity-rated report with actionable fix suggestions.
9
-
10
- ### When to Use
11
- - User says "security audit", "security review", "check for vulnerabilities"
12
- - Before deployment or release
13
- - After adding authentication, authorization, or data handling code
14
- - During code review of security-sensitive changes
15
-
16
- ### `/prizmkit-security`-audit
17
-
18
- ### Steps
19
-
20
- #### Step 1: Load Project Context
21
- Read .prizm-docs/root.prizm for:
22
- - Project tech stack and languages
23
- - Architecture overview
24
- - Module structure
25
-
26
- #### Step 2: Scan for Vulnerabilities
27
- Scan code files across these categories:
28
-
29
- **Injection**
30
- - SQL injection: raw query concatenation, unsanitized user input in queries
31
- - XSS: unescaped output in templates, innerHTML usage, dangerouslySetInnerHTML
32
- - Command injection: shell exec with user input, unsanitized system calls
33
- - LDAP injection: unescaped LDAP filter construction
34
-
35
- **Authentication**
36
- - Weak password handling: plaintext storage, weak hashing (MD5, SHA1)
37
- - Missing auth checks: unprotected routes/endpoints
38
- - Session management: predictable session IDs, missing expiration
39
-
40
- **Authorization**
41
- - Broken access control: missing role checks, horizontal privilege escalation
42
- - IDOR: direct object references without ownership validation
43
- - Privilege escalation: admin functions without proper guards
44
-
45
- **Data Exposure**
46
- - Hardcoded credentials: API keys, tokens, passwords in source code
47
- - Sensitive data in logs: PII, credentials, tokens logged in plaintext
48
- - Unencrypted sensitive data: passwords, SSN, credit cards stored in plain text
49
-
50
- **Configuration**
51
- - Debug mode enabled in production configs
52
- - Default credentials in configuration files
53
- - Insecure defaults: CORS *, permissive CSP, disabled CSRF
54
-
55
- **Dependencies**
56
- - Cross-reference package manifests (package.json, requirements.txt, etc.)
57
- - Flag known vulnerable version ranges where identifiable
58
-
59
- **Cryptography**
60
- - Weak algorithms: DES, RC4, MD5 for security purposes
61
- - Hardcoded encryption keys or IVs
62
- - Improper random generation: Math.random() for security tokens
63
-
64
- **Input Validation**
65
- - Missing validation on user inputs
66
- - Improper sanitization or escaping
67
- - Regex DoS (ReDoS) patterns
68
-
69
- #### Step 3: Check Sensitive File Handling
70
- - Verify .gitignore covers: .env, credentials.json, *.pem, *.key, *.p12
71
- - Check for sensitive files already tracked in git
72
- - Flag any secrets that may have been committed historically
73
-
74
- #### Step 4: Classify Findings
75
- Rate each finding by severity:
76
- - **CRITICAL**: Actively exploitable, data breach risk, hardcoded production secrets
77
- - **HIGH**: Significant vulnerability requiring immediate attention
78
- - **MEDIUM**: Security weakness that should be addressed
79
- - **LOW**: Minor issue or best practice improvement
80
-
81
- Maximum 50 findings per report.
82
-
83
- #### Step 5: Generate Report
84
- Output structured security report to conversation (READ-ONLY, no file modifications):
85
-
86
- ```markdown
87
- # Security Audit Report
88
- Date: YYYY-MM-DD
89
- Project: <project-name>
90
-
91
- ## Summary
92
- - Critical: N | High: N | Medium: N | Low: N
93
- - Files scanned: N
94
- - Categories checked: N
95
-
96
- ## Critical Findings
97
- ### [C-001] <Title>
98
- - **File**: path/to/file.ext:line
99
- - **Category**: Injection / Auth / etc.
100
- - **Description**: What the issue is
101
- - **Impact**: What could happen if exploited
102
- - **Fix**: How to remediate
103
-
104
- ## High Findings
105
- ...
106
-
107
- ## Medium Findings
108
- ...
109
-
110
- ## Low Findings
111
- ...
112
-
113
- ## Recommendations
114
- 1. Immediate actions (Critical + High)
115
- 2. Short-term improvements (Medium)
116
- 3. Long-term hardening (Low + best practices)
117
- ```
118
-
119
- #### Step 6: Suggest Fixes
120
- For CRITICAL and HIGH findings:
121
- - Provide specific code fix suggestions
122
- - Reference security best practices
123
- - Link to relevant documentation where applicable
124
-
125
- #### Step 7: Record Findings (Optional)
126
- If `.prizm-docs/` exists:
127
- - Update affected module RULES with security conventions discovered
128
- - Update affected module TRAPS with security pitfalls found
129
- - Track security posture improvements over time via changelog.prizm
@@ -1,138 +0,0 @@
1
- ---
2
- name: "prizmkit-tool-tech-debt-tracker"
3
- description: [Tier 1] Identify and track technical debt via code pattern analysis. Scans TODOs, complexity hotspots, code smells. AI strength. (project)
4
- ---
5
-
6
- # PrizmKit Tech Debt Tracker
7
-
8
- Systematic technical debt identification and tracking. Scans the codebase for code smells, TODO markers, complexity hotspots, missing tests, and other debt indicators. Generates a prioritized report with actionable recommendations.
9
-
10
- ### When to Use
11
- - User says "tech debt", "code quality", "what needs cleanup"
12
- - During sprint planning to identify maintenance work
13
- - Before major refactoring efforts
14
- - Periodically as part of codebase health monitoring
15
-
16
- ### `/prizmkit-tech`-debt
17
-
18
- ### Steps
19
-
20
- #### Step 1: Load Project Context
21
- Read .prizm-docs/ for:
22
- - Project structure and module boundaries
23
- - Tech stack and language conventions
24
- - Existing architecture documentation
25
-
26
- #### Step 2: Scan for Debt Indicators
27
-
28
- **TODO/FIXME/HACK/XXX Markers**
29
- - Search all source files for marker comments
30
- - Categorize by file and module
31
- - Extract context (the comment text and surrounding code)
32
-
33
- **Complexity Hotspots**
34
- - Files exceeding 500 lines of code
35
- - Deeply nested logic (4+ levels of nesting)
36
- - Functions/methods exceeding 100 lines
37
- - High cyclomatic complexity (many branches/conditions)
38
-
39
- **Code Duplication**
40
- - Similar code blocks appearing across multiple files
41
- - Copy-pasted logic with minor variations
42
- - Repeated patterns that could be abstracted
43
-
44
- **Missing Tests**
45
- - Source files without corresponding test files
46
- - Public APIs without test coverage
47
- - Critical paths without integration tests
48
-
49
- **Outdated Patterns**
50
- - Deprecated API usage
51
- - Old language syntax (var instead of let/const, callbacks instead of async/await)
52
- - Legacy framework patterns
53
-
54
- **Dead Code**
55
- - Unused imports and variables
56
- - Unreachable code blocks
57
- - Commented-out code blocks (>5 lines)
58
- - Exported functions with no consumers
59
-
60
- **Poor Naming**
61
- - Single-letter variables outside of loops/lambdas
62
- - Misleading names (obvious cases only)
63
- - Inconsistent naming conventions within a module
64
-
65
- **Missing Documentation**
66
- - Public APIs without doc comments
67
- - Complex functions without explanatory comments
68
- - Missing README in significant directories
69
-
70
- #### Step 3: Calculate Debt Score
71
- Per module:
72
- - CRITICAL issues: weight x4 (security-adjacent, data-loss risk)
73
- - HIGH issues: weight x3 (maintainability blockers)
74
- - MEDIUM issues: weight x2 (code quality)
75
- - LOW issues: weight x1 (best practices)
76
-
77
- Normalize by module size (lines of code) to get debt density.
78
-
79
- #### Step 4: Generate Prioritized Report
80
- Write to .prizmkit/tech-debt.md (overwrite each run):
81
-
82
- ```markdown
83
- # Technical Debt Report
84
- Generated: YYYY-MM-DD
85
-
86
- ## Summary
87
- - Total debt items: N
88
- - Critical: N | High: N | Medium: N | Low: N
89
- - Modules scanned: N
90
-
91
- ## Top 10 Hotspots (by debt score)
92
- | Rank | Module/File | Score | Top Issues |
93
- |------|-------------|-------|------------|
94
- | 1 | path/file | 42 | complexity, missing tests |
95
-
96
- ## Debt by Category
97
- | Category | Count | Severity Breakdown |
98
- |----------|-------|--------------------|
99
- | TODO markers | N | H:N M:N L:N |
100
- | Complexity | N | C:N H:N M:N |
101
- | Missing tests | N | H:N M:N |
102
- | Dead code | N | M:N L:N |
103
- | Duplication | N | M:N L:N |
104
- | Documentation | N | L:N |
105
-
106
- ## Trend
107
- (If previous report exists in .prizmkit/):
108
- - Previous total: N → Current: N (improving/degrading)
109
- - Categories improving: ...
110
- - Categories degrading: ...
111
-
112
- ## Detailed Findings
113
-
114
- ### Critical
115
- - [File:Line] Description | Impact | Suggested Fix
116
-
117
- ### High
118
- - [File:Line] Description | Impact | Suggested Fix
119
-
120
- ### Medium
121
- ...
122
-
123
- ### Low
124
- ...
125
- ```
126
-
127
- #### Step 5: Output Summary
128
- Display to conversation:
129
- - Overall debt score and trend
130
- - Top 3 highest-impact items to address first
131
- - Estimated effort categories (quick fix / medium effort / large refactor)
132
-
133
- #### Step 6: Suggest Action Items
134
- Recommend top 3 highest-impact debt items to address first, considering:
135
- - Severity (critical > high > medium > low)
136
- - Blast radius (how many modules affected)
137
- - Effort to fix (prefer quick wins)
138
- - Risk if left unaddressed