@su-record/vibe 2.6.28 → 2.6.30

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 (240) hide show
  1. package/CLAUDE.md +235 -202
  2. package/LICENSE +21 -21
  3. package/README.md +276 -267
  4. package/agents/architect-low.md +41 -41
  5. package/agents/architect-medium.md +59 -59
  6. package/agents/architect.md +80 -80
  7. package/agents/build-error-resolver.md +115 -115
  8. package/agents/compounder.md +261 -261
  9. package/agents/diagrammer.md +178 -178
  10. package/agents/docs/api-documenter.md +99 -99
  11. package/agents/docs/changelog-writer.md +93 -93
  12. package/agents/e2e-tester.md +266 -266
  13. package/agents/explorer-low.md +42 -42
  14. package/agents/explorer-medium.md +59 -59
  15. package/agents/explorer.md +48 -48
  16. package/agents/implementer-low.md +43 -43
  17. package/agents/implementer-medium.md +52 -52
  18. package/agents/implementer.md +54 -54
  19. package/agents/planning/requirements-analyst.md +84 -84
  20. package/agents/planning/ux-advisor.md +83 -83
  21. package/agents/qa/acceptance-tester.md +86 -86
  22. package/agents/qa/edge-case-finder.md +93 -93
  23. package/agents/refactor-cleaner.md +143 -143
  24. package/agents/research/best-practices-agent.md +199 -199
  25. package/agents/research/codebase-patterns-agent.md +157 -157
  26. package/agents/research/framework-docs-agent.md +188 -188
  27. package/agents/research/security-advisory-agent.md +213 -213
  28. package/agents/review/architecture-reviewer.md +107 -107
  29. package/agents/review/complexity-reviewer.md +116 -116
  30. package/agents/review/data-integrity-reviewer.md +88 -88
  31. package/agents/review/git-history-reviewer.md +103 -103
  32. package/agents/review/performance-reviewer.md +86 -86
  33. package/agents/review/python-reviewer.md +150 -150
  34. package/agents/review/rails-reviewer.md +139 -139
  35. package/agents/review/react-reviewer.md +144 -144
  36. package/agents/review/security-reviewer.md +80 -80
  37. package/agents/review/simplicity-reviewer.md +140 -140
  38. package/agents/review/test-coverage-reviewer.md +116 -116
  39. package/agents/review/typescript-reviewer.md +127 -127
  40. package/agents/searcher.md +54 -54
  41. package/agents/simplifier.md +120 -120
  42. package/agents/tester.md +49 -49
  43. package/agents/ui-previewer.md +268 -268
  44. package/commands/vibe.analyze.md +356 -356
  45. package/commands/vibe.reason.md +329 -329
  46. package/commands/vibe.review.md +423 -423
  47. package/commands/vibe.run.md +1423 -1313
  48. package/commands/vibe.spec.md +1054 -1054
  49. package/commands/vibe.spec.review.md +412 -412
  50. package/commands/vibe.trace.md +161 -161
  51. package/commands/vibe.utils.md +376 -376
  52. package/commands/vibe.verify.md +375 -375
  53. package/dist/cli/collaborator.js +52 -52
  54. package/dist/cli/detect.js +32 -32
  55. package/dist/cli/hud.js +20 -20
  56. package/dist/cli/index.js +112 -112
  57. package/dist/cli/llm.js +144 -144
  58. package/dist/cli/postinstall.js +858 -858
  59. package/dist/lib/DeepInit.js +24 -24
  60. package/dist/lib/IterationTracker.js +11 -11
  61. package/dist/lib/PythonParser.js +108 -108
  62. package/dist/lib/ReviewRace.js +96 -96
  63. package/dist/lib/SkillFrontmatter.js +28 -28
  64. package/dist/lib/SkillQualityGate.js +9 -9
  65. package/dist/lib/SkillRepository.js +159 -159
  66. package/dist/lib/UltraQA.js +77 -77
  67. package/dist/lib/gemini-api.js +5 -5
  68. package/dist/lib/gpt-api.js +4 -4
  69. package/dist/lib/memory/KnowledgeGraph.js +4 -4
  70. package/dist/lib/memory/MemorySearch.js +43 -43
  71. package/dist/lib/memory/MemoryStorage.js +130 -130
  72. package/dist/lib/memory/ObservationStore.js +28 -28
  73. package/dist/lib/memory/SessionRAGRetriever.js +7 -7
  74. package/dist/lib/memory/SessionRAGStore.js +216 -216
  75. package/dist/lib/memory/SessionSummarizer.js +9 -9
  76. package/dist/orchestrator/AgentManager.js +12 -12
  77. package/dist/orchestrator/MultiLlmResearch.js +8 -8
  78. package/dist/orchestrator/SmartRouter.js +11 -11
  79. package/dist/orchestrator/SwarmOrchestrator.test.js +16 -16
  80. package/dist/orchestrator/parallelResearch.js +24 -24
  81. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  82. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  83. package/dist/tools/spec/prdParser.test.js +171 -171
  84. package/dist/tools/spec/specGenerator.js +169 -169
  85. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  86. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  87. package/hooks/hooks.json +115 -115
  88. package/hooks/scripts/code-check.js +70 -70
  89. package/hooks/scripts/code-review.js +22 -22
  90. package/hooks/scripts/complexity.js +22 -22
  91. package/hooks/scripts/compound.js +23 -23
  92. package/hooks/scripts/context-save.js +53 -53
  93. package/hooks/scripts/gemini-ui-gen.js +281 -281
  94. package/hooks/scripts/generate-brand-assets.js +474 -474
  95. package/hooks/scripts/hud-multiline.js +262 -262
  96. package/hooks/scripts/hud-status.js +291 -291
  97. package/hooks/scripts/keyword-detector.js +214 -214
  98. package/hooks/scripts/llm-orchestrate.js +328 -171
  99. package/hooks/scripts/post-edit.js +97 -97
  100. package/hooks/scripts/post-tool-verify.js +210 -210
  101. package/hooks/scripts/pre-tool-guard.js +125 -125
  102. package/hooks/scripts/prompt-dispatcher.js +161 -161
  103. package/hooks/scripts/recall.js +22 -22
  104. package/hooks/scripts/session-start.js +30 -30
  105. package/hooks/scripts/skill-injector.js +191 -191
  106. package/hooks/scripts/utils.js +97 -97
  107. package/languages/csharp-unity.md +515 -515
  108. package/languages/gdscript-godot.md +470 -470
  109. package/languages/ruby-rails.md +489 -489
  110. package/languages/typescript-angular.md +433 -433
  111. package/languages/typescript-astro.md +416 -416
  112. package/languages/typescript-electron.md +406 -406
  113. package/languages/typescript-nestjs.md +524 -524
  114. package/languages/typescript-svelte.md +407 -407
  115. package/languages/typescript-tauri.md +365 -365
  116. package/package.json +84 -84
  117. package/skills/brand-assets.md +141 -141
  118. package/skills/commerce-patterns.md +361 -361
  119. package/skills/context7-usage.md +102 -102
  120. package/skills/e2e-commerce.md +304 -304
  121. package/skills/frontend-design.md +92 -92
  122. package/skills/git-worktree.md +181 -181
  123. package/skills/parallel-research.md +77 -77
  124. package/skills/priority-todos.md +239 -239
  125. package/skills/seo-checklist.md +244 -244
  126. package/skills/tool-fallback.md +190 -190
  127. package/skills/vibe-capabilities.md +161 -161
  128. package/vibe/constitution.md +227 -227
  129. package/vibe/rules/core/communication-guide.md +98 -98
  130. package/vibe/rules/core/development-philosophy.md +52 -52
  131. package/vibe/rules/core/quick-start.md +102 -102
  132. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  133. package/vibe/rules/quality/checklist.md +276 -276
  134. package/vibe/rules/quality/testing-strategy.md +440 -440
  135. package/vibe/rules/standards/anti-patterns.md +541 -541
  136. package/vibe/rules/standards/code-structure.md +291 -291
  137. package/vibe/rules/standards/complexity-metrics.md +313 -313
  138. package/vibe/rules/standards/naming-conventions.md +198 -198
  139. package/vibe/setup.sh +31 -31
  140. package/vibe/templates/constitution-template.md +252 -252
  141. package/vibe/templates/contract-backend-template.md +526 -526
  142. package/vibe/templates/contract-frontend-template.md +599 -599
  143. package/vibe/templates/feature-template.md +96 -96
  144. package/vibe/templates/spec-template.md +221 -221
  145. package/dist/cli/mcp.d.ts +0 -49
  146. package/dist/cli/mcp.d.ts.map +0 -1
  147. package/dist/cli/mcp.js +0 -169
  148. package/dist/cli/mcp.js.map +0 -1
  149. package/dist/lib/gemini-mcp.d.ts +0 -10
  150. package/dist/lib/gemini-mcp.d.ts.map +0 -1
  151. package/dist/lib/gemini-mcp.js +0 -353
  152. package/dist/lib/gemini-mcp.js.map +0 -1
  153. package/dist/lib/gpt-mcp.d.ts +0 -10
  154. package/dist/lib/gpt-mcp.d.ts.map +0 -1
  155. package/dist/lib/gpt-mcp.js +0 -352
  156. package/dist/lib/gpt-mcp.js.map +0 -1
  157. package/dist/tools/analytics/getUsageAnalytics.d.ts +0 -10
  158. package/dist/tools/analytics/getUsageAnalytics.d.ts.map +0 -1
  159. package/dist/tools/analytics/getUsageAnalytics.js +0 -246
  160. package/dist/tools/analytics/getUsageAnalytics.js.map +0 -1
  161. package/dist/tools/analytics/index.d.ts +0 -5
  162. package/dist/tools/analytics/index.d.ts.map +0 -1
  163. package/dist/tools/analytics/index.js +0 -5
  164. package/dist/tools/analytics/index.js.map +0 -1
  165. package/dist/tools/convention/getCodingGuide.d.ts +0 -7
  166. package/dist/tools/convention/getCodingGuide.d.ts.map +0 -1
  167. package/dist/tools/convention/getCodingGuide.js +0 -69
  168. package/dist/tools/convention/getCodingGuide.js.map +0 -1
  169. package/dist/tools/planning/analyzeRequirements.d.ts +0 -9
  170. package/dist/tools/planning/analyzeRequirements.d.ts.map +0 -1
  171. package/dist/tools/planning/analyzeRequirements.js +0 -171
  172. package/dist/tools/planning/analyzeRequirements.js.map +0 -1
  173. package/dist/tools/planning/createUserStories.d.ts +0 -9
  174. package/dist/tools/planning/createUserStories.d.ts.map +0 -1
  175. package/dist/tools/planning/createUserStories.js +0 -124
  176. package/dist/tools/planning/createUserStories.js.map +0 -1
  177. package/dist/tools/planning/featureRoadmap.d.ts +0 -10
  178. package/dist/tools/planning/featureRoadmap.d.ts.map +0 -1
  179. package/dist/tools/planning/featureRoadmap.js +0 -207
  180. package/dist/tools/planning/featureRoadmap.js.map +0 -1
  181. package/dist/tools/planning/generatePrd.d.ts +0 -11
  182. package/dist/tools/planning/generatePrd.d.ts.map +0 -1
  183. package/dist/tools/planning/generatePrd.js +0 -161
  184. package/dist/tools/planning/generatePrd.js.map +0 -1
  185. package/dist/tools/planning/index.d.ts +0 -8
  186. package/dist/tools/planning/index.d.ts.map +0 -1
  187. package/dist/tools/planning/index.js +0 -8
  188. package/dist/tools/planning/index.js.map +0 -1
  189. package/dist/tools/prompt/analyzePrompt.d.ts +0 -7
  190. package/dist/tools/prompt/analyzePrompt.d.ts.map +0 -1
  191. package/dist/tools/prompt/analyzePrompt.js +0 -150
  192. package/dist/tools/prompt/analyzePrompt.js.map +0 -1
  193. package/dist/tools/prompt/enhancePrompt.d.ts +0 -8
  194. package/dist/tools/prompt/enhancePrompt.d.ts.map +0 -1
  195. package/dist/tools/prompt/enhancePrompt.js +0 -110
  196. package/dist/tools/prompt/enhancePrompt.js.map +0 -1
  197. package/dist/tools/prompt/enhancePromptGemini.d.ts +0 -8
  198. package/dist/tools/prompt/enhancePromptGemini.d.ts.map +0 -1
  199. package/dist/tools/prompt/enhancePromptGemini.js +0 -332
  200. package/dist/tools/prompt/enhancePromptGemini.js.map +0 -1
  201. package/dist/tools/prompt/index.d.ts +0 -7
  202. package/dist/tools/prompt/index.d.ts.map +0 -1
  203. package/dist/tools/prompt/index.js +0 -7
  204. package/dist/tools/prompt/index.js.map +0 -1
  205. package/dist/tools/reasoning/applyReasoningFramework.d.ts +0 -8
  206. package/dist/tools/reasoning/applyReasoningFramework.d.ts.map +0 -1
  207. package/dist/tools/reasoning/applyReasoningFramework.js +0 -266
  208. package/dist/tools/reasoning/applyReasoningFramework.js.map +0 -1
  209. package/dist/tools/reasoning/index.d.ts +0 -5
  210. package/dist/tools/reasoning/index.d.ts.map +0 -1
  211. package/dist/tools/reasoning/index.js +0 -5
  212. package/dist/tools/reasoning/index.js.map +0 -1
  213. package/dist/tools/thinking/analyzeProblem.d.ts +0 -7
  214. package/dist/tools/thinking/analyzeProblem.d.ts.map +0 -1
  215. package/dist/tools/thinking/analyzeProblem.js +0 -55
  216. package/dist/tools/thinking/analyzeProblem.js.map +0 -1
  217. package/dist/tools/thinking/breakDownProblem.d.ts +0 -8
  218. package/dist/tools/thinking/breakDownProblem.d.ts.map +0 -1
  219. package/dist/tools/thinking/breakDownProblem.js +0 -145
  220. package/dist/tools/thinking/breakDownProblem.js.map +0 -1
  221. package/dist/tools/thinking/createThinkingChain.d.ts +0 -7
  222. package/dist/tools/thinking/createThinkingChain.d.ts.map +0 -1
  223. package/dist/tools/thinking/createThinkingChain.js +0 -44
  224. package/dist/tools/thinking/createThinkingChain.js.map +0 -1
  225. package/dist/tools/thinking/formatAsPlan.d.ts +0 -9
  226. package/dist/tools/thinking/formatAsPlan.d.ts.map +0 -1
  227. package/dist/tools/thinking/formatAsPlan.js +0 -78
  228. package/dist/tools/thinking/formatAsPlan.js.map +0 -1
  229. package/dist/tools/thinking/index.d.ts +0 -10
  230. package/dist/tools/thinking/index.d.ts.map +0 -1
  231. package/dist/tools/thinking/index.js +0 -10
  232. package/dist/tools/thinking/index.js.map +0 -1
  233. package/dist/tools/thinking/stepByStepAnalysis.d.ts +0 -8
  234. package/dist/tools/thinking/stepByStepAnalysis.d.ts.map +0 -1
  235. package/dist/tools/thinking/stepByStepAnalysis.js +0 -63
  236. package/dist/tools/thinking/stepByStepAnalysis.js.map +0 -1
  237. package/dist/tools/thinking/thinkAloudProcess.d.ts +0 -8
  238. package/dist/tools/thinking/thinkAloudProcess.d.ts.map +0 -1
  239. package/dist/tools/thinking/thinkAloudProcess.js +0 -80
  240. package/dist/tools/thinking/thinkAloudProcess.js.map +0 -1
@@ -1,52 +1,52 @@
1
- # Development Philosophy and Principles - Answering "Why"
2
-
3
- ## 1.1 Top Priority: Surgical Precision
4
-
5
- > **⚠️ This is the first principle that precedes all work.**
6
- >
7
- > **Never modify/delete code that wasn't requested.**
8
-
9
- ### Principles
10
-
11
- - **Strict scope adherence**: Only modify files and code blocks explicitly requested by the user
12
- - **Preserve existing code**: Do not arbitrarily refactor or remove working code
13
- - **Respect style**: Maintain existing naming, formatting, and comment styles
14
-
15
- ## 1.2 Core Philosophy
16
-
17
- ### Development Golden Rules
18
-
19
- - **Simplicity aesthetics**: Less code is better code
20
- - **DRY principle**: Don't repeat, reuse
21
- - **Single responsibility**: One function serves one purpose
22
- - **Pragmatism**: Practical over perfect, YAGNI spirit
23
-
24
- ### Code Quality Standards
25
-
26
- - **Readability**: Code is for humans
27
- - **Predictability**: No surprises in code
28
- - **Maintainability**: Consider future you
29
- - **Testability**: Verifiable structure
30
-
31
- ## 1.3 Architecture Principles
32
-
33
- ### Design Wisdom
34
-
35
- - **Appropriate pattern application**: Apply Composite, Observer, Factory, etc. as needed
36
- - **Avoid over-abstraction**: No more than 3 levels of wrappers
37
- - **Prevent circular dependencies**: File A → File B → File A ❌
38
-
39
- ### Accessibility is Mandatory, Not Optional
40
-
41
- - Use semantic HTML as default
42
- - Support keyboard navigation
43
- - Optimize for screen readers
44
- - Actively use ARIA attributes
45
-
46
- ## Core Values
47
-
48
- 1. **Clarity**: Code should be self-explanatory
49
- 2. **Conciseness**: Remove unnecessary complexity
50
- 3. **Consistency**: Maintain consistent patterns and styles
51
- 4. **Scalability**: Design considering future changes
52
- 5. **Safety**: Consider error handling and edge cases
1
+ # Development Philosophy and Principles - Answering "Why"
2
+
3
+ ## 1.1 Top Priority: Surgical Precision
4
+
5
+ > **⚠️ This is the first principle that precedes all work.**
6
+ >
7
+ > **Never modify/delete code that wasn't requested.**
8
+
9
+ ### Principles
10
+
11
+ - **Strict scope adherence**: Only modify files and code blocks explicitly requested by the user
12
+ - **Preserve existing code**: Do not arbitrarily refactor or remove working code
13
+ - **Respect style**: Maintain existing naming, formatting, and comment styles
14
+
15
+ ## 1.2 Core Philosophy
16
+
17
+ ### Development Golden Rules
18
+
19
+ - **Simplicity aesthetics**: Less code is better code
20
+ - **DRY principle**: Don't repeat, reuse
21
+ - **Single responsibility**: One function serves one purpose
22
+ - **Pragmatism**: Practical over perfect, YAGNI spirit
23
+
24
+ ### Code Quality Standards
25
+
26
+ - **Readability**: Code is for humans
27
+ - **Predictability**: No surprises in code
28
+ - **Maintainability**: Consider future you
29
+ - **Testability**: Verifiable structure
30
+
31
+ ## 1.3 Architecture Principles
32
+
33
+ ### Design Wisdom
34
+
35
+ - **Appropriate pattern application**: Apply Composite, Observer, Factory, etc. as needed
36
+ - **Avoid over-abstraction**: No more than 3 levels of wrappers
37
+ - **Prevent circular dependencies**: File A → File B → File A ❌
38
+
39
+ ### Accessibility is Mandatory, Not Optional
40
+
41
+ - Use semantic HTML as default
42
+ - Support keyboard navigation
43
+ - Optimize for screen readers
44
+ - Actively use ARIA attributes
45
+
46
+ ## Core Values
47
+
48
+ 1. **Clarity**: Code should be self-explanatory
49
+ 2. **Conciseness**: Remove unnecessary complexity
50
+ 3. **Consistency**: Maintain consistent patterns and styles
51
+ 4. **Scalability**: Design considering future changes
52
+ 5. **Safety**: Consider error handling and edge cases
@@ -1,102 +1,102 @@
1
- # Quick Start - Immediately Applicable Principles
2
-
3
- ## 5 Core Principles
4
-
5
- ```
6
- ✅ 📉 Less code means less technical debt
7
- ✅ 🚫 DRY - Don't Repeat Yourself
8
- ✅ 🎯 Single Responsibility Principle (SRP)
9
- ✅ 🙏 YAGNI - You Aren't Gonna Need It
10
- ✅ 🔒 Security first
11
- ```
12
-
13
- ## Language Configuration
14
-
15
- Language settings can be configured in `.sutory/config.json`:
16
-
17
- ```json
18
- {
19
- "language": "en" // Options: "en", "ko"
20
- }
21
- ```
22
-
23
- ## Checkpoints
24
-
25
- ### Before Adding New Packages
26
-
27
- - [ ] Can it be solved with existing packages?
28
- - [ ] Is it really necessary?
29
- - [ ] What is the bundle size impact?
30
-
31
- ### When Creating Files
32
-
33
- - [ ] Verify where it will be used
34
- - [ ] Add imports immediately
35
- - [ ] Check for circular dependencies
36
-
37
- ## Top Priority: Surgical Precision
38
-
39
- > **⚠️ This is the first principle that precedes all work.**
40
- >
41
- > **Never modify/delete code that wasn't requested.**
42
-
43
- - **Strict scope adherence**: Only modify files and code blocks explicitly requested by the user
44
- - **Preserve existing code**: Do not arbitrarily refactor or remove working code
45
- - **Respect style**: Maintain existing naming, formatting, and comment styles
46
-
47
- ## Pre-Work Checklist
48
-
49
- ```
50
- [x] Follow top priority: Never modify outside request scope
51
- [ ] Respect existing code: Maintain existing style and structure
52
- [ ] Follow documentation rules: Adhere to naming, structure guidelines
53
- ```
54
-
55
- ## Golden Rules
56
-
57
- - **Simplicity aesthetics**: Less code is better code
58
- - **DRY principle**: Don't repeat, reuse
59
- - **Single responsibility**: One function serves one purpose
60
- - **Pragmatism**: Practical over perfect, YAGNI spirit
61
-
62
- ## Code Examples
63
-
64
- ### Good Example
65
-
66
- ```python
67
- # User authentication middleware
68
- async def authenticate_user(token: str) -> User:
69
- """
70
- Verify JWT token and return user.
71
-
72
- Args:
73
- token: JWT authentication token
74
-
75
- Returns:
76
- Authenticated user object
77
-
78
- Raises:
79
- HTTPException: When token is invalid
80
- """
81
- # Verify token
82
- payload = decode_jwt(token)
83
-
84
- # Get user
85
- user = await get_user(payload["sub"])
86
- if not user:
87
- raise HTTPException(401, detail="Authentication failed")
88
-
89
- return user
90
- ```
91
-
92
- ### Bad Example
93
-
94
- ```python
95
- # No comments, unclear purpose
96
- async def auth(t):
97
- p = decode_jwt(t)
98
- u = await get_user(p["sub"])
99
- if not u:
100
- raise HTTPException(401)
101
- return u
102
- ```
1
+ # Quick Start - Immediately Applicable Principles
2
+
3
+ ## 5 Core Principles
4
+
5
+ ```
6
+ ✅ 📉 Less code means less technical debt
7
+ ✅ 🚫 DRY - Don't Repeat Yourself
8
+ ✅ 🎯 Single Responsibility Principle (SRP)
9
+ ✅ 🙏 YAGNI - You Aren't Gonna Need It
10
+ ✅ 🔒 Security first
11
+ ```
12
+
13
+ ## Language Configuration
14
+
15
+ Language settings can be configured in `.sutory/config.json`:
16
+
17
+ ```json
18
+ {
19
+ "language": "en" // Options: "en", "ko"
20
+ }
21
+ ```
22
+
23
+ ## Checkpoints
24
+
25
+ ### Before Adding New Packages
26
+
27
+ - [ ] Can it be solved with existing packages?
28
+ - [ ] Is it really necessary?
29
+ - [ ] What is the bundle size impact?
30
+
31
+ ### When Creating Files
32
+
33
+ - [ ] Verify where it will be used
34
+ - [ ] Add imports immediately
35
+ - [ ] Check for circular dependencies
36
+
37
+ ## Top Priority: Surgical Precision
38
+
39
+ > **⚠️ This is the first principle that precedes all work.**
40
+ >
41
+ > **Never modify/delete code that wasn't requested.**
42
+
43
+ - **Strict scope adherence**: Only modify files and code blocks explicitly requested by the user
44
+ - **Preserve existing code**: Do not arbitrarily refactor or remove working code
45
+ - **Respect style**: Maintain existing naming, formatting, and comment styles
46
+
47
+ ## Pre-Work Checklist
48
+
49
+ ```
50
+ [x] Follow top priority: Never modify outside request scope
51
+ [ ] Respect existing code: Maintain existing style and structure
52
+ [ ] Follow documentation rules: Adhere to naming, structure guidelines
53
+ ```
54
+
55
+ ## Golden Rules
56
+
57
+ - **Simplicity aesthetics**: Less code is better code
58
+ - **DRY principle**: Don't repeat, reuse
59
+ - **Single responsibility**: One function serves one purpose
60
+ - **Pragmatism**: Practical over perfect, YAGNI spirit
61
+
62
+ ## Code Examples
63
+
64
+ ### Good Example
65
+
66
+ ```python
67
+ # User authentication middleware
68
+ async def authenticate_user(token: str) -> User:
69
+ """
70
+ Verify JWT token and return user.
71
+
72
+ Args:
73
+ token: JWT authentication token
74
+
75
+ Returns:
76
+ Authenticated user object
77
+
78
+ Raises:
79
+ HTTPException: When token is invalid
80
+ """
81
+ # Verify token
82
+ payload = decode_jwt(token)
83
+
84
+ # Get user
85
+ user = await get_user(payload["sub"])
86
+ if not user:
87
+ raise HTTPException(401, detail="Authentication failed")
88
+
89
+ return user
90
+ ```
91
+
92
+ ### Bad Example
93
+
94
+ ```python
95
+ # No comments, unclear purpose
96
+ async def auth(t):
97
+ p = decode_jwt(t)
98
+ u = await get_user(p["sub"])
99
+ if not u:
100
+ raise HTTPException(401)
101
+ return u
102
+ ```