heimdall-agent 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (231) hide show
  1. package/README.md +57 -26
  2. package/README.pt-BR.md +429 -0
  3. package/agents/cloud-engineer.md +77 -0
  4. package/agents/code-sentinel.md +66 -35
  5. package/agents/database-architect.md +31 -25
  6. package/agents/frontend-designer.md +30 -28
  7. package/agents/mobile-designer.md +25 -24
  8. package/agents/modernizer.md +66 -0
  9. package/agents/orchestrator.md +94 -93
  10. package/agents/reviewer.md +100 -71
  11. package/agents/security-auditor.md +27 -27
  12. package/agents/tester.md +97 -90
  13. package/commands/grill-me.md +20 -4
  14. package/commands/orchestrate.md +16 -0
  15. package/commands/orchestrator.md +16 -0
  16. package/commands/plan.md +17 -1
  17. package/config/agents.json +21 -3
  18. package/config/mcp.json +72 -0
  19. package/config/models.json +26 -16
  20. package/config/profiles.json +2 -4
  21. package/config/skills.json +210 -100
  22. package/docs/SKILLS.md +341 -245
  23. package/docs/designs/old/2026-10-31 plan-lifecycle-backlog-and-clean-code-skill.md +87 -0
  24. package/docs/designs/old/2026-11-02 skill-upstream-audit-and-update.md +105 -0
  25. package/docs/designs/old/2026-11-05 communication-doctrine-bluf-ste.md +94 -0
  26. package/docs/designs/old/2026-11-06-cloud-engineer-and-resilience-synthesis.md +67 -0
  27. package/docs/designs/old/2026-11-06-herdr-native-agent-orchestration.md +45 -0
  28. package/docs/runs/skill-audit/add_progressive_disclosure.cjs +30 -0
  29. package/docs/runs/skill-audit/check_heimdall_skills.ps1 +9 -0
  30. package/docs/runs/skill-audit/compare_classics.ps1 +26 -0
  31. package/docs/runs/skill-audit/compare_taste.ps1 +12 -0
  32. package/docs/runs/skill-audit/customization-report.json +380 -0
  33. package/docs/runs/skill-audit/diff_pending_skills.cjs +94 -0
  34. package/docs/runs/skill-audit/fetch_and_apply_skill.cjs +58 -0
  35. package/docs/runs/skill-audit/fetch_and_apply_taste_v2.cjs +65 -0
  36. package/docs/runs/skill-audit/inspect_pending_skills.cjs +71 -0
  37. package/docs/runs/skill-audit/inventory.json +308 -0
  38. package/docs/runs/skill-audit/list_local_taste.ps1 +1 -0
  39. package/docs/runs/skill-audit/phase5-update-plan.json +595 -0
  40. package/docs/runs/skill-audit/phase5-update-plan.md +138 -0
  41. package/docs/runs/skill-audit/probe.ps1 +16 -0
  42. package/docs/runs/skill-audit/probe_classics_branches.ps1 +3 -0
  43. package/docs/runs/skill-audit/probe_commits.ps1 +15 -0
  44. package/docs/runs/skill-audit/probe_repos.ps1 +17 -0
  45. package/docs/runs/skill-audit/probe_sentry_sec.ps1 +3 -0
  46. package/docs/runs/skill-audit/probe_sentry_sweep.ps1 +5 -0
  47. package/docs/runs/skill-audit/probe_snyk.ps1 +3 -0
  48. package/docs/runs/skill-audit/probe_snyk_recipes.ps1 +5 -0
  49. package/docs/runs/skill-audit/probe_taste_branches.ps1 +8 -0
  50. package/docs/runs/skill-audit/probe_taste_v19.ps1 +3 -0
  51. package/docs/runs/skill-audit/probe_user_repos.ps1 +19 -0
  52. package/docs/runs/skill-audit/prune_taste_skills.cjs +22 -0
  53. package/docs/runs/skill-audit/run_phase1_2.cjs +142 -0
  54. package/docs/runs/skill-audit/run_phase6_verification.cjs +107 -0
  55. package/docs/runs/skill-audit/show_16_details.ps1 +25 -0
  56. package/docs/runs/skill-audit/show_20_skills.ps1 +28 -0
  57. package/docs/runs/skill-audit/show_classics_diff.cjs +37 -0
  58. package/docs/runs/skill-audit/sync_agent_markdowns.cjs +30 -0
  59. package/docs/runs/skill-audit/taste-skill-upstream.md +542 -0
  60. package/docs/runs/skill-audit/update-manifest.md +88 -0
  61. package/docs/runs/skill-audit/update_config_skills.cjs +52 -0
  62. package/docs/runs/skill-audit/update_registry_phase7.cjs +83 -0
  63. package/docs/runs/skill-audit/upstream-status.json +563 -0
  64. package/docs/runs/skill-audit/verification-results.json +252 -0
  65. package/doctrine/AGENTS.md +39 -77
  66. package/hooks/git/pre-commit +11 -0
  67. package/hooks/heimdall-hook.cjs +81 -2
  68. package/hooks/herdr-agent-state.ps1 +55 -0
  69. package/hooks/hooks.json +0 -11
  70. package/lib/catalog-sync.cjs +162 -0
  71. package/lib/hermes-context.cjs +57 -0
  72. package/lib/model-context.cjs +123 -0
  73. package/lib/path-discovery.cjs +94 -0
  74. package/package.json +7 -3
  75. package/playbooks/01-interactive-grilling-gate.md +14 -1
  76. package/playbooks/02-fast-code-deep-verification.md +3 -2
  77. package/playbooks/03-adversarial-code-review.md +3 -3
  78. package/playbooks/05-canonical-plan-template.md +32 -18
  79. package/playbooks/06-model-registry-matrix.md +24 -13
  80. package/playbooks/07-legacy-code-modernization.md +74 -0
  81. package/playbooks/08-backlog-and-change-request-flow.md +122 -0
  82. package/setup.mjs +592 -172
  83. package/skills/antislop/SKILL.md +76 -56
  84. package/skills/antislop/VERSION +1 -0
  85. package/skills/antislop-copywriting/SKILL.md +372 -372
  86. package/skills/antislop-human/LICENSE-web-quality-skills +21 -0
  87. package/skills/antislop-human/SKILL.md +204 -147
  88. package/skills/antislop-human/contrast-check.py +168 -165
  89. package/skills/antislop-human/contrast-mcp.py +6 -3
  90. package/skills/antislop-human/references/A11Y-PATTERNS.md +249 -0
  91. package/skills/antislop-human/references/WCAG.md +127 -0
  92. package/skills/antislop-ui/LICENSE-web-quality-skills +21 -0
  93. package/skills/antislop-ui/SKILL.md +344 -304
  94. package/skills/antislop-ui/references/CORE-WEB-VITALS.md +181 -0
  95. package/skills/antislop-ui/references/WEB-BASELINE.md +28 -0
  96. package/skills/brainstorming/SKILL.md +274 -265
  97. package/skills/brainstorming/builder-check-prompt.md +23 -0
  98. package/skills/brainstorming/scripts/frame-template.html +213 -213
  99. package/skills/brainstorming/scripts/server.cjs +723 -723
  100. package/skills/brandkit/SKILL.md +798 -798
  101. package/skills/brutalist-skill/SKILL.md +93 -92
  102. package/skills/caveman/README.md +68 -0
  103. package/skills/caveman/SKILL.md +73 -38
  104. package/skills/claude-collaborator/SKILL.md +24 -44
  105. package/skills/clean-code/SKILL.md +152 -0
  106. package/skills/cloudflare-security-audit/AI-AND-LLM.md +83 -83
  107. package/skills/cloudflare-security-audit/ATTACK-CLASSES.md +130 -130
  108. package/skills/cloudflare-security-audit/CLIENT-SIDE.md +83 -83
  109. package/skills/cloudflare-security-audit/CLOUD-AND-DEPLOYMENT.md +86 -86
  110. package/skills/cloudflare-security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -84
  111. package/skills/cloudflare-security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -89
  112. package/skills/cloudflare-security-audit/HUNTING.md +251 -251
  113. package/skills/cloudflare-security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -101
  114. package/skills/cloudflare-security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -81
  115. package/skills/cloudflare-security-audit/RECONNAISSANCE.md +156 -156
  116. package/skills/cloudflare-security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -78
  117. package/skills/cloudflare-security-audit/SKILL.md +192 -192
  118. package/skills/cloudflare-security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -73
  119. package/skills/cloudflare-security-audit/VALIDATION-AND-REPORTING.md +186 -186
  120. package/skills/cloudflare-security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -105
  121. package/skills/cloudflare-security-audit/report-schema.json +461 -461
  122. package/skills/cloudflare-security-audit/validate-coverage-ledger.cjs +872 -872
  123. package/skills/cloudflare-security-audit/validate-coverage-ledger.test.cjs +740 -740
  124. package/skills/cloudflare-security-audit/validate-findings.cjs +773 -773
  125. package/skills/cloudflare-security-audit/validate-findings.test.cjs +652 -652
  126. package/skills/codex-collaborator/SKILL.md +24 -45
  127. package/skills/communication-doctrine/SKILL.md +89 -0
  128. package/skills/diagnosing-superpowers/SKILL.md +1 -1
  129. package/skills/diagnosing-superpowers/references/github-issues.md +3 -3
  130. package/skills/diagnosing-superpowers/templates/issue.md +23 -4
  131. package/skills/executing-plans/SKILL.md +0 -52
  132. package/skills/executing-plans/scripts/task-done +52 -52
  133. package/skills/executing-plans/scripts/task-start +28 -28
  134. package/skills/gemini-collaborator/SKILL.md +24 -56
  135. package/skills/herdr/SKILL.md +243 -0
  136. package/skills/image-to-code-skill/SKILL.md +1228 -1228
  137. package/skills/imagegen-frontend-mobile/SKILL.md +1465 -1465
  138. package/skills/imagegen-frontend-web/SKILL.md +987 -987
  139. package/skills/karpathy-guidelines/SKILL.md +67 -67
  140. package/skills/mcp-engineering/SKILL.md +74 -0
  141. package/skills/minimalist-skill/SKILL.md +87 -85
  142. package/skills/output-skill/SKILL.md +49 -49
  143. package/skills/ponytail/SKILL.md +36 -52
  144. package/skills/postgres-best-practices/SKILL.md +30 -52
  145. package/skills/postgres-best-practices/references/backup-restore.md +372 -0
  146. package/skills/postgres-best-practices/references/bulk-loading.md +315 -0
  147. package/skills/postgres-best-practices/references/connection-pooling.md +310 -0
  148. package/skills/postgres-best-practices/references/hot-standby.md +221 -0
  149. package/skills/postgres-best-practices/references/indexing.md +318 -0
  150. package/skills/postgres-best-practices/references/logical-replication.md +610 -0
  151. package/skills/postgres-best-practices/references/major-version-upgrades.md +334 -0
  152. package/skills/postgres-best-practices/references/performance-diagnostics.md +553 -0
  153. package/skills/postgres-best-practices/references/query-optimization.md +294 -0
  154. package/skills/postgres-best-practices/references/query-patterns.md +566 -0
  155. package/skills/postgres-best-practices/references/schema-design.md +362 -0
  156. package/skills/postgres-best-practices/references/security-roles.md +489 -0
  157. package/skills/postgres-best-practices/references/transaction-isolation.md +344 -0
  158. package/skills/progressive-disclosure/SKILL.md +68 -0
  159. package/skills/pstack-discipline/SKILL.md +40 -0
  160. package/skills/receiving-code-review/SKILL.md +2 -23
  161. package/skills/requesting-code-review/SKILL.md +7 -36
  162. package/skills/soft-skill/SKILL.md +99 -98
  163. package/skills/stitch-skill/DESIGN.md +121 -121
  164. package/skills/stitch-skill/SKILL.md +185 -184
  165. package/skills/strix-security/SKILL.md +54 -53
  166. package/skills/subagent-driven-development/SKILL.md +28 -260
  167. package/skills/subagent-driven-development/references/batching.md +11 -0
  168. package/skills/subagent-driven-development/references/cannot-verify.md +10 -0
  169. package/skills/subagent-driven-development/references/final-review.md +47 -0
  170. package/skills/subagent-driven-development/references/fix-loop.md +77 -0
  171. package/skills/subagent-driven-development/references/handling-reports.md +15 -0
  172. package/skills/subagent-driven-development/references/preflight.md +26 -0
  173. package/skills/subagent-driven-development/references/resuming.md +12 -0
  174. package/skills/subagent-driven-development/scripts/review-package +53 -53
  175. package/skills/subagent-driven-development/scripts/sdd-workspace +87 -82
  176. package/skills/subagent-driven-development/scripts/task-brief +43 -43
  177. package/skills/systematic-debugging/SKILL.md +283 -306
  178. package/skills/taste-skill/SKILL.md +542 -1206
  179. package/skills/taste-skill/references/app-screens.md +1199 -0
  180. package/skills/taste-skill/references/colour.md +141 -0
  181. package/skills/taste-skill/references/copy.md +177 -0
  182. package/skills/taste-skill/references/critique.md +182 -0
  183. package/skills/taste-skill/references/imagery.md +791 -0
  184. package/skills/taste-skill/references/layout.md +292 -0
  185. package/skills/taste-skill/references/motion.md +980 -0
  186. package/skills/taste-skill/references/research.md +356 -0
  187. package/skills/taste-skill/references/scenes.md +174 -0
  188. package/skills/taste-skill/references/tells.md +115 -0
  189. package/skills/taste-skill/references/type.md +170 -0
  190. package/skills/test-driven-development/SKILL.md +330 -337
  191. package/skills/thermo/SKILL.md +67 -0
  192. package/skills/threat-modeling/SKILL.md +55 -0
  193. package/skills/trailofbits-audit-context/SKILL.md +72 -72
  194. package/skills/trailofbits-insecure-defaults/commands/audit.md +35 -0
  195. package/skills/trailofbits-insecure-defaults/references/debug-features.json +13 -13
  196. package/skills/trailofbits-insecure-defaults/references/debug-features.md +75 -75
  197. package/skills/trailofbits-insecure-defaults/references/default-credentials.json +12 -12
  198. package/skills/trailofbits-insecure-defaults/references/default-credentials.md +76 -76
  199. package/skills/trailofbits-insecure-defaults/references/fail-open-security.json +11 -11
  200. package/skills/trailofbits-insecure-defaults/references/fail-open-security.md +70 -70
  201. package/skills/trailofbits-insecure-defaults/references/fallback-secrets.json +11 -11
  202. package/skills/trailofbits-insecure-defaults/references/fallback-secrets.md +70 -70
  203. package/skills/trailofbits-insecure-defaults/references/permissive-access.json +13 -13
  204. package/skills/trailofbits-insecure-defaults/references/permissive-access.md +62 -62
  205. package/skills/trailofbits-insecure-defaults/references/weak-crypto.json +13 -13
  206. package/skills/trailofbits-insecure-defaults/references/weak-crypto.md +71 -71
  207. package/skills/trailofbits-triage-brocards/SKILL.md +208 -208
  208. package/skills/verification-before-completion/SKILL.md +0 -14
  209. package/skills/writing-plans/SKILL.md +11 -15
  210. package/skills/writing-skills/SKILL.md +21 -303
  211. package/skills/writing-skills/references/CLAUDE_MD_TESTING.md +189 -0
  212. package/skills/writing-skills/references/anthropic-best-practices.md +1150 -0
  213. package/skills/writing-skills/references/bulletproofing.md +80 -0
  214. package/skills/writing-skills/references/discovery.md +201 -0
  215. package/skills/writing-skills/references/flowcharts.md +37 -0
  216. package/skills/writing-skills/references/graphviz-conventions.dot +172 -0
  217. package/skills/writing-skills/references/persuasion-principles.md +187 -0
  218. package/skills/writing-skills/references/testing-skills-with-subagents.md +384 -0
  219. package/tools/{claude-bridge.ps1 → archive/claude-bridge.ps1} +10 -7
  220. package/tools/{codex-bridge.ps1 → archive/codex-bridge.ps1} +1 -1
  221. package/tools/{gemini-bridge.ps1 → archive/gemini-bridge.ps1} +12 -19
  222. package/skills/gpt-tasteskill/SKILL.md +0 -74
  223. package/skills/taste-skill-v1/SKILL.md +0 -226
  224. /package/tools/{claude-bridge.cmd → archive/claude-bridge.cmd} +0 -0
  225. /package/tools/{claude-bridge.sh → archive/claude-bridge.sh} +0 -0
  226. /package/tools/{codex-bridge.cmd → archive/codex-bridge.cmd} +0 -0
  227. /package/tools/{codex-bridge.sh → archive/codex-bridge.sh} +0 -0
  228. /package/tools/{codexcli-bridge.cmd → archive/codexcli-bridge.cmd} +0 -0
  229. /package/tools/{codexcli-bridge.ps1 → archive/codexcli-bridge.ps1} +0 -0
  230. /package/tools/{gemini-bridge.cmd → archive/gemini-bridge.cmd} +0 -0
  231. /package/tools/{gemini-bridge.sh → archive/gemini-bridge.sh} +0 -0
@@ -1,92 +1,93 @@
1
- ---
2
- name: industrial-brutalist-ui
3
- description: Raw mechanical interfaces fusing Swiss typographic print with military terminal aesthetics. Rigid grids, extreme type scale contrast, utilitarian color, analog degradation effects. For data-heavy dashboards, portfolios, or editorial sites that need to feel like declassified blueprints.
4
- ---
5
-
6
- # SKILL: Industrial Brutalism & Tactical Telemetry UI
7
-
8
- ## 1. Skill Meta
9
- **Name:** Industrial Brutalism & Tactical Telemetry Interface Engineering
10
- **Description:** Advanced proficiency in architecting web interfaces that synthesize mid-century Swiss Typographic design, industrial manufacturing manuals, and retro-futuristic aerospace/military terminal interfaces. This discipline requires absolute mastery over rigid modular grids, extreme typographic scale contrast, purely utilitarian color palettes, and the programmatic simulation of analog degradation (halftones, CRT scanlines, bitmap dithering). The objective is to construct digital environments that project raw functionality, mechanical precision, and high data density, deliberately discarding conventional consumer UI patterns.
11
-
12
- ## 2. Visual Archetypes
13
- The design system operates by merging two distinct but highly compatible visual paradigms. **Pick ONE per project and commit to it. Do not alternate or mix both modes within the same interface.**
14
-
15
- ### 2.1 Swiss Industrial Print
16
- Derived from 1960s corporate identity systems and heavy machinery blueprints.
17
- * **Characteristics:** High-contrast light modes (newsprint/off-white substrates). Reliance on monolithic, heavy sans-serif typography. Unforgiving structural grids outlined by visible dividing lines. Aggressive, asymmetric use of negative space punctuated by oversized, viewport-bleeding numerals or letterforms. Heavy use of primary red as an alert/accent color.
18
-
19
- ### 2.2 Tactical Telemetry & CRT Terminal
20
- Derived from classified military databases, legacy mainframes, and aerospace Heads-Up Displays (HUDs).
21
- * **Characteristics:** Dark mode exclusivity. High-density tabular data presentation. Absolute dominance of monospaced typography. Integration of technical framing devices (ASCII brackets, crosshairs). Application of simulated hardware limitations (phosphor glow, scanlines, low bit-depth rendering).
22
-
23
- ## 3. Typographic Architecture
24
- Typography is the primary structural and decorative infrastructure. Imagery is secondary. The system demands extreme variance in scale, weight, and spacing.
25
-
26
- ### 3.1 Macro-Typography (Structural Headers)
27
- * **Classification:** Neo-Grotesque / Heavy Sans-Serif.
28
- * **Optimal Web Fonts:** Neue Haas Grotesk (Black), Inter (Extra Bold/Black), Archivo Black, Roboto Flex (Heavy), Monument Extended.
29
- * **Implementation Parameters:**
30
- * **Scale:** Deployed at massive scales using fluid typography (e.g., `clamp(4rem, 10vw, 15rem)`).
31
- * **Tracking (Letter-spacing):** Extremely tight, often negative (`-0.03em` to `-0.06em`), forcing glyphs to form solid architectural blocks.
32
- * **Leading (Line-height):** Highly compressed (`0.85` to `0.95`).
33
- * **Casing:** Exclusively uppercase for structural impact.
34
-
35
- ### 3.2 Micro-Typography (Data & Telemetry)
36
- * **Classification:** Monospace / Technical Sans.
37
- * **Optimal Web Fonts:** JetBrains Mono, IBM Plex Mono, Space Mono, VT323, Courier Prime.
38
- * **Implementation Parameters:**
39
- * **Scale:** Fixed and small (`10px` to `14px` / `0.7rem` to `0.875rem`).
40
- * **Tracking:** Generous (`0.05em` to `0.1em`) to simulate mechanical typewriter spacing or terminal matrices.
41
- * **Leading:** Standard to tight (`1.2` to `1.4`).
42
- * **Casing:** Exclusively uppercase. Used for all metadata, navigation, unit IDs, and coordinates.
43
-
44
- ### 3.3 Textural Contrast (Artistic Disruption)
45
- * **Classification:** High-Contrast Serif.
46
- * **Optimal Web Fonts:** Playfair Display, EB Garamond, Times New Roman.
47
- * **Implementation Parameters:** Used exceedingly sparingly. Must be subjected to heavy post-processing (halftone filters, 1-bit dithering) to degrade vector perfection and create textural juxtaposition against the clean sans-serifs.
48
-
49
- ## 4. Color System
50
- The color architecture is uncompromising. Gradients, soft drop shadows, and modern translucency are strictly prohibited. Colors simulate physical media or primitive emissive displays.
51
-
52
- **CRITICAL: Choose ONE substrate palette per project and use it consistently. Never mix light and dark substrates within the same interface.**
53
-
54
- ### If Swiss Industrial Print (Light):
55
- * **Background:** `#F4F4F0` or `#EAE8E3` (Matte, unbleached documentation paper).
56
- * **Foreground:** `#050505` to `#111111` (Carbon Ink).
57
- * **Accent:** `#E61919` or `#FF2A2A` (Aviation/Hazard Red). This is the ONLY accent color. Used for strike-throughs, thick structural dividing lines, or vital data highlights.
58
-
59
- ### If Tactical Telemetry (Dark):
60
- * **Background:** `#0A0A0A` or `#121212` (Deactivated CRT. Avoid pure `#000000`).
61
- * **Foreground:** `#EAEAEA` (White phosphor). This is the primary text color.
62
- * **Accent:** `#E61919` or `#FF2A2A` (Aviation/Hazard Red). Same red, same rules.
63
- * **Terminal Green (`#4AF626`):** Optional. Use ONLY for a single specific UI element (e.g., one status indicator or one data readout) — never as a general text color. If it doesn't serve a clear purpose, omit it entirely.
64
-
65
- ## 5. Layout and Spatial Engineering
66
- The layout must appear mathematically engineered. It rejects conventional web padding in favor of visible compartmentalization.
67
-
68
- * **The Blueprint Grid:** Strict adherence to CSS Grid architectures. Elements do not float; they are anchored precisely to grid tracks and intersections.
69
- * **Visible Compartmentalization:** Extensive utilization of solid borders (`1px` or `2px solid`) to delineate distinct zones of information. Horizontal rules (`<hr>`) frequently span the entire container width to segregate operational units.
70
- * **Bimodal Density:** Layouts oscillate between extreme data density (tightly packed monospace metadata clustered together) and vast expanses of calculated negative space framing macro-typography.
71
- * **Geometry:** Absolute rejection of `border-radius`. All corners must be exactly 90 degrees to enforce mechanical rigidity.
72
-
73
- ## 6. UI Components and Symbology
74
- Standard web UI conventions are replaced with utilitarian, industrial graphic elements.
75
-
76
- * **Syntax Decoration:** Utilization of ASCII characters to frame data points.
77
- * *Framing:* `[ DELIVERY SYSTEMS ]`, `< RE-IND >`
78
- * *Directional:* `>>>`, `///`, `\\\\`
79
- * **Industrial Markers:** Prominent integration of registration (`®`), copyright (`©`), and trademark (`™`) symbols functioning as structural geometric elements rather than legal text.
80
- * **Technical Assets:** Integration of crosshairs (`+`) at grid intersections, repeating vertical lines (barcodes), thick horizontal warning stripes, and randomized string data (e.g., `REV 2.6`, `UNIT / D-01`) to simulate active mechanical processes.
81
-
82
- ## 7. Textural and Post-Processing Effects
83
- To prevent the design from appearing purely digital, simulated analog degradation is engineered into the frontend via CSS and SVG filters.
84
-
85
- * **Halftone and 1-Bit Dithering:** Transforming continuous-tone images or large serif typography into dot-matrix patterns. Achieved via pre-processing or CSS `mix-blend-mode: multiply` overlays combined with SVG radial dot patterns.
86
- * **CRT Scanlines:** For terminal interfaces, applying a `repeating-linear-gradient` to the background to simulate horizontal electron beam sweeps (e.g., `repeating-linear-gradient(0deg, transparent, transparent 2px, rgba(0,0,0,0.1) 2px, rgba(0,0,0,0.1) 4px)`).
87
- * **Mechanical Noise:** A global, low-opacity SVG static/noise filter applied to the DOM root to introduce a unified physical grain across both dark and light modes.
88
-
89
- ## 8. Web Engineering Directives
90
- 1. **Grid Determinism:** Utilize `display: grid; gap: 1px;` with contrasting parent/child background colors to generate mathematically perfect, razor-thin dividing lines without complex border declarations.
91
- 2. **Semantic Rigidity:** Construct the DOM using precise semantic tags (`<data>`, `<samp>`, `<kbd>`, `<output>`, `<dl>`) to accurately reflect the technical nature of the telemetry.
92
- 3. **Typography Clamping:** Implement CSS `clamp()` functions exclusively for macro-typography to ensure massive text scales aggressively while maintaining structural integrity across viewports.
1
+ ---
2
+ name: industrial-brutalist-ui
3
+ description: "Classic style skill, opt-in: it runs only when called by name. A hard mechanical look with Swiss type, rigid grids, extreme scale contrast and utilitarian colour."
4
+ disable-model-invocation: true
5
+ ---
6
+
7
+ # SKILL: Industrial Brutalism & Tactical Telemetry UI
8
+
9
+ ## 1. Skill Meta
10
+ **Name:** Industrial Brutalism & Tactical Telemetry Interface Engineering
11
+ **Description:** Advanced proficiency in architecting web interfaces that synthesize mid-century Swiss Typographic design, industrial manufacturing manuals, and retro-futuristic aerospace/military terminal interfaces. This discipline requires absolute mastery over rigid modular grids, extreme typographic scale contrast, purely utilitarian color palettes, and the programmatic simulation of analog degradation (halftones, CRT scanlines, bitmap dithering). The objective is to construct digital environments that project raw functionality, mechanical precision, and high data density, deliberately discarding conventional consumer UI patterns.
12
+
13
+ ## 2. Visual Archetypes
14
+ The design system operates by merging two distinct but highly compatible visual paradigms. **Pick ONE per project and commit to it. Do not alternate or mix both modes within the same interface.**
15
+
16
+ ### 2.1 Swiss Industrial Print
17
+ Derived from 1960s corporate identity systems and heavy machinery blueprints.
18
+ * **Characteristics:** High-contrast light modes (newsprint/off-white substrates). Reliance on monolithic, heavy sans-serif typography. Unforgiving structural grids outlined by visible dividing lines. Aggressive, asymmetric use of negative space punctuated by oversized, viewport-bleeding numerals or letterforms. Heavy use of primary red as an alert/accent color.
19
+
20
+ ### 2.2 Tactical Telemetry & CRT Terminal
21
+ Derived from classified military databases, legacy mainframes, and aerospace Heads-Up Displays (HUDs).
22
+ * **Characteristics:** Dark mode exclusivity. High-density tabular data presentation. Absolute dominance of monospaced typography. Integration of technical framing devices (ASCII brackets, crosshairs). Application of simulated hardware limitations (phosphor glow, scanlines, low bit-depth rendering).
23
+
24
+ ## 3. Typographic Architecture
25
+ Typography is the primary structural and decorative infrastructure. Imagery is secondary. The system demands extreme variance in scale, weight, and spacing.
26
+
27
+ ### 3.1 Macro-Typography (Structural Headers)
28
+ * **Classification:** Neo-Grotesque / Heavy Sans-Serif.
29
+ * **Optimal Web Fonts:** Neue Haas Grotesk (Black), Inter (Extra Bold/Black), Archivo Black, Roboto Flex (Heavy), Monument Extended.
30
+ * **Implementation Parameters:**
31
+ * **Scale:** Deployed at massive scales using fluid typography (e.g., `clamp(4rem, 10vw, 15rem)`).
32
+ * **Tracking (Letter-spacing):** Extremely tight, often negative (`-0.03em` to `-0.06em`), forcing glyphs to form solid architectural blocks.
33
+ * **Leading (Line-height):** Highly compressed (`0.85` to `0.95`).
34
+ * **Casing:** Exclusively uppercase for structural impact.
35
+
36
+ ### 3.2 Micro-Typography (Data & Telemetry)
37
+ * **Classification:** Monospace / Technical Sans.
38
+ * **Optimal Web Fonts:** JetBrains Mono, IBM Plex Mono, Space Mono, VT323, Courier Prime.
39
+ * **Implementation Parameters:**
40
+ * **Scale:** Fixed and small (`10px` to `14px` / `0.7rem` to `0.875rem`).
41
+ * **Tracking:** Generous (`0.05em` to `0.1em`) to simulate mechanical typewriter spacing or terminal matrices.
42
+ * **Leading:** Standard to tight (`1.2` to `1.4`).
43
+ * **Casing:** Exclusively uppercase. Used for all metadata, navigation, unit IDs, and coordinates.
44
+
45
+ ### 3.3 Textural Contrast (Artistic Disruption)
46
+ * **Classification:** High-Contrast Serif.
47
+ * **Optimal Web Fonts:** Playfair Display, EB Garamond, Times New Roman.
48
+ * **Implementation Parameters:** Used exceedingly sparingly. Must be subjected to heavy post-processing (halftone filters, 1-bit dithering) to degrade vector perfection and create textural juxtaposition against the clean sans-serifs.
49
+
50
+ ## 4. Color System
51
+ The color architecture is uncompromising. Gradients, soft drop shadows, and modern translucency are strictly prohibited. Colors simulate physical media or primitive emissive displays.
52
+
53
+ **CRITICAL: Choose ONE substrate palette per project and use it consistently. Never mix light and dark substrates within the same interface.**
54
+
55
+ ### If Swiss Industrial Print (Light):
56
+ * **Background:** `#F4F4F0` or `#EAE8E3` (Matte, unbleached documentation paper).
57
+ * **Foreground:** `#050505` to `#111111` (Carbon Ink).
58
+ * **Accent:** `#E61919` or `#FF2A2A` (Aviation/Hazard Red). This is the ONLY accent color. Used for strike-throughs, thick structural dividing lines, or vital data highlights.
59
+
60
+ ### If Tactical Telemetry (Dark):
61
+ * **Background:** `#0A0A0A` or `#121212` (Deactivated CRT. Avoid pure `#000000`).
62
+ * **Foreground:** `#EAEAEA` (White phosphor). This is the primary text color.
63
+ * **Accent:** `#E61919` or `#FF2A2A` (Aviation/Hazard Red). Same red, same rules.
64
+ * **Terminal Green (`#4AF626`):** Optional. Use ONLY for a single specific UI element (e.g., one status indicator or one data readout) — never as a general text color. If it doesn't serve a clear purpose, omit it entirely.
65
+
66
+ ## 5. Layout and Spatial Engineering
67
+ The layout must appear mathematically engineered. It rejects conventional web padding in favor of visible compartmentalization.
68
+
69
+ * **The Blueprint Grid:** Strict adherence to CSS Grid architectures. Elements do not float; they are anchored precisely to grid tracks and intersections.
70
+ * **Visible Compartmentalization:** Extensive utilization of solid borders (`1px` or `2px solid`) to delineate distinct zones of information. Horizontal rules (`<hr>`) frequently span the entire container width to segregate operational units.
71
+ * **Bimodal Density:** Layouts oscillate between extreme data density (tightly packed monospace metadata clustered together) and vast expanses of calculated negative space framing macro-typography.
72
+ * **Geometry:** Absolute rejection of `border-radius`. All corners must be exactly 90 degrees to enforce mechanical rigidity.
73
+
74
+ ## 6. UI Components and Symbology
75
+ Standard web UI conventions are replaced with utilitarian, industrial graphic elements.
76
+
77
+ * **Syntax Decoration:** Utilization of ASCII characters to frame data points.
78
+ * *Framing:* `[ DELIVERY SYSTEMS ]`, `< RE-IND >`
79
+ * *Directional:* `>>>`, `///`, `\\\\`
80
+ * **Industrial Markers:** Prominent integration of registration (`®`), copyright (`©`), and trademark (`™`) symbols functioning as structural geometric elements rather than legal text.
81
+ * **Technical Assets:** Integration of crosshairs (`+`) at grid intersections, repeating vertical lines (barcodes), thick horizontal warning stripes, and randomized string data (e.g., `REV 2.6`, `UNIT / D-01`) to simulate active mechanical processes.
82
+
83
+ ## 7. Textural and Post-Processing Effects
84
+ To prevent the design from appearing purely digital, simulated analog degradation is engineered into the frontend via CSS and SVG filters.
85
+
86
+ * **Halftone and 1-Bit Dithering:** Transforming continuous-tone images or large serif typography into dot-matrix patterns. Achieved via pre-processing or CSS `mix-blend-mode: multiply` overlays combined with SVG radial dot patterns.
87
+ * **CRT Scanlines:** For terminal interfaces, applying a `repeating-linear-gradient` to the background to simulate horizontal electron beam sweeps (e.g., `repeating-linear-gradient(0deg, transparent, transparent 2px, rgba(0,0,0,0.1) 2px, rgba(0,0,0,0.1) 4px)`).
88
+ * **Mechanical Noise:** A global, low-opacity SVG static/noise filter applied to the DOM root to introduce a unified physical grain across both dark and light modes.
89
+
90
+ ## 8. Web Engineering Directives
91
+ 1. **Grid Determinism:** Utilize `display: grid; gap: 1px;` with contrasting parent/child background colors to generate mathematically perfect, razor-thin dividing lines without complex border declarations.
92
+ 2. **Semantic Rigidity:** Construct the DOM using precise semantic tags (`<data>`, `<samp>`, `<kbd>`, `<output>`, `<dl>`) to accurately reflect the technical nature of the telemetry.
93
+ 3. **Typography Clamping:** Implement CSS `clamp()` functions exclusively for macro-typography to ensure massive text scales aggressively while maintaining structural integrity across viewports.
@@ -0,0 +1,68 @@
1
+ # caveman
2
+
3
+ Talk like smart caveman. Same brain, fewer tokens.
4
+
5
+ ## What it does
6
+
7
+ Makes the model answer first and cut the ceremony: no greeting, hedging,
8
+ filler, recap, or closer. Articles drop when the sentence still reads in one
9
+ pass. Code, commands, paths, numbers, and exact error strings never change.
10
+ Result depends on model and workload. Measured once on the 3.1.0 skill text (`evals/snapshots/results.json`: claude-opus-5-5, ten prompts, single run, output length only, tiktoken o200k approximation): caveman 3% fewer output tokens at the median than a plain `Answer concisely.` control, inside the noise; ultracave 35%; megacave 9%. No quality-equivalence claim is published. Mode persists until changed or stopped.
11
+
12
+ Caveman is one of three sibling skills:
13
+
14
+ | Skill | Command | What change |
15
+ |-------|---------|-------------|
16
+ | `caveman` | `/caveman` | The voice. Default. Answer first, fluff gone, every fact kept. |
17
+ | `ultracave` | `/ultracave` | Grammar stripped. Fragments, one word when one word is enough, each fact once. |
18
+ | `megacave` | `/megacave` | Classical Chinese (文言文). Far fewer characters, technical terms verbatim. |
19
+
20
+ `/caveman ultra` and `/caveman wenyan` still work as aliases.
21
+
22
+ Auto-clarity: every skill drops to normal prose for security warnings,
23
+ irreversible-action confirmations, step sequences a fragment could scramble,
24
+ and a user who repeats a question. Resumes after the clear part.
25
+
26
+ ## How to invoke
27
+
28
+ ```
29
+ /caveman # the voice (default)
30
+ /caveman status # show current mode without changing it
31
+ /ultracave # grammar stripped
32
+ /megacave # classical Chinese
33
+ stop caveman # back to normal prose
34
+ ```
35
+
36
+ Claude Code and the standalone OpenCode plugin read stored mode state. Other
37
+ hosts answer from the conversation and mark it `(not tracked by this host)`.
38
+
39
+ Want Claude Code sessions to start with normal prose? Set
40
+ `{"defaultMode":"manual"}` in `.caveman.json` for one project or
41
+ `~/.config/caveman/config.json` for your user. You can also set
42
+ `CAVEMAN_DEFAULT_MODE=manual`. Then `/caveman` activates the voice and
43
+ `/ultracave` selects ultracave. Stop persists across compaction and resume; a
44
+ fresh session starts off again. This startup policy is Claude Code-only:
45
+ OpenCode keeps its caveman default because the installer also supplies static
46
+ activation rules.
47
+
48
+ ## Example output
49
+
50
+ Question: "Why does my React component re-render?"
51
+
52
+ Normal prose:
53
+ > Your component re-renders because you create a new object reference each render. Wrapping it in `useMemo` will fix the issue.
54
+
55
+ caveman:
56
+ > New object ref each render, so React re-renders. Wrap the prop in `useMemo`.
57
+
58
+ ultracave:
59
+ > Inline object prop, new ref, re-render. `useMemo`.
60
+
61
+ megacave:
62
+ > 每繪新生對象參照,故重繪;以 `useMemo` 包之則免。
63
+
64
+ ## See also
65
+
66
+ - [`SKILL.md`](./SKILL.md): full LLM-facing instructions
67
+ - [`../ultracave/`](../ultracave/) and [`../megacave/`](../megacave/): the sibling skills
68
+ - [Caveman README](../../README.md): repo overview, install, benchmarks
@@ -1,54 +1,89 @@
1
1
  ---
2
2
  name: caveman
3
3
  description: >
4
- Slashes chat token consumption by dropping conversational filler, pleasantries, and polite ceremony.
5
- Speaks in direct, concise fragments while keeping code blocks, technical literals, diffs, and
6
- structured outputs completely intact.
7
- upstream: https://github.com/JuliusBrussee/caveman
8
- version: 4.0.0
4
+ Terse caveman voice: answer first, fluff gone, every technical fact kept.
5
+ Use for /caveman, "caveman mode", "talk like caveman", "be brief", "less
6
+ tokens". Stays on until "stop caveman" or "normal mode".
9
7
  ---
10
8
 
11
- # Caveman — Token-Efficiency & Terse Communication Skill
9
+ # caveman
12
10
 
13
- You are operating under the **Caveman** communication protocol. Your mandate is to slash unnecessary conversational token consumption and respect the user's context window.
11
+ Respond terse like smart caveman. All technical substance stay. Only fluff die.
14
12
 
15
- > *"Why use many token when few token do trick."*
13
+ Caveman is a voice, not broken grammar. Reader pays per token and reads in a terminal. Every word earns its place. Every fact survives.
16
14
 
17
- ---
15
+ ## Persistence
18
16
 
19
- ## 1. Core Principles
20
-
21
- 1. **Answer First**:
22
- - Give the solution or conclusion immediately.
23
- - Do not bury the answer behind preambles or recaps.
24
- 2. **Kill Ceremony**:
25
- - Zero pleasantries ("Certainly!", "I would be happy to assist with that!").
26
- - Zero conversational padding ("As requested, here is the updated implementation...").
27
- - Zero repetitive play-by-play narration of every obvious keystroke.
28
- - Zero sycophantic apologetic loops ("I apologize for the oversight...").
29
- 3. **Short Words & Direct Phrasing**:
30
- - "Fix" instead of "Implement a resolution for".
31
- - "Add" instead of "Successfully introduce the capability to".
32
- - One clear thought per sentence.
33
- 4. **Omit Optional Articles & Conversational Connectors**:
34
- - Direct, clear, telegraphic style when describing simple status.
17
+ Every response, whole session, until user says "stop caveman" or "normal mode". Unsure if still on? It is. Confirm the switch-off in one line.
35
18
 
36
- ---
19
+ `/caveman ultra` and `/caveman wenyan` are aliases: follow the `ultracave` or `megacave` skill instead of this one. `/caveman status` reports the mode and changes nothing. Relay the hook's `Caveman mode: <mode>` value when present. No hook value (host without hooks): report the mode you followed before this command, or `off` if caveman was turned off or never active, plus `(not tracked by this host)`. Example: `Caveman mode: caveman (not tracked by this host)`. Loading this skill to answer status is not activation. Never infer a mode from the configured default.
37
20
 
38
- ## 2. Multi-Agent & Code Integrity Invariants (Do Not Touch)
21
+ ## Why
39
22
 
40
- Caveman applies **strictly to conversational English prose**. It must **never** degrade technical payload precision:
23
+ 1. Every output token is billed and read. Filler costs twice.
24
+ 2. Code, commands, paths, numbers, errors are the payload. One changed character breaks them.
25
+ 3. Ceremony is expensive, grammar is cheap. "Sure, I'd be happy to help" is ten tokens. "the" is one.
26
+ 4. A dropped negation costs more than every token saved. Clarity beats compression.
41
27
 
42
- - **Code Blocks**: Write complete, syntactically valid code. Never omit required code lines with `// rest of code unchanged` unless explicitly using a surgical diff tool.
43
- - **Commands & Arguments**: Preserve exact CLI commands, flags, and shell syntax verbatim.
44
- - **Diffs & File Paths**: Preserve complete file links (`[file](file:///...)`), line numbers, and symbol identifiers.
45
- - **Structured Outputs & Cross-Model Reviews**: Never strip JSON keys, schema fields, or verification checklist criteria needed by cross-model review bridges (`claude-bridge`, `gemini-bridge`, `codex-bridge`).
46
- - **Turn 1 Grilling Questions & Alternatives**: Never omit, swallow, or truncate the probing questions, scope classification, or architectural alternatives required by interactive grilling gates (`/plan`, `/grill-me`). These are mandatory technical payloads.
28
+ ## Rules
47
29
 
48
- ---
30
+ ### 1. Answer first
31
+
32
+ Answer, then reason, then next step. Pattern: `[thing] [action] [reason]. [next step].`
33
+
34
+ Bad: "Sure! I'd be happy to help. The issue you're experiencing is likely caused by..."
35
+ Good: "Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:"
36
+
37
+ ### 2. Kill ceremony
38
+
39
+ No greeting, hedging, pleasantries, recap, or closer. No "Sure!", "Let me", "I'll now", "Hope this helps". No just/really/basically/actually/simply.
40
+
41
+ ### 3. Short word
42
+
43
+ "fix" not "implement a solution for". Standard acronyms fine (DB, API, HTTP). Invented abbreviations not (cfg, impl, fn): same tokens, harder read. No arrows.
44
+
45
+ ### 4. Articles optional, meaning never
46
+
47
+ Drop a/an/the when the sentence still reads in one pass. Fragments fine. Never drop not/never/no/only/except. Numbers and units exact.
48
+
49
+ Bad: "Migration drop column backup first."
50
+ Good: "Back up first. Then run migration: it drops the column."
51
+
52
+ ### 5. One idea per sentence
53
+
54
+ ASD-STE100 is the floor: 20 words max, active voice, imperative for instructions, one term per thing, pronoun only with an obvious referent. Compression and clarity conflict? Clarity wins.
55
+
56
+ ### 6. Payload verbatim
57
+
58
+ Code blocks unchanged. Commands, paths, API names exact. Errors quoted exact, shortest decisive line only. Code change shown in chat: changed lines plus 1-2 lines of context, not the whole file. Whole file only if the user asks, the file is new, or most of it changes. Existing comments in files you edit are payload too: never delete or shorten one you were not asked to change.
59
+
60
+ ### 7. Tool runs: bounded status
61
+
62
+ No text between routine calls. One line before a multi-step run, one line per phase change, one line with the result at the end. Otherwise text before a call only to clarify, warn, or disambiguate.
63
+
64
+ ### 8. User's language
65
+
66
+ Compress the style, not the language. An explicit reply-language instruction wins. Never switch because of quoted text. Technical terms and errors stay verbatim. Particles and case markers are grammar, not filler.
67
+
68
+ ### 9. Never perform caveman
69
+
70
+ No "caveman mode on", no "me think", no "Caveman:" prefix, no normal answer plus caveman copy. No decorative tables or emoji. Never add a word to sound caveman. Caveman phrasing not shorter than plain? Use plain.
71
+
72
+ ## When to break the rules
73
+
74
+ Plain prose, then resume:
75
+
76
+ 1. Security warning.
77
+ 2. Irreversible action. Confirm in full sentences first.
78
+ 3. Step order a fragment could scramble.
79
+ 4. User confused or repeats the question.
80
+ 5. Anything persisted outside chat: code, comments, commits, docs, issues, PRs, tickets, memory files, third-party messages. `/caveman-compress` exempt.
81
+ 6. Harness asks for a status line or confirmation. Give it. Harness decides *when* you speak, caveman decides *how*.
82
+ 7. You ask the user a question or offer options. Full sentences, so the answer comes back right first time.
49
83
 
50
- ## Upstream Provenance & Governance Protocol
84
+ ## Pre-send check
51
85
 
52
- - **Source Repository**: [JuliusBrussee/caveman](https://github.com/JuliusBrussee/caveman)
53
- - **Update Directive**:
54
- > *Update the selected skill or plugin through its supported mechanism. Review changed instructions/references and repeat a bounded review after material updates. Record source revision, reviewed range, actual tests and remaining validation in the private report.*
86
+ 1. First sentence announces what you will do? Delete.
87
+ 2. Last sentence recaps or offers help? Delete.
88
+ 3. Every not/never/no/only present? Every code span, path, number, error verbatim?
89
+ 4. Any sentence with two readings? Make it a full sentence.
@@ -1,23 +1,11 @@
1
1
  ---
2
2
  name: claude-collaborator
3
- description: Coordinate with Claude Code CLI (claude.exe) to cross-validate changes, request second-opinion reviews on git diffs, or validate test runs.
3
+ description: Coordinate with Claude Code CLI (claude.exe) via Herdr to cross-validate changes, request second-opinion reviews on git diffs, or validate test runs.
4
4
  ---
5
5
 
6
6
  # Claude Collaborator Skill
7
7
 
8
- This skill enables Antigravity (Gemini) to orchestrate tasks with Claude Code (`claude.exe`), delegating complex architectural reasoning, diff reviews, and adversarial validation.
9
-
10
- ## Real-Time Visibility in Herdr (Right Split & Auto-Close)
11
-
12
- By default when running inside Herdr, all bridge invocations automatically:
13
- - **Split the calling screen to the right**: Creates a side-by-side split pane in your current Herdr window.
14
- - **Display a prominent request banner**:
15
- - Caller AI $\rightarrow$ Target Model
16
- - Action & Working Directory
17
- - **`>> WHAT IS BEING REQUESTED:`** A highlighted box showing the exact prompt/instructions.
18
- - Summary of modified files (`git diff --stat`) for code reviews.
19
- - **Stream Claude's live execution**: Real-time display of reasoning, tool calls, and output right in that split pane.
20
- - **Auto-close when complete**: Automatically closes the right pane after finishing and collapses your screen back to normal, returning the captured output to Antigravity.
8
+ This skill enables Antigravity (Gemini) to orchestrate tasks with Claude Code (`claude.exe`) directly through native Herdr multiplexing, delegating complex architectural reasoning, diff reviews, and adversarial validation.
21
9
 
22
10
  ## When to Activate
23
11
 
@@ -25,47 +13,39 @@ By default when running inside Herdr, all bridge invocations automatically:
25
13
  - After making non-trivial code edits or architectural refactors, to verify there are no hidden regressions.
26
14
  - When facing ambiguous design choices where a second model's critique helps pick the best approach.
27
15
 
28
- ## Available Actions via `tools/claude-bridge.ps1`
16
+ ## Orchestration Method: Native Herdr Agent (`herdr` skill)
29
17
 
30
- Run commands using the project PowerShell helper script:
18
+ When running inside Herdr (`$env:HERDR_ENV = "1"`), communicate directly using Herdr's native agent orchestration. This maintains a persistent session across turns, preserves context, respects interactive approvals (`blocked`), and handles bracketed paste:
31
19
 
32
- ### 1. Adversarial Code Review of Git Diff
33
- Splits the screen to the right, runs Claude Code review, streams live, and auto-closes:
34
- ```powershell
35
- powershell -ExecutionPolicy Bypass -File tools/claude-bridge.ps1 review
20
+ ### 1. Fast Path: Re-use Active Idle Agent
21
+ Before splitting a pane, check if a Claude agent is already running and idle:
22
+ ```bash
23
+ herdr agent list
36
24
  ```
37
- To provide specific review instructions:
38
- ```powershell
39
- powershell -ExecutionPolicy Bypass -File tools/claude-bridge.ps1 review "Focus on security vulnerabilities and ZITADEL OIDC session handling"
25
+ If an agent named `claude-reviewer` or `claude` is idle or done, prompt it directly:
26
+ ```bash
27
+ herdr agent prompt claude-reviewer "Review the latest changes." --wait --timeout 120000
40
28
  ```
41
29
 
42
- ### 2. Consult Claude for Architectural Second Opinion
43
- Sends an inquiry or architectural prompt directly to Claude in a right-split pane:
44
- ```powershell
45
- powershell -ExecutionPolicy Bypass -File tools/claude-bridge.ps1 ask "How should we model group permission scopes for module pulse in Postgres?"
30
+ ### 2. Spawning a New Claude Agent (Single-Execution Batch)
31
+ If no active Claude agent exists, batch pane creation and agent startup in a single command:
32
+ ```bash
33
+ PANE_ID=$(herdr pane split --current --direction right --cwd "$PWD" --no-focus | jq -r '.result.pane.pane_id')
34
+ herdr agent start claude-reviewer --kind claude --pane "$PANE_ID" -- --model claude-sonnet-5
35
+ herdr agent prompt claude-reviewer "Review git diff for security regressions and type errors." --wait --timeout 120000
46
36
  ```
47
37
 
48
- ### 3. Validate Test or Build Run
49
- Runs a test command and has Claude analyze output and errors in a right-split pane:
50
- ```powershell
51
- powershell -ExecutionPolicy Bypass -File tools/claude-bridge.ps1 validate "pnpm test"
38
+ ### 3. Read Findings into Context
39
+ ```bash
40
+ herdr agent read claude-reviewer --source recent-unwrapped --lines 120
52
41
  ```
53
42
 
54
- ### 4. Interactive Handoff to Claude in a Right Split Pane
55
- Launches a full interactive Claude session in a right split pane pre-loaded with a task:
56
- ```powershell
57
- powershell -ExecutionPolicy Bypass -File tools/claude-bridge.ps1 interactive "Let's refactor the router together"
43
+ ### 4. Interactive Collaboration
44
+ When an interactive session or clarification is needed, send keys or prompt interactively:
45
+ ```bash
46
+ herdr agent send-keys claude-reviewer enter
58
47
  ```
59
48
 
60
- ### Display & Control Flags:
61
- - *(default)*: Splits the current Herdr screen to the right, streams live, and auto-closes when done.
62
- - `-KeepOpen`: Keeps the split pane open after completion instead of auto-closing.
63
- - `-Tab`: Opens in a new Herdr tab instead of splitting the screen.
64
- - `-Window`: Forces a standalone OS console window instead of Herdr.
65
- - `-Headless`: Runs silently in the background (for CI/unattended scripts).
66
- - `-NoFocus`: Prevents switching focus to the right pane.
67
- - `-Model <name>`: Override model (e.g. `-Model opus-5`, `-Model sonnet-5`, `-Model fable-5.1`).
68
-
69
49
  ## Guidelines for Antigravity
70
50
 
71
51
  - **Synthesize, Don't Blindly Echo**: When Claude returns feedback, analyze its critiques against the platform's requirements (`docs/03.REQUIREMENTS.md`, `docs/06.DECISIONS.md`, `docs/02.GLOSSARY.md`).