ai-flow-dev 2.7.0 → 2.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (171) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +573 -570
  3. package/package.json +74 -74
  4. package/prompts/backend/flow-build-phase-0.md +535 -535
  5. package/prompts/backend/flow-build-phase-1.md +626 -626
  6. package/prompts/backend/flow-build-phase-10.md +340 -340
  7. package/prompts/backend/flow-build-phase-2.md +573 -573
  8. package/prompts/backend/flow-build-phase-3.md +834 -834
  9. package/prompts/backend/flow-build-phase-4.md +554 -554
  10. package/prompts/backend/flow-build-phase-5.md +703 -703
  11. package/prompts/backend/flow-build-phase-6.md +524 -524
  12. package/prompts/backend/flow-build-phase-7.md +1001 -1001
  13. package/prompts/backend/flow-build-phase-8.md +1407 -1407
  14. package/prompts/backend/flow-build-phase-9.md +477 -477
  15. package/prompts/backend/flow-build.md +137 -137
  16. package/prompts/backend/flow-check-review.md +656 -20
  17. package/prompts/backend/flow-check-test.md +526 -14
  18. package/prompts/backend/flow-check.md +717 -67
  19. package/prompts/backend/flow-commit.md +88 -119
  20. package/prompts/backend/flow-docs-sync.md +354 -354
  21. package/prompts/backend/flow-finish.md +919 -0
  22. package/prompts/backend/flow-release.md +949 -0
  23. package/prompts/backend/flow-work-feature.md +61 -61
  24. package/prompts/backend/flow-work-fix.md +46 -46
  25. package/prompts/backend/flow-work-refactor.md +48 -48
  26. package/prompts/backend/flow-work-resume.md +34 -34
  27. package/prompts/backend/flow-work.md +1098 -1286
  28. package/prompts/desktop/flow-build-phase-0.md +359 -359
  29. package/prompts/desktop/flow-build-phase-1.md +295 -295
  30. package/prompts/desktop/flow-build-phase-10.md +357 -357
  31. package/prompts/desktop/flow-build-phase-2.md +282 -282
  32. package/prompts/desktop/flow-build-phase-3.md +291 -291
  33. package/prompts/desktop/flow-build-phase-4.md +308 -308
  34. package/prompts/desktop/flow-build-phase-5.md +269 -269
  35. package/prompts/desktop/flow-build-phase-6.md +350 -350
  36. package/prompts/desktop/flow-build-phase-7.md +297 -297
  37. package/prompts/desktop/flow-build-phase-8.md +541 -541
  38. package/prompts/desktop/flow-build-phase-9.md +439 -439
  39. package/prompts/desktop/flow-build.md +156 -156
  40. package/prompts/desktop/flow-check-review.md +656 -20
  41. package/prompts/desktop/flow-check-test.md +526 -14
  42. package/prompts/desktop/flow-check.md +717 -67
  43. package/prompts/desktop/flow-commit.md +88 -119
  44. package/prompts/desktop/flow-docs-sync.md +354 -354
  45. package/prompts/desktop/flow-finish.md +919 -0
  46. package/prompts/desktop/flow-release.md +662 -0
  47. package/prompts/desktop/flow-work-feature.md +61 -61
  48. package/prompts/desktop/flow-work-fix.md +46 -46
  49. package/prompts/desktop/flow-work-refactor.md +48 -48
  50. package/prompts/desktop/flow-work-resume.md +34 -34
  51. package/prompts/desktop/flow-work.md +1202 -1390
  52. package/prompts/frontend/flow-build-phase-0.md +425 -425
  53. package/prompts/frontend/flow-build-phase-1.md +626 -626
  54. package/prompts/frontend/flow-build-phase-10.md +33 -33
  55. package/prompts/frontend/flow-build-phase-2.md +573 -573
  56. package/prompts/frontend/flow-build-phase-3.md +782 -782
  57. package/prompts/frontend/flow-build-phase-4.md +554 -554
  58. package/prompts/frontend/flow-build-phase-5.md +703 -703
  59. package/prompts/frontend/flow-build-phase-6.md +524 -524
  60. package/prompts/frontend/flow-build-phase-7.md +1001 -1001
  61. package/prompts/frontend/flow-build-phase-8.md +872 -872
  62. package/prompts/frontend/flow-build-phase-9.md +94 -94
  63. package/prompts/frontend/flow-build.md +137 -137
  64. package/prompts/frontend/flow-check-review.md +656 -20
  65. package/prompts/frontend/flow-check-test.md +526 -14
  66. package/prompts/frontend/flow-check.md +717 -67
  67. package/prompts/frontend/flow-commit.md +88 -119
  68. package/prompts/frontend/flow-docs-sync.md +550 -550
  69. package/prompts/frontend/flow-finish.md +919 -0
  70. package/prompts/frontend/flow-release.md +519 -0
  71. package/prompts/frontend/flow-work-api.md +1547 -0
  72. package/prompts/frontend/flow-work-feature.md +61 -61
  73. package/prompts/frontend/flow-work-fix.md +38 -38
  74. package/prompts/frontend/flow-work-refactor.md +48 -48
  75. package/prompts/frontend/flow-work-resume.md +34 -34
  76. package/prompts/frontend/flow-work.md +1595 -1320
  77. package/prompts/mobile/flow-build-phase-0.md +425 -425
  78. package/prompts/mobile/flow-build-phase-1.md +626 -626
  79. package/prompts/mobile/flow-build-phase-10.md +32 -32
  80. package/prompts/mobile/flow-build-phase-2.md +573 -573
  81. package/prompts/mobile/flow-build-phase-3.md +782 -782
  82. package/prompts/mobile/flow-build-phase-4.md +554 -554
  83. package/prompts/mobile/flow-build-phase-5.md +703 -703
  84. package/prompts/mobile/flow-build-phase-6.md +524 -524
  85. package/prompts/mobile/flow-build-phase-7.md +1001 -1001
  86. package/prompts/mobile/flow-build-phase-8.md +888 -888
  87. package/prompts/mobile/flow-build-phase-9.md +90 -90
  88. package/prompts/mobile/flow-build.md +135 -135
  89. package/prompts/mobile/flow-check-review.md +656 -20
  90. package/prompts/mobile/flow-check-test.md +526 -14
  91. package/prompts/mobile/flow-check.md +717 -67
  92. package/prompts/mobile/flow-commit.md +88 -119
  93. package/prompts/mobile/flow-docs-sync.md +620 -620
  94. package/prompts/mobile/flow-finish.md +919 -0
  95. package/prompts/mobile/flow-release.md +751 -0
  96. package/prompts/mobile/flow-work-api.md +1500 -0
  97. package/prompts/mobile/flow-work-feature.md +61 -61
  98. package/prompts/mobile/flow-work-fix.md +46 -46
  99. package/prompts/mobile/flow-work-refactor.md +48 -48
  100. package/prompts/mobile/flow-work-resume.md +34 -34
  101. package/prompts/mobile/flow-work.md +1605 -1329
  102. package/prompts/shared/mermaid-guidelines.md +102 -102
  103. package/prompts/shared/scope-levels.md +114 -114
  104. package/prompts/shared/smart-skip-preflight.md +214 -214
  105. package/prompts/shared/story-points.md +55 -55
  106. package/prompts/shared/task-format.md +74 -74
  107. package/prompts/shared/task-summary-template.md +277 -277
  108. package/templates/AGENT.template.md +443 -443
  109. package/templates/backend/.clauderules.template +112 -112
  110. package/templates/backend/.cursorrules.template +102 -102
  111. package/templates/backend/README.template.md +2 -2
  112. package/templates/backend/ai-instructions.template.md +2 -2
  113. package/templates/backend/copilot-instructions.template.md +2 -2
  114. package/templates/backend/docs/api.template.md +320 -320
  115. package/templates/backend/docs/business-flows.template.md +97 -97
  116. package/templates/backend/docs/code-standards.template.md +2 -2
  117. package/templates/backend/docs/contributing.template.md +3 -3
  118. package/templates/backend/docs/data-model.template.md +520 -520
  119. package/templates/backend/docs/testing.template.md +2 -2
  120. package/templates/backend/project-brief.template.md +2 -2
  121. package/templates/backend/specs/configuration.template.md +2 -2
  122. package/templates/backend/specs/security.template.md +2 -2
  123. package/templates/desktop/.clauderules.template +112 -112
  124. package/templates/desktop/.cursorrules.template +102 -102
  125. package/templates/desktop/README.template.md +170 -170
  126. package/templates/desktop/ai-instructions.template.md +366 -366
  127. package/templates/desktop/copilot-instructions.template.md +140 -140
  128. package/templates/desktop/docs/docs/api.template.md +320 -320
  129. package/templates/desktop/docs/docs/architecture.template.md +724 -724
  130. package/templates/desktop/docs/docs/business-flows.template.md +102 -102
  131. package/templates/desktop/docs/docs/code-standards.template.md +792 -792
  132. package/templates/desktop/docs/docs/contributing.template.md +149 -149
  133. package/templates/desktop/docs/docs/data-model.template.md +520 -520
  134. package/templates/desktop/docs/docs/operations.template.md +720 -720
  135. package/templates/desktop/docs/docs/testing.template.md +722 -722
  136. package/templates/desktop/project-brief.template.md +150 -150
  137. package/templates/desktop/specs/specs/configuration.template.md +121 -121
  138. package/templates/desktop/specs/specs/security.template.md +392 -392
  139. package/templates/frontend/README.template.md +2 -2
  140. package/templates/frontend/ai-instructions.template.md +2 -2
  141. package/templates/frontend/docs/api-integration.template.md +362 -362
  142. package/templates/frontend/docs/components.template.md +2 -2
  143. package/templates/frontend/docs/error-handling.template.md +360 -360
  144. package/templates/frontend/docs/operations.template.md +107 -107
  145. package/templates/frontend/docs/performance.template.md +124 -124
  146. package/templates/frontend/docs/pwa.template.md +119 -119
  147. package/templates/frontend/docs/state-management.template.md +2 -2
  148. package/templates/frontend/docs/styling.template.md +2 -2
  149. package/templates/frontend/docs/testing.template.md +2 -2
  150. package/templates/frontend/project-brief.template.md +2 -2
  151. package/templates/frontend/specs/accessibility.template.md +95 -95
  152. package/templates/frontend/specs/configuration.template.md +2 -2
  153. package/templates/frontend/specs/security.template.md +175 -175
  154. package/templates/fullstack/README.template.md +252 -252
  155. package/templates/fullstack/ai-instructions.template.md +444 -444
  156. package/templates/fullstack/project-brief.template.md +157 -157
  157. package/templates/fullstack/specs/configuration.template.md +340 -340
  158. package/templates/mobile/README.template.md +167 -167
  159. package/templates/mobile/ai-instructions.template.md +196 -196
  160. package/templates/mobile/docs/app-store.template.md +135 -135
  161. package/templates/mobile/docs/architecture.template.md +63 -63
  162. package/templates/mobile/docs/native-features.template.md +94 -94
  163. package/templates/mobile/docs/navigation.template.md +59 -59
  164. package/templates/mobile/docs/offline-strategy.template.md +65 -65
  165. package/templates/mobile/docs/permissions.template.md +56 -56
  166. package/templates/mobile/docs/state-management.template.md +85 -85
  167. package/templates/mobile/docs/testing.template.md +109 -109
  168. package/templates/mobile/project-brief.template.md +69 -69
  169. package/templates/mobile/specs/build-configuration.template.md +91 -91
  170. package/templates/mobile/specs/deployment.template.md +92 -92
  171. package/templates/work.template.md +61 -47
@@ -1,100 +1,100 @@
1
- # Build Configuration
2
-
3
- > Build and CI/CD configuration for {{PROJECT_NAME}}
1
+ # Build Configuration
2
+
3
+ > Build and CI/CD configuration for {{PROJECT_NAME}}
4
4
  ---
5
- ## 🔧 Build Tools
6
-
7
- **CI/CD Platform:** {{CICD_PLATFORM}}
8
-
9
- **Build Automation:** {{BUILD_AUTOMATION_TOOL}}
10
-
11
- **Versioning:** {{VERSIONING_STRATEGY}}
5
+ ## 🔧 Build Tools
6
+
7
+ **CI/CD Platform:** {{CICD_PLATFORM}}
8
+
9
+ **Build Automation:** {{BUILD_AUTOMATION_TOOL}}
10
+
11
+ **Versioning:** {{VERSIONING_STRATEGY}}
12
12
  ---
13
- ## 📦 Build Configuration
14
-
15
- ### iOS Build
16
-
17
- **Xcode Version:** {{XCODE_VERSION}}
18
-
19
- **iOS Deployment Target:** {{IOS_DEPLOYMENT_TARGET}}
20
-
21
- **Build Configuration:**
22
- {{IOS_BUILD_CONFIGURATION}}
23
-
24
- ### Android Build
25
-
26
- **Gradle Version:** {{GRADLE_VERSION}}
27
-
28
- **Android SDK:** {{ANDROID_SDK_VERSION}}
29
-
30
- **Min SDK:** {{MIN_ANDROID_SDK}}
31
-
32
- **Target SDK:** {{TARGET_ANDROID_SDK}}
33
-
34
- **Build Configuration:**
35
- {{ANDROID_BUILD_CONFIGURATION}}
13
+ ## 📦 Build Configuration
14
+
15
+ ### iOS Build
16
+
17
+ **Xcode Version:** {{XCODE_VERSION}}
18
+
19
+ **iOS Deployment Target:** {{IOS_DEPLOYMENT_TARGET}}
20
+
21
+ **Build Configuration:**
22
+ {{IOS_BUILD_CONFIGURATION}}
23
+
24
+ ### Android Build
25
+
26
+ **Gradle Version:** {{GRADLE_VERSION}}
27
+
28
+ **Android SDK:** {{ANDROID_SDK_VERSION}}
29
+
30
+ **Min SDK:** {{MIN_ANDROID_SDK}}
31
+
32
+ **Target SDK:** {{TARGET_ANDROID_SDK}}
33
+
34
+ **Build Configuration:**
35
+ {{ANDROID_BUILD_CONFIGURATION}}
36
36
  ---
37
- ## 🔐 Code Signing
38
-
39
- **Code Signing Strategy:** {{CODE_SIGNING_STRATEGY}}
40
-
41
- ### iOS
42
-
43
- {{IOS_CODE_SIGNING_DESCRIPTION}}
44
-
45
- ### Android
46
-
47
- {{ANDROID_CODE_SIGNING_DESCRIPTION}}
37
+ ## 🔐 Code Signing
38
+
39
+ **Code Signing Strategy:** {{CODE_SIGNING_STRATEGY}}
40
+
41
+ ### iOS
42
+
43
+ {{IOS_CODE_SIGNING_DESCRIPTION}}
44
+
45
+ ### Android
46
+
47
+ {{ANDROID_CODE_SIGNING_DESCRIPTION}}
48
48
  ---
49
- ## 🚀 CI/CD Pipeline
50
-
51
- **Pipeline Configuration:**
52
- {{CICD_PIPELINE_DESCRIPTION}}
53
-
54
- ### Build Steps
55
-
56
- {{BUILD_STEPS}}
57
-
58
- ### Test Steps
59
-
60
- {{TEST_STEPS}}
61
-
62
- ### Deployment Steps
63
-
64
- {{DEPLOYMENT_STEPS}}
49
+ ## 🚀 CI/CD Pipeline
50
+
51
+ **Pipeline Configuration:**
52
+ {{CICD_PIPELINE_DESCRIPTION}}
53
+
54
+ ### Build Steps
55
+
56
+ {{BUILD_STEPS}}
57
+
58
+ ### Test Steps
59
+
60
+ {{TEST_STEPS}}
61
+
62
+ ### Deployment Steps
63
+
64
+ {{DEPLOYMENT_STEPS}}
65
65
  ---
66
- ## 📊 Build Artifacts
67
-
68
- **iOS:**
69
- - IPA file
70
- - dSYM file (for crash reporting)
71
-
72
- **Android:**
73
- - APK file (for testing)
74
- - AAB file (for Play Store)
66
+ ## 📊 Build Artifacts
67
+
68
+ **iOS:**
69
+ - IPA file
70
+ - dSYM file (for crash reporting)
71
+
72
+ **Android:**
73
+ - APK file (for testing)
74
+ - AAB file (for Play Store)
75
75
  ---
76
- ## 🔄 Version Management
77
-
78
- **Versioning Strategy:** {{VERSIONING_STRATEGY}}
79
-
80
- **Version Format:** {{VERSION_FORMAT}}
81
-
82
- **Version Increment:** {{VERSION_INCREMENT_RULES}}
76
+ ## 🔄 Version Management
77
+
78
+ **Versioning Strategy:** {{VERSIONING_STRATEGY}}
79
+
80
+ **Version Format:** {{VERSION_FORMAT}}
81
+
82
+ **Version Increment:** {{VERSION_INCREMENT_RULES}}
83
83
  ---
84
- ## 🛠️ Environment Variables
85
-
86
- {{ENVIRONMENT_VARIABLES}}
84
+ ## 🛠️ Environment Variables
85
+
86
+ {{ENVIRONMENT_VARIABLES}}
87
87
  ---
88
- ## ✅ Build Checklist
89
-
90
- - [ ] Build succeeds locally
91
- - [ ] Tests pass
92
- - [ ] Linting passes
93
- - [ ] Code signing configured
94
- - [ ] Environment variables set
95
- - [ ] Build artifacts generated
88
+ ## ✅ Build Checklist
89
+
90
+ - [ ] Build succeeds locally
91
+ - [ ] Tests pass
92
+ - [ ] Linting passes
93
+ - [ ] Code signing configured
94
+ - [ ] Environment variables set
95
+ - [ ] Build artifacts generated
96
96
  ---
97
- **Last Updated:** {{LAST_UPDATED}}
98
-
99
-
100
-
97
+ **Last Updated:** {{LAST_UPDATED}}
98
+
99
+
100
+
@@ -1,100 +1,100 @@
1
- # Deployment Procedures
2
-
3
- > Step-by-step deployment guide for {{PROJECT_NAME}}
1
+ # Deployment Procedures
2
+
3
+ > Step-by-step deployment guide for {{PROJECT_NAME}}
4
4
  ---
5
- ## 🚀 Deployment Overview
6
-
7
- **Deployment Strategy:** {{DEPLOYMENT_STRATEGY}}
8
-
9
- **Release Frequency:** {{RELEASE_FREQUENCY}}
10
-
11
- **Rollback Strategy:** {{ROLLBACK_STRATEGY}}
5
+ ## 🚀 Deployment Overview
6
+
7
+ **Deployment Strategy:** {{DEPLOYMENT_STRATEGY}}
8
+
9
+ **Release Frequency:** {{RELEASE_FREQUENCY}}
10
+
11
+ **Rollback Strategy:** {{ROLLBACK_STRATEGY}}
12
12
  ---
13
- ## 📱 iOS Deployment
14
-
15
- ### Prerequisites
16
-
17
- - Apple Developer Account
18
- - Xcode installed
19
- - Code signing certificates configured
20
-
21
- ### Steps
22
-
23
- {{IOS_DEPLOYMENT_STEPS}}
24
-
25
- ### Fastlane (if used)
26
-
27
- ```bash
28
- fastlane ios release
29
- ```
13
+ ## 📱 iOS Deployment
14
+
15
+ ### Prerequisites
16
+
17
+ - Apple Developer Account
18
+ - Xcode installed
19
+ - Code signing certificates configured
20
+
21
+ ### Steps
22
+
23
+ {{IOS_DEPLOYMENT_STEPS}}
24
+
25
+ ### Fastlane (if used)
26
+
27
+ ```bash
28
+ fastlane ios release
29
+ ```
30
30
  ---
31
- ## 🤖 Android Deployment
32
-
33
- ### Prerequisites
34
-
35
- - Google Play Developer Account
36
- - Signing keystore configured
37
- - AAB file built
38
-
39
- ### Steps
40
-
41
- {{ANDROID_DEPLOYMENT_STEPS}}
42
-
43
- ### Fastlane (if used)
44
-
45
- ```bash
46
- fastlane android release
47
- ```
31
+ ## 🤖 Android Deployment
32
+
33
+ ### Prerequisites
34
+
35
+ - Google Play Developer Account
36
+ - Signing keystore configured
37
+ - AAB file built
38
+
39
+ ### Steps
40
+
41
+ {{ANDROID_DEPLOYMENT_STEPS}}
42
+
43
+ ### Fastlane (if used)
44
+
45
+ ```bash
46
+ fastlane android release
47
+ ```
48
48
  ---
49
- ## 🔄 Staged Rollout
50
-
51
- **Rollout Strategy:** {{ROLLOUT_STRATEGY}}
52
-
53
- {{ROLLOUT_DESCRIPTION}}
49
+ ## 🔄 Staged Rollout
50
+
51
+ **Rollout Strategy:** {{ROLLOUT_STRATEGY}}
52
+
53
+ {{ROLLOUT_DESCRIPTION}}
54
54
  ---
55
- ## 🔙 Rollback Procedure
56
-
57
- **Rollback Strategy:** {{ROLLBACK_STRATEGY}}
58
-
59
- {{ROLLBACK_PROCEDURE}}
55
+ ## 🔙 Rollback Procedure
56
+
57
+ **Rollback Strategy:** {{ROLLBACK_STRATEGY}}
58
+
59
+ {{ROLLBACK_PROCEDURE}}
60
60
  ---
61
- ## 📊 Post-Deployment
62
-
63
- ### Monitoring
64
-
65
- - Monitor crash reports
66
- - Monitor analytics
67
- - Monitor user reviews
68
-
69
- ### Verification
70
-
71
- - [ ] App appears in stores
72
- - [ ] App installs correctly
73
- - [ ] Key features work
74
- - [ ] No critical crashes
61
+ ## 📊 Post-Deployment
62
+
63
+ ### Monitoring
64
+
65
+ - Monitor crash reports
66
+ - Monitor analytics
67
+ - Monitor user reviews
68
+
69
+ ### Verification
70
+
71
+ - [ ] App appears in stores
72
+ - [ ] App installs correctly
73
+ - [ ] Key features work
74
+ - [ ] No critical crashes
75
75
  ---
76
- ## ✅ Deployment Checklist
77
-
78
- ### Pre-Deployment
79
-
80
- - [ ] All tests pass
81
- - [ ] Version number updated
82
- - [ ] Release notes prepared
83
- - [ ] Screenshots updated
84
- - [ ] Metadata reviewed
85
-
86
- ### Deployment
87
-
88
- - [ ] Build uploaded
89
- - [ ] Metadata submitted
90
- - [ ] Submitted for review
91
-
92
- ### Post-Deployment
93
-
94
- - [ ] Monitoring active
95
- - [ ] Ready for rollback if needed
76
+ ## ✅ Deployment Checklist
77
+
78
+ ### Pre-Deployment
79
+
80
+ - [ ] All tests pass
81
+ - [ ] Version number updated
82
+ - [ ] Release notes prepared
83
+ - [ ] Screenshots updated
84
+ - [ ] Metadata reviewed
85
+
86
+ ### Deployment
87
+
88
+ - [ ] Build uploaded
89
+ - [ ] Metadata submitted
90
+ - [ ] Submitted for review
91
+
92
+ ### Post-Deployment
93
+
94
+ - [ ] Monitoring active
95
+ - [ ] Ready for rollback if needed
96
96
  ---
97
- **Last Updated:** {{LAST_UPDATED}}
98
-
99
-
100
-
97
+ **Last Updated:** {{LAST_UPDATED}}
98
+
99
+
100
+
@@ -1,47 +1,61 @@
1
- # [Type]: [Feature/Fix/Refactor Name]
2
-
3
- ## Context
4
- **Source**: HU-XXX-XXX | Roadmap X.X | Manual
5
- **SP**: X | **Branch**: [type]/[slug] | **Deps**: None | TXXX
6
-
7
- ## Objective
8
- [1-2 clear paragraphs describing WHAT will be implemented/fixed/refactored]
9
-
10
- ## Documentation Constraints
11
- **Read**: ai-instructions.md, architecture.md, code-standards.md
12
-
13
- **Key Rules**:
14
- - ✅ ALWAYS: [List specific rules that apply]
15
- - ❌ NEVER: [List specific prohibitions]
16
- - 📐 Pattern: [Architectural pattern from docs]
17
- - 📁 Location: [File structure from architecture.md]
18
-
19
- ## Approach
20
- **Layer**: [Data | Business Logic | API | UI]
21
- **Files**: [List files to create/modify]
22
- **Reference**: [Existing file to follow as pattern]
23
-
24
- **Phases**:
25
- 1. [Phase 1 description]
26
- 2. [Phase 2 description]
27
- 3. [Phase 3 description]
28
- 4. [Phase 4 description]
29
-
30
- ## Tasks
31
- **Source**: [Manual | Roadmap X.X (expanded) | HU-XXX-XXX (expanded) | HU-XXX-XXX (reference)]
32
-
33
- - [ ] T001 [D] [Description] → [file path] • X SP
34
- - [Pattern/constraint details]
35
- - [ ] T002 [L] [Description] → [file path] • X SP
36
- - [Pattern/constraint details] (deps: T001)
37
- - [ ] T003 [A] [Description] → [file path] • X SP
38
- - [Pattern/constraint details] (deps: T002)
39
- - [ ] T004 [T] [Description] → [file path] • X SP
40
- - [Pattern/constraint details] (deps: T002)
41
-
42
- ## Validation
43
- - [ ] All NEVER/ALWAYS rules followed
44
- - [ ] Tests pass (coverage per docs/testing.md)
45
- - [ ] No hardcoded secrets
46
- - [ ] Follows existing patterns
47
- - [ ] [Add specific validations based on type]
1
+ <!--
2
+ ⚠️ IMPORTANT: This is the ONLY planning/analysis file for this task
3
+ Do NOT create separate analysis.md, api-analysis.md, or spec.md files.
4
+ All analysis results, specifications, and implementation details belong here.
5
+ -->
6
+
7
+ # [Type]: [Feature/Fix/Refactor Name]
8
+
9
+ ## Context
10
+
11
+ **Source**: HU-XXX-XXX | Roadmap X.X | Manual
12
+ **SP**: X | **Branch**: [type]/[slug] | **Deps**: None | TXXX
13
+
14
+ ## Objective
15
+
16
+ [1-2 clear paragraphs describing WHAT will be implemented/fixed/refactored]
17
+
18
+ ## Documentation Constraints
19
+
20
+ **Read**: ai-instructions.md, architecture.md, code-standards.md
21
+
22
+ **Key Rules**:
23
+
24
+ - ✅ ALWAYS: [List specific rules that apply]
25
+ - ❌ NEVER: [List specific prohibitions]
26
+ - 📐 Pattern: [Architectural pattern from docs]
27
+ - 📁 Location: [File structure from architecture.md]
28
+
29
+ ## Approach
30
+
31
+ **Layer**: [Data | Business Logic | API | UI]
32
+ **Files**: [List files to create/modify]
33
+ **Reference**: [Existing file to follow as pattern]
34
+
35
+ **Phases**:
36
+
37
+ 1. [Phase 1 description]
38
+ 2. [Phase 2 description]
39
+ 3. [Phase 3 description]
40
+ 4. [Phase 4 description]
41
+
42
+ ## Tasks
43
+
44
+ **Source**: [Manual | Roadmap X.X (expanded) | HU-XXX-XXX (expanded) | HU-XXX-XXX (reference)]
45
+
46
+ - [ ] T001 [D] [Description] → [file path] • X SP
47
+ - [Pattern/constraint details]
48
+ - [ ] T002 [L] [Description] → [file path] • X SP
49
+ - [Pattern/constraint details] (deps: T001)
50
+ - [ ] T003 [A] [Description] → [file path] • X SP
51
+ - [Pattern/constraint details] (deps: T002)
52
+ - [ ] T004 [T] [Description] → [file path] • X SP
53
+ - [Pattern/constraint details] (deps: T002)
54
+
55
+ ## Validation
56
+
57
+ - [ ] All NEVER/ALWAYS rules followed
58
+ - [ ] Tests pass (coverage per docs/testing.md)
59
+ - [ ] No hardcoded secrets
60
+ - [ ] Follows existing patterns
61
+ - [ ] [Add specific validations based on type]