agcel 1.0.4 → 2.0.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 (293) hide show
  1. package/README.md +40 -47
  2. package/dist/cli/commands/create.d.ts +4 -0
  3. package/dist/cli/commands/create.d.ts.map +1 -0
  4. package/dist/cli/commands/create.js +68 -0
  5. package/dist/cli/commands/create.js.map +1 -0
  6. package/dist/cli/commands/init.d.ts +3 -0
  7. package/dist/cli/commands/init.d.ts.map +1 -0
  8. package/dist/cli/commands/init.js +98 -0
  9. package/dist/cli/commands/init.js.map +1 -0
  10. package/dist/cli/commands/install.d.ts +3 -0
  11. package/dist/cli/commands/install.d.ts.map +1 -0
  12. package/dist/cli/commands/install.helpers.d.ts +15 -0
  13. package/dist/cli/commands/install.helpers.d.ts.map +1 -0
  14. package/dist/cli/commands/install.helpers.js +47 -0
  15. package/dist/cli/commands/install.helpers.js.map +1 -0
  16. package/dist/cli/commands/install.helpers.test.d.ts +2 -0
  17. package/dist/cli/commands/install.helpers.test.d.ts.map +1 -0
  18. package/dist/cli/commands/install.helpers.test.js +18 -0
  19. package/dist/cli/commands/install.helpers.test.js.map +1 -0
  20. package/dist/cli/commands/install.js +74 -0
  21. package/dist/cli/commands/install.js.map +1 -0
  22. package/dist/cli/commands/pulse.d.ts +4 -0
  23. package/dist/cli/commands/pulse.d.ts.map +1 -0
  24. package/dist/cli/commands/pulse.js +48 -0
  25. package/dist/cli/commands/pulse.js.map +1 -0
  26. package/dist/cli/commands/pulse.test.d.ts +2 -0
  27. package/dist/cli/commands/pulse.test.d.ts.map +1 -0
  28. package/dist/cli/commands/pulse.test.js +19 -0
  29. package/dist/cli/commands/pulse.test.js.map +1 -0
  30. package/dist/cli/commands/suggest.d.ts +3 -0
  31. package/dist/cli/commands/suggest.d.ts.map +1 -0
  32. package/dist/cli/commands/suggest.js +32 -0
  33. package/dist/cli/commands/suggest.js.map +1 -0
  34. package/dist/cli/index.d.ts +3 -0
  35. package/dist/cli/index.d.ts.map +1 -0
  36. package/dist/cli/index.js +20 -0
  37. package/dist/cli/index.js.map +1 -0
  38. package/dist/cli/research-hints.d.ts +5 -0
  39. package/dist/cli/research-hints.d.ts.map +1 -0
  40. package/dist/cli/research-hints.js +109 -0
  41. package/dist/cli/research-hints.js.map +1 -0
  42. package/dist/cli/research-hints.test.d.ts +2 -0
  43. package/dist/cli/research-hints.test.d.ts.map +1 -0
  44. package/dist/cli/research-hints.test.js +50 -0
  45. package/dist/cli/research-hints.test.js.map +1 -0
  46. package/dist/core/agcel-config.d.ts +27 -0
  47. package/dist/core/agcel-config.d.ts.map +1 -0
  48. package/dist/core/agcel-config.js +4 -0
  49. package/dist/core/agcel-config.js.map +1 -0
  50. package/dist/core/build-rag-engine.d.ts +12 -0
  51. package/dist/core/build-rag-engine.d.ts.map +1 -0
  52. package/dist/core/build-rag-engine.js +24 -0
  53. package/dist/core/build-rag-engine.js.map +1 -0
  54. package/dist/core/build-rag-engine.test.d.ts +2 -0
  55. package/dist/core/build-rag-engine.test.d.ts.map +1 -0
  56. package/dist/core/build-rag-engine.test.js +34 -0
  57. package/dist/core/build-rag-engine.test.js.map +1 -0
  58. package/dist/core/chroma-rag.d.ts +20 -0
  59. package/dist/core/chroma-rag.d.ts.map +1 -0
  60. package/dist/core/chroma-rag.js +108 -0
  61. package/dist/core/chroma-rag.js.map +1 -0
  62. package/dist/core/context-hygiene.d.ts +12 -0
  63. package/dist/core/context-hygiene.d.ts.map +1 -0
  64. package/dist/core/context-hygiene.js +43 -0
  65. package/dist/core/context-hygiene.js.map +1 -0
  66. package/dist/core/context-hygiene.test.d.ts +2 -0
  67. package/dist/core/context-hygiene.test.d.ts.map +1 -0
  68. package/dist/core/context-hygiene.test.js +18 -0
  69. package/dist/core/context-hygiene.test.js.map +1 -0
  70. package/dist/core/context.d.ts +44 -0
  71. package/dist/core/context.d.ts.map +1 -0
  72. package/dist/core/context.js +114 -0
  73. package/dist/core/context.js.map +1 -0
  74. package/dist/core/conversation-routing.d.ts +10 -0
  75. package/dist/core/conversation-routing.d.ts.map +1 -0
  76. package/dist/core/conversation-routing.js +27 -0
  77. package/dist/core/conversation-routing.js.map +1 -0
  78. package/dist/core/conversation-routing.test.d.ts +2 -0
  79. package/dist/core/conversation-routing.test.d.ts.map +1 -0
  80. package/dist/core/conversation-routing.test.js +29 -0
  81. package/dist/core/conversation-routing.test.js.map +1 -0
  82. package/dist/core/guardrails.d.ts +26 -0
  83. package/dist/core/guardrails.d.ts.map +1 -0
  84. package/dist/core/guardrails.js +76 -0
  85. package/dist/core/guardrails.js.map +1 -0
  86. package/dist/core/guardrails.test.d.ts +2 -0
  87. package/dist/core/guardrails.test.d.ts.map +1 -0
  88. package/dist/core/guardrails.test.js +35 -0
  89. package/dist/core/guardrails.test.js.map +1 -0
  90. package/dist/core/intent.d.ts +22 -0
  91. package/dist/core/intent.d.ts.map +1 -0
  92. package/dist/core/intent.js +79 -0
  93. package/dist/core/intent.js.map +1 -0
  94. package/dist/core/intent.test.d.ts +2 -0
  95. package/dist/core/intent.test.d.ts.map +1 -0
  96. package/dist/core/intent.test.js +43 -0
  97. package/dist/core/intent.test.js.map +1 -0
  98. package/dist/core/local-rag.d.ts +17 -0
  99. package/dist/core/local-rag.d.ts.map +1 -0
  100. package/dist/core/local-rag.js +74 -0
  101. package/dist/core/local-rag.js.map +1 -0
  102. package/dist/core/local-rag.test.d.ts +2 -0
  103. package/dist/core/local-rag.test.d.ts.map +1 -0
  104. package/dist/core/local-rag.test.js +47 -0
  105. package/dist/core/local-rag.test.js.map +1 -0
  106. package/dist/core/orchestrator.d.ts +47 -0
  107. package/dist/core/orchestrator.d.ts.map +1 -0
  108. package/dist/core/orchestrator.js +138 -0
  109. package/dist/core/orchestrator.js.map +1 -0
  110. package/dist/core/orchestrator.test.d.ts +2 -0
  111. package/dist/core/orchestrator.test.d.ts.map +1 -0
  112. package/dist/core/orchestrator.test.js +118 -0
  113. package/dist/core/orchestrator.test.js.map +1 -0
  114. package/dist/core/pulse.d.ts +13 -0
  115. package/dist/core/pulse.d.ts.map +1 -0
  116. package/dist/core/pulse.js +29 -0
  117. package/dist/core/pulse.js.map +1 -0
  118. package/dist/core/pulse.test.d.ts +2 -0
  119. package/dist/core/pulse.test.d.ts.map +1 -0
  120. package/dist/core/pulse.test.js +18 -0
  121. package/dist/core/pulse.test.js.map +1 -0
  122. package/dist/core/rag-metadata.d.ts +5 -0
  123. package/dist/core/rag-metadata.d.ts.map +1 -0
  124. package/dist/core/rag-metadata.js +13 -0
  125. package/dist/core/rag-metadata.js.map +1 -0
  126. package/dist/core/rag-metadata.test.d.ts +2 -0
  127. package/dist/core/rag-metadata.test.d.ts.map +1 -0
  128. package/dist/core/rag-metadata.test.js +12 -0
  129. package/dist/core/rag-metadata.test.js.map +1 -0
  130. package/dist/core/rag-types.d.ts +18 -0
  131. package/dist/core/rag-types.d.ts.map +1 -0
  132. package/dist/core/rag-types.js +2 -0
  133. package/dist/core/rag-types.js.map +1 -0
  134. package/dist/core/read-agcel-config.d.ts +3 -0
  135. package/dist/core/read-agcel-config.d.ts.map +1 -0
  136. package/dist/core/read-agcel-config.js +13 -0
  137. package/dist/core/read-agcel-config.js.map +1 -0
  138. package/dist/core/registry.d.ts +9 -0
  139. package/dist/core/registry.d.ts.map +1 -0
  140. package/dist/core/registry.js +75 -0
  141. package/dist/core/registry.js.map +1 -0
  142. package/dist/core/registry.test.d.ts +2 -0
  143. package/dist/core/registry.test.d.ts.map +1 -0
  144. package/dist/core/registry.test.js +128 -0
  145. package/dist/core/registry.test.js.map +1 -0
  146. package/dist/core/schema.d.ts +51 -0
  147. package/dist/core/schema.d.ts.map +1 -0
  148. package/dist/core/schema.js +31 -0
  149. package/dist/core/schema.js.map +1 -0
  150. package/dist/core/summarizer.d.ts +23 -0
  151. package/dist/core/summarizer.d.ts.map +1 -0
  152. package/dist/core/summarizer.js +66 -0
  153. package/dist/core/summarizer.js.map +1 -0
  154. package/dist/core/text-similarity.d.ts +7 -0
  155. package/dist/core/text-similarity.d.ts.map +1 -0
  156. package/dist/core/text-similarity.js +35 -0
  157. package/dist/core/text-similarity.js.map +1 -0
  158. package/dist/core/text-similarity.test.d.ts +2 -0
  159. package/dist/core/text-similarity.test.d.ts.map +1 -0
  160. package/dist/core/text-similarity.test.js +11 -0
  161. package/dist/core/text-similarity.test.js.map +1 -0
  162. package/dist/docs-site.test.d.ts +2 -0
  163. package/dist/docs-site.test.d.ts.map +1 -0
  164. package/dist/docs-site.test.js +19 -0
  165. package/dist/docs-site.test.js.map +1 -0
  166. package/dist/index.d.ts +8 -0
  167. package/dist/index.d.ts.map +1 -0
  168. package/dist/index.js +8 -39
  169. package/dist/index.js.map +1 -0
  170. package/dist/providers/adapter.d.ts +23 -0
  171. package/dist/providers/adapter.d.ts.map +1 -0
  172. package/dist/providers/adapter.js +9 -0
  173. package/dist/providers/adapter.js.map +1 -0
  174. package/dist/providers/chatgpt.d.ts +13 -0
  175. package/dist/providers/chatgpt.d.ts.map +1 -0
  176. package/dist/providers/chatgpt.js +33 -0
  177. package/dist/providers/chatgpt.js.map +1 -0
  178. package/dist/providers/chatgpt.test.d.ts +2 -0
  179. package/dist/providers/chatgpt.test.d.ts.map +1 -0
  180. package/dist/providers/chatgpt.test.js +23 -0
  181. package/dist/providers/chatgpt.test.js.map +1 -0
  182. package/dist/providers/claude.d.ts +13 -0
  183. package/dist/providers/claude.d.ts.map +1 -0
  184. package/dist/providers/claude.js +48 -0
  185. package/dist/providers/claude.js.map +1 -0
  186. package/dist/providers/cursor.d.ts +14 -0
  187. package/dist/providers/cursor.d.ts.map +1 -0
  188. package/dist/providers/cursor.js +47 -0
  189. package/dist/providers/cursor.js.map +1 -0
  190. package/dist/providers/gemini.d.ts +13 -0
  191. package/dist/providers/gemini.d.ts.map +1 -0
  192. package/dist/providers/gemini.js +42 -0
  193. package/dist/providers/gemini.js.map +1 -0
  194. package/dist/providers/index.d.ts +5 -0
  195. package/dist/providers/index.d.ts.map +1 -0
  196. package/dist/providers/index.js +18 -0
  197. package/dist/providers/index.js.map +1 -0
  198. package/dist/server/index.d.ts +2 -0
  199. package/dist/server/index.d.ts.map +1 -0
  200. package/dist/server/index.js +288 -154
  201. package/dist/server/index.js.map +1 -0
  202. package/package.json +62 -52
  203. package/.agent/workflows/api-gen.md +0 -63
  204. package/.agent/workflows/architect.md +0 -44
  205. package/.agent/workflows/brainstorm.md +0 -227
  206. package/.agent/workflows/build.md +0 -38
  207. package/.agent/workflows/changelog.md +0 -55
  208. package/.agent/workflows/checkpoint.md +0 -142
  209. package/.agent/workflows/commit.md +0 -227
  210. package/.agent/workflows/debug.md +0 -61
  211. package/.agent/workflows/deploy.md +0 -80
  212. package/.agent/workflows/doc.md +0 -251
  213. package/.agent/workflows/execute-plan.md +0 -229
  214. package/.agent/workflows/feature.md +0 -259
  215. package/.agent/workflows/fix.md +0 -327
  216. package/.agent/workflows/help.md +0 -67
  217. package/.agent/workflows/index.md +0 -152
  218. package/.agent/workflows/load.md +0 -116
  219. package/.agent/workflows/mode.md +0 -174
  220. package/.agent/workflows/optimize.md +0 -57
  221. package/.agent/workflows/plan.md +0 -341
  222. package/.agent/workflows/pr.md +0 -78
  223. package/.agent/workflows/product-plan.md +0 -36
  224. package/.agent/workflows/production-deploy.md +0 -39
  225. package/.agent/workflows/refactor.md +0 -67
  226. package/.agent/workflows/research.md +0 -120
  227. package/.agent/workflows/review.md +0 -348
  228. package/.agent/workflows/security-scan.md +0 -60
  229. package/.agent/workflows/ship.md +0 -225
  230. package/.agent/workflows/spawn.md +0 -181
  231. package/.agent/workflows/status.md +0 -63
  232. package/.agent/workflows/tdd.md +0 -143
  233. package/.agent/workflows/test.md +0 -344
  234. package/.agent/workflows/verify.md +0 -35
  235. package/LICENSE +0 -21
  236. package/dist/commands/init.js +0 -147
  237. package/dist/commands/list.js +0 -43
  238. package/dist/commands/uninstall.js +0 -70
  239. package/dist/utils/index.js +0 -28
  240. package/skills/api-security-best-practices/SKILL.md +0 -291
  241. package/skills/api-security-best-practices/references/examples.md +0 -617
  242. package/skills/architecture/SKILL.md +0 -59
  243. package/skills/architecture/context-discovery.md +0 -43
  244. package/skills/architecture/examples.md +0 -94
  245. package/skills/architecture/pattern-selection.md +0 -68
  246. package/skills/architecture/patterns-reference.md +0 -50
  247. package/skills/architecture/trade-off-analysis.md +0 -77
  248. package/skills/aws-serverless/SKILL.md +0 -327
  249. package/skills/brainstorming/SKILL.md +0 -234
  250. package/skills/c4-context/SKILL.md +0 -154
  251. package/skills/ci-cd-engineer/SKILL.md +0 -50
  252. package/skills/code-auditing/SKILL.md +0 -55
  253. package/skills/copywriting/SKILL.md +0 -248
  254. package/skills/database-engineer/SKILL.md +0 -47
  255. package/skills/doc-coauthoring/SKILL.md +0 -379
  256. package/skills/docker-expert/SKILL.md +0 -412
  257. package/skills/langgraph/SKILL.md +0 -291
  258. package/skills/postgresql/SKILL.md +0 -73
  259. package/skills/pricing-strategy/SKILL.md +0 -360
  260. package/skills/product-manager/SKILL.md +0 -57
  261. package/skills/prompt-engineer/README.md +0 -659
  262. package/skills/prompt-engineer/SKILL.md +0 -256
  263. package/skills/python-patterns/SKILL.md +0 -445
  264. package/skills/qa-engineer/SKILL.md +0 -42
  265. package/skills/rag-engineer/SKILL.md +0 -94
  266. package/skills/react-patterns/SKILL.md +0 -202
  267. package/skills/secure-refactoring/SKILL.md +0 -54
  268. package/skills/security-documentation/SKILL.md +0 -53
  269. package/skills/senior-architect/SKILL.md +0 -213
  270. package/skills/senior-architect/references/architecture_patterns.md +0 -103
  271. package/skills/senior-architect/references/system_design_workflows.md +0 -103
  272. package/skills/senior-architect/references/tech_decision_guide.md +0 -103
  273. package/skills/senior-architect/scripts/architecture_diagram_generator.py +0 -114
  274. package/skills/senior-architect/scripts/dependency_analyzer.py +0 -114
  275. package/skills/senior-architect/scripts/project_architect.py +0 -114
  276. package/skills/seo-audit/SKILL.md +0 -491
  277. package/skills/sql-injection-testing/SKILL.md +0 -452
  278. package/skills/test-driven-development/SKILL.md +0 -375
  279. package/skills/test-driven-development/testing-anti-patterns.md +0 -299
  280. package/skills/test-fixing/SKILL.md +0 -123
  281. package/skills/testing-patterns/SKILL.md +0 -263
  282. package/skills/typescript-expert/SKILL.md +0 -202
  283. package/skills/typescript-expert/references/advanced-topics.md +0 -252
  284. package/skills/typescript-expert/references/tsconfig-strict.json +0 -92
  285. package/skills/typescript-expert/references/typescript-cheatsheet.md +0 -383
  286. package/skills/typescript-expert/references/utility-types.ts +0 -335
  287. package/skills/typescript-expert/scripts/ts_diagnostic.py +0 -203
  288. package/skills/ui-ux-designer/SKILL.md +0 -46
  289. package/skills/vercel-deployment/SKILL.md +0 -83
  290. package/skills/vulnerability-scanner/SKILL.md +0 -280
  291. package/skills/vulnerability-scanner/checklists.md +0 -121
  292. package/skills/vulnerability-scanner/scripts/security_scan.py +0 -458
  293. package/skills/writing-plans/SKILL.md +0 -120
@@ -1,227 +0,0 @@
1
- ---
2
- description: Smart Commit with Auto-generated Message
3
- ---
4
-
5
- # /commit - Smart Commit Command
6
-
7
- ## Purpose
8
-
9
- Create a well-formatted commit with auto-generated message based on staged changes.
10
-
11
- ## Usage
12
-
13
- ```
14
- /commit [optional message hint]
15
- ```
16
-
17
- ## Arguments
18
-
19
- - `$ARGUMENTS`: Optional hint for commit message focus (e.g., "auth", "bugfix", "refactor")
20
-
21
- ---
22
-
23
- Create a commit for staged changes with hint: **$ARGUMENTS**
24
-
25
- ## Workflow
26
-
27
- ### Step 1: Analyze Changes
28
-
29
- 1. **Check Status**
30
- ```bash
31
- git status
32
- ```
33
-
34
- 2. **View Staged Changes**
35
- ```bash
36
- git diff --staged
37
- ```
38
-
39
- 3. **Review Recent Commits**
40
- ```bash
41
- git log --oneline -5
42
- ```
43
-
44
- ### Step 2: Categorize Changes
45
-
46
- Determine commit type:
47
- - `feat`: New feature
48
- - `fix`: Bug fix
49
- - `docs`: Documentation
50
- - `style`: Formatting
51
- - `refactor`: Code restructuring
52
- - `test`: Adding tests
53
- - `chore`: Maintenance
54
-
55
- ### Step 3: Generate Message
56
-
57
- Follow conventional commit format:
58
- ```
59
- type(scope): subject
60
-
61
- body (optional)
62
-
63
- footer (optional)
64
- ```
65
-
66
- ### Step 4: Create Commit
67
-
68
- ```bash
69
- git commit -m "$(cat <<'EOF'
70
- type(scope): subject
71
-
72
- - Change 1
73
- - Change 2
74
-
75
- 🤖 Generated with [Claude Code](https://claude.com/claude-code)
76
-
77
- Co-Authored-By: Claude <noreply@anthropic.com>
78
- EOF
79
- )"
80
- ```
81
-
82
- ## Commit Message Guidelines
83
-
84
- ### Subject Line
85
- - Max 50 characters
86
- - Imperative mood ("Add" not "Added")
87
- - No period at end
88
- - Capitalize first letter
89
-
90
- ### Body
91
- - Wrap at 72 characters
92
- - Explain what and why
93
- - Use bullet points for multiple changes
94
-
95
- ### Examples
96
-
97
- #### Feature
98
- ```
99
- feat(auth): add password reset functionality
100
-
101
- - Add reset token generation
102
- - Implement email sending
103
- - Add rate limiting for reset requests
104
-
105
- Closes #123
106
- ```
107
-
108
- #### Bug Fix
109
- ```
110
- fix(api): handle null user in profile endpoint
111
-
112
- The profile endpoint crashed when accessing deleted users.
113
- Added null check and proper 404 response.
114
-
115
- Fixes #456
116
- ```
117
-
118
- #### Refactor
119
- ```
120
- refactor(database): extract query builders
121
-
122
- Split large database service into focused modules
123
- for better maintainability and testing.
124
- ```
125
-
126
- #### Documentation
127
- ```
128
- docs(readme): update installation instructions
129
-
130
- - Add prerequisites section
131
- - Update configuration examples
132
- - Fix broken links
133
- ```
134
-
135
- #### Test
136
- ```
137
- test(auth): add missing login tests
138
-
139
- - Add test for invalid credentials
140
- - Add test for locked account
141
- - Add test for expired session
142
- ```
143
-
144
- #### Chore
145
- ```
146
- chore(deps): update dependencies
147
-
148
- - Update React to 18.2
149
- - Update TypeScript to 5.3
150
- - Remove unused packages
151
- ```
152
-
153
- ## Output
154
-
155
- ### Commit Created
156
-
157
- ```markdown
158
- ## Commit Created
159
-
160
- **Hash**: `abc1234`
161
- **Branch**: `feature/auth-improvements`
162
-
163
- ### Message
164
- ```
165
- feat(auth): add OAuth2 login support
166
-
167
- - Implement Google OAuth provider
168
- - Implement GitHub OAuth provider
169
- - Add session token generation
170
- - Update user model for OAuth data
171
-
172
- Closes #789
173
- ```
174
-
175
- ### Files Changed
176
- | Status | File |
177
- |--------|------|
178
- | M | src/auth/providers.ts |
179
- | A | src/auth/oauth/google.ts |
180
- | A | src/auth/oauth/github.ts |
181
- | M | src/models/user.ts |
182
- | A | tests/auth/oauth.test.ts |
183
-
184
- ### Stats
185
- - 5 files changed
186
- - 234 insertions(+)
187
- - 12 deletions(-)
188
-
189
- ### Next Steps
190
- ```bash
191
- # Push to remote
192
- git push -u origin feature/auth-improvements
193
-
194
- # Create PR
195
- gh pr create
196
- ```
197
- ```
198
-
199
- ## Pre-Commit Checks
200
-
201
- Before committing:
202
- - [ ] No secrets in staged files
203
- - [ ] No debug statements
204
- - [ ] No TODO comments (unless intentional)
205
- - [ ] Code is formatted
206
-
207
- ## Amending Commits
208
-
209
- If pre-commit hooks modify files:
210
- ```bash
211
- # Stage modified files and amend
212
- git add -A
213
- git commit --amend --no-edit
214
- ```
215
-
216
- <!-- CUSTOMIZATION POINT -->
217
- ## Variations
218
-
219
- Modify behavior via CLAUDE.md:
220
- - Commit message format
221
- - Required sections
222
- - Issue reference format
223
- - Co-author settings
224
-
225
-
226
- ## Gap Analysis Rule
227
- Always identify gaps and suggest next steps to users. In case there is no gaps anymore, then AI should clearly state that there is no gap left.
@@ -1,61 +0,0 @@
1
- ---
2
- description: Debug and Fix Errors
3
- ---
4
-
5
- # /debug - Debug Command
6
-
7
- ## Purpose
8
-
9
- Analyze and debug an error, exception, or unexpected behavior.
10
-
11
- ## Usage
12
-
13
- ```
14
- /debug [error message or description]
15
- ```
16
-
17
- ---
18
-
19
- Debug issue: **$ARGUMENTS**
20
-
21
- ## Workflow
22
-
23
- ### Step 1: Analyze Error
24
-
25
- 1. Parse error message and stack trace
26
- 2. Identify error location
27
- 3. Understand error type
28
-
29
- ### Step 2: Investigate
30
-
31
- 1. Trace execution path
32
- 2. Check related code
33
- 3. Form hypotheses
34
-
35
- ### Step 3: Fix
36
-
37
- 1. Implement minimal fix
38
- 2. Verify fix works
39
- 3. Add regression test
40
-
41
- ## Output
42
-
43
- ```markdown
44
- ## Debug Report
45
-
46
- ### Error
47
- [Error message]
48
-
49
- ### Root Cause
50
- [Explanation]
51
-
52
- ### Fix
53
- [Code changes]
54
-
55
- ### Prevention
56
- [Test added]
57
- ```
58
-
59
-
60
- ## Gap Analysis Rule
61
- Always identify gaps and suggest next steps to users. In case there is no gaps anymore, then AI should clearly state that there is no gap left.
@@ -1,80 +0,0 @@
1
- ---
2
- description: Deployment
3
- ---
4
-
5
- # /deploy - Deployment Command
6
-
7
- ## Purpose
8
-
9
- Deploy the application to a specified environment with proper checks.
10
-
11
- ## Usage
12
-
13
- ```
14
- /deploy [environment: staging | production]
15
- ```
16
-
17
- ---
18
-
19
- Deploy to: **$ARGUMENTS**
20
-
21
- ## Workflow
22
-
23
- ### Pre-Deploy Checks
24
-
25
- 1. **Verify Build**
26
- ```bash
27
- pnpm build
28
- ```
29
-
30
- 2. **Run Tests**
31
- ```bash
32
- pnpm test
33
- ```
34
-
35
- 3. **Security Scan**
36
- ```bash
37
- npm audit --audit-level=high
38
- ```
39
-
40
- ### Deploy
41
-
42
- 1. **Staging**
43
- ```bash
44
- # Deploy to staging environment
45
- ```
46
-
47
- 2. **Production** (requires confirmation)
48
- ```bash
49
- # Deploy to production environment
50
- ```
51
-
52
- ### Post-Deploy
53
-
54
- 1. **Verify Deployment**
55
- - Health checks
56
- - Smoke tests
57
-
58
- 2. **Monitor**
59
- - Check logs
60
- - Watch metrics
61
-
62
- ## Output
63
-
64
- ```markdown
65
- ## Deployment Complete
66
-
67
- **Environment**: staging
68
- **Version**: v1.2.3
69
- **URL**: https://staging.example.com
70
-
71
- ### Checks
72
- - [x] Build successful
73
- - [x] Tests passing
74
- - [x] Security scan clean
75
- - [x] Health check passed
76
- ```
77
-
78
-
79
- ## Gap Analysis Rule
80
- Always identify gaps and suggest next steps to users. In case there is no gaps anymore, then AI should clearly state that there is no gap left.
@@ -1,251 +0,0 @@
1
- ---
2
- description: Documentation Generation
3
- ---
4
-
5
- # /doc - Documentation Command
6
-
7
- ## Purpose
8
-
9
- Generate or update documentation including API docs, README files, code comments, and technical specifications.
10
-
11
- ## Usage
12
-
13
- ```
14
- /doc [target | 'api' | 'readme' | 'changelog']
15
- ```
16
-
17
- ## Arguments
18
-
19
- - `$ARGUMENTS`:
20
- - File/function path: Document specific code
21
- - `api`: Generate API documentation
22
- - `readme`: Update README file
23
- - `changelog`: Generate changelog from commits
24
-
25
- ---
26
-
27
- Generate documentation for: **$ARGUMENTS**
28
-
29
- ## Workflow
30
-
31
- ### For Code Documentation
32
-
33
- 1. **Analyze Code**
34
- - Read the code thoroughly
35
- - Understand purpose and behavior
36
- - Identify inputs and outputs
37
- - Note side effects
38
-
39
- 2. **Generate Documentation**
40
- - Add docstrings/JSDoc
41
- - Include examples
42
- - Document edge cases
43
- - Add type annotations
44
-
45
- ### For API Documentation
46
-
47
- 1. **Find All Endpoints**
48
- - Scan route definitions
49
- - Identify HTTP methods
50
- - Note authentication requirements
51
-
52
- 2. **Document Each Endpoint**
53
- - Request format
54
- - Response format
55
- - Error responses
56
- - Examples
57
-
58
- ### For README
59
-
60
- 1. **Analyze Project**
61
- - Purpose and features
62
- - Installation steps
63
- - Usage examples
64
- - Configuration
65
-
66
- 2. **Generate/Update**
67
- - Clear structure
68
- - Working examples
69
- - Up-to-date info
70
-
71
- ### For Changelog
72
-
73
- 1. **Analyze Commits**
74
- ```bash
75
- git log --oneline --since="last release"
76
- ```
77
-
78
- 2. **Categorize Changes**
79
- - Added
80
- - Changed
81
- - Fixed
82
- - Removed
83
-
84
- ## Templates
85
-
86
- ### Python Docstring
87
- ```python
88
- def calculate_discount(price: float, percentage: float) -> float:
89
- """
90
- Calculate discounted price.
91
-
92
- Args:
93
- price: Original price in dollars.
94
- percentage: Discount percentage (0-100).
95
-
96
- Returns:
97
- The discounted price.
98
-
99
- Raises:
100
- ValueError: If percentage is not between 0 and 100.
101
-
102
- Example:
103
- >>> calculate_discount(100.0, 20)
104
- 80.0
105
- """
106
- ```
107
-
108
- ### TypeScript JSDoc
109
- ```typescript
110
- /**
111
- * Calculate discounted price.
112
- *
113
- * @param price - Original price in dollars
114
- * @param percentage - Discount percentage (0-100)
115
- * @returns The discounted price
116
- * @throws {RangeError} If percentage is not between 0 and 100
117
- *
118
- * @example
119
- * calculateDiscount(100, 20); // returns 80
120
- */
121
- ```
122
-
123
- ### API Endpoint
124
- ```markdown
125
- ## POST /api/orders
126
-
127
- Create a new order.
128
-
129
- ### Authentication
130
- Requires Bearer token.
131
-
132
- ### Request Body
133
- ```json
134
- {
135
- "items": [
136
- { "productId": "123", "quantity": 2 }
137
- ],
138
- "shippingAddress": {
139
- "street": "123 Main St",
140
- "city": "New York",
141
- "zip": "10001"
142
- }
143
- }
144
- ```
145
-
146
- ### Response (201 Created)
147
- ```json
148
- {
149
- "id": "order_456",
150
- "status": "pending",
151
- "total": 99.99,
152
- "createdAt": "2024-01-15T10:00:00Z"
153
- }
154
- ```
155
-
156
- ### Errors
157
- | Status | Code | Description |
158
- |--------|------|-------------|
159
- | 400 | INVALID_ITEMS | Items array is empty |
160
- | 401 | UNAUTHORIZED | Invalid or missing token |
161
- | 422 | OUT_OF_STOCK | Item not available |
162
- ```
163
-
164
- ### README Section
165
- ```markdown
166
- ## Installation
167
-
168
- ```bash
169
- npm install my-package
170
- ```
171
-
172
- ## Quick Start
173
-
174
- ```typescript
175
- import { Client } from 'my-package';
176
-
177
- const client = new Client({ apiKey: 'your-key' });
178
- const result = await client.fetch();
179
- ```
180
-
181
- ## Configuration
182
-
183
- | Option | Type | Default | Description |
184
- |--------|------|---------|-------------|
185
- | `apiKey` | string | required | Your API key |
186
- | `timeout` | number | 5000 | Request timeout in ms |
187
- ```
188
-
189
- ### Changelog Entry
190
- ```markdown
191
- ## [1.2.0] - 2024-01-15
192
-
193
- ### Added
194
- - Password reset functionality (#123)
195
- - Email verification for new accounts
196
-
197
- ### Changed
198
- - Improved error messages for validation failures
199
- - Updated dependencies to latest versions
200
-
201
- ### Fixed
202
- - Race condition in session handling (#456)
203
- - Incorrect timezone in date displays
204
- ```
205
-
206
- ## Output
207
-
208
- ### Documentation Report
209
-
210
- ```markdown
211
- ## Documentation Updated
212
-
213
- ### Files Modified
214
- - `src/services/auth.ts` - Added JSDoc comments
215
- - `docs/api/auth.md` - New API documentation
216
- - `README.md` - Updated configuration section
217
-
218
- ### Documentation Added
219
-
220
- #### Code Comments
221
- - `AuthService.login()` - Full JSDoc with examples
222
- - `AuthService.logout()` - Parameter documentation
223
- - `validateToken()` - Return type and exceptions
224
-
225
- #### API Documentation
226
- - POST /api/auth/login
227
- - POST /api/auth/logout
228
- - POST /api/auth/refresh
229
-
230
- ### Coverage
231
- - Functions documented: 15/18 (83%)
232
- - Endpoints documented: 12/12 (100%)
233
-
234
- ### Next Steps
235
- 1. Add examples to remaining functions
236
- 2. Create getting started guide
237
- 3. Add architecture diagram
238
- ```
239
-
240
- <!-- CUSTOMIZATION POINT -->
241
- ## Variations
242
-
243
- Modify behavior via CLAUDE.md:
244
- - Documentation format
245
- - Required sections
246
- - Example requirements
247
- - API documentation tool
248
-
249
-
250
- ## Gap Analysis Rule
251
- Always identify gaps and suggest next steps to users. In case there is no gaps anymore, then AI should clearly state that there is no gap left.