owflow 0.5.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.
Files changed (195) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +448 -261
  3. package/dist/agents/bottleneck-analyzer.md +332 -329
  4. package/dist/agents/code-quality-pragmatist.md +353 -354
  5. package/dist/agents/code-reviewer.md +238 -239
  6. package/dist/agents/codebase-analysis-reporter.md +245 -246
  7. package/dist/agents/docs-operator.md +22 -23
  8. package/dist/agents/e2e-test-verifier.md +447 -448
  9. package/dist/agents/gap-analyzer.md +501 -502
  10. package/dist/agents/implementation-completeness-checker.md +219 -220
  11. package/dist/agents/implementation-planner.md +308 -309
  12. package/dist/agents/information-gatherer.md +690 -691
  13. package/dist/agents/production-readiness-checker.md +278 -279
  14. package/dist/agents/project-analyzer.md +403 -403
  15. package/dist/agents/reality-assessor.md +365 -366
  16. package/dist/agents/research-planner.md +449 -450
  17. package/dist/agents/research-synthesizer.md +402 -403
  18. package/dist/agents/solution-brainstormer.md +256 -257
  19. package/dist/agents/solution-designer.md +371 -372
  20. package/dist/agents/spec-auditor.md +297 -298
  21. package/dist/agents/specification-creator.md +333 -334
  22. package/dist/agents/task-classifier.md +449 -450
  23. package/dist/agents/task-group-implementer.md +283 -284
  24. package/dist/agents/test-suite-runner.md +194 -195
  25. package/dist/agents/user-docs-generator.md +508 -509
  26. package/dist/commands/reviews-code.md +90 -90
  27. package/dist/commands/reviews-pragmatic.md +99 -99
  28. package/dist/commands/reviews-production-readiness.md +113 -113
  29. package/dist/commands/reviews-reality-check.md +110 -110
  30. package/dist/commands/reviews-spec-audit.md +114 -114
  31. package/dist/commands/work.md +280 -280
  32. package/dist/configuration/agents-config.d.ts +2 -0
  33. package/dist/configuration/agents-config.js +8 -44
  34. package/dist/configuration/commands-config.d.ts +23 -0
  35. package/dist/configuration/commands-config.js +17 -17
  36. package/dist/configuration/skills-config.d.ts +2 -0
  37. package/dist/configuration/skills-config.js +3 -3
  38. package/dist/hooks/hooks-diagnostics.d.ts +3 -0
  39. package/dist/hooks/hooks-diagnostics.js +21 -0
  40. package/dist/hooks/hooks-persistence.d.ts +17 -0
  41. package/dist/hooks/hooks-persistence.js +207 -0
  42. package/dist/hooks/hooks-registry.d.ts +6 -0
  43. package/dist/hooks/hooks-registry.js +104 -0
  44. package/dist/hooks/hooks-wrapper.d.ts +25 -0
  45. package/dist/hooks/hooks-wrapper.js +318 -0
  46. package/dist/hooks/internal/before-tool.d.ts +6 -0
  47. package/dist/hooks/internal/before-tool.js +13 -0
  48. package/dist/hooks/internal/session-compaction.d.ts +9 -0
  49. package/dist/hooks/{session-compaction.js → internal/session-compaction.js} +9 -7
  50. package/dist/hooks/runtime/circuit-breaker.d.ts +23 -0
  51. package/dist/hooks/runtime/circuit-breaker.js +39 -0
  52. package/dist/hooks/runtime/failure-policy.d.ts +15 -0
  53. package/dist/hooks/runtime/failure-policy.js +49 -0
  54. package/dist/hooks/runtime/process-executor.d.ts +33 -0
  55. package/dist/hooks/runtime/process-executor.js +147 -0
  56. package/dist/hooks/runtime/status-recorder.d.ts +27 -0
  57. package/dist/hooks/runtime/status-recorder.js +111 -0
  58. package/dist/index.d.ts +7 -0
  59. package/dist/index.js +111 -40
  60. package/dist/skills/agents-md-generator/SKILL.md +223 -223
  61. package/dist/skills/codebase-analyzer/SKILL.md +162 -162
  62. package/dist/skills/codebase-analyzer/references/code-analysis.md +63 -63
  63. package/dist/skills/codebase-analyzer/references/combined.md +31 -31
  64. package/dist/skills/codebase-analyzer/references/context-discovery.md +63 -63
  65. package/dist/skills/codebase-analyzer/references/file-discovery.md +51 -51
  66. package/dist/skills/codebase-analyzer/references/migration-target.md +23 -23
  67. package/dist/skills/codebase-analyzer/references/pattern-mining.md +22 -22
  68. package/dist/skills/dev-analyze/SKILL.md +115 -115
  69. package/dist/skills/dev-bugfix/SKILL.md +452 -452
  70. package/dist/skills/dev-finalize/SKILL.md +118 -118
  71. package/dist/skills/dev-implement/SKILL.md +167 -167
  72. package/dist/skills/dev-plan/SKILL.md +147 -147
  73. package/dist/skills/dev-spec/SKILL.md +182 -182
  74. package/dist/skills/dev-tdd-red/SKILL.md +94 -94
  75. package/dist/skills/dev-verify/SKILL.md +153 -153
  76. package/dist/skills/development/SKILL.md +260 -260
  77. package/dist/skills/diagrams-mermaid/SKILL.md +183 -159
  78. package/dist/skills/diagrams-mermaid/references/reference.md +220 -148
  79. package/dist/skills/docs-manager/SKILL.md +379 -379
  80. package/dist/skills/docs-manager/docs/INDEX.md +199 -199
  81. package/dist/skills/docs-manager/docs/standards/backend/api.md +25 -25
  82. package/dist/skills/docs-manager/docs/standards/backend/migrations.md +22 -22
  83. package/dist/skills/docs-manager/docs/standards/backend/models.md +25 -25
  84. package/dist/skills/docs-manager/docs/standards/backend/queries.md +22 -22
  85. package/dist/skills/docs-manager/docs/standards/frontend/accessibility.md +25 -25
  86. package/dist/skills/docs-manager/docs/standards/frontend/components.md +28 -28
  87. package/dist/skills/docs-manager/docs/standards/frontend/css.md +16 -16
  88. package/dist/skills/docs-manager/docs/standards/frontend/responsive.md +28 -28
  89. package/dist/skills/docs-manager/docs/standards/global/coding-style.md +25 -25
  90. package/dist/skills/docs-manager/docs/standards/global/commenting.md +10 -10
  91. package/dist/skills/docs-manager/docs/standards/global/conventions.md +31 -31
  92. package/dist/skills/docs-manager/docs/standards/global/error-handling.md +22 -22
  93. package/dist/skills/docs-manager/docs/standards/global/minimal-implementation.md +22 -22
  94. package/dist/skills/docs-manager/docs/standards/global/validation.md +28 -28
  95. package/dist/skills/docs-manager/docs/standards/testing/test-writing.md +25 -25
  96. package/dist/skills/docs-manager/references/agents-md-template.md +29 -29
  97. package/dist/skills/docs-manager/references/index-md-template.md +73 -73
  98. package/dist/skills/flow-init/SKILL.md +234 -234
  99. package/dist/skills/flow-init/references/architecture-template.md +45 -45
  100. package/dist/skills/flow-init/references/roadmap-templates.md +93 -93
  101. package/dist/skills/flow-init/references/tech-stack-template.md +70 -70
  102. package/dist/skills/flow-init/references/vision-templates.md +75 -75
  103. package/dist/skills/goal-development/SKILL.md +96 -96
  104. package/dist/skills/goal-migration/SKILL.md +114 -114
  105. package/dist/skills/goal-performance/SKILL.md +126 -0
  106. package/dist/skills/goal-research/SKILL.md +118 -118
  107. package/dist/skills/html-renderer/SKILL.md +173 -173
  108. package/dist/skills/html-renderer/references/index.html +318 -318
  109. package/dist/skills/html-renderer/references/styles.css +388 -388
  110. package/dist/skills/html-renderer/references/tokens.json +104 -104
  111. package/dist/skills/implementation-plan-executor/SKILL.md +378 -378
  112. package/dist/skills/implementation-verifier/SKILL.md +307 -307
  113. package/dist/skills/migration/SKILL.md +268 -268
  114. package/dist/skills/migration-analyze/SKILL.md +126 -126
  115. package/dist/skills/migration-finalize/SKILL.md +161 -161
  116. package/dist/skills/migration-fix/SKILL.md +155 -155
  117. package/dist/skills/migration-implement/SKILL.md +131 -131
  118. package/dist/skills/migration-plan/SKILL.md +131 -131
  119. package/dist/skills/migration-spec/SKILL.md +135 -135
  120. package/dist/skills/migration-spec/references/migration-strategies.md +430 -430
  121. package/dist/skills/migration-target/SKILL.md +134 -134
  122. package/dist/skills/migration-target/references/migration-types.md +489 -489
  123. package/dist/skills/migration-verify/SKILL.md +184 -184
  124. package/dist/skills/orchestrator-framework/SKILL.md +65 -65
  125. package/dist/skills/orchestrator-framework/references/command-namespacing.md +7 -7
  126. package/dist/skills/orchestrator-framework/references/confirm-or-revise-exception.md +20 -20
  127. package/dist/skills/orchestrator-framework/references/delegation-rules.md +54 -54
  128. package/dist/skills/orchestrator-framework/references/dispatcher-handoff.md +27 -27
  129. package/dist/skills/orchestrator-framework/references/fix-loop-contract.md +65 -65
  130. package/dist/skills/orchestrator-framework/references/gate-contract.md +122 -117
  131. package/dist/skills/orchestrator-framework/references/orchestrator-creation-checklist.md +51 -51
  132. package/dist/skills/orchestrator-framework/references/orchestrator-patterns.md +235 -235
  133. package/dist/skills/performance/SKILL.md +267 -437
  134. package/dist/skills/performance-analyze/SKILL.md +129 -0
  135. package/dist/skills/{performance → performance-analyze}/references/performance-optimization-guide.md +271 -365
  136. package/dist/skills/performance-finalize/SKILL.md +117 -0
  137. package/dist/skills/performance-implement/SKILL.md +114 -0
  138. package/dist/skills/performance-plan/SKILL.md +112 -0
  139. package/dist/skills/performance-spec/SKILL.md +145 -0
  140. package/dist/skills/performance-verify/SKILL.md +164 -0
  141. package/dist/skills/research/SKILL.md +249 -249
  142. package/dist/skills/research-brainstorm/SKILL.md +120 -120
  143. package/dist/skills/research-brainstorm/references/brainstorming-techniques.md +84 -84
  144. package/dist/skills/research-converge/SKILL.md +130 -130
  145. package/dist/skills/research-design/SKILL.md +146 -146
  146. package/dist/skills/research-design/references/design-techniques.md +40 -40
  147. package/dist/skills/research-finalize/SKILL.md +125 -125
  148. package/dist/skills/research-fork/SKILL.md +190 -190
  149. package/dist/skills/research-gather/SKILL.md +133 -133
  150. package/dist/skills/research-plan/SKILL.md +141 -141
  151. package/dist/skills/research-plan/references/research-methodologies.md +710 -710
  152. package/dist/skills/research-quick/SKILL.md +139 -139
  153. package/dist/skills/research-synthesize/SKILL.md +127 -127
  154. package/dist/skills/rule-reviewer/SKILL.md +334 -334
  155. package/dist/skills/standards-discover/SKILL.md +260 -260
  156. package/dist/skills/standards-discover/references/aggregation-strategy.md +76 -76
  157. package/dist/skills/standards-discover/references/code-pattern-prompt.md +68 -68
  158. package/dist/skills/standards-discover/references/config-analyzer-prompt.md +67 -67
  159. package/dist/skills/standards-discover/references/docs-extractor-prompt.md +65 -65
  160. package/dist/skills/standards-discover/references/external-analyzer-prompt.md +75 -75
  161. package/dist/skills/standards-update/SKILL.md +207 -207
  162. package/dist/templates/orchestrator-state-base.yml +17 -17
  163. package/dist/templates/orchestrator-state-development.yml +95 -95
  164. package/dist/templates/orchestrator-state-migration.yml +95 -95
  165. package/dist/templates/orchestrator-state-performance.yml +64 -53
  166. package/dist/templates/orchestrator-state-research.yml +67 -67
  167. package/dist/tools/fork_task.d.ts +17 -0
  168. package/dist/tools/fork_task.js +21 -11
  169. package/dist/tools/verify_template.d.ts +11 -0
  170. package/dist/tools/verify_template.js +32 -17
  171. package/dist/tui/hooks-dialogs.d.ts +20 -0
  172. package/dist/tui/hooks-dialogs.js +181 -0
  173. package/dist/tui/hooks-presenter.d.ts +15 -0
  174. package/dist/tui/hooks-presenter.js +70 -0
  175. package/dist/tui/hooks-sidebar.d.ts +10 -0
  176. package/dist/tui/hooks-sidebar.js +104 -0
  177. package/dist/tui/primitives.d.ts +21 -0
  178. package/dist/tui/primitives.js +47 -0
  179. package/dist/tui.d.ts +12 -0
  180. package/dist/tui.js +129 -0
  181. package/dist/types/hook-types.d.ts +125 -0
  182. package/dist/types/hook-types.js +76 -0
  183. package/dist/types/opencode-types.d.ts +13 -0
  184. package/dist/utils/file-util.d.ts +2 -0
  185. package/dist/utils/file-util.js +6 -6
  186. package/dist/utils/fork-task.d.ts +27 -0
  187. package/dist/utils/fork-task.js +18 -23
  188. package/dist/utils/plugin-info.d.ts +3 -0
  189. package/dist/utils/plugin-info.js +8 -10
  190. package/dist/utils/workflow-paths.d.ts +17 -0
  191. package/dist/utils/workflow-paths.js +18 -0
  192. package/dist/utils/yaml-structure.d.ts +7 -0
  193. package/dist/utils/yaml-structure.js +7 -11
  194. package/package.json +68 -48
  195. 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
+ ```