@caddis/cli 0.4.86 → 0.4.88

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 (44) hide show
  1. package/bundles/antigravity-plugin/plugin.json +1 -1
  2. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_exit.cpython-311.pyc +0 -0
  3. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_file_lock.cpython-311.pyc +0 -0
  4. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_frontmatter.cpython-311.pyc +0 -0
  5. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_redact.cpython-311.pyc +0 -0
  6. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_roadmap.cpython-311.pyc +0 -0
  7. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_rows.cpython-311.pyc +0 -0
  8. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_status.cpython-311.pyc +0 -0
  9. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_tidy.cpython-311.pyc +0 -0
  10. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_todo.cpython-311.pyc +0 -0
  11. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_workstreams.cpython-311.pyc +0 -0
  12. package/bundles/antigravity-plugin/scripts/__pycache__/caddis_worktree_safety.cpython-311.pyc +0 -0
  13. package/bundles/antigravity-plugin/scripts/caddis_guide.json +2413 -0
  14. package/bundles/antigravity-plugin/scripts/caddis_hub_collect.py +59 -2
  15. package/bundles/antigravity-plugin/scripts/caddis_roadmap.py +5 -13
  16. package/bundles/antigravity-plugin/scripts/caddis_status.py +45 -0
  17. package/bundles/antigravity-plugin/scripts/caddis_todo.py +154 -22
  18. package/bundles/antigravity-plugin/scripts/schemas/hub-collect.schema.json +20 -1
  19. package/bundles/antigravity-plugin/scripts/schemas/hub-plans.schema.json +20 -1
  20. package/bundles/antigravity-plugin/skills/feature-plan/SKILL.md +4 -0
  21. package/bundles/antigravity-plugin/skills/implement/SKILL.md +2 -1
  22. package/bundles/manifest.json +2 -2
  23. package/dist/cli.js +1 -1
  24. package/dist/export/assets/export-CEtCs5rg.css +1 -0
  25. package/dist/export/assets/{export-DErZHj4B.js → export-v-kcNvPW.js} +30 -30
  26. package/dist/export/assets/mark-small-B1q4Vk3J.svg +8 -0
  27. package/dist/export/fonts/atkinson-500.21d6ef26.woff2 +0 -0
  28. package/dist/export/fonts/atkinson-600.ce9f3210.woff2 +0 -0
  29. package/dist/export/index.html +2 -2
  30. package/dist/ui/assets/{Activity-CaqQ_HdD.js → Activity-C9TCizJV.js} +1 -1
  31. package/dist/ui/assets/{Guide-9PV1m0e9.js → Guide-6aEYW9oW.js} +1 -1
  32. package/dist/ui/assets/RoadmapTab-hUK2kzCW.js +31 -0
  33. package/dist/ui/assets/index-DE7v-v_o.css +1 -0
  34. package/dist/ui/assets/{index-Dotj3WfG.js → index-d44hkSAE.js} +39 -39
  35. package/dist/ui/assets/mark-small-B1q4Vk3J.svg +8 -0
  36. package/dist/ui/fonts/atkinson-500.21d6ef26.woff2 +0 -0
  37. package/dist/ui/fonts/atkinson-600.ce9f3210.woff2 +0 -0
  38. package/dist/ui/index.html +2 -2
  39. package/package.json +1 -1
  40. package/dist/export/assets/export-C0_skoDL.css +0 -1
  41. package/dist/export/assets/mark-small-CwCIyjyC.svg +0 -8
  42. package/dist/ui/assets/RoadmapTab-CDm42wB2.js +0 -31
  43. package/dist/ui/assets/index-Cv4RVfyi.css +0 -1
  44. package/dist/ui/assets/mark-small-CwCIyjyC.svg +0 -8
@@ -0,0 +1,2413 @@
1
+ {
2
+ "schema": 1,
3
+ "version": "1.3.171",
4
+ "generated": "2026-10-26 08:51 UTC",
5
+ "commands": [
6
+ {
7
+ "name": "add-rules",
8
+ "description": "Create canonical rules for ANY folder — write <folder>/AGENTS.md (from the folder template) + a <folder>/CLAUDE.md @import shim. For folders the stack-map generator doesn't cover.",
9
+ "hint": "<folder> [one-line purpose]",
10
+ "steps": [
11
+ [
12
+ "",
13
+ "Steps"
14
+ ]
15
+ ],
16
+ "scripts": [],
17
+ "noArgs": false,
18
+ "stage": "knowledge",
19
+ "daily": false
20
+ },
21
+ {
22
+ "name": "catchup",
23
+ "description": "Where were we? A quick list of what this session was doing and what is still open",
24
+ "hint": "[name]",
25
+ "steps": [
26
+ [
27
+ "",
28
+ "Read these, in this order, and stop as soon as you can answer"
29
+ ],
30
+ [
31
+ "",
32
+ "What to report"
33
+ ],
34
+ [
35
+ "",
36
+ "Say plainly when the answer is thin"
37
+ ],
38
+ [
39
+ "",
40
+ "When the user wants more than a list"
41
+ ],
42
+ [
43
+ "",
44
+ "Workstreams and open work"
45
+ ]
46
+ ],
47
+ "scripts": [
48
+ "caddis_relay_git.py",
49
+ "caddis_roadmap.py",
50
+ "caddis_workstreams.py"
51
+ ],
52
+ "noArgs": false,
53
+ "stage": "continuity",
54
+ "daily": false
55
+ },
56
+ {
57
+ "name": "cloud-phases",
58
+ "description": "Run plan phases in Claude Code cloud sessions — write one prompt per phase, push, hand out paste lines, then take the PRs back",
59
+ "hint": "[plan path] [phase numbers] | intake",
60
+ "steps": [
61
+ [
62
+ "0",
63
+ "Is this checkout safe to move?"
64
+ ],
65
+ [
66
+ "1",
67
+ "check the preconditions (stop on any failure)"
68
+ ],
69
+ [
70
+ "2",
71
+ "pick the phases for the cloud"
72
+ ],
73
+ [
74
+ "3",
75
+ "check the facts each phase depends on (rule: think before you send)"
76
+ ],
77
+ [
78
+ "4",
79
+ "write one prompt per phase"
80
+ ],
81
+ [
82
+ "",
83
+ "Where you are"
84
+ ],
85
+ [
86
+ "",
87
+ "The phase (copied from the plan)"
88
+ ],
89
+ [
90
+ "",
91
+ "Facts already checked (<date>, at <short SHA>)"
92
+ ],
93
+ [
94
+ "",
95
+ "Edge cases to handle"
96
+ ]
97
+ ],
98
+ "scripts": [
99
+ "caddis_checkout_guard.py",
100
+ "caddis_lanes.py",
101
+ "caddis_todo.py",
102
+ "caddis_worktree_root.py"
103
+ ],
104
+ "noArgs": false,
105
+ "stage": "build",
106
+ "daily": false
107
+ },
108
+ {
109
+ "name": "coordinate",
110
+ "description": "Run this session as the repo's coordinator — one merge queue for all sessions, one merge at a time, a deploy check after each merge, routine approvals in the ledger.",
111
+ "hint": "[start|status|stop]",
112
+ "steps": [
113
+ [
114
+ "",
115
+ "Restart and resume"
116
+ ],
117
+ [
118
+ "",
119
+ "Keep this session cheap"
120
+ ],
121
+ [
122
+ "",
123
+ "How to call the script"
124
+ ],
125
+ [
126
+ "1",
127
+ ". Start (design 0.1)"
128
+ ],
129
+ [
130
+ "2",
131
+ ". Merge mode (design 3, design 12 Q1)"
132
+ ],
133
+ [
134
+ "3",
135
+ ". The loop (design 1, 2, 3, 5, 7)"
136
+ ],
137
+ [
138
+ "4",
139
+ ". Approvals (design 6)"
140
+ ],
141
+ [
142
+ "5",
143
+ ". Failures (design 8) and stalls (design 7.4)"
144
+ ],
145
+ [
146
+ "6",
147
+ ". Stop"
148
+ ]
149
+ ],
150
+ "scripts": [
151
+ "caddis_coordinate.py",
152
+ "caddis_lanes.py"
153
+ ],
154
+ "noArgs": false,
155
+ "stage": "ship",
156
+ "daily": true
157
+ },
158
+ {
159
+ "name": "cross-review",
160
+ "description": "Cross-vendor code review of the current diff — a second-vendor model (agy Argon by default; DeepSeek, GLM or any OpenAI-compatible endpoint) reviews your changes to catch bugs a same-vendor reviewer misses",
161
+ "hint": "[git range, e.g. origin/main..HEAD]",
162
+ "steps": [
163
+ [
164
+ "0",
165
+ "check the key BEFORE reading the diff"
166
+ ],
167
+ [
168
+ "",
169
+ "Run it"
170
+ ],
171
+ [
172
+ "",
173
+ "Interpret the exit code"
174
+ ],
175
+ [
176
+ "",
177
+ "Three rules: one attempt, one review"
178
+ ]
179
+ ],
180
+ "scripts": [
181
+ "caddis_gate.py",
182
+ "oss_review.py"
183
+ ],
184
+ "noArgs": false,
185
+ "stage": "review",
186
+ "daily": false
187
+ },
188
+ {
189
+ "name": "data-lineage",
190
+ "description": "Generate End-to-End Data Lineage and Telemetry Specification Markdown and Confluence XHTML for fleet observability.",
191
+ "hint": "(no arguments — documents the app in this repo)",
192
+ "steps": [],
193
+ "scripts": [
194
+ "convert_doc_to_confluence.py"
195
+ ],
196
+ "noArgs": true,
197
+ "stage": "plan",
198
+ "daily": false
199
+ },
200
+ {
201
+ "name": "decide",
202
+ "description": "Record a decision in one step — .caddis/decisions/<date>-<slug>.md",
203
+ "hint": "<decision>",
204
+ "steps": [
205
+ [
206
+ "1",
207
+ "build the slug"
208
+ ],
209
+ [
210
+ "2",
211
+ "pick the path"
212
+ ],
213
+ [
214
+ "3",
215
+ "write the file"
216
+ ],
217
+ [
218
+ "",
219
+ "Context"
220
+ ],
221
+ [
222
+ "",
223
+ "Decision"
224
+ ],
225
+ [
226
+ "",
227
+ "Consequences"
228
+ ],
229
+ [
230
+ "4",
231
+ "verify"
232
+ ],
233
+ [
234
+ "5",
235
+ "report"
236
+ ]
237
+ ],
238
+ "scripts": [
239
+ "caddis_gate.py"
240
+ ],
241
+ "noArgs": false,
242
+ "stage": "knowledge",
243
+ "daily": false
244
+ },
245
+ {
246
+ "name": "digress",
247
+ "description": "Park the current workstream on the stack and switch to a new task — without losing the original",
248
+ "hint": "[reason for the detour]",
249
+ "steps": [
250
+ [
251
+ "1",
252
+ "identify the CURRENT workstream (the thing being parked)"
253
+ ],
254
+ [
255
+ "2",
256
+ "write a one-line `resumePointer`"
257
+ ],
258
+ [
259
+ "3",
260
+ "write the workstream relay to `.caddis/relay/<name>.md`"
261
+ ],
262
+ [
263
+ "",
264
+ "Current workstream"
265
+ ],
266
+ [
267
+ "",
268
+ "Next step (exact)"
269
+ ],
270
+ [
271
+ "4",
272
+ "confirm, then continue"
273
+ ]
274
+ ],
275
+ "scripts": [],
276
+ "noArgs": false,
277
+ "stage": "continuity",
278
+ "daily": false
279
+ },
280
+ {
281
+ "name": "excalidraw-db",
282
+ "description": "Turn a SQL artifact into an Excalidraw diagram for a design review / ARB pack / slide — higher-level, drag-the-boxes format",
283
+ "hint": "[file path | object name | pasted SQL]",
284
+ "steps": [
285
+ [
286
+ "",
287
+ "Do this"
288
+ ]
289
+ ],
290
+ "scripts": [
291
+ "sql_to_graph.py"
292
+ ],
293
+ "noArgs": false,
294
+ "stage": "knowledge",
295
+ "daily": false
296
+ },
297
+ {
298
+ "name": "feature-plan",
299
+ "description": "Create a phased, TDD-structured implementation plan that acts as the durable spine for multi-session work",
300
+ "hint": "<feature description>",
301
+ "steps": [
302
+ [
303
+ "",
304
+ "Headless mode"
305
+ ],
306
+ [
307
+ "1",
308
+ "Scope check"
309
+ ],
310
+ [
311
+ "2",
312
+ "Design phases"
313
+ ],
314
+ [
315
+ "3",
316
+ "Write the plan to `.caddis/plans/<feature-slug>.md`"
317
+ ],
318
+ [
319
+ "",
320
+ "Goal"
321
+ ],
322
+ [
323
+ "",
324
+ "Current state"
325
+ ],
326
+ [
327
+ "",
328
+ "Constraints & decisions"
329
+ ],
330
+ [
331
+ "",
332
+ "Global Constraints"
333
+ ],
334
+ [
335
+ "",
336
+ "Review Focus"
337
+ ]
338
+ ],
339
+ "scripts": [
340
+ "caddis_gate.py",
341
+ "caddis_lanes.py",
342
+ "caddis_routing.py",
343
+ "caddis_spend.py",
344
+ "caddis_status.py"
345
+ ],
346
+ "noArgs": false,
347
+ "stage": "plan",
348
+ "daily": true
349
+ },
350
+ {
351
+ "name": "fleet-close",
352
+ "description": "Close a fleet of sessions — every session writes its handoff and acks, then print one restart sheet for the owner",
353
+ "hint": "(no arguments — run it in the session that coordinates the close)",
354
+ "steps": [
355
+ [
356
+ "1",
357
+ "list the fleet"
358
+ ],
359
+ [
360
+ "2",
361
+ "make the fleet dir"
362
+ ],
363
+ [
364
+ "3",
365
+ "send the close message"
366
+ ],
367
+ [
368
+ "4",
369
+ "collect acks (first wait: 10 minutes)"
370
+ ],
371
+ [
372
+ "5",
373
+ "remind once (second wait: 20 minutes)"
374
+ ],
375
+ [
376
+ "6",
377
+ "your own handoff and ack"
378
+ ],
379
+ [
380
+ "7",
381
+ "write and check the sheet"
382
+ ],
383
+ [
384
+ "8",
385
+ "final reply"
386
+ ]
387
+ ],
388
+ "scripts": [
389
+ "caddis_fleet.py"
390
+ ],
391
+ "noArgs": true,
392
+ "stage": "continuity",
393
+ "daily": false
394
+ },
395
+ {
396
+ "name": "fleet-open",
397
+ "description": "Restore one role from the fleet restart sheet in a new session — name check, relay, tasks, peer greeting, watchers",
398
+ "hint": "<role> (the Role column of the restart sheet, e.g. containment-build)",
399
+ "steps": [
400
+ [
401
+ "1",
402
+ "find the newest restart sheet that holds the role"
403
+ ],
404
+ [
405
+ "2",
406
+ "check this session's name before loading anything"
407
+ ],
408
+ [
409
+ "3",
410
+ "read the relay and run its resume prompt"
411
+ ],
412
+ [
413
+ "4",
414
+ "greet the live local peers"
415
+ ],
416
+ [
417
+ "5",
418
+ "restart the watchers"
419
+ ],
420
+ [
421
+ "6",
422
+ "record the name and report"
423
+ ]
424
+ ],
425
+ "scripts": [
426
+ "caddis_fleet.py"
427
+ ],
428
+ "noArgs": false,
429
+ "stage": "continuity",
430
+ "daily": false
431
+ },
432
+ {
433
+ "name": "gate-preflight",
434
+ "description": "Deterministic headless preflight — validates a plan against the actual codebase, self-contained (never depends on a skill activating)",
435
+ "hint": "[path to plan.md]",
436
+ "steps": [
437
+ [
438
+ "",
439
+ "HEADLESS RUN RULES (mandatory)"
440
+ ]
441
+ ],
442
+ "scripts": [
443
+ "caddis_todo.py"
444
+ ],
445
+ "noArgs": false,
446
+ "stage": "plan",
447
+ "daily": false
448
+ },
449
+ {
450
+ "name": "gate-review",
451
+ "description": "Deterministic headless code review — adversarial diff review, self-contained (never depends on a skill activating)",
452
+ "hint": "[git range, defaults to the working diff]",
453
+ "steps": [
454
+ [
455
+ "",
456
+ "HEADLESS RUN RULES (mandatory)"
457
+ ]
458
+ ],
459
+ "scripts": [],
460
+ "noArgs": false,
461
+ "stage": "review",
462
+ "daily": false
463
+ },
464
+ {
465
+ "name": "glossary",
466
+ "description": "Define the words this project invented, in one place — .caddis/kb/GLOSSARY.md",
467
+ "hint": "(no arguments — scans this repo for coined terms)",
468
+ "steps": [
469
+ [
470
+ "1",
471
+ "get the candidates"
472
+ ],
473
+ [
474
+ "2",
475
+ "apply the admission test to each candidate"
476
+ ],
477
+ [
478
+ "3",
479
+ "write each definition from the CODE, not from the word"
480
+ ],
481
+ [
482
+ "4",
483
+ "flag what is still dirty"
484
+ ],
485
+ [
486
+ "5",
487
+ "report"
488
+ ],
489
+ [
490
+ "",
491
+ "Keeping it honest"
492
+ ]
493
+ ],
494
+ "scripts": [
495
+ "caddis_glossary.py"
496
+ ],
497
+ "noArgs": true,
498
+ "stage": "knowledge",
499
+ "daily": false
500
+ },
501
+ {
502
+ "name": "handoff",
503
+ "description": "End-of-session handoff — capture exact state so the next session resumes with zero re-discovery",
504
+ "hint": "(no arguments — writes this workstream's relay, .caddis/relay/<name>.md)",
505
+ "steps": [
506
+ [
507
+ "0",
508
+ "is this a shared checkout?"
509
+ ],
510
+ [
511
+ "",
512
+ "Checklist"
513
+ ],
514
+ [
515
+ "1",
516
+ "capture learnings FIRST (knowledge-transfer)"
517
+ ],
518
+ [
519
+ "2",
520
+ "gather verified signals (don't guess)"
521
+ ],
522
+ [
523
+ "2b",
524
+ "was any of it the harness?"
525
+ ],
526
+ [
527
+ "3",
528
+ "write the resume doc (overwrite) with exactly these sections"
529
+ ],
530
+ [
531
+ "",
532
+ "Current workstream"
533
+ ],
534
+ [
535
+ "",
536
+ "Done (this session / across sessions)"
537
+ ],
538
+ [
539
+ "",
540
+ "Next step (exact)"
541
+ ]
542
+ ],
543
+ "scripts": [
544
+ "caddis_budget.py",
545
+ "caddis_checkout_guard.py",
546
+ "caddis_coordinate.py",
547
+ "caddis_created.py",
548
+ "caddis_docs_pr.py",
549
+ "caddis_fleet.py",
550
+ "caddis_gate.py",
551
+ "caddis_inventory.py",
552
+ "caddis_relay_git.py",
553
+ "caddis_tidy.py",
554
+ "caddis_workstreams.py",
555
+ "check_doc_coverage.py",
556
+ "session_state.py"
557
+ ],
558
+ "noArgs": true,
559
+ "stage": "continuity",
560
+ "daily": true
561
+ },
562
+ {
563
+ "name": "hld",
564
+ "description": "Generate High-Level Design (HLD) Markdown documentation and Confluence XHTML with native PlantUML diagrams.",
565
+ "hint": "(no arguments — documents the app in this repo)",
566
+ "steps": [],
567
+ "scripts": [
568
+ "convert_doc_to_confluence.py"
569
+ ],
570
+ "noArgs": true,
571
+ "stage": "plan",
572
+ "daily": false
573
+ },
574
+ {
575
+ "name": "implement",
576
+ "description": "Headless plan executor — implement an approved plan phase-by-phase on the current feature branch, TDD-first, committing per phase",
577
+ "hint": "[path to .caddis/plans/<slug>.md]",
578
+ "steps": [
579
+ [
580
+ "",
581
+ "Non-negotiable safety rules (the runner enforces these too — violating them fails the whole run)"
582
+ ],
583
+ [
584
+ "",
585
+ "Keep the session small and quiet"
586
+ ],
587
+ [
588
+ "",
589
+ "Three rules: one attempt, one review"
590
+ ],
591
+ [
592
+ "",
593
+ "Programme triggers"
594
+ ],
595
+ [
596
+ "",
597
+ "What to do"
598
+ ],
599
+ [
600
+ "",
601
+ "What changed"
602
+ ],
603
+ [
604
+ "",
605
+ "Assumptions made"
606
+ ],
607
+ [
608
+ "",
609
+ "Task progress *(only for `Execution: per-task` phases)*"
610
+ ],
611
+ [
612
+ "",
613
+ "Not done / follow-ups"
614
+ ]
615
+ ],
616
+ "scripts": [
617
+ "caddis_gate.py",
618
+ "caddis_lanes.py",
619
+ "caddis_spend.py",
620
+ "caddis_status.py",
621
+ "caddis_tidy.py",
622
+ "caddis_todo.py"
623
+ ],
624
+ "noArgs": false,
625
+ "stage": "build",
626
+ "daily": true
627
+ },
628
+ {
629
+ "name": "install-statusline",
630
+ "description": "Install the caddis status line into Claude Code and agy — one renderer, once per machine",
631
+ "hint": "(no arguments — installs the caddis status line for Claude Code and agy)",
632
+ "steps": [
633
+ [
634
+ "",
635
+ "What the user gets"
636
+ ],
637
+ [
638
+ "",
639
+ "Run it"
640
+ ],
641
+ [
642
+ "",
643
+ "Verify"
644
+ ],
645
+ [
646
+ "",
647
+ "Change the look"
648
+ ]
649
+ ],
650
+ "scripts": [
651
+ "caddis_statusline.py"
652
+ ],
653
+ "noArgs": true,
654
+ "stage": "setup",
655
+ "daily": false
656
+ },
657
+ {
658
+ "name": "kb",
659
+ "description": "Rebuild the KB index (.caddis/kb/DOC-MAP.md) — create it if missing, index un-indexed notes, report dangling links",
660
+ "hint": "(no arguments — rebuilds .caddis/kb/DOC-MAP.md from the notes on disk)",
661
+ "steps": [
662
+ [
663
+ "1",
664
+ "locate the checker"
665
+ ],
666
+ [
667
+ "2",
668
+ "run the reindexer"
669
+ ],
670
+ [
671
+ "3",
672
+ "finish by hand"
673
+ ],
674
+ [
675
+ "4",
676
+ "verify clean"
677
+ ],
678
+ [
679
+ "5",
680
+ "was any of it the harness?"
681
+ ],
682
+ [
683
+ "",
684
+ "KB note format (OKF-lite — mandatory for every new note)"
685
+ ]
686
+ ],
687
+ "scripts": [
688
+ "check_doc_coverage.py"
689
+ ],
690
+ "noArgs": true,
691
+ "stage": "knowledge",
692
+ "daily": false
693
+ },
694
+ {
695
+ "name": "lld",
696
+ "description": "Generate Lower-Level Design (LLD) Markdown documentation and Confluence XHTML with native PlantUML diagrams.",
697
+ "hint": "(no arguments — documents the app in this repo)",
698
+ "steps": [],
699
+ "scripts": [
700
+ "convert_doc_to_confluence.py"
701
+ ],
702
+ "noArgs": true,
703
+ "stage": "plan",
704
+ "daily": false
705
+ },
706
+ {
707
+ "name": "mermaid-db",
708
+ "description": "Turn a SQL artifact (proc, view, query, .sql file, or table name) into a Mermaid diagram that explains it — git-diffable, saved as .md",
709
+ "hint": "[file path | object name | pasted SQL] [output path]",
710
+ "steps": [
711
+ [
712
+ "",
713
+ "Do this"
714
+ ]
715
+ ],
716
+ "scripts": [
717
+ "sql_to_graph.py"
718
+ ],
719
+ "noArgs": false,
720
+ "stage": "knowledge",
721
+ "daily": false
722
+ },
723
+ {
724
+ "name": "migrate-dir",
725
+ "description": "Rename this repo's legacy `.claudster/` artifact dir to `.caddis/` — dry-run first, `git mv` to keep history, merges a straggler dir, rewrites live refs. Opt-in, never automatic.",
726
+ "hint": "[target-repo] [--apply]",
727
+ "steps": [
728
+ [
729
+ "1",
730
+ "locate the migrator"
731
+ ],
732
+ [
733
+ "2",
734
+ "check the tree first (L1: shared worktrees)"
735
+ ],
736
+ [
737
+ "3",
738
+ "dry run"
739
+ ],
740
+ [
741
+ "4",
742
+ "apply"
743
+ ],
744
+ [
745
+ "5",
746
+ "verify, then commit"
747
+ ]
748
+ ],
749
+ "scripts": [
750
+ "caddis_migrate_dir.py"
751
+ ],
752
+ "noArgs": false,
753
+ "stage": "setup",
754
+ "daily": false
755
+ },
756
+ {
757
+ "name": "mmr",
758
+ "description": "Multi-Model Review & Runner (MMR) — run an ad-hoc task in an isolated multi-lane sandbox with rate-limit failover, test gates, and second-vendor review, or run a fast cross-model review on a diff",
759
+ "hint": "[\"task description\" | keep | drop | status | git-range]",
760
+ "steps": [
761
+ [
762
+ "",
763
+ "Three rules: one attempt, one review"
764
+ ],
765
+ [
766
+ "",
767
+ "Natural Language Triggers"
768
+ ],
769
+ [
770
+ "",
771
+ "Commands"
772
+ ],
773
+ [
774
+ "",
775
+ "Tool Resolution"
776
+ ]
777
+ ],
778
+ "scripts": [
779
+ "caddis_adhoc.py",
780
+ "caddis_gate.py"
781
+ ],
782
+ "noArgs": false,
783
+ "stage": "review",
784
+ "daily": false
785
+ },
786
+ {
787
+ "name": "park",
788
+ "description": "File a future-work item in the one backlog — .caddis/parking-lot/ — or list what is open",
789
+ "hint": "[--harness] <what to park> | list | done <slug> | drop <slug>",
790
+ "steps": [
791
+ [
792
+ "",
793
+ "Mode select"
794
+ ],
795
+ [
796
+ "",
797
+ "Harness mode — `--harness`"
798
+ ],
799
+ [
800
+ "",
801
+ "File mode"
802
+ ],
803
+ [
804
+ "",
805
+ "What happened"
806
+ ],
807
+ [
808
+ "",
809
+ "What it costs"
810
+ ],
811
+ [
812
+ "",
813
+ "Suggested fix"
814
+ ],
815
+ [
816
+ "",
817
+ "List mode"
818
+ ],
819
+ [
820
+ "",
821
+ "Close mode"
822
+ ]
823
+ ],
824
+ "scripts": [
825
+ "caddis_gate.py",
826
+ "caddis_harness_path.py",
827
+ "caddis_tidy.py"
828
+ ],
829
+ "noArgs": false,
830
+ "stage": "continuity",
831
+ "daily": false
832
+ },
833
+ {
834
+ "name": "pr-merge",
835
+ "description": "End-to-end pull request and merge lane — push feature branch, open or update PR, monitor CI to green, merge to default branch, and clean up the feature branch.",
836
+ "hint": "[PR title override — else derived from commits]",
837
+ "steps": [
838
+ [
839
+ "0",
840
+ "Detect the lane (before anything else)"
841
+ ],
842
+ [
843
+ "0b",
844
+ "Is this checkout safe to move?"
845
+ ],
846
+ [
847
+ "1",
848
+ "Refuse on the default branch"
849
+ ],
850
+ [
851
+ "2",
852
+ "Preflight (local gates mirroring CI)"
853
+ ],
854
+ [
855
+ "3",
856
+ "Scope-guard pre-check (before the PR exists)"
857
+ ],
858
+ [
859
+ "3b",
860
+ "Cross-review trigger (before anything is pushed)"
861
+ ],
862
+ [
863
+ "4",
864
+ "Rebase-safe currency"
865
+ ],
866
+ [
867
+ "5",
868
+ "Push + create or update the PR"
869
+ ],
870
+ [
871
+ "6",
872
+ "Monitor PR CI checks"
873
+ ]
874
+ ],
875
+ "scripts": [
876
+ "caddis_checkout_guard.py",
877
+ "caddis_gate.py",
878
+ "caddis_lanes.py",
879
+ "caddis_merge_chain.py",
880
+ "caddis_worktree_root.py"
881
+ ],
882
+ "noArgs": false,
883
+ "stage": "ship",
884
+ "daily": true
885
+ },
886
+ {
887
+ "name": "prd",
888
+ "description": "Capture requirements through structured discovery and write a PRD",
889
+ "hint": "<feature or problem>",
890
+ "steps": [
891
+ [
892
+ "",
893
+ "Discovery (ask, don't assume)"
894
+ ],
895
+ [
896
+ "",
897
+ "Headless mode"
898
+ ],
899
+ [
900
+ "",
901
+ "Write to `.caddis/prd/<feature-slug>.md`"
902
+ ],
903
+ [
904
+ "",
905
+ "Problem"
906
+ ],
907
+ [
908
+ "",
909
+ "Goal & success criteria"
910
+ ],
911
+ [
912
+ "",
913
+ "Functional requirements"
914
+ ],
915
+ [
916
+ "",
917
+ "Non-functional requirements"
918
+ ],
919
+ [
920
+ "",
921
+ "Out of scope"
922
+ ],
923
+ [
924
+ "",
925
+ "Data"
926
+ ]
927
+ ],
928
+ "scripts": [],
929
+ "noArgs": false,
930
+ "stage": "plan",
931
+ "daily": false
932
+ },
933
+ {
934
+ "name": "rca",
935
+ "description": "Record a root cause in one step — .caddis/rca/<date>-<slug>.md — or close one with the fixing commit",
936
+ "hint": "<symptom> | done <file>",
937
+ "steps": [
938
+ [
939
+ "",
940
+ "Mode select"
941
+ ],
942
+ [
943
+ "",
944
+ "File mode"
945
+ ],
946
+ [
947
+ "",
948
+ "Symptom"
949
+ ],
950
+ [
951
+ "",
952
+ "Root cause"
953
+ ],
954
+ [
955
+ "",
956
+ "How verified"
957
+ ],
958
+ [
959
+ "",
960
+ "Close mode — `done <file>`"
961
+ ]
962
+ ],
963
+ "scripts": [
964
+ "caddis_gate.py"
965
+ ],
966
+ "noArgs": false,
967
+ "stage": "knowledge",
968
+ "daily": false
969
+ },
970
+ {
971
+ "name": "review-pr",
972
+ "description": "Review someone else's OPEN pull request end to end — what changed, what CI says, what is risky — then approve or request changes. Never approves on its own.",
973
+ "hint": "[pr-number] [owner/repo]",
974
+ "steps": [
975
+ [
976
+ "",
977
+ "Absolute rule"
978
+ ],
979
+ [
980
+ "1",
981
+ ". Resolve the PR"
982
+ ],
983
+ [
984
+ "2",
985
+ ". Gather what the decision needs"
986
+ ],
987
+ [
988
+ "3",
989
+ ". Review the diff"
990
+ ],
991
+ [
992
+ "4",
993
+ ". Report, then hand over"
994
+ ]
995
+ ],
996
+ "scripts": [
997
+ "caddis_lanes.py"
998
+ ],
999
+ "noArgs": false,
1000
+ "stage": "review",
1001
+ "daily": false
1002
+ },
1003
+ {
1004
+ "name": "setup-project-ai",
1005
+ "description": "Install or refresh the agent-agnostic dev harness in this project (AGENTS.md-canonical rules hierarchy + CLAUDE.md @import shims, subagents, commands, settings)",
1006
+ "hint": "[--force] [project description]",
1007
+ "steps": [
1008
+ [
1009
+ "",
1010
+ "After the deterministic step — install the claude-oss / claude-glm launchers (optional)"
1011
+ ],
1012
+ [
1013
+ "",
1014
+ "After the deterministic step — deploy private harness skills (optional)"
1015
+ ]
1016
+ ],
1017
+ "scripts": [
1018
+ "setup_project_ai.py"
1019
+ ],
1020
+ "noArgs": false,
1021
+ "stage": "setup",
1022
+ "daily": false
1023
+ },
1024
+ {
1025
+ "name": "ship-merge",
1026
+ "description": "Merge an already-green, already-reviewed PR behind an explicit deploy-confirm, monitor the deploy, validate prod, then clean up the branch — only on green.",
1027
+ "hint": "[PR number or URL — else inferred from the current branch's open PR]",
1028
+ "steps": [
1029
+ [
1030
+ "0",
1031
+ "Detect the lane, resolve the PR"
1032
+ ],
1033
+ [
1034
+ "0b",
1035
+ "Is this checkout safe to move?"
1036
+ ],
1037
+ [
1038
+ "1",
1039
+ "Refuse unless green + mergeable + reviewed"
1040
+ ],
1041
+ [
1042
+ "2",
1043
+ "Explicit human-confirm gate (the deploy warning)"
1044
+ ],
1045
+ [
1046
+ "",
1047
+ "Programme triggers"
1048
+ ],
1049
+ [
1050
+ "3",
1051
+ "Merge"
1052
+ ],
1053
+ [
1054
+ "4",
1055
+ "Monitor the deploy"
1056
+ ],
1057
+ [
1058
+ "5",
1059
+ "Post-deploy validation"
1060
+ ],
1061
+ [
1062
+ "6",
1063
+ "Branch cleanup — only after a confirmed-green deploy"
1064
+ ]
1065
+ ],
1066
+ "scripts": [
1067
+ "caddis_checkout_guard.py",
1068
+ "caddis_lanes.py",
1069
+ "caddis_merge_chain.py",
1070
+ "caddis_worktree_root.py"
1071
+ ],
1072
+ "noArgs": false,
1073
+ "stage": "ship",
1074
+ "daily": true
1075
+ },
1076
+ {
1077
+ "name": "ship-pr",
1078
+ "description": "Open a reviewed PR for the current feature branch — rebase-safe push, PR create/update, monitor CI, STOP at green. Never merges, never deploys (that's /ship-merge).",
1079
+ "hint": "[PR title override]",
1080
+ "steps": [
1081
+ [
1082
+ "0",
1083
+ "Detect the lane (before anything else)"
1084
+ ],
1085
+ [
1086
+ "0b",
1087
+ "Is this checkout safe to move?"
1088
+ ],
1089
+ [
1090
+ "1",
1091
+ "Refuse on the default branch"
1092
+ ],
1093
+ [
1094
+ "2",
1095
+ "Preflight (local gates mirroring CI)"
1096
+ ],
1097
+ [
1098
+ "2b",
1099
+ "Tidy check on this PR's files (before the PR exists)"
1100
+ ],
1101
+ [
1102
+ "3",
1103
+ "Scope-guard pre-check (before the PR exists)"
1104
+ ],
1105
+ [
1106
+ "3b",
1107
+ "Cross-review trigger (before anything is pushed)"
1108
+ ],
1109
+ [
1110
+ "4",
1111
+ "Rebase-safe currency"
1112
+ ],
1113
+ [
1114
+ "5",
1115
+ "Push + create/update the PR"
1116
+ ]
1117
+ ],
1118
+ "scripts": [
1119
+ "caddis_checkout_guard.py",
1120
+ "caddis_gate.py",
1121
+ "caddis_lanes.py",
1122
+ "caddis_tidy.py",
1123
+ "caddis_worktree_root.py"
1124
+ ],
1125
+ "noArgs": false,
1126
+ "stage": "ship",
1127
+ "daily": true
1128
+ },
1129
+ {
1130
+ "name": "ship",
1131
+ "description": "Commit, push, and monitor the deploy pipeline (auto-detects Gitea, GitHub Actions, or local-only)",
1132
+ "hint": "[commit message]",
1133
+ "steps": [
1134
+ [
1135
+ "0",
1136
+ "Detect the pipeline (do this before anything else)"
1137
+ ],
1138
+ [
1139
+ "",
1140
+ "Steps 1–3 — common to every lane"
1141
+ ],
1142
+ [
1143
+ "4",
1144
+ "MONITOR CI (lane-specific)"
1145
+ ],
1146
+ [
1147
+ "5",
1148
+ "PROD / POST-DEPLOY VALIDATION"
1149
+ ],
1150
+ [
1151
+ "6",
1152
+ "REPORT"
1153
+ ],
1154
+ [
1155
+ "",
1156
+ "Programme triggers"
1157
+ ]
1158
+ ],
1159
+ "scripts": [
1160
+ "caddis_gate.py",
1161
+ "caddis_lanes.py",
1162
+ "caddis_merge_chain.py",
1163
+ "caddis_prod_check.py"
1164
+ ],
1165
+ "noArgs": false,
1166
+ "stage": "ship",
1167
+ "daily": false
1168
+ },
1169
+ {
1170
+ "name": "spawn-session",
1171
+ "description": "Hand the WORK to a fresh session — generate the handover from the repo, then validate the successor by re-deriving its answers",
1172
+ "hint": "<name-of-the-session-you-just-started> <what it should work on first>",
1173
+ "steps": [
1174
+ [
1175
+ "",
1176
+ "The failure this exists to catch"
1177
+ ],
1178
+ [
1179
+ "",
1180
+ "Start the successor FIRST, then name it"
1181
+ ],
1182
+ [
1183
+ "",
1184
+ "The capture ORDER — it is an order, not a list"
1185
+ ],
1186
+ [
1187
+ "",
1188
+ "Round 0 — validate your OWN handover. No relay trip."
1189
+ ],
1190
+ [
1191
+ "",
1192
+ "Round 1 — the questions. One relay trip."
1193
+ ],
1194
+ [
1195
+ "",
1196
+ "The verdict — three, not two"
1197
+ ],
1198
+ [
1199
+ "",
1200
+ "Round 2 — the first task, scoped small, reviewed. One relay trip."
1201
+ ],
1202
+ [
1203
+ "",
1204
+ "The parent's ending"
1205
+ ],
1206
+ [
1207
+ "",
1208
+ "Files — all three committed"
1209
+ ]
1210
+ ],
1211
+ "scripts": [
1212
+ "caddis_inventory.py",
1213
+ "caddis_spawn.py"
1214
+ ],
1215
+ "noArgs": false,
1216
+ "stage": "continuity",
1217
+ "daily": false
1218
+ },
1219
+ {
1220
+ "name": "tdd",
1221
+ "description": "Run a strict red-green-refactor TDD cycle for a unit of behavior",
1222
+ "hint": "<behavior to build>",
1223
+ "steps": [
1224
+ [
1225
+ "",
1226
+ "The cycle — do not skip or reorder"
1227
+ ]
1228
+ ],
1229
+ "scripts": [],
1230
+ "noArgs": false,
1231
+ "stage": "build",
1232
+ "daily": false
1233
+ },
1234
+ {
1235
+ "name": "ui-brief",
1236
+ "description": "Design-first UI brief — lock the aesthetic before writing any code",
1237
+ "hint": "<what you're building, e.g. \"dashboard for NPS scores\" or \"login page\">",
1238
+ "steps": [
1239
+ [
1240
+ "",
1241
+ "What you're building"
1242
+ ],
1243
+ [
1244
+ "1",
1245
+ "Load the right skill"
1246
+ ],
1247
+ [
1248
+ "2",
1249
+ "Propose the brief (3 things only)"
1250
+ ],
1251
+ [
1252
+ "3",
1253
+ "Wait"
1254
+ ],
1255
+ [
1256
+ "4",
1257
+ "Build"
1258
+ ]
1259
+ ],
1260
+ "scripts": [],
1261
+ "noArgs": false,
1262
+ "stage": "plan",
1263
+ "daily": false
1264
+ },
1265
+ {
1266
+ "name": "usage-review",
1267
+ "description": "Review local caddis usage over a window, surface prioritised recommendations, and apply config changes in one step",
1268
+ "hint": "[days]",
1269
+ "steps": [
1270
+ [
1271
+ "1",
1272
+ "run the analysis script"
1273
+ ],
1274
+ [
1275
+ "2",
1276
+ "present the report"
1277
+ ],
1278
+ [
1279
+ "2b",
1280
+ "check the borrowed upstream skills"
1281
+ ],
1282
+ [
1283
+ "3",
1284
+ "offer to apply"
1285
+ ],
1286
+ [
1287
+ "4",
1288
+ "report outcome"
1289
+ ],
1290
+ [
1291
+ "5",
1292
+ "do NOT offer to schedule this as a cloud routine"
1293
+ ]
1294
+ ],
1295
+ "scripts": [
1296
+ "usage_review.py"
1297
+ ],
1298
+ "noArgs": false,
1299
+ "stage": "setup",
1300
+ "daily": false
1301
+ },
1302
+ {
1303
+ "name": "use-model",
1304
+ "description": "Explain (or apply) the model lanes — claude / claude-glm / cross-review — key resolution, and how to add a provider",
1305
+ "hint": "[provider name, e.g. glm | deepseek | openrouter]",
1306
+ "steps": [
1307
+ [
1308
+ "",
1309
+ "The lanes"
1310
+ ],
1311
+ [
1312
+ "",
1313
+ "Run it"
1314
+ ],
1315
+ [
1316
+ "",
1317
+ "Key resolution (never hardcoded)"
1318
+ ],
1319
+ [
1320
+ "",
1321
+ "Adding a provider (or overriding one)"
1322
+ ],
1323
+ [
1324
+ "",
1325
+ "First-time install"
1326
+ ],
1327
+ [
1328
+ "",
1329
+ "Exit codes"
1330
+ ]
1331
+ ],
1332
+ "scripts": [
1333
+ "oss_model.py"
1334
+ ],
1335
+ "noArgs": false,
1336
+ "stage": "setup",
1337
+ "daily": false
1338
+ },
1339
+ {
1340
+ "name": "version",
1341
+ "description": "Report the installed caddis version",
1342
+ "hint": "(no arguments — prints the installed caddis version)",
1343
+ "steps": [],
1344
+ "scripts": [],
1345
+ "noArgs": true,
1346
+ "stage": "setup",
1347
+ "daily": false
1348
+ }
1349
+ ],
1350
+ "agents": [
1351
+ {
1352
+ "name": "anchor",
1353
+ "description": "Use this agent for evidence-first verification of high-risk work — hotfixes, security-sensitive changes, DB migrations, or anything where correctness matters more than speed. Captures a baseline, verifies the change against it, and returns a structured Evidence Bundle with pushback. Read-only verification; it does NOT implement — coding stays in the main thread.",
1354
+ "tools": [
1355
+ "Read",
1356
+ "Grep",
1357
+ "Glob",
1358
+ "Bash"
1359
+ ],
1360
+ "model": "opus",
1361
+ "writes": false
1362
+ },
1363
+ {
1364
+ "name": "claude-md-curator",
1365
+ "description": "Use this agent periodically (every few weeks, or when any AGENTS.md exceeds ~200 lines) to prune and consolidate the project's AGENTS.md rules files (the canonical rules; CLAUDE.md is a thin @AGENTS.md import shim). Flags staleness, bloat, duplication, misrouted how-to content, and CLAUDE.md shims that have grown rules of their own. Proposes a curated version — never writes without showing the diff to the main thread first.",
1366
+ "tools": [
1367
+ "Read",
1368
+ "Grep",
1369
+ "Glob"
1370
+ ],
1371
+ "model": "sonnet",
1372
+ "writes": false
1373
+ },
1374
+ {
1375
+ "name": "code-reviewer",
1376
+ "description": "Use this agent to review a diff or set of changes for correctness, security, and convention adherence. Use proactively after a phase is green and before commit/merge. Reads the diff and relevant files in its own context and returns a verdict + prioritized issue list — it does NOT edit code.",
1377
+ "tools": [
1378
+ "Read",
1379
+ "Glob",
1380
+ "Grep",
1381
+ "Bash"
1382
+ ],
1383
+ "model": "sonnet",
1384
+ "writes": false
1385
+ },
1386
+ {
1387
+ "name": "codebase-audit",
1388
+ "description": "Use this agent to systematically audit an unfamiliar codebase before architecture, a major feature, or refactoring. Use proactively when entering a project you haven't worked in this session. Reads broadly in its own context and returns an audit-findings report plus open questions — read-only; it does NOT change code.",
1389
+ "tools": [
1390
+ "Read",
1391
+ "Grep",
1392
+ "Glob",
1393
+ "Bash"
1394
+ ],
1395
+ "model": "sonnet",
1396
+ "writes": false
1397
+ },
1398
+ {
1399
+ "name": "data-engineer",
1400
+ "description": "Use this agent to design or review an ETL/ELT pipeline or data contract — source-to-target mapping, transformations, ingestion, validation. Use proactively when adding a data pipeline, integrating a new source, or auditing data-layer design. Analyzes in its own context and returns a design + suggested code — it does NOT edit code; the main thread implements.",
1401
+ "tools": [
1402
+ "Read",
1403
+ "Grep",
1404
+ "Glob",
1405
+ "Bash"
1406
+ ],
1407
+ "model": "sonnet",
1408
+ "writes": false
1409
+ },
1410
+ {
1411
+ "name": "debug",
1412
+ "description": "Use this agent to diagnose a bug's root cause and return a fix plan. Use proactively when a test fails, an error/stack trace appears, or behavior is wrong and the cause is unknown. Reproduces and isolates in its own context, then returns root cause + suggested fix + regression test — it does NOT edit code; the main thread applies the fix.",
1413
+ "tools": [
1414
+ "Read",
1415
+ "Grep",
1416
+ "Glob",
1417
+ "Bash"
1418
+ ],
1419
+ "model": "sonnet",
1420
+ "writes": false
1421
+ },
1422
+ {
1423
+ "name": "knowledge-transfer",
1424
+ "description": "Use this agent after a completed implementation or debugging session to capture durable lessons and write them into the project's live knowledge docs before context is lost. Extracts non-obvious learnings and writes them to the right long-lived files (instructions, runbooks, AGENTS.md — the canonical rules file), with a session log as a secondary record. Writes knowledge docs only — never production code.",
1425
+ "tools": [
1426
+ "Read",
1427
+ "Grep",
1428
+ "Glob",
1429
+ "Edit",
1430
+ "Write"
1431
+ ],
1432
+ "model": "sonnet",
1433
+ "writes": true
1434
+ },
1435
+ {
1436
+ "name": "preflight",
1437
+ "description": "Use this agent to validate an implementation plan (or a phase of it) against the ACTUAL codebase before writing code. Use proactively right after a plan is drafted and before starting a phase. Checks that every technical claim in the plan — file paths, symbol names, API shapes, data fields, dependencies — matches reality. Read-only; returns a PASS/FAIL report. Does not fix anything.",
1438
+ "tools": [
1439
+ "Read",
1440
+ "Glob",
1441
+ "Grep",
1442
+ "Bash"
1443
+ ],
1444
+ "model": "sonnet",
1445
+ "writes": false
1446
+ },
1447
+ {
1448
+ "name": "security-analyst",
1449
+ "description": "Use this agent to assess code or a change for security vulnerabilities using OWASP methodology. Use proactively for auth/crypto/PII-touching code, before merging security-sensitive changes, or when the user asks for a security review. Reads the code in its own context and returns a severity-ranked findings report — it does NOT edit code; the main thread applies fixes.",
1450
+ "tools": [
1451
+ "Read",
1452
+ "Grep",
1453
+ "Glob",
1454
+ "Bash"
1455
+ ],
1456
+ "model": "opus",
1457
+ "writes": false
1458
+ },
1459
+ {
1460
+ "name": "sql-expert",
1461
+ "description": "Use this agent to design, review, or optimize SQL — schema, queries, stored procedures, indexing. Use proactively for slow queries, new schema/migration design, or before shipping hand-written SQL. Analyzes in its own context and returns a review + suggested SQL with rationale — it does NOT edit code; the main thread applies it.",
1462
+ "tools": [
1463
+ "Read",
1464
+ "Grep",
1465
+ "Glob",
1466
+ "Bash"
1467
+ ],
1468
+ "model": "sonnet",
1469
+ "writes": false
1470
+ },
1471
+ {
1472
+ "name": "tester",
1473
+ "description": "Use this agent to author and run tests for a change and report pass/fail. Use proactively after implementing a phase, or to add coverage. Runs the suite in its own context and returns a compact result block (pass/fail counts + failures), keeping the main thread clean. Enforces TDD discipline and the project's test conventions.",
1474
+ "tools": [
1475
+ "Read",
1476
+ "Glob",
1477
+ "Grep",
1478
+ "Edit",
1479
+ "Write",
1480
+ "Bash"
1481
+ ],
1482
+ "model": "sonnet",
1483
+ "writes": true
1484
+ },
1485
+ {
1486
+ "name": "ui-design-reviewer",
1487
+ "description": "Use this agent to critique a running UI's aesthetics, UX, and accessibility. Give it a URL (and optionally a design-doc path). It screenshots the app at desktop + mobile viewports, reads the images, and returns structured findings. Does NOT edit code. Use proactively after a frontend phase is complete, before shipping.",
1488
+ "tools": [
1489
+ "Bash",
1490
+ "Read",
1491
+ "Glob",
1492
+ "Grep"
1493
+ ],
1494
+ "model": "sonnet",
1495
+ "writes": false
1496
+ }
1497
+ ],
1498
+ "skills": [
1499
+ {
1500
+ "name": "aws-agentic-ai",
1501
+ "category": "cloud",
1502
+ "description": "AWS Bedrock AgentCore expert: deploy and manage Gateway, Runtime, Memory, Identity, MCP targets and credentials. Use when working with any AgentCore component.",
1503
+ "core": false
1504
+ },
1505
+ {
1506
+ "name": "aws-cdk-development",
1507
+ "category": "cloud",
1508
+ "description": "AWS CDK infrastructure as code in TypeScript/Python: stacks, constructs, deployment. Use when the user mentions CDK, CloudFormation, IaC, cdk synth, cdk deploy, or wants to define AWS infrastructure in code.",
1509
+ "core": false
1510
+ },
1511
+ {
1512
+ "name": "aws-cost-operations",
1513
+ "category": "cloud",
1514
+ "description": "AWS cost optimization, monitoring and operations, with MCP servers for billing analysis, cost estimation, observability and security assessment.",
1515
+ "core": false
1516
+ },
1517
+ {
1518
+ "name": "aws-serverless-eda",
1519
+ "category": "cloud",
1520
+ "description": "AWS serverless and event-driven architecture. Use when the user mentions serverless, Lambda, API Gateway, DynamoDB, Step Functions, EventBridge, SQS, SNS, event-driven, async processing, queues or pub/sub.",
1521
+ "core": false
1522
+ },
1523
+ {
1524
+ "name": "building-ai-agent-on-cloudflare",
1525
+ "category": "cloud",
1526
+ "description": "|",
1527
+ "core": false
1528
+ },
1529
+ {
1530
+ "name": "building-mcp-server-on-cloudflare",
1531
+ "category": "cloud",
1532
+ "description": "|",
1533
+ "core": false
1534
+ },
1535
+ {
1536
+ "name": "adopt-rbac",
1537
+ "category": "coding",
1538
+ "description": ">-",
1539
+ "core": false
1540
+ },
1541
+ {
1542
+ "name": "anchor-review",
1543
+ "category": "coding",
1544
+ "description": "Single-model adversarial review technique — 3-lens analysis with confidence scoring and self-challenge",
1545
+ "core": false
1546
+ },
1547
+ {
1548
+ "name": "api-client-patterns",
1549
+ "category": "coding",
1550
+ "description": "Typed client-side API consumption: fetch wrappers, zod validation, auth injection, TanStack Query (useQuery, useMutation, optimistic updates), tRPC, OpenAPI codegen, pagination. Use when consuming REST or tRPC APIs.",
1551
+ "core": false
1552
+ },
1553
+ {
1554
+ "name": "api-design",
1555
+ "category": "coding",
1556
+ "description": "REST and GraphQL API design: endpoints, resource schemas, versioning, pagination, error responses, OpenAPI. Use when designing or reviewing API contracts.",
1557
+ "core": true
1558
+ },
1559
+ {
1560
+ "name": "architecture-design",
1561
+ "category": "coding",
1562
+ "description": "Design application architecture and system diagrams with layered patterns, Mermaid C4 diagrams, SQL Server data platform, and on-premise deployment considerations.",
1563
+ "core": false
1564
+ },
1565
+ {
1566
+ "name": "backend-development",
1567
+ "category": "coding",
1568
+ "description": "Backend API design, database schemas, microservices and TDD. Use for backend system architecture.",
1569
+ "core": true
1570
+ },
1571
+ {
1572
+ "name": "backend-to-frontend-handoff-docs",
1573
+ "category": "coding",
1574
+ "description": "Document a finished backend API for frontend integration. Use when the user says 'create handoff', 'document API', 'frontend handoff', or 'API documentation'.",
1575
+ "core": false
1576
+ },
1577
+ {
1578
+ "name": "caching-patterns",
1579
+ "category": "coding",
1580
+ "description": "Caching strategies for Streamlit and FastAPI applications",
1581
+ "core": false
1582
+ },
1583
+ {
1584
+ "name": "case-management",
1585
+ "category": "coding",
1586
+ "description": ">-",
1587
+ "core": false
1588
+ },
1589
+ {
1590
+ "name": "code-explainer",
1591
+ "category": "coding",
1592
+ "description": "Explain code with diagrams, analogies and step-by-step walkthroughs. Use when teaching a codebase or answering \"how does this work?\"",
1593
+ "core": false
1594
+ },
1595
+ {
1596
+ "name": "code-review",
1597
+ "category": "coding",
1598
+ "description": "Automated code review for quality, security, performance and best practices. Use when reviewing code changes, PRs, or doing code audits.",
1599
+ "core": true
1600
+ },
1601
+ {
1602
+ "name": "codebase-audit",
1603
+ "category": "coding",
1604
+ "description": "Audit an unfamiliar codebase before architecture or implementation work. Use for a new codebase, pre-implementation audit, codebase review, technical due diligence or onboarding. Produces AUDIT-FINDINGS.md and QUESTIONS.md.",
1605
+ "core": true
1606
+ },
1607
+ {
1608
+ "name": "cross-review",
1609
+ "category": "coding",
1610
+ "description": "Have a different vendor's model (agy Argon by default; DeepSeek, GLM, any OpenAI-compatible endpoint) review the current diff. Use after a phase is green and before commit/merge, or for a second opinion on a risky diff.",
1611
+ "core": false
1612
+ },
1613
+ {
1614
+ "name": "dashboard-perf-sweep",
1615
+ "category": "coding",
1616
+ "description": "Re-measure dashboard/API endpoints for load-time regressions and decide by checklist if a slow one needs the rs-kit refresher, an index, keyset paging, gzip, or nothing. Use when the user says \"sweep dashboard performance\", \"check if this app needs rs-kit\", \"re-measure the perf tracker\", \"is this endpoint a refresher candidate\", or dashboard-performance-tracker.md is stale. Read-only.",
1617
+ "core": true
1618
+ },
1619
+ {
1620
+ "name": "error-handling",
1621
+ "category": "coding",
1622
+ "description": "Error handling for Python and TypeScript: error hierarchies, custom exceptions, result types, retries, circuit breakers, error boundaries, logging, user-facing messages.",
1623
+ "core": true
1624
+ },
1625
+ {
1626
+ "name": "fastapi-dev",
1627
+ "category": "coding",
1628
+ "description": "Build FastAPI backends with standard patterns, error handling, and testing",
1629
+ "core": true
1630
+ },
1631
+ {
1632
+ "name": "javascript-typescript",
1633
+ "category": "coding",
1634
+ "description": "JavaScript and TypeScript development with ES6+, Node.js, React, and modern web frameworks. Use for frontend, backend, or full-stack JavaScript/TypeScript projects.",
1635
+ "core": true
1636
+ },
1637
+ {
1638
+ "name": "llm-application-dev",
1639
+ "category": "coding",
1640
+ "description": "LLM applications: prompt engineering, RAG and LLM integration. Use for AI-powered features, chatbots or LLM automation.",
1641
+ "core": false
1642
+ },
1643
+ {
1644
+ "name": "mcp-builder",
1645
+ "category": "coding",
1646
+ "description": "Build high-quality MCP (Model Context Protocol) servers that let LLMs use external APIs and services, in Python (FastMCP) or Node/TypeScript (MCP SDK).",
1647
+ "core": false
1648
+ },
1649
+ {
1650
+ "name": "observability",
1651
+ "category": "coding",
1652
+ "description": "Structured logging, correlation IDs, PII redaction, OpenTelemetry tracing, metrics (RED), SLO alerting, health probes and Sentry, in Python and TypeScript. Use when adding logs, traces, metrics or error tracking.",
1653
+ "core": false
1654
+ },
1655
+ {
1656
+ "name": "python-development",
1657
+ "category": "coding",
1658
+ "description": "Modern Python 3.12+ (Django, FastAPI, async) with production best practices. Use for Python projects, APIs, data processing or scripts.",
1659
+ "core": false
1660
+ },
1661
+ {
1662
+ "name": "refactoring",
1663
+ "category": "coding",
1664
+ "description": "Safely refactor code while maintaining behavior. Use when improving code structure, reducing duplication, extracting functions, or modernizing legacy code.",
1665
+ "core": true
1666
+ },
1667
+ {
1668
+ "name": "security-review",
1669
+ "category": "coding",
1670
+ "description": "Security review workflow — OWASP, code scanning, cloud infrastructure",
1671
+ "core": true
1672
+ },
1673
+ {
1674
+ "name": "sql",
1675
+ "category": "coding",
1676
+ "description": "Write optimized, secure, readable SQL: performance, NULL handling, dialect-specific notes.",
1677
+ "core": true
1678
+ },
1679
+ {
1680
+ "name": "understand-anything",
1681
+ "category": "coding",
1682
+ "description": ">",
1683
+ "core": false
1684
+ },
1685
+ {
1686
+ "name": "data-analysis",
1687
+ "category": "data",
1688
+ "description": "Analyze datasets and generate insights with a systematic 5-phase workflow. Use when user provides data for analysis, asks about patterns, or needs visualizations.",
1689
+ "core": false
1690
+ },
1691
+ {
1692
+ "name": "data-loader",
1693
+ "category": "data",
1694
+ "description": "Load Excel, JSON or CSV files into any database (SQL Server, PostgreSQL, MySQL, SQLite and others). Use when importing data files into a database.",
1695
+ "core": false
1696
+ },
1697
+ {
1698
+ "name": "data-validation",
1699
+ "category": "data",
1700
+ "description": "Data quality and validation for ETL, API inputs and pipelines: validation rules, schema validation, data contracts, Pydantic, Great Expectations, SQL constraints.",
1701
+ "core": false
1702
+ },
1703
+ {
1704
+ "name": "database-design",
1705
+ "category": "data",
1706
+ "description": "Database schema design, migrations and query optimization for PostgreSQL, MySQL and NoSQL.",
1707
+ "core": true
1708
+ },
1709
+ {
1710
+ "name": "db-diagram",
1711
+ "category": "data",
1712
+ "description": "Diagram a SQL artifact (stored proc, view, query, .sql file, table) as Mermaid or Excalidraw. Use when the user says \"diagram this query/proc/view/schema\", \"explain this SQL visually\", \"draw the ER diagram\", \"show me the data flow of this stored proc\", \"/mermaid-db\", or \"/excalidraw-db\". Read-only.",
1713
+ "core": true
1714
+ },
1715
+ {
1716
+ "name": "db-testing",
1717
+ "category": "data",
1718
+ "description": "Test, debug, and validate database connectivity and queries. Use when diagnosing connection errors, testing configurations, or validating queries before deployment.",
1719
+ "core": false
1720
+ },
1721
+ {
1722
+ "name": "schema-migration",
1723
+ "category": "data",
1724
+ "description": "Migrate an app's data access layer when tables or columns are renamed, merged or split: update queries, mappings and abstractions without data loss. Read-only against the database.",
1725
+ "core": false
1726
+ },
1727
+ {
1728
+ "name": "adopt-app",
1729
+ "category": "devops",
1730
+ "description": ">-",
1731
+ "core": true
1732
+ },
1733
+ {
1734
+ "name": "changelog-generator",
1735
+ "category": "devops",
1736
+ "description": "Create user-facing changelogs and release notes from git commit history, grouping changes and rewriting technical commits in plain language.",
1737
+ "core": false
1738
+ },
1739
+ {
1740
+ "name": "ci-cd-pipeline",
1741
+ "category": "devops",
1742
+ "description": "CI/CD pipelines for GitHub Actions and Azure DevOps: build and deploy workflows, quality gates, environment promotion and release automation.",
1743
+ "core": true
1744
+ },
1745
+ {
1746
+ "name": "deploy-local",
1747
+ "category": "devops",
1748
+ "description": "Local deployment loop for Gitea-hosted projects: commit on dev, push, watch the golden CI/build/deploy workflow, check prod, and fix lint/test/pipeline failures until the deploy is healthy.",
1749
+ "core": false
1750
+ },
1751
+ {
1752
+ "name": "gh-cli",
1753
+ "category": "devops",
1754
+ "description": "GitHub CLI operations — issues, PRs, releases, and repo management",
1755
+ "core": true
1756
+ },
1757
+ {
1758
+ "name": "git-commit",
1759
+ "category": "devops",
1760
+ "description": "Create well-structured conventional commit messages following Conventional Commits standard. Use when committing changes, preparing PRs, or generating changelogs.",
1761
+ "core": true
1762
+ },
1763
+ {
1764
+ "name": "monorepo",
1765
+ "category": "devops",
1766
+ "description": "Turborepo and pnpm workspaces: turbo.json tasks, remote caching, shared packages, affected-only CI, apps/ vs packages/ layout, and pitfalls like circular deps, version drift and hoisting.",
1767
+ "core": false
1768
+ },
1769
+ {
1770
+ "name": "port-to-github",
1771
+ "category": "devops",
1772
+ "description": ">-",
1773
+ "core": true
1774
+ },
1775
+ {
1776
+ "name": "runner-move",
1777
+ "category": "devops",
1778
+ "description": ">-",
1779
+ "core": false
1780
+ },
1781
+ {
1782
+ "name": "safe-cleanup",
1783
+ "category": "devops",
1784
+ "description": "Use BEFORE deleting a directory tree, scratchpad or git worktree, or \"tidying up\" generated folders, especially on Windows, where deleting through a junction or symlink destroys its target; and to verify a venv or node_modules survived.",
1785
+ "core": true
1786
+ },
1787
+ {
1788
+ "name": "update-readme",
1789
+ "category": "devops",
1790
+ "description": "Detect feature commits and update README sections (Features, API, Usage) to match, then stage only the README. Use when features, routes or components were added.",
1791
+ "core": false
1792
+ },
1793
+ {
1794
+ "name": "using-git-worktrees",
1795
+ "category": "devops",
1796
+ "description": "Use when starting feature work that needs isolation from the current workspace, or before executing an implementation plan: creates an isolated git worktree safely.",
1797
+ "core": true
1798
+ },
1799
+ {
1800
+ "name": "windows-deployment",
1801
+ "category": "devops",
1802
+ "description": "Deploy FastAPI + React/Vite apps to Windows Server with NSSM services, IIS or nginx reverse proxy and git-pull. Use for Windows prod deploys, NSSM, reverse proxy setup, dev/prod config, or prod troubleshooting.",
1803
+ "core": true
1804
+ },
1805
+ {
1806
+ "name": "architecture-document",
1807
+ "category": "docs",
1808
+ "description": "Generate enterprise HLD and LLD documents from the living Architecture.md, as DOCX (editable) or PPTX (executive summary).",
1809
+ "core": false
1810
+ },
1811
+ {
1812
+ "name": "code-documentation",
1813
+ "category": "docs",
1814
+ "description": "Write code documentation: API docs, README files, inline comments and developer guides.",
1815
+ "core": true
1816
+ },
1817
+ {
1818
+ "name": "confluence-hla",
1819
+ "category": "docs",
1820
+ "description": "High-Level Architecture (HLA) documents in Simplified Technical English as Confluence Storage Format XHTML with PlantUML. Use for Confluence architecture docs or converting markdown architecture.",
1821
+ "core": true
1822
+ },
1823
+ {
1824
+ "name": "doc-coauthoring",
1825
+ "category": "docs",
1826
+ "description": "Structured workflow for co-authoring documentation: transfer context, refine by iteration, test it on readers. Use when the user is writing docs, proposals, technical specs or decision docs.",
1827
+ "core": false
1828
+ },
1829
+ {
1830
+ "name": "documentation-analyzer",
1831
+ "category": "docs",
1832
+ "description": "Analyze a codebase, explain what the code does, and generate documentation such as README files.",
1833
+ "core": false
1834
+ },
1835
+ {
1836
+ "name": "explainer-doc",
1837
+ "category": "docs",
1838
+ "description": "Hand-off doc for a team that did NOT do the investigation (vendor, contractor, another team) — the \"stranger must follow it alone\" case. Use when the user says \"write a spec for the X team\", \"document this for someone outside the team\", \"explainer doc\", \"implementation spec for a vendor\", or \"hand this off to Y\". Not for readers with full context.",
1839
+ "core": true
1840
+ },
1841
+ {
1842
+ "name": "hld",
1843
+ "category": "docs",
1844
+ "description": "Generate High-Level Design (HLD) Markdown and convert it to Confluence Storage Format XHTML with PlantUML diagrams and legends.",
1845
+ "core": false
1846
+ },
1847
+ {
1848
+ "name": "lld",
1849
+ "category": "docs",
1850
+ "description": "Generate Lower-Level Design (LLD) Markdown and convert it to Confluence Storage Format XHTML with PlantUML diagrams and legends.",
1851
+ "core": false
1852
+ },
1853
+ {
1854
+ "name": "naming-analyzer",
1855
+ "category": "docs",
1856
+ "description": "Suggest better variable, function, and class names based on context and conventions.",
1857
+ "core": false
1858
+ },
1859
+ {
1860
+ "name": "office-documents-official",
1861
+ "category": "docs",
1862
+ "description": "Hint for Office and PDF file work. Use when the user asks to create, edit, read or convert a Word .docx, PDF, PowerPoint .pptx or Excel .xlsx file. caddis does not ship these skills; points to Anthropic's official document-skills plugin.",
1863
+ "core": true
1864
+ },
1865
+ {
1866
+ "name": "prd-to-code",
1867
+ "category": "docs",
1868
+ "description": "Turn a PRD into working application code with a 6-phase method. Use when starting a project from requirements or specs.",
1869
+ "core": false
1870
+ },
1871
+ {
1872
+ "name": "tech-explainer",
1873
+ "category": "docs",
1874
+ "description": ">-",
1875
+ "core": true
1876
+ },
1877
+ {
1878
+ "name": "technical-writing",
1879
+ "category": "docs",
1880
+ "description": "Documentation best practices for READMEs, API docs, architecture docs, runbooks and developer guides. Use when writing or reviewing docs or setting documentation standards.",
1881
+ "core": true
1882
+ },
1883
+ {
1884
+ "name": "writing-plans",
1885
+ "category": "docs",
1886
+ "description": "Use when you have a spec or requirements for a multi-step task, before touching code. In caddis, plans are written with /caddis:feature-plan, the only plan writer; this skill sends you there.",
1887
+ "core": true
1888
+ },
1889
+ {
1890
+ "name": "algorithmic-art",
1891
+ "category": "frontend",
1892
+ "description": "Generative and algorithmic art with p5.js: flow fields, particle systems, animations, WebGL, audio-reactive visuals; exports HTML, PNG, GIF, MP4, SVG. Use for creative coding or any p5.js visual.",
1893
+ "core": false
1894
+ },
1895
+ {
1896
+ "name": "artifacts-builder",
1897
+ "category": "frontend",
1898
+ "description": "Build elaborate multi-component claude.ai HTML artifacts with React, Tailwind CSS and shadcn/ui. Use for complex artifacts with state or routing, not simple single-file HTML.",
1899
+ "core": false
1900
+ },
1901
+ {
1902
+ "name": "banner-design",
1903
+ "category": "frontend",
1904
+ "description": "Design banners for social media, ads, website heroes and print, in 22 styles, sized for Facebook, X, LinkedIn, YouTube, Instagram and Google Display.",
1905
+ "core": false
1906
+ },
1907
+ {
1908
+ "name": "brand-design",
1909
+ "category": "frontend",
1910
+ "description": "Brand design: logos, corporate identity (CIP) mockups, SVG icons and social media visuals. Use for logo, CIP, icon or social visual design tasks.",
1911
+ "core": false
1912
+ },
1913
+ {
1914
+ "name": "brand-guidelines",
1915
+ "category": "frontend",
1916
+ "description": "Apply brand colors and typography to artifacts. Use when brand colors, style guidelines or company design standards apply.",
1917
+ "core": false
1918
+ },
1919
+ {
1920
+ "name": "brand-voice",
1921
+ "category": "frontend",
1922
+ "description": "Brand voice, tone, messaging frameworks and brand consistency. Use for branded content, marketing assets, brand compliance and style guides.",
1923
+ "core": false
1924
+ },
1925
+ {
1926
+ "name": "canvas-design",
1927
+ "category": "frontend",
1928
+ "description": "Create original static visual art as .png or .pdf from a design philosophy. Use when the user asks for a poster, piece of art, design or other static visual.",
1929
+ "core": false
1930
+ },
1931
+ {
1932
+ "name": "css-architecture",
1933
+ "category": "frontend",
1934
+ "description": "CSS architecture: design tokens, custom properties, Tailwind config, CSS Modules, container queries, dark mode, fluid typography, animation. Covers how to implement styling; frontend-design covers what to achieve.",
1935
+ "core": true
1936
+ },
1937
+ {
1938
+ "name": "design-md",
1939
+ "category": "frontend",
1940
+ "description": "Google's DESIGN.md spec for describing a visual identity to coding agents: YAML tokens, Markdown rationale, CLI for WCAG checks and DTCG/Tailwind export. Use for agent-readable design system docs.",
1941
+ "core": false
1942
+ },
1943
+ {
1944
+ "name": "design-system-tokens",
1945
+ "category": "frontend",
1946
+ "description": "Design token architecture (primitive → semantic → component), CSS variables, spacing and type scales, component state specs. Use when creating design tokens.",
1947
+ "core": false
1948
+ },
1949
+ {
1950
+ "name": "enterprise-dashboard-aesthetic-system",
1951
+ "category": "frontend",
1952
+ "description": "Use when upgrading or harmonizing React/Vite enterprise dashboards: executive analytics UI, cohesive dashboard design systems, tasteful motion, polished data-heavy pages (FastAPI + React + Tailwind + shadcn).",
1953
+ "core": false
1954
+ },
1955
+ {
1956
+ "name": "flow-studio",
1957
+ "category": "frontend",
1958
+ "description": "Design an interactive flow, lifecycle or journey page (nodes, lanes, links, motion, inspector, notes) from a JSON model as a self-contained demo, then build it in an app. Use for lineage, pipelines, ticket or agent journeys.",
1959
+ "core": true
1960
+ },
1961
+ {
1962
+ "name": "frontend-design",
1963
+ "category": "frontend",
1964
+ "description": "Create distinctive, production-grade frontend interfaces that avoid generic AI aesthetics. Use when the user asks to build web components, pages, artifacts, posters or applications.",
1965
+ "core": true
1966
+ },
1967
+ {
1968
+ "name": "mockup",
1969
+ "category": "frontend",
1970
+ "description": "Create framework-aware UI mockups with feasibility checks. Prevents wasted effort by validating that proposed designs work within the target framework's constraints.",
1971
+ "core": true
1972
+ },
1973
+ {
1974
+ "name": "nextjs-app-router",
1975
+ "category": "frontend",
1976
+ "description": "Next.js App Router: Server vs Client Components, SSR/RSC, Server Actions, Middleware, data fetching, generateMetadata, route handlers, layout/page/error/loading.tsx, route groups, parallel routes, hydration issues.",
1977
+ "core": false
1978
+ },
1979
+ {
1980
+ "name": "popular-web-designs",
1981
+ "category": "frontend",
1982
+ "description": "54 real-world design systems (Stripe, Linear, Vercel, Apple, Notion and more) as HTML/CSS reference: colors, type, components, spacing. Use when UI should match a specific company's look.",
1983
+ "core": false
1984
+ },
1985
+ {
1986
+ "name": "react-best-practices",
1987
+ "category": "frontend",
1988
+ "description": "Modern React development guidelines covering hooks, component patterns, state management, performance optimization, and TypeScript integration.",
1989
+ "core": true
1990
+ },
1991
+ {
1992
+ "name": "react-dev",
1993
+ "category": "frontend",
1994
+ "description": "Type-safe React 18-19 with TypeScript: components, generic components, hooks, events, Server Components, TanStack Router and React Router. Use when React TypeScript or React 19 is involved.",
1995
+ "core": true
1996
+ },
1997
+ {
1998
+ "name": "react-useeffect",
1999
+ "category": "frontend",
2000
+ "description": "React useEffect best practices from the official docs: when NOT to use an Effect, derived state, data fetching, synchronization. Use when writing or reviewing useEffect.",
2001
+ "core": false
2002
+ },
2003
+ {
2004
+ "name": "responsive-mobile-native",
2005
+ "category": "frontend",
2006
+ "description": ">",
2007
+ "core": false
2008
+ },
2009
+ {
2010
+ "name": "shadcn-radix",
2011
+ "category": "frontend",
2012
+ "description": "shadcn/ui and Radix UI: setup (shadcn add, components.json), theming, react-hook-form + zod forms, TanStack Table data tables, cva variants, command palette, date picker, combobox, drawer/sheet.",
2013
+ "core": false
2014
+ },
2015
+ {
2016
+ "name": "sketch",
2017
+ "category": "frontend",
2018
+ "description": "Generate 2-3 interactive HTML design variants to compare UI directions before production code. Use for early design exploration or when asked to \"sketch this screen\" or \"show me variants\".",
2019
+ "core": false
2020
+ },
2021
+ {
2022
+ "name": "slides",
2023
+ "category": "frontend",
2024
+ "description": "Create strategic HTML presentations with Chart.js, design tokens, responsive layouts, copywriting formulas, and contextual slide strategies.",
2025
+ "core": false
2026
+ },
2027
+ {
2028
+ "name": "streamlit-dev",
2029
+ "category": "frontend",
2030
+ "description": "Build production Streamlit dashboards: caching, components, theming. Use for any Streamlit page, component, chart or UI feature.",
2031
+ "core": false
2032
+ },
2033
+ {
2034
+ "name": "theme-factory",
2035
+ "category": "frontend",
2036
+ "description": "Style artifacts (slides, docs, reports, HTML pages) with one of 10 preset themes or a newly generated theme.",
2037
+ "core": false
2038
+ },
2039
+ {
2040
+ "name": "ui-review",
2041
+ "category": "frontend",
2042
+ "description": "Review a UI against design requirements, WCAG 2.2 AA and brand guidelines. Use when validating UI before release.",
2043
+ "core": true
2044
+ },
2045
+ {
2046
+ "name": "ui-styling-patterns",
2047
+ "category": "frontend",
2048
+ "description": "Accessible UIs with shadcn/ui, Radix and Tailwind CSS: responsive layouts, theming, dark mode and consistent styling.",
2049
+ "core": false
2050
+ },
2051
+ {
2052
+ "name": "ui-ux-intelligence",
2053
+ "category": "frontend",
2054
+ "description": "Data-backed UI/UX decisions from CSV knowledge bases: 50+ styles, 161 palettes, 57 font pairings, UX guidelines, chart types. Use to look up palettes, font pairs or style guidance.",
2055
+ "core": false
2056
+ },
2057
+ {
2058
+ "name": "warm-editorial-ui",
2059
+ "category": "frontend",
2060
+ "description": "Apply the \"Warm Editorial Refinement\" design system (warm cream/charcoal surfaces, Bahnschrift + Plus Jakarta Sans, layered shadows), the canonical template for new frontend builds. Use for apps, dashboards or UI in the abc-project style, or on \"use our design system\", \"apply our template\", \"make it look like abc-project\", \"use the warm editorial style\", \"use our brand template\", \"add dark mode\", or a new tool for XYZ Brand.",
2061
+ "core": true
2062
+ },
2063
+ {
2064
+ "name": "webapp-development",
2065
+ "category": "frontend",
2066
+ "description": "End-to-end web application development workflow with brand theming and standard patterns",
2067
+ "core": false
2068
+ },
2069
+ {
2070
+ "name": "word-cloud",
2071
+ "category": "frontend",
2072
+ "description": "Generate static or animated word clouds from any text source (PDF, DOCX, XLSX, PPTX, HTML, CSV, TXT), with theming, sentiment coloring and shape masks.",
2073
+ "core": false
2074
+ },
2075
+ {
2076
+ "name": "architecture-diagram",
2077
+ "category": "media",
2078
+ "description": "Dark-themed architecture diagrams as self-contained HTML/SVG, no external tools. Use for system, cloud, microservice and deployment diagrams.",
2079
+ "core": false
2080
+ },
2081
+ {
2082
+ "name": "ascii-art",
2083
+ "category": "media",
2084
+ "description": "Create ASCII art (banners, borders, image conversion, custom art), choosing between pyfiglet, cowsay, TOIlet, boxes and more.",
2085
+ "core": false
2086
+ },
2087
+ {
2088
+ "name": "draw-io",
2089
+ "category": "media",
2090
+ "description": "draw.io diagram creation, editing, and review. Use for .drawio XML editing, PNG conversion, layout adjustment, and AWS icon usage.",
2091
+ "core": true
2092
+ },
2093
+ {
2094
+ "name": "excalidraw",
2095
+ "category": "media",
2096
+ "description": "Brand-themed Excalidraw diagrams for project documentation",
2097
+ "core": false
2098
+ },
2099
+ {
2100
+ "name": "flow-chart-from-counts",
2101
+ "category": "media",
2102
+ "description": "Turn a from-to-count edge list into a zoomable Mermaid flow chart page with counts, a legend and a render check.",
2103
+ "core": true
2104
+ },
2105
+ {
2106
+ "name": "mermaid-diagrams",
2107
+ "category": "media",
2108
+ "description": "Software diagrams in Mermaid: class, sequence, flowchart, ERD, C4, state, git graph, gantt. Use for domain models, API flows, processes and database schemas.",
2109
+ "core": true
2110
+ },
2111
+ {
2112
+ "name": "particle-art",
2113
+ "category": "media",
2114
+ "description": ">-",
2115
+ "core": true
2116
+ },
2117
+ {
2118
+ "name": "plantuml",
2119
+ "category": "media",
2120
+ "description": "Brand-themed PlantUML diagrams for project documentation",
2121
+ "core": false
2122
+ },
2123
+ {
2124
+ "name": "svg-create",
2125
+ "category": "media",
2126
+ "description": "Brand-themed SVG diagrams with consistent color palette and accessible design",
2127
+ "core": false
2128
+ },
2129
+ {
2130
+ "name": "github-issues",
2131
+ "category": "productivity",
2132
+ "description": "Create well-structured GitHub issues with proper labels, descriptions, and acceptance criteria. Use when creating bug reports, feature requests, or tracking tasks.",
2133
+ "core": false
2134
+ },
2135
+ {
2136
+ "name": "internal-comms",
2137
+ "category": "productivity",
2138
+ "description": "Write internal communications in company formats: status reports, leadership updates, newsletters, FAQs, incident reports, project updates.",
2139
+ "core": false
2140
+ },
2141
+ {
2142
+ "name": "jira-issues",
2143
+ "category": "productivity",
2144
+ "description": "Create, update and manage Jira issues from natural language: log bugs, create tickets, update status, manage the backlog.",
2145
+ "core": false
2146
+ },
2147
+ {
2148
+ "name": "component-testing",
2149
+ "category": "testing",
2150
+ "description": "React component tests with Vitest, Testing Library, userEvent, renderHook and MSW: setup, queries, hooks, API mocking, snapshots, loading/error states. E2E is playwright; method is tdd-workflow.",
2151
+ "core": false
2152
+ },
2153
+ {
2154
+ "name": "performance-testing",
2155
+ "category": "testing",
2156
+ "description": "Performance and load testing for APIs, databases and web apps: budgets, profiling, scalability, with Locust, k6 and pytest-benchmark.",
2157
+ "core": false
2158
+ },
2159
+ {
2160
+ "name": "playwright",
2161
+ "category": "testing",
2162
+ "description": "Browser automation and testing with Playwright: auto-detects dev servers; tests pages, forms, logins, links, screenshots and responsive layouts. Use to test websites or automate any browser task.",
2163
+ "core": true
2164
+ },
2165
+ {
2166
+ "name": "tdd-workflow",
2167
+ "category": "testing",
2168
+ "description": "Test-Driven Development workflow — red-green-refactor cycle",
2169
+ "core": true
2170
+ },
2171
+ {
2172
+ "name": "test-strategy",
2173
+ "category": "testing",
2174
+ "description": "Plan what to test: test types, coverage goals, test pyramid, quality gates. Produces a prioritized TEST-STRATEGY.md for the Tester agent.",
2175
+ "core": true
2176
+ },
2177
+ {
2178
+ "name": "ui-testing",
2179
+ "category": "testing",
2180
+ "description": "Create automated UI tests using Playwright for Streamlit and web applications. Use when writing end-to-end tests, automating UI testing, or testing new features.",
2181
+ "core": false
2182
+ },
2183
+ {
2184
+ "name": "webapp-testing",
2185
+ "category": "testing",
2186
+ "description": "Test local web apps with Playwright: verify frontend behavior, debug UI, capture screenshots and browser logs.",
2187
+ "core": true
2188
+ },
2189
+ {
2190
+ "name": "agent-md-refactor",
2191
+ "category": "workflow",
2192
+ "description": "Refactor bloated agent instruction files (AGENTS.md, .cursorrules, .github/ files) into linked, progressively disclosed docs.",
2193
+ "core": false
2194
+ },
2195
+ {
2196
+ "name": "agent-orchestration",
2197
+ "category": "workflow",
2198
+ "description": "Blueprint for orchestrating the agent pipeline from spec to planning, implementation, testing and debugging, plus when a second model is worth it, the intent→model map and cost guardrails.",
2199
+ "core": false
2200
+ },
2201
+ {
2202
+ "name": "ask-questions-if-underspecified",
2203
+ "category": "workflow",
2204
+ "description": "Clarify requirements before implementing. Do not use automatically, only when invoked explicitly.",
2205
+ "core": false
2206
+ },
2207
+ {
2208
+ "name": "best-practices",
2209
+ "category": "workflow",
2210
+ "description": ">-",
2211
+ "core": true
2212
+ },
2213
+ {
2214
+ "name": "brainstorming",
2215
+ "category": "workflow",
2216
+ "description": "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.",
2217
+ "core": true
2218
+ },
2219
+ {
2220
+ "name": "context-curator",
2221
+ "category": "workflow",
2222
+ "description": "Compress and prioritize codebase context before handing work to reasoning agents, minimizing token waste while preserving the required decision inputs.",
2223
+ "core": true
2224
+ },
2225
+ {
2226
+ "name": "data-contract-pipeline",
2227
+ "category": "workflow",
2228
+ "description": "Build, audit and validate data-to-UI contracts. Use when the user mentions data mapping, UI lineage, DB-to-UI, DisplayDTOs, source-to-screen mapping, data contracts, schema drift, typed API responses, mockup grounding, or asks whether a UI is backed by real data.",
2229
+ "core": false
2230
+ },
2231
+ {
2232
+ "name": "developer-growth-analysis",
2233
+ "category": "workflow",
2234
+ "description": "Analyze recent Claude Code chat history for coding patterns and gaps, find learning resources on HackerNews, and send a growth report to Slack DMs.",
2235
+ "core": false
2236
+ },
2237
+ {
2238
+ "name": "file-organizer",
2239
+ "category": "workflow",
2240
+ "description": "Organize files and folders by context: find duplicates, suggest better structures, automate cleanup.",
2241
+ "core": false
2242
+ },
2243
+ {
2244
+ "name": "game-changing-features",
2245
+ "category": "workflow",
2246
+ "description": "Find 10x product opportunities and high-leverage features. Use when the user mentions '10x', says 'what would make this 10x better', 'product strategy', or 'what should we build next'.",
2247
+ "core": false
2248
+ },
2249
+ {
2250
+ "name": "golden-nuggets",
2251
+ "category": "workflow",
2252
+ "description": "Extract durable tribal knowledge ('gold nuggets') from a codebase or changed files and route each to an instruction file, runbook, hub or CI review inbox. Use after a feature, fix, sprint, incident or release.",
2253
+ "core": false
2254
+ },
2255
+ {
2256
+ "name": "intent-writer",
2257
+ "category": "workflow",
2258
+ "description": "Structure freetext ideas, backlog items, or vague requirements into a formal Intent Document that preserves user intent across the entire agent pipeline chain.",
2259
+ "core": false
2260
+ },
2261
+ {
2262
+ "name": "preflight",
2263
+ "category": "workflow",
2264
+ "description": "Plan-vs-codebase validation — verifies API contracts, type names, field accuracy, dependencies, and paths before implementation begins",
2265
+ "core": true
2266
+ },
2267
+ {
2268
+ "name": "receiving-code-review",
2269
+ "category": "workflow",
2270
+ "description": "Use when receiving code review feedback, before implementing it, especially if it seems unclear or wrong: verify with technical rigor, no performative agreement or blind implementation.",
2271
+ "core": false
2272
+ },
2273
+ {
2274
+ "name": "roadmap",
2275
+ "category": "workflow",
2276
+ "description": "Track milestones across plans in .caddis/roadmaps/<slug>/: next batch, typed blockers, rollup. Every change is a docs PR via caddis_roadmap.py.",
2277
+ "core": true
2278
+ },
2279
+ {
2280
+ "name": "setup-project-ai",
2281
+ "category": "workflow",
2282
+ "description": "Install or refresh the agent-agnostic harness in a project: AGENTS.md rules with CLAUDE.md shims, subagents, commands and settings. Use when setting up AI resources on a project, or the user says 'set up the harness', 'setup-project-ai', 'generate CLAUDE.md', 'onboard this project to Claude Code / Codex / agy', or runs /setup-project-ai.",
2283
+ "core": false
2284
+ },
2285
+ {
2286
+ "name": "skill-creator",
2287
+ "category": "workflow",
2288
+ "description": "Create, edit and improve skills, run evals and benchmarks, and optimize a skill's description for triggering accuracy.",
2289
+ "core": true
2290
+ },
2291
+ {
2292
+ "name": "verification-loop",
2293
+ "category": "workflow",
2294
+ "description": "Systematic code change verification — lint, test, type-check, review",
2295
+ "core": false
2296
+ }
2297
+ ],
2298
+ "hooks": [
2299
+ {
2300
+ "event": "PreToolUse",
2301
+ "matcher": "Bash|PowerShell|Edit|Write|MultiEdit|Read|Grep",
2302
+ "handler": "guard.py"
2303
+ },
2304
+ {
2305
+ "event": "PreToolUse",
2306
+ "matcher": "Write|Edit|MultiEdit",
2307
+ "handler": "doc_header_guard.py"
2308
+ },
2309
+ {
2310
+ "event": "SessionStart",
2311
+ "matcher": "(every)",
2312
+ "handler": "inject_relay.py"
2313
+ },
2314
+ {
2315
+ "event": "SessionStart",
2316
+ "matcher": "(every)",
2317
+ "handler": "repo_freshness.py"
2318
+ },
2319
+ {
2320
+ "event": "SessionStart",
2321
+ "matcher": "(every)",
2322
+ "handler": "caddis_statusline.py"
2323
+ },
2324
+ {
2325
+ "event": "PreCompact",
2326
+ "matcher": "(every)",
2327
+ "handler": "inject_relay.py"
2328
+ },
2329
+ {
2330
+ "event": "Stop",
2331
+ "matcher": "(every)",
2332
+ "handler": "session_end.py"
2333
+ },
2334
+ {
2335
+ "event": "Stop",
2336
+ "matcher": "(every)",
2337
+ "handler": "session_waiting.py"
2338
+ },
2339
+ {
2340
+ "event": "SubagentStop",
2341
+ "matcher": "(every)",
2342
+ "handler": "agent_log.py"
2343
+ },
2344
+ {
2345
+ "event": "PostToolUse",
2346
+ "matcher": "Edit|Write|MultiEdit",
2347
+ "handler": "auto_lint.py"
2348
+ },
2349
+ {
2350
+ "event": "PostToolUse",
2351
+ "matcher": "Edit|Write|MultiEdit",
2352
+ "handler": "rules_budget_nudge.py"
2353
+ },
2354
+ {
2355
+ "event": "PostToolUse",
2356
+ "matcher": "Bash|PowerShell|Read|Grep|Agent|Task|WebFetch",
2357
+ "handler": "context_size.py"
2358
+ },
2359
+ {
2360
+ "event": "SessionEnd",
2361
+ "matcher": "(every)",
2362
+ "handler": "session_end.py"
2363
+ },
2364
+ {
2365
+ "event": "SessionEnd",
2366
+ "matcher": "(every)",
2367
+ "handler": "session_waiting.py"
2368
+ },
2369
+ {
2370
+ "event": "Notification",
2371
+ "matcher": "(every)",
2372
+ "handler": "session_waiting.py"
2373
+ },
2374
+ {
2375
+ "event": "UserPromptSubmit",
2376
+ "matcher": "(every)",
2377
+ "handler": "session_waiting.py"
2378
+ },
2379
+ {
2380
+ "event": "UserPromptSubmit",
2381
+ "matcher": "(every)",
2382
+ "handler": "context_size.py"
2383
+ }
2384
+ ],
2385
+ "coverage": {
2386
+ "commands": [
2387
+ "antigravity-plugin",
2388
+ "claude",
2389
+ "codex-plugin"
2390
+ ],
2391
+ "skills": [
2392
+ "antigravity",
2393
+ "antigravity-plugin",
2394
+ "claude",
2395
+ "codex",
2396
+ "codex-plugin",
2397
+ "copilot"
2398
+ ],
2399
+ "agents": [
2400
+ "antigravity-plugin",
2401
+ "claude",
2402
+ "codex-plugin",
2403
+ "copilot"
2404
+ ]
2405
+ },
2406
+ "counts": {
2407
+ "commands": 39,
2408
+ "agents": 12,
2409
+ "skills": 133,
2410
+ "core": 50,
2411
+ "hooks": 17
2412
+ }
2413
+ }