@programinglive/dev-workflow-mcp-server 1.4.6 → 1.5.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.
- package/CHANGELOG.md +114 -0
- package/docs/NETLIFY_DEPLOYMENT.md +125 -0
- package/docs/product/PRD.md +4 -2
- package/docs/release-notes/RELEASE_NOTES.md +32 -0
- package/docs/web-dashboard.md +12 -0
- package/package.json +1 -1
- package/server.json +13 -3
- package/tests/build.test.js +30 -0
- package/tests/mcpRegistry.test.js +13 -3
- package/web/app/api/history/route.ts +10 -17
- package/web/app/api/summary/route.ts +11 -13
- package/web/app/api/version/route.ts +4 -11
- package/web/netlify.toml +6 -0
- package/web/next.config.ts +1 -2
- package/web/package-lock.json +17 -428
- package/web/package.json +0 -1
- package/web-legacy/public/assets/android-chrome-192x192.png +0 -0
- package/web-legacy/public/assets/android-chrome-512x512.png +0 -0
- package/web-legacy/public/assets/apple-touch-icon.png +0 -0
- package/web-legacy/public/assets/favicon-16x16.png +0 -0
- package/web-legacy/public/assets/favicon-32x32.png +0 -0
- package/web-legacy/public/assets/favicon.ico +0 -0
- package/web-legacy/public/assets/favicon.png +0 -0
- package/web-legacy/public/assets/logo.png +0 -0
- package/web-legacy/public/assets/og-preview.png +0 -0
- package/web-legacy/public/assets/site.webmanifest +0 -1
- package/web-legacy/public/docs/EXAMPLES.html +0 -496
- package/web-legacy/public/docs/GETTING-STARTED.html +0 -318
- package/web-legacy/public/docs/README.html +0 -620
- package/web-legacy/public/docs/RELEASE_NOTES.html +0 -275
- package/web-legacy/public/docs/TROUBLESHOOTING.html +0 -627
- package/web-legacy/public/docs/WORKFLOW-TEMPLATES.html +0 -676
- package/web-legacy/public/docs/web-dashboard.html +0 -243
- package/web-legacy/public/index.html +0 -223
- package/web-legacy/public/input.css +0 -80
- package/web-legacy/public/main.js +0 -167
- package/web-legacy/public/output.css +0 -1559
- package/web-legacy/server.js +0 -207
|
@@ -1,676 +0,0 @@
|
|
|
1
|
-
<!DOCTYPE html>
|
|
2
|
-
<html lang="en">
|
|
3
|
-
<head>
|
|
4
|
-
<meta charset="UTF-8">
|
|
5
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
-
<title>Workflow Templates for Dev-Workflow MCP Server - Dev Workflow</title>
|
|
7
|
-
<link rel="icon" type="image/png" href="/assets/favicon.png">
|
|
8
|
-
<meta property="og:type" content="website">
|
|
9
|
-
<meta property="og:url" content="https://commiter.programinglive.com/docs/WORKFLOW-TEMPLATES.md">
|
|
10
|
-
<meta property="og:title" content="Workflow Templates for Dev-Workflow MCP Server - Dev Workflow">
|
|
11
|
-
<meta property="og:description" content="Detailed documentation for Dev Workflow MCP Server commands and usage.">
|
|
12
|
-
<meta property="og:image" content="/assets/og-preview.png">
|
|
13
|
-
<meta property="twitter:card" content="summary_large_image">
|
|
14
|
-
<meta property="twitter:url" content="https://commiter.programinglive.com/docs/WORKFLOW-TEMPLATES.md">
|
|
15
|
-
<meta property="twitter:title" content="Workflow Templates for Dev-Workflow MCP Server - Dev Workflow">
|
|
16
|
-
<meta property="twitter:description" content="Detailed documentation for Dev Workflow MCP Server commands and usage.">
|
|
17
|
-
<meta property="twitter:image" content="/assets/og-preview.png">
|
|
18
|
-
<link rel="stylesheet" href="/output.css">
|
|
19
|
-
<script src="https://unpkg.com/lucide@latest"></script>
|
|
20
|
-
</head>
|
|
21
|
-
<body class="bg-[#0a0a0f] text-white font-sans antialiased selection:bg-primary/30 selection:text-white min-h-screen flex flex-col">
|
|
22
|
-
<header class="fixed top-0 left-0 right-0 z-50 border-b border-white/10 bg-[#0a0a0f]/80 backdrop-blur-md">
|
|
23
|
-
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 h-16 flex items-center justify-between">
|
|
24
|
-
<div class="flex items-center gap-3">
|
|
25
|
-
<a href="/" class="flex items-center gap-3 hover:opacity-80 transition-opacity">
|
|
26
|
-
<div class="w-10 h-10 rounded-lg overflow-hidden border border-white/10 shadow-lg shadow-primary/20">
|
|
27
|
-
<img src="/assets/logo.png" alt="Dev Workflow Logo" class="w-full h-full object-cover">
|
|
28
|
-
</div>
|
|
29
|
-
<div>
|
|
30
|
-
<h1 class="font-bold text-lg tracking-tight text-white">Dev Workflow</h1>
|
|
31
|
-
<div class="flex items-center gap-2 text-xs text-gray-400">
|
|
32
|
-
<span class="w-2 h-2 rounded-full bg-emerald-500 shadow-[0_0_8px_rgba(16,185,129,0.5)]"></span>
|
|
33
|
-
<span>Documentation</span>
|
|
34
|
-
</div>
|
|
35
|
-
</div>
|
|
36
|
-
</a>
|
|
37
|
-
</div>
|
|
38
|
-
<div class="flex items-center gap-4">
|
|
39
|
-
<a href="/" class="flex items-center gap-2 px-4 py-2 bg-white/5 hover:bg-white/10 border border-white/10 rounded-full text-sm font-medium transition-all group">
|
|
40
|
-
<i data-lucide="layout-dashboard" class="w-4 h-4 text-gray-400 group-hover:text-white transition-colors"></i>
|
|
41
|
-
<span>Dashboard</span>
|
|
42
|
-
</a>
|
|
43
|
-
</div>
|
|
44
|
-
</div>
|
|
45
|
-
</header>
|
|
46
|
-
|
|
47
|
-
<div class="flex-1 max-w-7xl mx-auto w-full px-4 sm:px-6 lg:px-8 pt-24 pb-12 flex gap-8">
|
|
48
|
-
<aside class="hidden lg:block w-64 flex-shrink-0 fixed h-[calc(100vh-6rem)] overflow-y-auto pr-4 custom-scrollbar">
|
|
49
|
-
<nav class="space-y-1">
|
|
50
|
-
<a href="/" class="flex items-center gap-3 px-4 py-3 text-sm font-medium rounded-lg text-gray-400 hover:text-white hover:bg-white/5 transition-colors">
|
|
51
|
-
<i data-lucide="arrow-left" class="w-4 h-4"></i>
|
|
52
|
-
Back to Dashboard
|
|
53
|
-
</a>
|
|
54
|
-
</nav>
|
|
55
|
-
<div class="mt-8 pt-8 border-t border-white/10">
|
|
56
|
-
<h3 class="px-4 text-xs font-semibold text-gray-500 uppercase tracking-wider mb-2">Documentation</h3>
|
|
57
|
-
<div class="space-y-1">
|
|
58
|
-
<a href="/docs/README.html" class="doc-link block px-4 py-2 text-sm font-medium text-gray-400 hover:text-white hover:bg-white/5 rounded-lg transition-colors ">README</a>
|
|
59
|
-
<a href="/docs/web-dashboard.html" class="doc-link block px-4 py-2 text-sm font-medium text-gray-400 hover:text-white hover:bg-white/5 rounded-lg transition-colors ">web dashboard</a>
|
|
60
|
-
<a href="/docs/GETTING-STARTED.html" class="doc-link block px-4 py-2 text-sm font-medium text-gray-400 hover:text-white hover:bg-white/5 rounded-lg transition-colors ">GETTING STARTED</a>
|
|
61
|
-
<a href="/docs/EXAMPLES.html" class="doc-link block px-4 py-2 text-sm font-medium text-gray-400 hover:text-white hover:bg-white/5 rounded-lg transition-colors ">EXAMPLES</a>
|
|
62
|
-
<a href="/docs/WORKFLOW-TEMPLATES.html" class="doc-link block px-4 py-2 text-sm font-medium hover:text-white hover:bg-white/5 rounded-lg transition-colors bg-white/5 text-white ring-1 ring-white/5">WORKFLOW TEMPLATES</a>
|
|
63
|
-
<a href="/docs/TROUBLESHOOTING.html" class="doc-link block px-4 py-2 text-sm font-medium text-gray-400 hover:text-white hover:bg-white/5 rounded-lg transition-colors ">TROUBLESHOOTING</a>
|
|
64
|
-
<a href="/docs/RELEASE_NOTES.html" class="doc-link block px-4 py-2 text-sm font-medium text-gray-400 hover:text-white hover:bg-white/5 rounded-lg transition-colors ">RELEASE_NOTES</a>
|
|
65
|
-
</div>
|
|
66
|
-
</div>
|
|
67
|
-
</aside>
|
|
68
|
-
|
|
69
|
-
<main class="flex-1 lg:pl-72 min-w-0">
|
|
70
|
-
<div class="bg-surface border border-white/10 rounded-xl p-8 backdrop-blur-sm">
|
|
71
|
-
<header class="mb-8 border-b border-white/10 pb-6">
|
|
72
|
-
<h1 class="text-3xl font-bold text-white mb-2">Workflow Templates for Dev-Workflow MCP Server</h1>
|
|
73
|
-
<p class="text-gray-400 font-mono text-sm">WORKFLOW-TEMPLATES.md</p>
|
|
74
|
-
</header>
|
|
75
|
-
<article class="prose prose-invert prose-lg max-w-none">
|
|
76
|
-
<p>Ready-to-use workflow templates for common development scenarios in Antigravity.</p>
|
|
77
|
-
<h2>Table of Contents</h2>
|
|
78
|
-
<ul>
|
|
79
|
-
<li><a href="#feature-development-template">Feature Development Template</a></li>
|
|
80
|
-
<li><a href="#bug-fix-template">Bug Fix Template</a></li>
|
|
81
|
-
<li><a href="#refactoring-template">Refactoring Template</a></li>
|
|
82
|
-
<li><a href="#hotfix-template">Hotfix Template</a></li>
|
|
83
|
-
<li><a href="#documentation-update-template">Documentation Update Template</a></li>
|
|
84
|
-
<li><a href="#release-preparation-template">Release Preparation Template</a></li>
|
|
85
|
-
</ul>
|
|
86
|
-
<hr>
|
|
87
|
-
<h2>Feature Development Template</h2>
|
|
88
|
-
<p>Use this template when adding new functionality to your application.</p>
|
|
89
|
-
<h3>Checklist</h3>
|
|
90
|
-
<pre><code class="language-markdown">## Feature: [Feature Name]
|
|
91
|
-
|
|
92
|
-
### Planning
|
|
93
|
-
- [ ] Define feature requirements
|
|
94
|
-
- [ ] Design API/component interface
|
|
95
|
-
- [ ] Identify affected files
|
|
96
|
-
- [ ] Plan test cases
|
|
97
|
-
|
|
98
|
-
### Implementation
|
|
99
|
-
- [ ] Start workflow task
|
|
100
|
-
- [ ] Implement feature code
|
|
101
|
-
- [ ] Mark as fixed
|
|
102
|
-
|
|
103
|
-
### Testing
|
|
104
|
-
- [ ] Write unit tests
|
|
105
|
-
- [ ] Write integration tests
|
|
106
|
-
- [ ] Create tests in workflow
|
|
107
|
-
- [ ] Run test suite
|
|
108
|
-
- [ ] Record passing tests
|
|
109
|
-
|
|
110
|
-
### Documentation
|
|
111
|
-
- [ ] Update README
|
|
112
|
-
- [ ] Add inline comments
|
|
113
|
-
- [ ] Update API documentation
|
|
114
|
-
- [ ] Create documentation in workflow
|
|
115
|
-
|
|
116
|
-
### Release
|
|
117
|
-
- [ ] Commit and push changes
|
|
118
|
-
- [ ] Perform release (minor version)
|
|
119
|
-
- [ ] Complete task
|
|
120
|
-
</code></pre>
|
|
121
|
-
<h3>Workflow Commands</h3>
|
|
122
|
-
<pre><code># 1. Start
|
|
123
|
-
start_task:
|
|
124
|
-
description: "Add [feature name] to [component/module]"
|
|
125
|
-
type: "feature"
|
|
126
|
-
|
|
127
|
-
# 2. Code the feature
|
|
128
|
-
# ... your implementation ...
|
|
129
|
-
|
|
130
|
-
# 3. Mark as fixed
|
|
131
|
-
mark_bug_fixed:
|
|
132
|
-
summary: "[Brief description of what was implemented]"
|
|
133
|
-
|
|
134
|
-
# 4. Create tests
|
|
135
|
-
# ... write your test files ...
|
|
136
|
-
create_tests
|
|
137
|
-
|
|
138
|
-
# 5. Run tests
|
|
139
|
-
run_tests:
|
|
140
|
-
passed: true
|
|
141
|
-
testCommand: "npm test"
|
|
142
|
-
details: "[X tests passed, coverage Y%]"
|
|
143
|
-
|
|
144
|
-
# 6. Document
|
|
145
|
-
# ... update documentation ...
|
|
146
|
-
create_documentation:
|
|
147
|
-
documentationType: "README"
|
|
148
|
-
summary: "[What you documented]"
|
|
149
|
-
|
|
150
|
-
# 7. Commit
|
|
151
|
-
commit_and_push:
|
|
152
|
-
commitMessage: "feat([scope]): [description]"
|
|
153
|
-
|
|
154
|
-
# 8. Release
|
|
155
|
-
perform_release:
|
|
156
|
-
command: "npm run release:minor"
|
|
157
|
-
notes: "v[X.Y.Z] - [Feature name]"
|
|
158
|
-
|
|
159
|
-
# 9. Complete
|
|
160
|
-
complete_task:
|
|
161
|
-
commitMessage: "feat([scope]): [description]"
|
|
162
|
-
</code></pre>
|
|
163
|
-
<h3>Example</h3>
|
|
164
|
-
<p><strong>Feature:</strong> Add shopping cart functionality</p>
|
|
165
|
-
<pre><code>start_task:
|
|
166
|
-
description: "Add shopping cart with add/remove items and checkout"
|
|
167
|
-
type: "feature"
|
|
168
|
-
|
|
169
|
-
mark_bug_fixed:
|
|
170
|
-
summary: "Shopping cart with localStorage persistence and quantity controls"
|
|
171
|
-
|
|
172
|
-
create_tests
|
|
173
|
-
|
|
174
|
-
run_tests:
|
|
175
|
-
passed: true
|
|
176
|
-
testCommand: "npm test -- cart"
|
|
177
|
-
details: "12 cart tests passed: add, remove, update quantity, persist"
|
|
178
|
-
|
|
179
|
-
create_documentation:
|
|
180
|
-
documentationType: "README"
|
|
181
|
-
summary: "Added shopping cart API reference and integration guide"
|
|
182
|
-
|
|
183
|
-
commit_and_push:
|
|
184
|
-
commitMessage: "feat(cart): add shopping cart with persistence"
|
|
185
|
-
|
|
186
|
-
perform_release:
|
|
187
|
-
command: "npm run release:minor"
|
|
188
|
-
notes: "v1.5.0 - Shopping cart feature"
|
|
189
|
-
|
|
190
|
-
complete_task:
|
|
191
|
-
commitMessage: "feat(cart): add shopping cart with persistence"
|
|
192
|
-
</code></pre>
|
|
193
|
-
<hr>
|
|
194
|
-
<h2>Bug Fix Template</h2>
|
|
195
|
-
<p>Use this template when fixing defects or unexpected behavior.</p>
|
|
196
|
-
<h3>Checklist</h3>
|
|
197
|
-
<pre><code class="language-markdown">## Bug Fix: [Bug Description]
|
|
198
|
-
|
|
199
|
-
### Investigation
|
|
200
|
-
- [ ] Reproduce the bug
|
|
201
|
-
- [ ] Identify root cause
|
|
202
|
-
- [ ] Document expected vs actual behavior
|
|
203
|
-
|
|
204
|
-
### Implementation
|
|
205
|
-
- [ ] Start workflow task
|
|
206
|
-
- [ ] Fix the bug
|
|
207
|
-
- [ ] Verify fix locally
|
|
208
|
-
- [ ] Mark as fixed
|
|
209
|
-
|
|
210
|
-
### Testing
|
|
211
|
-
- [ ] Write regression test
|
|
212
|
-
- [ ] Update existing tests if needed
|
|
213
|
-
- [ ] Create tests in workflow
|
|
214
|
-
- [ ] Run full test suite
|
|
215
|
-
- [ ] Record passing tests
|
|
216
|
-
|
|
217
|
-
### Documentation
|
|
218
|
-
- [ ] Update CHANGELOG
|
|
219
|
-
- [ ] Add code comments explaining the fix
|
|
220
|
-
- [ ] Create documentation in workflow
|
|
221
|
-
|
|
222
|
-
### Release
|
|
223
|
-
- [ ] Commit and push changes
|
|
224
|
-
- [ ] Perform release (patch version)
|
|
225
|
-
- [ ] Complete task
|
|
226
|
-
</code></pre>
|
|
227
|
-
<h3>Workflow Commands</h3>
|
|
228
|
-
<pre><code># 1. Start
|
|
229
|
-
start_task:
|
|
230
|
-
description: "Fix [bug description]"
|
|
231
|
-
type: "bugfix"
|
|
232
|
-
|
|
233
|
-
# 2. Fix the bug
|
|
234
|
-
# ... your fix ...
|
|
235
|
-
|
|
236
|
-
# 3. Mark as fixed
|
|
237
|
-
mark_bug_fixed:
|
|
238
|
-
summary: "[Brief description of the fix]"
|
|
239
|
-
|
|
240
|
-
# 4. Create regression tests
|
|
241
|
-
# ... write test to prevent recurrence ...
|
|
242
|
-
create_tests
|
|
243
|
-
|
|
244
|
-
# 5. Run tests
|
|
245
|
-
run_tests:
|
|
246
|
-
passed: true
|
|
247
|
-
testCommand: "npm test"
|
|
248
|
-
details: "[Include regression test results]"
|
|
249
|
-
|
|
250
|
-
# 6. Document
|
|
251
|
-
# ... update CHANGELOG ...
|
|
252
|
-
create_documentation:
|
|
253
|
-
documentationType: "changelog"
|
|
254
|
-
summary: "[What you documented]"
|
|
255
|
-
|
|
256
|
-
# 7. Commit
|
|
257
|
-
commit_and_push:
|
|
258
|
-
commitMessage: "fix([scope]): [description]"
|
|
259
|
-
|
|
260
|
-
# 8. Release
|
|
261
|
-
perform_release:
|
|
262
|
-
command: "npm run release:patch"
|
|
263
|
-
notes: "v[X.Y.Z] - Bugfix for [issue]"
|
|
264
|
-
|
|
265
|
-
# 9. Complete
|
|
266
|
-
complete_task:
|
|
267
|
-
commitMessage: "fix([scope]): [description]"
|
|
268
|
-
</code></pre>
|
|
269
|
-
<h3>Example</h3>
|
|
270
|
-
<p><strong>Bug:</strong> Date picker shows wrong month on mobile</p>
|
|
271
|
-
<pre><code>start_task:
|
|
272
|
-
description: "Fix date picker showing incorrect month on iOS Safari"
|
|
273
|
-
type: "bugfix"
|
|
274
|
-
|
|
275
|
-
mark_bug_fixed:
|
|
276
|
-
summary: "Fixed timezone offset calculation in date picker for iOS Safari"
|
|
277
|
-
|
|
278
|
-
create_tests
|
|
279
|
-
|
|
280
|
-
run_tests:
|
|
281
|
-
passed: true
|
|
282
|
-
testCommand: "npm test -- datepicker"
|
|
283
|
-
details: "Added timezone regression test, all 8 tests pass"
|
|
284
|
-
|
|
285
|
-
create_documentation:
|
|
286
|
-
documentationType: "changelog"
|
|
287
|
-
summary: "Added bug fix entry for date picker iOS issue"
|
|
288
|
-
|
|
289
|
-
commit_and_push:
|
|
290
|
-
commitMessage: "fix(ui): correct date picker timezone handling on iOS"
|
|
291
|
-
|
|
292
|
-
perform_release:
|
|
293
|
-
command: "npm run release:patch"
|
|
294
|
-
notes: "v1.4.1 - iOS date picker fix"
|
|
295
|
-
|
|
296
|
-
complete_task:
|
|
297
|
-
commitMessage: "fix(ui): correct date picker timezone handling on iOS"
|
|
298
|
-
</code></pre>
|
|
299
|
-
<hr>
|
|
300
|
-
<h2>Refactoring Template</h2>
|
|
301
|
-
<p>Use this template when improving code structure without changing behavior.</p>
|
|
302
|
-
<h3>Checklist</h3>
|
|
303
|
-
<pre><code class="language-markdown">## Refactoring: [What You're Refactoring]
|
|
304
|
-
|
|
305
|
-
### Planning
|
|
306
|
-
- [ ] Identify code smell or improvement opportunity
|
|
307
|
-
- [ ] Define refactoring goal
|
|
308
|
-
- [ ] Ensure test coverage exists
|
|
309
|
-
- [ ] Plan incremental changes
|
|
310
|
-
|
|
311
|
-
### Implementation
|
|
312
|
-
- [ ] Start workflow task
|
|
313
|
-
- [ ] Refactor code
|
|
314
|
-
- [ ] Verify behavior unchanged
|
|
315
|
-
- [ ] Mark as fixed
|
|
316
|
-
|
|
317
|
-
### Testing
|
|
318
|
-
- [ ] Update tests for new structure
|
|
319
|
-
- [ ] Ensure all existing tests still pass
|
|
320
|
-
- [ ] Create tests in workflow
|
|
321
|
-
- [ ] Run full test suite
|
|
322
|
-
- [ ] Record passing tests
|
|
323
|
-
|
|
324
|
-
### Documentation
|
|
325
|
-
- [ ] Update inline documentation
|
|
326
|
-
- [ ] Update architecture docs if needed
|
|
327
|
-
- [ ] Create documentation in workflow
|
|
328
|
-
|
|
329
|
-
### Release
|
|
330
|
-
- [ ] Commit and push changes
|
|
331
|
-
- [ ] Perform release (minor/patch)
|
|
332
|
-
- [ ] Complete task
|
|
333
|
-
</code></pre>
|
|
334
|
-
<h3>Workflow Commands</h3>
|
|
335
|
-
<pre><code># 1. Start
|
|
336
|
-
start_task:
|
|
337
|
-
description: "Refactor [component/module] to [improvement goal]"
|
|
338
|
-
type: "refactor"
|
|
339
|
-
|
|
340
|
-
# 2. Refactor
|
|
341
|
-
# ... your refactoring ...
|
|
342
|
-
|
|
343
|
-
# 3. Mark as fixed
|
|
344
|
-
mark_bug_fixed:
|
|
345
|
-
summary: "[Brief description of refactoring]"
|
|
346
|
-
|
|
347
|
-
# 4. Update tests
|
|
348
|
-
# ... update test structure ...
|
|
349
|
-
create_tests
|
|
350
|
-
|
|
351
|
-
# 5. Run tests
|
|
352
|
-
run_tests:
|
|
353
|
-
passed: true
|
|
354
|
-
testCommand: "npm test -- --coverage"
|
|
355
|
-
details: "[All tests pass, coverage maintained/improved]"
|
|
356
|
-
|
|
357
|
-
# 6. Document
|
|
358
|
-
create_documentation:
|
|
359
|
-
documentationType: "inline-comments"
|
|
360
|
-
summary: "[Updated documentation]"
|
|
361
|
-
|
|
362
|
-
# 7. Commit
|
|
363
|
-
commit_and_push:
|
|
364
|
-
commitMessage: "refactor([scope]): [description]"
|
|
365
|
-
|
|
366
|
-
# 8. Release
|
|
367
|
-
perform_release:
|
|
368
|
-
command: "npm run release:minor"
|
|
369
|
-
notes: "v[X.Y.Z] - Internal improvements"
|
|
370
|
-
|
|
371
|
-
# 9. Complete
|
|
372
|
-
complete_task:
|
|
373
|
-
commitMessage: "refactor([scope]): [description]"
|
|
374
|
-
</code></pre>
|
|
375
|
-
<h3>Example</h3>
|
|
376
|
-
<p><strong>Refactoring:</strong> Extract authentication logic to custom hooks</p>
|
|
377
|
-
<pre><code>start_task:
|
|
378
|
-
description: "Refactor authentication logic into reusable custom hooks"
|
|
379
|
-
type: "refactor"
|
|
380
|
-
|
|
381
|
-
mark_bug_fixed:
|
|
382
|
-
summary: "Extracted useAuth and usePermissions hooks from component logic"
|
|
383
|
-
|
|
384
|
-
create_tests
|
|
385
|
-
|
|
386
|
-
run_tests:
|
|
387
|
-
passed: true
|
|
388
|
-
testCommand: "npm test -- --coverage"
|
|
389
|
-
details: "All 145 tests pass, coverage improved from 89% to 92%"
|
|
390
|
-
|
|
391
|
-
create_documentation:
|
|
392
|
-
documentationType: "inline-comments"
|
|
393
|
-
summary: "Added JSDoc for custom hooks and usage examples"
|
|
394
|
-
|
|
395
|
-
commit_and_push:
|
|
396
|
-
commitMessage: "refactor(auth): extract authentication logic to custom hooks"
|
|
397
|
-
|
|
398
|
-
perform_release:
|
|
399
|
-
command: "npm run release:minor"
|
|
400
|
-
notes: "v1.6.0 - Authentication refactoring (improved maintainability)"
|
|
401
|
-
|
|
402
|
-
complete_task:
|
|
403
|
-
commitMessage: "refactor(auth): extract authentication logic to custom hooks"
|
|
404
|
-
</code></pre>
|
|
405
|
-
<hr>
|
|
406
|
-
<h2>Hotfix Template</h2>
|
|
407
|
-
<p>Use this for urgent production fixes that need immediate deployment.</p>
|
|
408
|
-
<h3>Checklist</h3>
|
|
409
|
-
<pre><code class="language-markdown">## Hotfix: [Critical Issue]
|
|
410
|
-
|
|
411
|
-
### Urgent Actions
|
|
412
|
-
- [ ] Identify production issue
|
|
413
|
-
- [ ] Create hotfix branch if using git-flow
|
|
414
|
-
- [ ] Start workflow task
|
|
415
|
-
|
|
416
|
-
### Fix
|
|
417
|
-
- [ ] Implement minimal fix
|
|
418
|
-
- [ ] Test fix locally
|
|
419
|
-
- [ ] Mark as fixed
|
|
420
|
-
|
|
421
|
-
### Testing
|
|
422
|
-
- [ ] Create focused regression test
|
|
423
|
-
- [ ] Run relevant test suite
|
|
424
|
-
- [ ] Manual verification in staging
|
|
425
|
-
- [ ] Record passing tests
|
|
426
|
-
|
|
427
|
-
### Documentation
|
|
428
|
-
- [ ] Update CHANGELOG with hotfix note
|
|
429
|
-
- [ ] Document in workflow
|
|
430
|
-
|
|
431
|
-
### Release
|
|
432
|
-
- [ ] Commit and push
|
|
433
|
-
- [ ] Perform PATCH release
|
|
434
|
-
- [ ] Deploy to production immediately
|
|
435
|
-
- [ ] Complete task
|
|
436
|
-
- [ ] Notify team
|
|
437
|
-
</code></pre>
|
|
438
|
-
<h3>Workflow Commands</h3>
|
|
439
|
-
<pre><code># 1. Start immediately
|
|
440
|
-
start_task:
|
|
441
|
-
description: "HOTFIX: [critical issue description]"
|
|
442
|
-
type: "bugfix"
|
|
443
|
-
|
|
444
|
-
# 2. Minimal fix
|
|
445
|
-
# ... implement fix ...
|
|
446
|
-
|
|
447
|
-
# 3. Mark as fixed
|
|
448
|
-
mark_bug_fixed:
|
|
449
|
-
summary: "[Brief description of hotfix]"
|
|
450
|
-
|
|
451
|
-
# 4. Focused test
|
|
452
|
-
create_tests
|
|
453
|
-
|
|
454
|
-
# 5. Run tests
|
|
455
|
-
run_tests:
|
|
456
|
-
passed: true
|
|
457
|
-
testCommand: "npm test -- [relevant-tests]"
|
|
458
|
-
details: "[Critical path tests pass]"
|
|
459
|
-
|
|
460
|
-
# 6. Document urgency
|
|
461
|
-
create_documentation:
|
|
462
|
-
documentationType: "changelog"
|
|
463
|
-
summary: "HOTFIX: [issue] - [fix description]"
|
|
464
|
-
|
|
465
|
-
# 7. Commit
|
|
466
|
-
commit_and_push:
|
|
467
|
-
commitMessage: "fix([scope])!: HOTFIX - [description]"
|
|
468
|
-
|
|
469
|
-
# 8. Emergency release
|
|
470
|
-
perform_release:
|
|
471
|
-
command: "npm run release:patch"
|
|
472
|
-
notes: "v[X.Y.Z] - HOTFIX: [issue]"
|
|
473
|
-
|
|
474
|
-
# 9. Complete
|
|
475
|
-
complete_task:
|
|
476
|
-
commitMessage: "fix([scope])!: HOTFIX - [description]"
|
|
477
|
-
</code></pre>
|
|
478
|
-
<h3>Example</h3>
|
|
479
|
-
<p><strong>Hotfix:</strong> Payment processing fails on production</p>
|
|
480
|
-
<pre><code>start_task:
|
|
481
|
-
description: "HOTFIX: Payment gateway timeout causing checkout failures"
|
|
482
|
-
type: "bugfix"
|
|
483
|
-
|
|
484
|
-
mark_bug_fixed:
|
|
485
|
-
summary: "Increased payment API timeout from 5s to 30s and added retry logic"
|
|
486
|
-
|
|
487
|
-
create_tests
|
|
488
|
-
|
|
489
|
-
run_tests:
|
|
490
|
-
passed: true
|
|
491
|
-
testCommand: "npm test -- payment"
|
|
492
|
-
details: "Payment flow tests pass with timeout scenarios"
|
|
493
|
-
|
|
494
|
-
create_documentation:
|
|
495
|
-
documentationType: "changelog"
|
|
496
|
-
summary: "HOTFIX: Resolved payment timeout failures with increased timeout and retry"
|
|
497
|
-
|
|
498
|
-
commit_and_push:
|
|
499
|
-
commitMessage: "fix(payment)!: HOTFIX - increase timeout and add retry logic"
|
|
500
|
-
|
|
501
|
-
perform_release:
|
|
502
|
-
command: "npm run release:patch"
|
|
503
|
-
notes: "v1.4.2 - HOTFIX: Payment processing timeout"
|
|
504
|
-
|
|
505
|
-
complete_task:
|
|
506
|
-
commitMessage: "fix(payment)!: HOTFIX - increase timeout and add retry logic"
|
|
507
|
-
</code></pre>
|
|
508
|
-
<hr>
|
|
509
|
-
<h2>Documentation Update Template</h2>
|
|
510
|
-
<p>Use this when updating documentation without code changes.</p>
|
|
511
|
-
<h3>Workflow Commands</h3>
|
|
512
|
-
<pre><code># 1. Start
|
|
513
|
-
start_task:
|
|
514
|
-
description: "Update documentation for [topic]"
|
|
515
|
-
type: "other"
|
|
516
|
-
|
|
517
|
-
# 2. Update docs
|
|
518
|
-
# ... write documentation ...
|
|
519
|
-
|
|
520
|
-
# 3. Mark as complete
|
|
521
|
-
mark_bug_fixed:
|
|
522
|
-
summary: "Updated [documentation type] with [additions]"
|
|
523
|
-
|
|
524
|
-
# 4. Skip tests (documentation only)
|
|
525
|
-
skip_tests:
|
|
526
|
-
reason: "Documentation-only change, no code modified"
|
|
527
|
-
|
|
528
|
-
# 5. Document
|
|
529
|
-
create_documentation:
|
|
530
|
-
documentationType: "README"
|
|
531
|
-
summary: "[What documentation was added/updated]"
|
|
532
|
-
|
|
533
|
-
# 6. Commit
|
|
534
|
-
commit_and_push:
|
|
535
|
-
commitMessage: "docs([scope]): [description]"
|
|
536
|
-
|
|
537
|
-
# 7. Release
|
|
538
|
-
perform_release:
|
|
539
|
-
command: "npm run release:patch"
|
|
540
|
-
notes: "v[X.Y.Z] - Documentation updates"
|
|
541
|
-
|
|
542
|
-
# 8. Complete
|
|
543
|
-
complete_task:
|
|
544
|
-
commitMessage: "docs([scope]): [description]"
|
|
545
|
-
</code></pre>
|
|
546
|
-
<h3>Example</h3>
|
|
547
|
-
<pre><code>start_task:
|
|
548
|
-
description: "Add migration guide for v2.0 breaking changes"
|
|
549
|
-
type: "other"
|
|
550
|
-
|
|
551
|
-
mark_bug_fixed:
|
|
552
|
-
summary: "Created comprehensive v2.0 migration guide with examples"
|
|
553
|
-
|
|
554
|
-
skip_tests:
|
|
555
|
-
reason: "Documentation-only update, no code changes"
|
|
556
|
-
|
|
557
|
-
create_documentation:
|
|
558
|
-
documentationType: "API-docs"
|
|
559
|
-
summary: "Added MIGRATION_V2.md with breaking changes and upgrade steps"
|
|
560
|
-
|
|
561
|
-
commit_and_push:
|
|
562
|
-
commitMessage: "docs(migration): add v2.0 migration guide"
|
|
563
|
-
|
|
564
|
-
perform_release:
|
|
565
|
-
command: "npm run release:patch"
|
|
566
|
-
notes: "v1.4.3 - v2.0 migration guide"
|
|
567
|
-
|
|
568
|
-
complete_task:
|
|
569
|
-
commitMessage: "docs(migration): add v2.0 migration guide"
|
|
570
|
-
</code></pre>
|
|
571
|
-
<hr>
|
|
572
|
-
<h2>Release Preparation Template</h2>
|
|
573
|
-
<p>Use this when preparing a major/minor release with multiple features.</p>
|
|
574
|
-
<h3>Checklist</h3>
|
|
575
|
-
<pre><code class="language-markdown">## Release Preparation: v[X.Y.Z]
|
|
576
|
-
|
|
577
|
-
### Pre-Release
|
|
578
|
-
- [ ] Review all merged features
|
|
579
|
-
- [ ] Update version numbers
|
|
580
|
-
- [ ] Update CHANGELOG
|
|
581
|
-
- [ ] Run full test suite
|
|
582
|
-
- [ ] Check documentation completeness
|
|
583
|
-
|
|
584
|
-
### Workflow
|
|
585
|
-
- [ ] Start workflow task
|
|
586
|
-
- [ ] Mark preparation as complete
|
|
587
|
-
- [ ] Verify tests
|
|
588
|
-
- [ ] Create documentation
|
|
589
|
-
- [ ] Commit and push
|
|
590
|
-
- [ ] Perform release
|
|
591
|
-
- [ ] Complete task
|
|
592
|
-
|
|
593
|
-
### Post-Release
|
|
594
|
-
- [ ] Tag release in git
|
|
595
|
-
- [ ] Create GitHub release notes
|
|
596
|
-
- [ ] Publish to npm/registry
|
|
597
|
-
- [ ] Notify users
|
|
598
|
-
</code></pre>
|
|
599
|
-
<h3>Workflow Commands</h3>
|
|
600
|
-
<pre><code>start_task:
|
|
601
|
-
description: "Prepare release v[X.Y.Z] with [feature list]"
|
|
602
|
-
type: "other"
|
|
603
|
-
|
|
604
|
-
mark_bug_fixed:
|
|
605
|
-
summary: "Release preparation complete: CHANGELOG updated, version bumped to [X.Y.Z]"
|
|
606
|
-
|
|
607
|
-
create_tests
|
|
608
|
-
|
|
609
|
-
run_tests:
|
|
610
|
-
passed: true
|
|
611
|
-
testCommand: "npm test -- --coverage"
|
|
612
|
-
details: "Full test suite: [X tests pass], coverage [Y%]"
|
|
613
|
-
|
|
614
|
-
create_documentation:
|
|
615
|
-
documentationType: "changelog"
|
|
616
|
-
summary: "Updated CHANGELOG with all v[X.Y.Z] features and fixes"
|
|
617
|
-
|
|
618
|
-
commit_and_push:
|
|
619
|
-
commitMessage: "chore(release): prepare v[X.Y.Z]"
|
|
620
|
-
|
|
621
|
-
perform_release:
|
|
622
|
-
command: "npm run release:minor"
|
|
623
|
-
notes: "v[X.Y.Z] - [Release highlights]"
|
|
624
|
-
|
|
625
|
-
complete_task:
|
|
626
|
-
commitMessage: "chore(release): prepare v[X.Y.Z]"
|
|
627
|
-
</code></pre>
|
|
628
|
-
<hr>
|
|
629
|
-
<h2>Using Templates in Antigravity</h2>
|
|
630
|
-
<h3>Quick Template Application</h3>
|
|
631
|
-
<ol>
|
|
632
|
-
<li><strong>Choose your template</strong> based on task type</li>
|
|
633
|
-
<li><strong>Copy the workflow commands</strong> section</li>
|
|
634
|
-
<li><strong>Customize</strong> brackets [...] with your specific details</li>
|
|
635
|
-
<li><strong>Execute</strong> commands in Antigravity</li>
|
|
636
|
-
</ol>
|
|
637
|
-
<h3>Template Variables</h3>
|
|
638
|
-
<p>Replace these placeholders in templates:</p>
|
|
639
|
-
<ul>
|
|
640
|
-
<li><code>[Feature Name]</code> - Your feature description</li>
|
|
641
|
-
<li><code>[Bug Description]</code> - Bug summary</li>
|
|
642
|
-
<li><code>[scope]</code> - Conventional commit scope (e.g., auth, ui, api)</li>
|
|
643
|
-
<li><code>[description]</code> - Commit description</li>
|
|
644
|
-
<li><code>[X.Y.Z]</code> - Version number</li>
|
|
645
|
-
<li><code>[X tests]</code> - Number of tests</li>
|
|
646
|
-
<li><code>[Y%]</code> - Coverage percentage</li>
|
|
647
|
-
</ul>
|
|
648
|
-
<h3>Automation with Workflows</h3>
|
|
649
|
-
<p>Save these as Antigravity workflow files in <code>.agent/workflows/</code>:</p>
|
|
650
|
-
<ul>
|
|
651
|
-
<li><code>dev-workflow-feature.md</code></li>
|
|
652
|
-
<li><code>dev-workflow-bugfix.md</code></li>
|
|
653
|
-
<li><code>dev-workflow-refactor.md</code></li>
|
|
654
|
-
<li><code>dev-workflow-hotfix.md</code></li>
|
|
655
|
-
</ul>
|
|
656
|
-
<p>Then use slash commands like <code>/dev-workflow-feature</code> to load templates!</p>
|
|
657
|
-
<hr>
|
|
658
|
-
<h2>Next Steps</h2>
|
|
659
|
-
<ul>
|
|
660
|
-
<li>See <a href="./EXAMPLES.md">EXAMPLES.md</a> for real-world usage scenarios</li>
|
|
661
|
-
<li>Check <a href="./TROUBLESHOOTING.md">TROUBLESHOOTING.md</a> for common issues</li>
|
|
662
|
-
<li>Return to <a href="./GETTING-STARTED.md">GETTING-STARTED.md</a> for setup</li>
|
|
663
|
-
</ul>
|
|
664
|
-
<hr>
|
|
665
|
-
<p><strong>Consistent workflows lead to consistent quality!</strong> ⚡</p>
|
|
666
|
-
|
|
667
|
-
</article>
|
|
668
|
-
</div>
|
|
669
|
-
</main>
|
|
670
|
-
</div>
|
|
671
|
-
|
|
672
|
-
<script>
|
|
673
|
-
lucide.createIcons();
|
|
674
|
-
</script>
|
|
675
|
-
</body>
|
|
676
|
-
</html>
|