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.
- 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/prizmkit-plan/references/clarify-guide.md +67 -0
- 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/config.js +504 -0
- package/src/gitignore-template.js +12 -0
- package/src/index.js +3 -22
- package/src/prompts.js +210 -0
- 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-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
- /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
|
|
File without changes
|