speccrew 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (153) hide show
  1. package/.speccrew/agents/speccrew-feature-designer.md +142 -0
  2. package/.speccrew/agents/speccrew-product-manager.md +61 -0
  3. package/.speccrew/agents/speccrew-system-designer.md +200 -0
  4. package/.speccrew/agents/speccrew-system-developer.md +238 -0
  5. package/.speccrew/agents/speccrew-task-worker.md +80 -0
  6. package/.speccrew/agents/speccrew-team-leader.md +92 -0
  7. package/.speccrew/agents/speccrew-test-manager.md +313 -0
  8. package/.speccrew/skills/speccrew-create-agents/SKILL.md +98 -0
  9. package/.speccrew/skills/speccrew-create-agents/templates/agents/designer-agent.md +54 -0
  10. package/.speccrew/skills/speccrew-create-agents/templates/agents/dev-agent.md +79 -0
  11. package/.speccrew/skills/speccrew-create-agents/templates/agents/test-agent.md +80 -0
  12. package/.speccrew/skills/speccrew-dev-backend/SKILL.md +205 -0
  13. package/.speccrew/skills/speccrew-dev-backend/templates/TASK-RECORD-TEMPLATE.md +118 -0
  14. package/.speccrew/skills/speccrew-dev-desktop/SKILL.md +258 -0
  15. package/.speccrew/skills/speccrew-dev-desktop/templates/TASK-RECORD-TEMPLATE.md +161 -0
  16. package/.speccrew/skills/speccrew-dev-frontend/SKILL.md +202 -0
  17. package/.speccrew/skills/speccrew-dev-frontend/templates/TASK-RECORD-TEMPLATE.md +115 -0
  18. package/.speccrew/skills/speccrew-dev-mobile/SKILL.md +200 -0
  19. package/.speccrew/skills/speccrew-dev-mobile/templates/TASK-RECORD-TEMPLATE.md +125 -0
  20. package/.speccrew/skills/speccrew-fd-api-contract/SKILL.md +73 -0
  21. package/.speccrew/skills/speccrew-fd-api-contract/templates/API-CONTRACT-TEMPLATE.md +96 -0
  22. package/.speccrew/skills/speccrew-fd-feature-design/SKILL.md +395 -0
  23. package/.speccrew/skills/speccrew-fd-feature-design/templates/FEATURE-SPEC-TEMPLATE.md +387 -0
  24. package/.speccrew/skills/speccrew-get-timestamp/SKILL.md +80 -0
  25. package/.speccrew/skills/speccrew-get-timestamp/scripts/get-timestamp.js +35 -0
  26. package/.speccrew/skills/speccrew-knowledge-bizs-api-analyze/SKILL.md +1116 -0
  27. package/.speccrew/skills/speccrew-knowledge-bizs-api-analyze/templates/FEATURE-DETAIL-TEMPLATE-FASTAPI.md +462 -0
  28. package/.speccrew/skills/speccrew-knowledge-bizs-api-analyze/templates/FEATURE-DETAIL-TEMPLATE-JAVA.md +480 -0
  29. package/.speccrew/skills/speccrew-knowledge-bizs-api-analyze/templates/FEATURE-DETAIL-TEMPLATE-NET.md +464 -0
  30. package/.speccrew/skills/speccrew-knowledge-bizs-api-analyze/templates/FEATURE-DETAIL-TEMPLATE.md +480 -0
  31. package/.speccrew/skills/speccrew-knowledge-bizs-api-analyze/templates/MODULE-OVERVIEW-TEMPLATE.md +367 -0
  32. package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/SKILL.md +667 -0
  33. package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/STATUS-FORMATS.md +74 -0
  34. package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/scripts/batch-orchestrator.js +176 -0
  35. package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/scripts/get-next-batch.js +150 -0
  36. package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/scripts/get-pending-features.js +106 -0
  37. package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/scripts/mark-stale.js +249 -0
  38. package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/scripts/process-batch-results.js +848 -0
  39. package/.speccrew/skills/speccrew-knowledge-bizs-dispatch/scripts/update-feature-status.js +226 -0
  40. package/.speccrew/skills/speccrew-knowledge-bizs-init-features/SKILL.md +264 -0
  41. package/.speccrew/skills/speccrew-knowledge-bizs-init-features/examples/features.json +34 -0
  42. package/.speccrew/skills/speccrew-knowledge-bizs-init-features/scripts/generate-inventory.js +867 -0
  43. package/.speccrew/skills/speccrew-knowledge-bizs-init-features/scripts/test-inventory.js +26 -0
  44. package/.speccrew/skills/speccrew-knowledge-bizs-module-classify/SKILL.md +165 -0
  45. package/.speccrew/skills/speccrew-knowledge-bizs-module-classify/scripts/apply-module-mapping.js +208 -0
  46. package/.speccrew/skills/speccrew-knowledge-bizs-module-classify/scripts/extract-module-summary.js +180 -0
  47. package/.speccrew/skills/speccrew-knowledge-bizs-module-classify/scripts/reindex-modules.js +358 -0
  48. package/.speccrew/skills/speccrew-knowledge-bizs-ui-analyze/SKILL.md +1055 -0
  49. package/.speccrew/skills/speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI-DESKTOP.md +303 -0
  50. package/.speccrew/skills/speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI-ELECTRON.md +327 -0
  51. package/.speccrew/skills/speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI-MINIAPP.md +292 -0
  52. package/.speccrew/skills/speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI-MOBILE.md +281 -0
  53. package/.speccrew/skills/speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI.md +324 -0
  54. package/.speccrew/skills/speccrew-knowledge-bizs-ui-style-extract/SKILL.md +270 -0
  55. package/.speccrew/skills/speccrew-knowledge-bizs-ui-style-extract/templates/COMPONENT-PATTERN-TEMPLATE.md +33 -0
  56. package/.speccrew/skills/speccrew-knowledge-bizs-ui-style-extract/templates/LAYOUT-PATTERN-TEMPLATE.md +33 -0
  57. package/.speccrew/skills/speccrew-knowledge-bizs-ui-style-extract/templates/PAGE-TYPE-TEMPLATE.md +33 -0
  58. package/.speccrew/skills/speccrew-knowledge-graph-query/SKILL.md +229 -0
  59. package/.speccrew/skills/speccrew-knowledge-graph-query/scripts/graph-query.js +549 -0
  60. package/.speccrew/skills/speccrew-knowledge-graph-write/SKILL.md +181 -0
  61. package/.speccrew/skills/speccrew-knowledge-graph-write/scripts/graph-write.js +651 -0
  62. package/.speccrew/skills/speccrew-knowledge-module-summarize/SKILL.md +305 -0
  63. package/.speccrew/skills/speccrew-knowledge-module-summarize/templates/MODULE-OVERVIEW-TEMPLATE.md +400 -0
  64. package/.speccrew/skills/speccrew-knowledge-system-summarize/SKILL.md +351 -0
  65. package/.speccrew/skills/speccrew-knowledge-system-summarize/templates/SYSTEM-OVERVIEW-TEMPLATE.md +294 -0
  66. package/.speccrew/skills/speccrew-knowledge-techs-dispatch/SKILL.md +683 -0
  67. package/.speccrew/skills/speccrew-knowledge-techs-dispatch/STATUS-FORMATS.md +550 -0
  68. package/.speccrew/skills/speccrew-knowledge-techs-dispatch/templates/techs-manifest-EXAMPLE.json +35 -0
  69. package/.speccrew/skills/speccrew-knowledge-techs-generate/SKILL.md +1087 -0
  70. package/.speccrew/skills/speccrew-knowledge-techs-generate/templates/ARCHITECTURE-TEMPLATE.md +240 -0
  71. package/.speccrew/skills/speccrew-knowledge-techs-generate/templates/COLOR-SYSTEM-TEMPLATE.md +68 -0
  72. package/.speccrew/skills/speccrew-knowledge-techs-generate/templates/COMPONENT-LIBRARY-TEMPLATE.md +86 -0
  73. package/.speccrew/skills/speccrew-knowledge-techs-generate/templates/CONVENTIONS-BUILD-TEMPLATE.md +466 -0
  74. package/.speccrew/skills/speccrew-knowledge-techs-generate/templates/CONVENTIONS-DATA-TEMPLATE.md +432 -0
  75. package/.speccrew/skills/speccrew-knowledge-techs-generate/templates/CONVENTIONS-DESIGN-TEMPLATE.md +1209 -0
  76. package/.speccrew/skills/speccrew-knowledge-techs-generate/templates/CONVENTIONS-DEV-TEMPLATE.md +1433 -0
  77. package/.speccrew/skills/speccrew-knowledge-techs-generate/templates/CONVENTIONS-SYSTEM-TEST-TEMPLATE.md +1052 -0
  78. package/.speccrew/skills/speccrew-knowledge-techs-generate/templates/CONVENTIONS-UNIT-TEST-TEMPLATE.md +946 -0
  79. package/.speccrew/skills/speccrew-knowledge-techs-generate/templates/INDEX-TEMPLATE.md +29 -0
  80. package/.speccrew/skills/speccrew-knowledge-techs-generate/templates/PAGE-LAYOUTS-TEMPLATE.md +69 -0
  81. package/.speccrew/skills/speccrew-knowledge-techs-generate/templates/PAGE-TYPE-SUMMARY-TEMPLATE.md +74 -0
  82. package/.speccrew/skills/speccrew-knowledge-techs-generate/templates/TECH-STACK-TEMPLATE.md +232 -0
  83. package/.speccrew/skills/speccrew-knowledge-techs-generate-conventions/SKILL.md +628 -0
  84. package/.speccrew/skills/speccrew-knowledge-techs-generate-ui-style/SKILL.md +392 -0
  85. package/.speccrew/skills/speccrew-knowledge-techs-index/SKILL.md +489 -0
  86. package/.speccrew/skills/speccrew-knowledge-techs-index/templates/INDEX-TEMPLATE.md +243 -0
  87. package/.speccrew/skills/speccrew-knowledge-techs-init/SKILL.md +269 -0
  88. package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/SKILL.md +562 -0
  89. package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/templates/BUSINESS-COMPONENTS-TEMPLATE.md +171 -0
  90. package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/templates/COMMON-COMPONENTS-TEMPLATE.md +177 -0
  91. package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/templates/COMPONENT-INDIVIDUAL-TEMPLATE.md +80 -0
  92. package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/templates/COMPONENT-LIBRARY-TEMPLATE.md +118 -0
  93. package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/templates/LAYOUT-INDIVIDUAL-TEMPLATE.md +97 -0
  94. package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/templates/LAYOUT-PATTERNS-TEMPLATE.md +208 -0
  95. package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/templates/NAVIGATION-PATTERNS-TEMPLATE.md +157 -0
  96. package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/templates/PAGE-TYPE-INDIVIDUAL-TEMPLATE.md +123 -0
  97. package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/templates/PAGE-TYPE-SUMMARY-TEMPLATE.md +58 -0
  98. package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/templates/SPACING-TEMPLATE.md +119 -0
  99. package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/templates/STYLE-SYSTEM-TEMPLATE.md +117 -0
  100. package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/templates/TYPOGRAPHY-TEMPLATE.md +107 -0
  101. package/.speccrew/skills/speccrew-knowledge-techs-ui-analyze/templates/UI-STYLE-GUIDE-TEMPLATE.md +171 -0
  102. package/.speccrew/skills/speccrew-pm-requirement-analysis/SKILL.md +434 -0
  103. package/.speccrew/skills/speccrew-pm-requirement-analysis/templates/BIZS-MODELING-TEMPLATE.md +332 -0
  104. package/.speccrew/skills/speccrew-pm-requirement-analysis/templates/PRD-TEMPLATE.md +200 -0
  105. package/.speccrew/skills/speccrew-pm-requirement-assess/SKILL.md +195 -0
  106. package/.speccrew/skills/speccrew-project-diagnosis/SKILL.md +208 -0
  107. package/.speccrew/skills/speccrew-project-diagnosis/templates/DIAGNOSIS-REPORT-TEMPLATE.md +202 -0
  108. package/.speccrew/skills/speccrew-sd-backend/SKILL.md +188 -0
  109. package/.speccrew/skills/speccrew-sd-backend/templates/INDEX-TEMPLATE.md +85 -0
  110. package/.speccrew/skills/speccrew-sd-backend/templates/SD-BACKEND-TEMPLATE.md +269 -0
  111. package/.speccrew/skills/speccrew-sd-desktop/SKILL.md +192 -0
  112. package/.speccrew/skills/speccrew-sd-desktop/templates/INDEX-TEMPLATE.md +271 -0
  113. package/.speccrew/skills/speccrew-sd-desktop/templates/SD-DESKTOP-TEMPLATE.md +673 -0
  114. package/.speccrew/skills/speccrew-sd-frontend/SKILL.md +176 -0
  115. package/.speccrew/skills/speccrew-sd-frontend/templates/INDEX-TEMPLATE.md +184 -0
  116. package/.speccrew/skills/speccrew-sd-frontend/templates/SD-FRONTEND-TEMPLATE.md +382 -0
  117. package/.speccrew/skills/speccrew-sd-mobile/SKILL.md +189 -0
  118. package/.speccrew/skills/speccrew-sd-mobile/templates/INDEX-TEMPLATE.md +219 -0
  119. package/.speccrew/skills/speccrew-sd-mobile/templates/SD-MOBILE-TEMPLATE.md +534 -0
  120. package/.speccrew/skills/speccrew-test-case-design/SKILL.md +284 -0
  121. package/.speccrew/skills/speccrew-test-case-design/templates/TEST-CASE-DESIGN-TEMPLATE.md +263 -0
  122. package/.speccrew/skills/speccrew-test-code-gen/SKILL.md +313 -0
  123. package/.speccrew/skills/speccrew-test-code-gen/templates/TEST-CODE-PLAN-TEMPLATE.md +180 -0
  124. package/.speccrew/skills/speccrew-test-execute/SKILL.md +283 -0
  125. package/.speccrew/skills/speccrew-test-execute/templates/BUG-REPORT-TEMPLATE.md +50 -0
  126. package/.speccrew/skills/speccrew-test-execute/templates/TEST-REPORT-TEMPLATE.md +57 -0
  127. package/.speccrew/skills/speccrew-workflow-diagnose/SKILL.md +155 -0
  128. package/LICENSE +21 -0
  129. package/README.ar.md +318 -0
  130. package/README.en.md +318 -0
  131. package/README.es.md +318 -0
  132. package/README.md +340 -0
  133. package/bin/cli.js +62 -0
  134. package/lib/commands/doctor.js +138 -0
  135. package/lib/commands/init.js +231 -0
  136. package/lib/commands/list.js +114 -0
  137. package/lib/commands/uninstall.js +117 -0
  138. package/lib/commands/update.js +351 -0
  139. package/lib/ide-adapters.js +73 -0
  140. package/lib/utils.js +104 -0
  141. package/package.json +28 -0
  142. package/workspace-template/docs/configs/document-templates.json +667 -0
  143. package/workspace-template/docs/configs/platform-mapping.json +194 -0
  144. package/workspace-template/docs/configs/tech-stack-mappings.json +313 -0
  145. package/workspace-template/docs/configs/validation-rules.json +87 -0
  146. package/workspace-template/docs/rules/mermaid-rule.md +114 -0
  147. package/workspace-template/docs/solutions/Agent/346/212/200/350/203/275/345/256/232/344/271/211+/351/234/200/346/261/202/346/226/207/346/241/243+UML/344/275/277/347/224/250/346/250/241/346/235/277/357/274/210ISA-95/345/205/255/346/256/265/345/274/217/350/236/215/345/220/210/347/211/210/357/274/211.md +586 -0
  148. package/workspace-template/docs/solutions/agent-knowledge-map.md +238 -0
  149. package/workspace-template/docs/solutions/bizs-knowledge-pipeline.md +678 -0
  150. package/workspace-template/docs/solutions/harness.md +410 -0
  151. package/workspace-template/docs/solutions/knowledge-incremental-sync-spec.md +943 -0
  152. package/workspace-template/docs/solutions/techs-knowledge-pipeline.md +803 -0
  153. package/workspace-template/docs/solutions/workspace-structure.md +318 -0
@@ -0,0 +1,29 @@
1
+ # {{PlatformName}} Knowledge Base
2
+
3
+ ## Platform Overview
4
+
5
+ | Field | Value |
6
+ |-------|-------|
7
+ | **Platform Name** | {{PlatformName}} |
8
+ | **Platform Type** | {{PlatformType}} |
9
+ | **Tech Stack** | {{TechStack}} |
10
+
11
+ ## Module Index
12
+
13
+ | Module | Description | Detail Doc |
14
+ |--------|-------------|------------|
15
+ | {{ModuleIndex}} |
16
+
17
+ ## Quick Navigation
18
+
19
+ - [System Overview]({{SystemSummarizeLink}})
20
+ - [Module List](#module-index)
21
+
22
+ ## Knowledge Structure
23
+
24
+ ```
25
+ {{PlatformType}}/
26
+ ├── INDEX.md
27
+ ├── system-summarize.md
28
+ └── {{ModuleDirectories}}
29
+ ```
@@ -0,0 +1,69 @@
1
+ <!-- AI-TAG: platform_id-ui-layouts -->
2
+ # Page Layouts - platform_id
3
+
4
+ <cite>
5
+ **Files Referenced in This Document**
6
+ - [layouts_dir](relative_pathlayouts_source_path)
7
+ </cite>
8
+
9
+ ---
10
+
11
+ ## 1. Layout System Overview
12
+
13
+ > platform_id uses layout_approach for page layout management.
14
+
15
+ ## 2. Layout Types
16
+
17
+ <!-- AI-TAG: LAYOUT_TYPES -->
18
+
19
+ | Layout Type | Description | Used By | Source |
20
+ |------------|-------------|---------|--------|
21
+ | layout_name | description | page_examples | [Source](relative_pathsource_file) |
22
+
23
+ ## 3. Layout Structure Details
24
+
25
+ <!-- AI-TAG: LAYOUT_DETAILS -->
26
+ <!-- For each layout type, document its structure -->
27
+
28
+ ### 3.1 LayoutName
29
+
30
+ **Structure:**
31
+ ```
32
+ ┌─────────────────────────────────┐
33
+ │ structure_ascii_art │
34
+ └─────────────────────────────────┘
35
+ ```
36
+
37
+ **Slots/Regions:**
38
+
39
+ | Region | Purpose | Required | Default Content |
40
+ |--------|---------|----------|-----------------|
41
+ | region | purpose | required | default |
42
+
43
+ **Responsive Behavior:**
44
+
45
+ | Breakpoint | Behavior |
46
+ |-----------|----------|
47
+ | Desktop (>=1200px) | behavior |
48
+ | Tablet (768-1199px) | behavior |
49
+ | Mobile (<768px) | behavior |
50
+
51
+ ## 4. Navigation Patterns
52
+
53
+ <!-- AI-TAG: NAVIGATION -->
54
+
55
+ | Pattern | Description | Implementation | Source |
56
+ |---------|-------------|----------------|--------|
57
+ | nav_pattern | description | implementation | [Source](relative_pathsource_file) |
58
+
59
+ ## 5. Agent Usage Guide
60
+
61
+ | Agent Role | How to Use This Document |
62
+ |-----------|------------------------|
63
+ | Design Agent | 参考布局类型选择合适的页面框架 |
64
+ | Dev Agent | 查阅布局实现方式和插槽定义 |
65
+
66
+ ---
67
+
68
+ **Section Source**
69
+ - [layouts_dir](relative_pathlayouts_source_path)
@@ -0,0 +1,74 @@
1
+ <!-- AI-TAG: platform_id-ui-page-types -->
2
+ # Page Type Summary - platform_id
3
+
4
+ <cite>
5
+ **Files Referenced in This Document**
6
+ - [views_dir](relative_pathviews_source_path)
7
+ </cite>
8
+
9
+ ---
10
+
11
+ ## 1. Page Type Overview
12
+
13
+ > platform_id contains total_pages pages across type_count page types.
14
+
15
+ ## 2. Page Type Classification
16
+
17
+ <!-- AI-TAG: PAGE_TYPES -->
18
+
19
+ | Page Type | Count | Description | Typical Structure | Example Pages |
20
+ |-----------|-------|-------------|-------------------|---------------|
21
+ | page_type | count | description | structure | examples |
22
+
23
+ ## 3. Page Type Details
24
+
25
+ <!-- AI-TAG: PAGE_TYPE_DETAILS -->
26
+
27
+ ### 3.1 PageTypeName
28
+
29
+ **Description:** description
30
+
31
+ **Standard Structure:**
32
+ ```
33
+ ┌─────────────────────────────────┐
34
+ │ structure_diagram │
35
+ └─────────────────────────────────┘
36
+ ```
37
+
38
+ **Required Components:**
39
+
40
+ | Component | Role | Required |
41
+ |-----------|------|----------|
42
+ | component | role | required |
43
+
44
+ **Routing Pattern:** `route_pattern`
45
+
46
+ **Data Flow:**
47
+ ```mermaid
48
+ graph LR
49
+ A[Component] --> B[Store]
50
+ B --> C[API]
51
+ ```
52
+
53
+ ## 4. Page Naming & Routing Conventions
54
+
55
+ <!-- AI-TAG: ROUTING -->
56
+
57
+ | Convention | Rule | Example |
58
+ |-----------|------|---------|
59
+ | File naming | rule | example |
60
+ | Route path | rule | example |
61
+ | Route params | rule | example |
62
+
63
+ ## 5. Agent Usage Guide
64
+
65
+ | Agent Role | How to Use This Document |
66
+ |-----------|------------------------|
67
+ | Solution Agent | 评估新功能应采用哪种页面类型 |
68
+ | Design Agent | 参考页面类型标准结构设计原型 |
69
+ | Dev Agent | 遵循路由和命名规范创建新页面 |
70
+
71
+ ---
72
+
73
+ **Section Source**
74
+ - [views_dir](relative_pathviews_source_path)
@@ -0,0 +1,232 @@
1
+ # {{platform_name}} Technology Stack
2
+
3
+ <cite>
4
+ **Files Referenced in This Document**
5
+ {{#each source_files}}
6
+ - [{{name}}](file://{{path}})
7
+ {{/each}}
8
+ </cite>
9
+
10
+ > **Target Audience**: devcrew-designer-{{platform_id}}, devcrew-dev-{{platform_id}}, devcrew-test-{{platform_id}}
11
+
12
+ ## Table of Contents
13
+
14
+ 1. [Introduction](#introduction)
15
+ 2. [Project Structure](#project-structure)
16
+ 3. [Core Components](#core-components)
17
+ 4. [Architecture Overview](#architecture-overview)
18
+ 5. [Detailed Component Analysis](#detailed-component-analysis)
19
+ 6. [Dependency Analysis](#dependency-analysis)
20
+ 7. [Performance Considerations](#performance-considerations)
21
+ 8. [Troubleshooting Guide](#troubleshooting-guide)
22
+ 9. [Conclusion](#conclusion)
23
+ 10. [Appendix](#appendix)
24
+
25
+ ## Introduction
26
+
27
+ This technology stack document provides a systematic overview of framework versions, dependencies, build tools, and configuration files for the {{platform_name}} platform, helping developers understand the technology choices and architecture design rationale.
28
+
29
+ ## Project Structure
30
+
31
+ {{platform_name}} is organized using the {{architecture_type}} architecture:
32
+
33
+ ```
34
+ {{directory_structure}}
35
+ ```
36
+
37
+ ```mermaid
38
+ graph TB
39
+ {{#each modules}}
40
+ {{id}}["{{name}}"]
41
+ {{/each}}
42
+ {{#each module_relations}}
43
+ {{from}} --> {{to}}
44
+ {{/each}}
45
+ ```
46
+
47
+ **Diagram Source**
48
+ {{#each structure_sources}}
49
+ - [{{name}}](file://{{path}}#L{{start}}-L{{end}})
50
+ {{/each}}
51
+
52
+ **Section Source**
53
+ {{#each project_structure_sources}}
54
+ - [{{name}}](file://{{path}}#L{{start}}-L{{end}})
55
+ {{/each}}
56
+
57
+ ## Core Components
58
+
59
+ | Component | Technology | Version | Purpose |
60
+ |-----------|------------|---------|---------|
61
+ {{#each core_technologies}}
62
+ | {{category}} | {{name}} | {{version}} | {{purpose}} |
63
+ {{/each}}
64
+
65
+ **Section Source**
66
+ {{#each core_components_sources}}
67
+ - [{{name}}](file://{{path}}#L{{start}}-L{{end}})
68
+ {{/each}}
69
+
70
+ ## Architecture Overview
71
+
72
+ {{architecture_overview}}
73
+
74
+ ```mermaid
75
+ graph TB
76
+ subgraph "{{platform_name}}"
77
+ {{#each arch_components}}
78
+ {{id}}["{{name}}"]
79
+ {{/each}}
80
+ end
81
+ {{#each arch_relations}}
82
+ {{from}} --> {{to}}
83
+ {{/each}}
84
+ ```
85
+
86
+ **Diagram Source**
87
+ {{#each architecture_sources}}
88
+ - [{{name}}](file://{{path}}#L{{start}}-L{{end}})
89
+ {{/each}}
90
+
91
+ **Section Source**
92
+ {{#each architecture_overview_sources}}
93
+ - [{{name}}](file://{{path}}#L{{start}}-L{{end}})
94
+ {{/each}}
95
+
96
+ ## Detailed Component Analysis
97
+
98
+ {{#each component_analysis}}
99
+ ### {{name}}
100
+
101
+ {{description}}
102
+
103
+ **Key Features:**
104
+ {{#each features}}
105
+ - {{this}}
106
+ {{/each}}
107
+
108
+ **Section Source**
109
+ {{#each sources}}
110
+ - [{{name}}](file://{{path}}#L{{start}}-L{{end}})
111
+ {{/each}}
112
+
113
+ {{/each}}
114
+
115
+ ## Dependency Analysis
116
+
117
+ ### Production Dependencies
118
+
119
+ | Package | Version | Purpose |
120
+ |---------|---------|---------|
121
+ {{#each production_dependencies}}
122
+ | {{name}} | {{version}} | {{purpose}} |
123
+ {{/each}}
124
+
125
+ ### Development Dependencies
126
+
127
+ | Package | Version | Purpose |
128
+ |---------|---------|---------|
129
+ {{#each development_dependencies}}
130
+ | {{name}} | {{version}} | {{purpose}} |
131
+ {{/each}}
132
+
133
+ ### Dependency Version Management
134
+
135
+ {{dependency_management_strategy}}
136
+
137
+ ```mermaid
138
+ graph LR
139
+ {{#each dependency_layers}}
140
+ {{id}}["{{name}}"]
141
+ {{/each}}
142
+ {{#each dependency_relations}}
143
+ {{from}} --> {{to}}
144
+ {{/each}}
145
+ ```
146
+
147
+ **Diagram Source**
148
+ {{#each dependency_sources}}
149
+ - [{{name}}](file://{{path}}#L{{start}}-L{{end}})
150
+ {{/each}}
151
+
152
+ **Section Source**
153
+ {{#each dependency_analysis_sources}}
154
+ - [{{name}}](file://{{path}}#L{{start}}-L{{end}})
155
+ {{/each}}
156
+
157
+ ## Performance Considerations
158
+
159
+ {{#each performance_considerations}}
160
+ ### {{category}}
161
+
162
+ {{description}}
163
+
164
+ **Recommendations:**
165
+ {{#each recommendations}}
166
+ - {{this}}
167
+ {{/each}}
168
+
169
+ {{/each}}
170
+
171
+ [This section provides general guidance, no specific file reference required]
172
+
173
+ ## Troubleshooting Guide
174
+
175
+ {{#each troubleshooting}}
176
+ ### {{issue}}
177
+
178
+ **Symptoms:**
179
+ {{#each symptoms}}
180
+ - {{this}}
181
+ {{/each}}
182
+
183
+ **Solutions:**
184
+ {{#each solutions}}
185
+ - {{this}}
186
+ {{/each}}
187
+
188
+ {{/each}}
189
+
190
+ **Section Source**
191
+ {{#each troubleshooting_sources}}
192
+ - [{{name}}](file://{{path}}#L{{start}}-L{{end}})
193
+ {{/each}}
194
+
195
+ ## Conclusion
196
+
197
+ {{conclusion}}
198
+
199
+ [This section is a summary, no specific file reference required]
200
+
201
+ ## Appendix
202
+
203
+ ### Configuration Files
204
+
205
+ | File | Purpose |
206
+ |------|---------|
207
+ {{#each config_files}}
208
+ | [{{name}}]({{path}}) | {{purpose}} |
209
+ {{/each}}
210
+
211
+ ### Package Scripts
212
+
213
+ | Script | Command | Purpose |
214
+ |--------|---------|---------|
215
+ {{#each package_scripts}}
216
+ | {{name}} | `{{command}}` | {{purpose}} |
217
+ {{/each}}
218
+
219
+ ### Environment Requirements
220
+
221
+ {{environment_requirements}}
222
+
223
+ ### Learning Resources
224
+
225
+ {{#each learning_resources}}
226
+ - **{{name}}**: {{url}}
227
+ {{/each}}
228
+
229
+ **Section Source**
230
+ {{#each appendix_sources}}
231
+ - [{{name}}](file://{{path}}#L{{start}}-L{{end}})
232
+ {{/each}}