owflow 0.6.0 → 0.7.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/LICENSE +21 -21
- package/README.md +448 -283
- package/dist/agents/bottleneck-analyzer.md +332 -333
- package/dist/agents/code-quality-pragmatist.md +353 -354
- package/dist/agents/code-reviewer.md +238 -239
- package/dist/agents/codebase-analysis-reporter.md +245 -246
- package/dist/agents/docs-operator.md +22 -23
- package/dist/agents/e2e-test-verifier.md +447 -448
- package/dist/agents/gap-analyzer.md +501 -502
- package/dist/agents/implementation-completeness-checker.md +219 -220
- package/dist/agents/implementation-planner.md +308 -309
- package/dist/agents/information-gatherer.md +690 -691
- package/dist/agents/production-readiness-checker.md +278 -279
- package/dist/agents/project-analyzer.md +403 -403
- package/dist/agents/reality-assessor.md +365 -366
- package/dist/agents/research-planner.md +449 -450
- package/dist/agents/research-synthesizer.md +402 -403
- package/dist/agents/solution-brainstormer.md +256 -257
- package/dist/agents/solution-designer.md +371 -372
- package/dist/agents/spec-auditor.md +297 -298
- package/dist/agents/specification-creator.md +333 -334
- package/dist/agents/task-classifier.md +449 -450
- package/dist/agents/task-group-implementer.md +283 -284
- package/dist/agents/test-suite-runner.md +194 -195
- package/dist/agents/user-docs-generator.md +508 -509
- package/dist/commands/reviews-code.md +90 -90
- package/dist/commands/reviews-pragmatic.md +99 -99
- package/dist/commands/reviews-production-readiness.md +113 -113
- package/dist/commands/reviews-reality-check.md +110 -110
- package/dist/commands/reviews-spec-audit.md +114 -114
- package/dist/commands/work.md +280 -280
- package/dist/configuration/agents-config.d.ts +2 -0
- package/dist/configuration/agents-config.js +8 -44
- package/dist/configuration/commands-config.d.ts +23 -0
- package/dist/configuration/commands-config.js +17 -17
- package/dist/configuration/skills-config.d.ts +2 -0
- package/dist/configuration/skills-config.js +3 -3
- package/dist/hooks/hooks-diagnostics.d.ts +3 -0
- package/dist/hooks/hooks-diagnostics.js +21 -0
- package/dist/hooks/hooks-persistence.d.ts +17 -0
- package/dist/hooks/hooks-persistence.js +207 -0
- package/dist/hooks/hooks-registry.d.ts +6 -0
- package/dist/hooks/hooks-registry.js +104 -0
- package/dist/hooks/hooks-wrapper.d.ts +25 -0
- package/dist/hooks/hooks-wrapper.js +318 -0
- package/dist/hooks/internal/before-tool.d.ts +6 -0
- package/dist/hooks/internal/before-tool.js +13 -0
- package/dist/hooks/internal/session-compaction.d.ts +9 -0
- package/dist/hooks/{session-compaction.js → internal/session-compaction.js} +9 -7
- package/dist/hooks/runtime/circuit-breaker.d.ts +23 -0
- package/dist/hooks/runtime/circuit-breaker.js +39 -0
- package/dist/hooks/runtime/failure-policy.d.ts +15 -0
- package/dist/hooks/runtime/failure-policy.js +49 -0
- package/dist/hooks/runtime/process-executor.d.ts +33 -0
- package/dist/hooks/runtime/process-executor.js +147 -0
- package/dist/hooks/runtime/status-recorder.d.ts +27 -0
- package/dist/hooks/runtime/status-recorder.js +111 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.js +111 -40
- package/dist/skills/agents-md-generator/SKILL.md +223 -223
- package/dist/skills/codebase-analyzer/SKILL.md +162 -162
- package/dist/skills/codebase-analyzer/references/code-analysis.md +63 -63
- package/dist/skills/codebase-analyzer/references/combined.md +31 -31
- package/dist/skills/codebase-analyzer/references/context-discovery.md +63 -63
- package/dist/skills/codebase-analyzer/references/file-discovery.md +51 -51
- package/dist/skills/codebase-analyzer/references/migration-target.md +23 -23
- package/dist/skills/codebase-analyzer/references/pattern-mining.md +22 -22
- package/dist/skills/dev-analyze/SKILL.md +115 -115
- package/dist/skills/dev-bugfix/SKILL.md +452 -452
- package/dist/skills/dev-finalize/SKILL.md +118 -118
- package/dist/skills/dev-implement/SKILL.md +167 -167
- package/dist/skills/dev-plan/SKILL.md +147 -147
- package/dist/skills/dev-spec/SKILL.md +182 -182
- package/dist/skills/dev-tdd-red/SKILL.md +94 -94
- package/dist/skills/dev-verify/SKILL.md +153 -153
- package/dist/skills/development/SKILL.md +260 -260
- package/dist/skills/diagrams-mermaid/SKILL.md +183 -159
- package/dist/skills/diagrams-mermaid/references/reference.md +220 -148
- package/dist/skills/docs-manager/SKILL.md +379 -379
- package/dist/skills/docs-manager/docs/INDEX.md +199 -199
- package/dist/skills/docs-manager/docs/standards/backend/api.md +25 -25
- package/dist/skills/docs-manager/docs/standards/backend/migrations.md +22 -22
- package/dist/skills/docs-manager/docs/standards/backend/models.md +25 -25
- package/dist/skills/docs-manager/docs/standards/backend/queries.md +22 -22
- package/dist/skills/docs-manager/docs/standards/frontend/accessibility.md +25 -25
- package/dist/skills/docs-manager/docs/standards/frontend/components.md +28 -28
- package/dist/skills/docs-manager/docs/standards/frontend/css.md +16 -16
- package/dist/skills/docs-manager/docs/standards/frontend/responsive.md +28 -28
- package/dist/skills/docs-manager/docs/standards/global/coding-style.md +25 -25
- package/dist/skills/docs-manager/docs/standards/global/commenting.md +10 -10
- package/dist/skills/docs-manager/docs/standards/global/conventions.md +31 -31
- package/dist/skills/docs-manager/docs/standards/global/error-handling.md +22 -22
- package/dist/skills/docs-manager/docs/standards/global/minimal-implementation.md +22 -22
- package/dist/skills/docs-manager/docs/standards/global/validation.md +28 -28
- package/dist/skills/docs-manager/docs/standards/testing/test-writing.md +25 -25
- package/dist/skills/docs-manager/references/agents-md-template.md +29 -29
- package/dist/skills/docs-manager/references/index-md-template.md +73 -73
- package/dist/skills/flow-init/SKILL.md +234 -234
- package/dist/skills/flow-init/references/architecture-template.md +45 -45
- package/dist/skills/flow-init/references/roadmap-templates.md +93 -93
- package/dist/skills/flow-init/references/tech-stack-template.md +70 -70
- package/dist/skills/flow-init/references/vision-templates.md +75 -75
- package/dist/skills/goal-development/SKILL.md +96 -96
- package/dist/skills/goal-migration/SKILL.md +114 -114
- package/dist/skills/goal-performance/SKILL.md +126 -126
- package/dist/skills/goal-research/SKILL.md +118 -118
- package/dist/skills/html-renderer/SKILL.md +173 -173
- package/dist/skills/html-renderer/references/index.html +318 -318
- package/dist/skills/html-renderer/references/styles.css +388 -388
- package/dist/skills/html-renderer/references/tokens.json +104 -104
- package/dist/skills/implementation-plan-executor/SKILL.md +378 -378
- package/dist/skills/implementation-verifier/SKILL.md +307 -307
- package/dist/skills/migration/SKILL.md +268 -268
- package/dist/skills/migration-analyze/SKILL.md +126 -126
- package/dist/skills/migration-finalize/SKILL.md +161 -161
- package/dist/skills/migration-fix/SKILL.md +155 -155
- package/dist/skills/migration-implement/SKILL.md +131 -131
- package/dist/skills/migration-plan/SKILL.md +131 -131
- package/dist/skills/migration-spec/SKILL.md +135 -135
- package/dist/skills/migration-spec/references/migration-strategies.md +430 -430
- package/dist/skills/migration-target/SKILL.md +134 -134
- package/dist/skills/migration-target/references/migration-types.md +489 -489
- package/dist/skills/migration-verify/SKILL.md +184 -184
- package/dist/skills/orchestrator-framework/SKILL.md +65 -65
- package/dist/skills/orchestrator-framework/references/command-namespacing.md +7 -7
- package/dist/skills/orchestrator-framework/references/confirm-or-revise-exception.md +20 -20
- package/dist/skills/orchestrator-framework/references/delegation-rules.md +54 -54
- package/dist/skills/orchestrator-framework/references/dispatcher-handoff.md +27 -27
- package/dist/skills/orchestrator-framework/references/fix-loop-contract.md +65 -65
- package/dist/skills/orchestrator-framework/references/gate-contract.md +122 -122
- package/dist/skills/orchestrator-framework/references/orchestrator-creation-checklist.md +51 -51
- package/dist/skills/orchestrator-framework/references/orchestrator-patterns.md +235 -235
- package/dist/skills/performance/SKILL.md +267 -267
- package/dist/skills/performance-analyze/SKILL.md +129 -129
- package/dist/skills/performance-analyze/references/performance-optimization-guide.md +271 -271
- package/dist/skills/performance-finalize/SKILL.md +117 -117
- package/dist/skills/performance-implement/SKILL.md +114 -114
- package/dist/skills/performance-plan/SKILL.md +112 -112
- package/dist/skills/performance-spec/SKILL.md +145 -145
- package/dist/skills/performance-verify/SKILL.md +164 -164
- package/dist/skills/research/SKILL.md +249 -249
- package/dist/skills/research-brainstorm/SKILL.md +120 -120
- package/dist/skills/research-brainstorm/references/brainstorming-techniques.md +84 -84
- package/dist/skills/research-converge/SKILL.md +130 -130
- package/dist/skills/research-design/SKILL.md +146 -146
- package/dist/skills/research-design/references/design-techniques.md +40 -40
- package/dist/skills/research-finalize/SKILL.md +125 -125
- package/dist/skills/research-fork/SKILL.md +190 -190
- package/dist/skills/research-gather/SKILL.md +133 -133
- package/dist/skills/research-plan/SKILL.md +141 -141
- package/dist/skills/research-plan/references/research-methodologies.md +710 -710
- package/dist/skills/research-quick/SKILL.md +139 -139
- package/dist/skills/research-synthesize/SKILL.md +127 -127
- package/dist/skills/rule-reviewer/SKILL.md +334 -334
- package/dist/skills/standards-discover/SKILL.md +260 -260
- package/dist/skills/standards-discover/references/aggregation-strategy.md +76 -76
- package/dist/skills/standards-discover/references/code-pattern-prompt.md +68 -68
- package/dist/skills/standards-discover/references/config-analyzer-prompt.md +67 -67
- package/dist/skills/standards-discover/references/docs-extractor-prompt.md +65 -65
- package/dist/skills/standards-discover/references/external-analyzer-prompt.md +75 -75
- package/dist/skills/standards-update/SKILL.md +207 -207
- package/dist/templates/orchestrator-state-base.yml +17 -17
- package/dist/templates/orchestrator-state-development.yml +95 -95
- package/dist/templates/orchestrator-state-migration.yml +95 -95
- package/dist/templates/orchestrator-state-performance.yml +64 -64
- package/dist/templates/orchestrator-state-research.yml +67 -67
- package/dist/tools/fork_task.d.ts +17 -0
- package/dist/tools/fork_task.js +21 -11
- package/dist/tools/verify_template.d.ts +11 -0
- package/dist/tools/verify_template.js +32 -17
- package/dist/tui/hooks-dialogs.d.ts +20 -0
- package/dist/tui/hooks-dialogs.js +181 -0
- package/dist/tui/hooks-presenter.d.ts +15 -0
- package/dist/tui/hooks-presenter.js +70 -0
- package/dist/tui/hooks-sidebar.d.ts +10 -0
- package/dist/tui/hooks-sidebar.js +104 -0
- package/dist/tui/primitives.d.ts +21 -0
- package/dist/tui/primitives.js +47 -0
- package/dist/tui.d.ts +12 -0
- package/dist/tui.js +129 -0
- package/dist/types/hook-types.d.ts +125 -0
- package/dist/types/hook-types.js +76 -0
- package/dist/types/opencode-types.d.ts +13 -0
- package/dist/utils/file-util.d.ts +2 -0
- package/dist/utils/file-util.js +6 -6
- package/dist/utils/fork-task.d.ts +27 -0
- package/dist/utils/fork-task.js +18 -23
- package/dist/utils/plugin-info.d.ts +3 -0
- package/dist/utils/plugin-info.js +8 -10
- package/dist/utils/workflow-paths.d.ts +17 -0
- package/dist/utils/workflow-paths.js +18 -0
- package/dist/utils/yaml-structure.d.ts +7 -0
- package/dist/utils/yaml-structure.js +7 -11
- package/package.json +68 -48
- package/dist/hooks/before-tool.js +0 -19
|
@@ -1,45 +1,45 @@
|
|
|
1
|
-
# Architecture Document Template
|
|
2
|
-
|
|
3
|
-
Optional documentation — only generate if user selected "Architecture" in Phase 3.
|
|
4
|
-
|
|
5
|
-
```markdown
|
|
6
|
-
# System Architecture
|
|
7
|
-
|
|
8
|
-
## Overview
|
|
9
|
-
[High-level description of system architecture]
|
|
10
|
-
|
|
11
|
-
## Architecture Pattern
|
|
12
|
-
**Pattern**: [From analysis - e.g., "Layered monolithic with REST API"]
|
|
13
|
-
|
|
14
|
-
[Description of how the pattern is implemented]
|
|
15
|
-
|
|
16
|
-
## System Structure
|
|
17
|
-
|
|
18
|
-
### [Component 1]
|
|
19
|
-
- **Location**: [From analysis - e.g., "src/api/"]
|
|
20
|
-
- **Purpose**: [What it does]
|
|
21
|
-
- **Key Files**: [List from analysis]
|
|
22
|
-
|
|
23
|
-
### [Component 2]
|
|
24
|
-
- **Location**: [From analysis]
|
|
25
|
-
- **Purpose**: [What it does]
|
|
26
|
-
- **Key Files**: [List from analysis]
|
|
27
|
-
|
|
28
|
-
## Data Flow
|
|
29
|
-
[Describe how data flows through the system]
|
|
30
|
-
|
|
31
|
-
## External Integrations
|
|
32
|
-
[List integrations found in analysis - databases, APIs, services]
|
|
33
|
-
|
|
34
|
-
## Database Schema
|
|
35
|
-
[If ORM detected, reference schema file location]
|
|
36
|
-
|
|
37
|
-
## Configuration
|
|
38
|
-
[How configuration is managed]
|
|
39
|
-
|
|
40
|
-
## Deployment Architecture
|
|
41
|
-
[If detected - Docker, K8s, cloud services]
|
|
42
|
-
|
|
43
|
-
---
|
|
44
|
-
*Based on codebase analysis performed [Date]*
|
|
45
|
-
```
|
|
1
|
+
# Architecture Document Template
|
|
2
|
+
|
|
3
|
+
Optional documentation — only generate if user selected "Architecture" in Phase 3.
|
|
4
|
+
|
|
5
|
+
```markdown
|
|
6
|
+
# System Architecture
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
[High-level description of system architecture]
|
|
10
|
+
|
|
11
|
+
## Architecture Pattern
|
|
12
|
+
**Pattern**: [From analysis - e.g., "Layered monolithic with REST API"]
|
|
13
|
+
|
|
14
|
+
[Description of how the pattern is implemented]
|
|
15
|
+
|
|
16
|
+
## System Structure
|
|
17
|
+
|
|
18
|
+
### [Component 1]
|
|
19
|
+
- **Location**: [From analysis - e.g., "src/api/"]
|
|
20
|
+
- **Purpose**: [What it does]
|
|
21
|
+
- **Key Files**: [List from analysis]
|
|
22
|
+
|
|
23
|
+
### [Component 2]
|
|
24
|
+
- **Location**: [From analysis]
|
|
25
|
+
- **Purpose**: [What it does]
|
|
26
|
+
- **Key Files**: [List from analysis]
|
|
27
|
+
|
|
28
|
+
## Data Flow
|
|
29
|
+
[Describe how data flows through the system]
|
|
30
|
+
|
|
31
|
+
## External Integrations
|
|
32
|
+
[List integrations found in analysis - databases, APIs, services]
|
|
33
|
+
|
|
34
|
+
## Database Schema
|
|
35
|
+
[If ORM detected, reference schema file location]
|
|
36
|
+
|
|
37
|
+
## Configuration
|
|
38
|
+
[How configuration is managed]
|
|
39
|
+
|
|
40
|
+
## Deployment Architecture
|
|
41
|
+
[If detected - Docker, K8s, cloud services]
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
*Based on codebase analysis performed [Date]*
|
|
45
|
+
```
|
|
@@ -1,93 +1,93 @@
|
|
|
1
|
-
# Roadmap Document Templates
|
|
2
|
-
|
|
3
|
-
Select the appropriate template based on project type detected by project-analyzer.
|
|
4
|
-
|
|
5
|
-
## New Project (Feature-Based)
|
|
6
|
-
|
|
7
|
-
```markdown
|
|
8
|
-
# Development Roadmap
|
|
9
|
-
|
|
10
|
-
This roadmap outlines the planned features and development phases for [PROJECT_NAME].
|
|
11
|
-
|
|
12
|
-
## Phase 1: MVP (Minimum Viable Product)
|
|
13
|
-
**Timeline**: [Estimated]
|
|
14
|
-
|
|
15
|
-
- [ ] **Feature 1** — [Description] `[Effort: S/M/L]`
|
|
16
|
-
- [ ] **Feature 2** — [Description] `[Effort: S/M/L]`
|
|
17
|
-
- [ ] **Feature 3** — [Description] `[Effort: S/M/L]`
|
|
18
|
-
|
|
19
|
-
## Phase 2: Core Features
|
|
20
|
-
**Timeline**: [Estimated]
|
|
21
|
-
|
|
22
|
-
- [ ] **Feature 4** — [Description] `[Effort: S/M/L]`
|
|
23
|
-
- [ ] **Feature 5** — [Description] `[Effort: S/M/L]`
|
|
24
|
-
|
|
25
|
-
## Future Enhancements
|
|
26
|
-
- [ ] **Feature X** — [Nice to have]
|
|
27
|
-
|
|
28
|
-
---
|
|
29
|
-
**Effort Scale**: `S`: 2-3 days | `M`: 1 week | `L`: 2+ weeks
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
## Existing Project (Evolution)
|
|
33
|
-
|
|
34
|
-
```markdown
|
|
35
|
-
# Development Roadmap
|
|
36
|
-
|
|
37
|
-
## Current State
|
|
38
|
-
- **Version**: [From analysis]
|
|
39
|
-
- **Key Features**: [List major current features]
|
|
40
|
-
- **Recent Updates**: [From git history]
|
|
41
|
-
|
|
42
|
-
## Planned Enhancements (Next 3-6 Months)
|
|
43
|
-
|
|
44
|
-
### High Priority
|
|
45
|
-
- [ ] **Enhancement 1** — [Description and why it matters]
|
|
46
|
-
- [ ] **Enhancement 2** — [Description and why it matters]
|
|
47
|
-
|
|
48
|
-
### Medium Priority
|
|
49
|
-
- [ ] **Enhancement 3** — [Description]
|
|
50
|
-
|
|
51
|
-
### Technical Debt
|
|
52
|
-
- [ ] **Debt Item 1** — [From analysis, if applicable]
|
|
53
|
-
- [ ] **Debt Item 2** — [From analysis, if applicable]
|
|
54
|
-
|
|
55
|
-
## Future Considerations
|
|
56
|
-
- **Feature Ideas**: [Long-term possibilities]
|
|
57
|
-
- **Scalability**: [Performance improvements needed]
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
## Legacy Project (Modernization)
|
|
61
|
-
|
|
62
|
-
```markdown
|
|
63
|
-
# Modernization Roadmap
|
|
64
|
-
|
|
65
|
-
## Current State Assessment
|
|
66
|
-
- **Technology Age**: [From analysis]
|
|
67
|
-
- **Technical Debt**: [High/Medium/Low]
|
|
68
|
-
- **Outdated Components**: [List from analysis]
|
|
69
|
-
- **Security Concerns**: [If identified]
|
|
70
|
-
|
|
71
|
-
## Modernization Goals
|
|
72
|
-
|
|
73
|
-
### Critical (Must Do)
|
|
74
|
-
- [ ] **Upgrade [Component]** — [e.g., "Java 8 → Java 17 LTS"] `Risk: High if delayed`
|
|
75
|
-
- [ ] **Security Patch** — [Address known vulnerabilities]
|
|
76
|
-
|
|
77
|
-
### Important (Should Do)
|
|
78
|
-
- [ ] **Framework Update** — [e.g., "Spring 3.x → Spring Boot 3.x"]
|
|
79
|
-
- [ ] **Improve Test Coverage** — [Current: X%, Target: Y%]
|
|
80
|
-
|
|
81
|
-
### Improvements (Nice to Do)
|
|
82
|
-
- [ ] **Refactor Module X** — [Reduce technical debt]
|
|
83
|
-
- [ ] **Add Documentation** — [Architecture, deployment]
|
|
84
|
-
|
|
85
|
-
## Migration Strategy
|
|
86
|
-
[Step-by-step approach if major migration needed]
|
|
87
|
-
|
|
88
|
-
## Risk Mitigation
|
|
89
|
-
[How to reduce risk during modernization]
|
|
90
|
-
|
|
91
|
-
---
|
|
92
|
-
*Assessment based on project analysis performed [Date]*
|
|
93
|
-
```
|
|
1
|
+
# Roadmap Document Templates
|
|
2
|
+
|
|
3
|
+
Select the appropriate template based on project type detected by project-analyzer.
|
|
4
|
+
|
|
5
|
+
## New Project (Feature-Based)
|
|
6
|
+
|
|
7
|
+
```markdown
|
|
8
|
+
# Development Roadmap
|
|
9
|
+
|
|
10
|
+
This roadmap outlines the planned features and development phases for [PROJECT_NAME].
|
|
11
|
+
|
|
12
|
+
## Phase 1: MVP (Minimum Viable Product)
|
|
13
|
+
**Timeline**: [Estimated]
|
|
14
|
+
|
|
15
|
+
- [ ] **Feature 1** — [Description] `[Effort: S/M/L]`
|
|
16
|
+
- [ ] **Feature 2** — [Description] `[Effort: S/M/L]`
|
|
17
|
+
- [ ] **Feature 3** — [Description] `[Effort: S/M/L]`
|
|
18
|
+
|
|
19
|
+
## Phase 2: Core Features
|
|
20
|
+
**Timeline**: [Estimated]
|
|
21
|
+
|
|
22
|
+
- [ ] **Feature 4** — [Description] `[Effort: S/M/L]`
|
|
23
|
+
- [ ] **Feature 5** — [Description] `[Effort: S/M/L]`
|
|
24
|
+
|
|
25
|
+
## Future Enhancements
|
|
26
|
+
- [ ] **Feature X** — [Nice to have]
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
**Effort Scale**: `S`: 2-3 days | `M`: 1 week | `L`: 2+ weeks
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## Existing Project (Evolution)
|
|
33
|
+
|
|
34
|
+
```markdown
|
|
35
|
+
# Development Roadmap
|
|
36
|
+
|
|
37
|
+
## Current State
|
|
38
|
+
- **Version**: [From analysis]
|
|
39
|
+
- **Key Features**: [List major current features]
|
|
40
|
+
- **Recent Updates**: [From git history]
|
|
41
|
+
|
|
42
|
+
## Planned Enhancements (Next 3-6 Months)
|
|
43
|
+
|
|
44
|
+
### High Priority
|
|
45
|
+
- [ ] **Enhancement 1** — [Description and why it matters]
|
|
46
|
+
- [ ] **Enhancement 2** — [Description and why it matters]
|
|
47
|
+
|
|
48
|
+
### Medium Priority
|
|
49
|
+
- [ ] **Enhancement 3** — [Description]
|
|
50
|
+
|
|
51
|
+
### Technical Debt
|
|
52
|
+
- [ ] **Debt Item 1** — [From analysis, if applicable]
|
|
53
|
+
- [ ] **Debt Item 2** — [From analysis, if applicable]
|
|
54
|
+
|
|
55
|
+
## Future Considerations
|
|
56
|
+
- **Feature Ideas**: [Long-term possibilities]
|
|
57
|
+
- **Scalability**: [Performance improvements needed]
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
## Legacy Project (Modernization)
|
|
61
|
+
|
|
62
|
+
```markdown
|
|
63
|
+
# Modernization Roadmap
|
|
64
|
+
|
|
65
|
+
## Current State Assessment
|
|
66
|
+
- **Technology Age**: [From analysis]
|
|
67
|
+
- **Technical Debt**: [High/Medium/Low]
|
|
68
|
+
- **Outdated Components**: [List from analysis]
|
|
69
|
+
- **Security Concerns**: [If identified]
|
|
70
|
+
|
|
71
|
+
## Modernization Goals
|
|
72
|
+
|
|
73
|
+
### Critical (Must Do)
|
|
74
|
+
- [ ] **Upgrade [Component]** — [e.g., "Java 8 → Java 17 LTS"] `Risk: High if delayed`
|
|
75
|
+
- [ ] **Security Patch** — [Address known vulnerabilities]
|
|
76
|
+
|
|
77
|
+
### Important (Should Do)
|
|
78
|
+
- [ ] **Framework Update** — [e.g., "Spring 3.x → Spring Boot 3.x"]
|
|
79
|
+
- [ ] **Improve Test Coverage** — [Current: X%, Target: Y%]
|
|
80
|
+
|
|
81
|
+
### Improvements (Nice to Do)
|
|
82
|
+
- [ ] **Refactor Module X** — [Reduce technical debt]
|
|
83
|
+
- [ ] **Add Documentation** — [Architecture, deployment]
|
|
84
|
+
|
|
85
|
+
## Migration Strategy
|
|
86
|
+
[Step-by-step approach if major migration needed]
|
|
87
|
+
|
|
88
|
+
## Risk Mitigation
|
|
89
|
+
[How to reduce risk during modernization]
|
|
90
|
+
|
|
91
|
+
---
|
|
92
|
+
*Assessment based on project analysis performed [Date]*
|
|
93
|
+
```
|
|
@@ -1,70 +1,70 @@
|
|
|
1
|
-
# Tech Stack Document Template
|
|
2
|
-
|
|
3
|
-
Always generated (required documentation). Fill in all detected technologies, versions, and rationale from project analysis.
|
|
4
|
-
|
|
5
|
-
```markdown
|
|
6
|
-
# Technology Stack
|
|
7
|
-
|
|
8
|
-
## Overview
|
|
9
|
-
This document describes the technology choices and rationale for [PROJECT_NAME].
|
|
10
|
-
|
|
11
|
-
## Languages
|
|
12
|
-
|
|
13
|
-
### [Primary Language] ([Version])
|
|
14
|
-
- **Usage**: [percentage]% of codebase
|
|
15
|
-
- **Rationale**: [Why this language?]
|
|
16
|
-
- **Key Features Used**: [Notable language features]
|
|
17
|
-
|
|
18
|
-
## Frameworks
|
|
19
|
-
|
|
20
|
-
### Frontend
|
|
21
|
-
[List detected frontend frameworks with versions and rationale]
|
|
22
|
-
|
|
23
|
-
### Backend
|
|
24
|
-
[List detected backend frameworks with versions and rationale]
|
|
25
|
-
|
|
26
|
-
### Testing
|
|
27
|
-
[List detected testing frameworks]
|
|
28
|
-
|
|
29
|
-
## Database
|
|
30
|
-
|
|
31
|
-
### [Database Name] ([Version])
|
|
32
|
-
- **Type**: [Relational/NoSQL/etc.]
|
|
33
|
-
- **ORM/Client**: [Detected library]
|
|
34
|
-
- **Rationale**: [Why this database?]
|
|
35
|
-
|
|
36
|
-
## Build Tools & Package Management
|
|
37
|
-
[From analysis: npm, Maven, pip, etc.]
|
|
38
|
-
|
|
39
|
-
## Infrastructure
|
|
40
|
-
|
|
41
|
-
### Containerization
|
|
42
|
-
[Docker, Docker Compose - if detected]
|
|
43
|
-
|
|
44
|
-
### CI/CD
|
|
45
|
-
[GitHub Actions, GitLab CI - if detected]
|
|
46
|
-
|
|
47
|
-
### Hosting
|
|
48
|
-
[Vercel, AWS, Heroku - if detected or known]
|
|
49
|
-
|
|
50
|
-
## Development Tools
|
|
51
|
-
|
|
52
|
-
### Linting & Formatting
|
|
53
|
-
[ESLint, Prettier, Black - from analysis]
|
|
54
|
-
|
|
55
|
-
### Type Checking
|
|
56
|
-
[TypeScript, MyPy - from analysis]
|
|
57
|
-
|
|
58
|
-
## Key Dependencies
|
|
59
|
-
[List major dependencies from package files]
|
|
60
|
-
|
|
61
|
-
## Version Management
|
|
62
|
-
[How versions are managed]
|
|
63
|
-
|
|
64
|
-
## Migration Path (for legacy projects)
|
|
65
|
-
[If applicable - planned upgrades]
|
|
66
|
-
|
|
67
|
-
---
|
|
68
|
-
*Last Updated*: [Date]
|
|
69
|
-
*Auto-detected*: [List what was auto-detected vs user-provided]
|
|
70
|
-
```
|
|
1
|
+
# Tech Stack Document Template
|
|
2
|
+
|
|
3
|
+
Always generated (required documentation). Fill in all detected technologies, versions, and rationale from project analysis.
|
|
4
|
+
|
|
5
|
+
```markdown
|
|
6
|
+
# Technology Stack
|
|
7
|
+
|
|
8
|
+
## Overview
|
|
9
|
+
This document describes the technology choices and rationale for [PROJECT_NAME].
|
|
10
|
+
|
|
11
|
+
## Languages
|
|
12
|
+
|
|
13
|
+
### [Primary Language] ([Version])
|
|
14
|
+
- **Usage**: [percentage]% of codebase
|
|
15
|
+
- **Rationale**: [Why this language?]
|
|
16
|
+
- **Key Features Used**: [Notable language features]
|
|
17
|
+
|
|
18
|
+
## Frameworks
|
|
19
|
+
|
|
20
|
+
### Frontend
|
|
21
|
+
[List detected frontend frameworks with versions and rationale]
|
|
22
|
+
|
|
23
|
+
### Backend
|
|
24
|
+
[List detected backend frameworks with versions and rationale]
|
|
25
|
+
|
|
26
|
+
### Testing
|
|
27
|
+
[List detected testing frameworks]
|
|
28
|
+
|
|
29
|
+
## Database
|
|
30
|
+
|
|
31
|
+
### [Database Name] ([Version])
|
|
32
|
+
- **Type**: [Relational/NoSQL/etc.]
|
|
33
|
+
- **ORM/Client**: [Detected library]
|
|
34
|
+
- **Rationale**: [Why this database?]
|
|
35
|
+
|
|
36
|
+
## Build Tools & Package Management
|
|
37
|
+
[From analysis: npm, Maven, pip, etc.]
|
|
38
|
+
|
|
39
|
+
## Infrastructure
|
|
40
|
+
|
|
41
|
+
### Containerization
|
|
42
|
+
[Docker, Docker Compose - if detected]
|
|
43
|
+
|
|
44
|
+
### CI/CD
|
|
45
|
+
[GitHub Actions, GitLab CI - if detected]
|
|
46
|
+
|
|
47
|
+
### Hosting
|
|
48
|
+
[Vercel, AWS, Heroku - if detected or known]
|
|
49
|
+
|
|
50
|
+
## Development Tools
|
|
51
|
+
|
|
52
|
+
### Linting & Formatting
|
|
53
|
+
[ESLint, Prettier, Black - from analysis]
|
|
54
|
+
|
|
55
|
+
### Type Checking
|
|
56
|
+
[TypeScript, MyPy - from analysis]
|
|
57
|
+
|
|
58
|
+
## Key Dependencies
|
|
59
|
+
[List major dependencies from package files]
|
|
60
|
+
|
|
61
|
+
## Version Management
|
|
62
|
+
[How versions are managed]
|
|
63
|
+
|
|
64
|
+
## Migration Path (for legacy projects)
|
|
65
|
+
[If applicable - planned upgrades]
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
*Last Updated*: [Date]
|
|
69
|
+
*Auto-detected*: [List what was auto-detected vs user-provided]
|
|
70
|
+
```
|
|
@@ -1,75 +1,75 @@
|
|
|
1
|
-
# Vision Document Templates
|
|
2
|
-
|
|
3
|
-
Select the appropriate template based on project type detected by project-analyzer.
|
|
4
|
-
|
|
5
|
-
## New Project
|
|
6
|
-
|
|
7
|
-
```markdown
|
|
8
|
-
# Project Vision
|
|
9
|
-
|
|
10
|
-
## Pitch
|
|
11
|
-
[PROJECT_NAME] is a [TYPE] that helps [TARGET_USERS] [SOLVE_PROBLEM] by [VALUE_PROPOSITION].
|
|
12
|
-
|
|
13
|
-
## Problem Statement
|
|
14
|
-
[What problem are you solving? Why does it matter?]
|
|
15
|
-
|
|
16
|
-
## Target Users
|
|
17
|
-
[Who will use this? What are their needs?]
|
|
18
|
-
|
|
19
|
-
## Key Features
|
|
20
|
-
[Core features that deliver value]
|
|
21
|
-
|
|
22
|
-
## Success Criteria
|
|
23
|
-
[How will you measure success?]
|
|
24
|
-
|
|
25
|
-
## Differentiators
|
|
26
|
-
[What makes this unique?]
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
## Existing Project
|
|
30
|
-
|
|
31
|
-
```markdown
|
|
32
|
-
# Project Vision
|
|
33
|
-
|
|
34
|
-
## Overview
|
|
35
|
-
[PROJECT_NAME] is a [TYPE] that [CURRENT_PURPOSE].
|
|
36
|
-
|
|
37
|
-
## Current State
|
|
38
|
-
- **Age**: [X years/months]
|
|
39
|
-
- **Status**: [Active development/Maintenance/etc.]
|
|
40
|
-
- **Users**: [Current user base]
|
|
41
|
-
- **Tech Stack**: [Primary technologies]
|
|
42
|
-
|
|
43
|
-
## Purpose
|
|
44
|
-
[Why this project exists, what problem it solves]
|
|
45
|
-
|
|
46
|
-
## Goals (Next 6-12 Months)
|
|
47
|
-
[Planned improvements and new features]
|
|
48
|
-
|
|
49
|
-
## Evolution
|
|
50
|
-
[How the project has changed, where it's headed]
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
## Legacy Project
|
|
54
|
-
|
|
55
|
-
```markdown
|
|
56
|
-
# Project Vision
|
|
57
|
-
|
|
58
|
-
## Overview
|
|
59
|
-
[PROJECT_NAME] is a [TYPE] built [X years ago] to [ORIGINAL_PURPOSE].
|
|
60
|
-
|
|
61
|
-
## Current State
|
|
62
|
-
- **Age**: [X years]
|
|
63
|
-
- **Tech Stack**: [Current technologies - note outdated items]
|
|
64
|
-
- **Technical Debt**: [Assessment from analysis]
|
|
65
|
-
- **Status**: [Production/Maintenance/Migration planned]
|
|
66
|
-
|
|
67
|
-
## Modernization Goals
|
|
68
|
-
[What needs to be updated and why]
|
|
69
|
-
|
|
70
|
-
## Migration Strategy
|
|
71
|
-
[If applicable - path from legacy to modern stack]
|
|
72
|
-
|
|
73
|
-
## Business Value
|
|
74
|
-
[Why maintain/modernize this system]
|
|
75
|
-
```
|
|
1
|
+
# Vision Document Templates
|
|
2
|
+
|
|
3
|
+
Select the appropriate template based on project type detected by project-analyzer.
|
|
4
|
+
|
|
5
|
+
## New Project
|
|
6
|
+
|
|
7
|
+
```markdown
|
|
8
|
+
# Project Vision
|
|
9
|
+
|
|
10
|
+
## Pitch
|
|
11
|
+
[PROJECT_NAME] is a [TYPE] that helps [TARGET_USERS] [SOLVE_PROBLEM] by [VALUE_PROPOSITION].
|
|
12
|
+
|
|
13
|
+
## Problem Statement
|
|
14
|
+
[What problem are you solving? Why does it matter?]
|
|
15
|
+
|
|
16
|
+
## Target Users
|
|
17
|
+
[Who will use this? What are their needs?]
|
|
18
|
+
|
|
19
|
+
## Key Features
|
|
20
|
+
[Core features that deliver value]
|
|
21
|
+
|
|
22
|
+
## Success Criteria
|
|
23
|
+
[How will you measure success?]
|
|
24
|
+
|
|
25
|
+
## Differentiators
|
|
26
|
+
[What makes this unique?]
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## Existing Project
|
|
30
|
+
|
|
31
|
+
```markdown
|
|
32
|
+
# Project Vision
|
|
33
|
+
|
|
34
|
+
## Overview
|
|
35
|
+
[PROJECT_NAME] is a [TYPE] that [CURRENT_PURPOSE].
|
|
36
|
+
|
|
37
|
+
## Current State
|
|
38
|
+
- **Age**: [X years/months]
|
|
39
|
+
- **Status**: [Active development/Maintenance/etc.]
|
|
40
|
+
- **Users**: [Current user base]
|
|
41
|
+
- **Tech Stack**: [Primary technologies]
|
|
42
|
+
|
|
43
|
+
## Purpose
|
|
44
|
+
[Why this project exists, what problem it solves]
|
|
45
|
+
|
|
46
|
+
## Goals (Next 6-12 Months)
|
|
47
|
+
[Planned improvements and new features]
|
|
48
|
+
|
|
49
|
+
## Evolution
|
|
50
|
+
[How the project has changed, where it's headed]
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
## Legacy Project
|
|
54
|
+
|
|
55
|
+
```markdown
|
|
56
|
+
# Project Vision
|
|
57
|
+
|
|
58
|
+
## Overview
|
|
59
|
+
[PROJECT_NAME] is a [TYPE] built [X years ago] to [ORIGINAL_PURPOSE].
|
|
60
|
+
|
|
61
|
+
## Current State
|
|
62
|
+
- **Age**: [X years]
|
|
63
|
+
- **Tech Stack**: [Current technologies - note outdated items]
|
|
64
|
+
- **Technical Debt**: [Assessment from analysis]
|
|
65
|
+
- **Status**: [Production/Maintenance/Migration planned]
|
|
66
|
+
|
|
67
|
+
## Modernization Goals
|
|
68
|
+
[What needs to be updated and why]
|
|
69
|
+
|
|
70
|
+
## Migration Strategy
|
|
71
|
+
[If applicable - path from legacy to modern stack]
|
|
72
|
+
|
|
73
|
+
## Business Value
|
|
74
|
+
[Why maintain/modernize this system]
|
|
75
|
+
```
|