heimdall-agent 1.0.0 → 1.2.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 (250) hide show
  1. package/README.md +57 -26
  2. package/README.pt-BR.md +443 -0
  3. package/agents/cloud-engineer.md +77 -0
  4. package/agents/code-sentinel.md +71 -34
  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 +68 -0
  9. package/agents/orchestrator.md +107 -93
  10. package/agents/reviewer.md +102 -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 +31 -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 +762 -573
  22. package/docs/SKILLS.md +393 -275
  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/2026-11-12-compare-report.json +1028 -0
  29. package/docs/runs/skill-audit/2026-11-12-upstream-audit.json +275 -0
  30. package/docs/runs/skill-audit/add_progressive_disclosure.cjs +30 -0
  31. package/docs/runs/skill-audit/check_heimdall_skills.ps1 +9 -0
  32. package/docs/runs/skill-audit/compare_classics.ps1 +26 -0
  33. package/docs/runs/skill-audit/compare_taste.ps1 +12 -0
  34. package/docs/runs/skill-audit/customization-report.json +380 -0
  35. package/docs/runs/skill-audit/diff_pending_skills.cjs +94 -0
  36. package/docs/runs/skill-audit/fetch_and_apply_skill.cjs +58 -0
  37. package/docs/runs/skill-audit/fetch_and_apply_taste_v2.cjs +65 -0
  38. package/docs/runs/skill-audit/inspect_pending_skills.cjs +71 -0
  39. package/docs/runs/skill-audit/inventory.json +308 -0
  40. package/docs/runs/skill-audit/list_local_taste.ps1 +1 -0
  41. package/docs/runs/skill-audit/phase5-update-plan.json +595 -0
  42. package/docs/runs/skill-audit/phase5-update-plan.md +138 -0
  43. package/docs/runs/skill-audit/probe.ps1 +16 -0
  44. package/docs/runs/skill-audit/probe_classics_branches.ps1 +3 -0
  45. package/docs/runs/skill-audit/probe_commits.ps1 +15 -0
  46. package/docs/runs/skill-audit/probe_repos.ps1 +17 -0
  47. package/docs/runs/skill-audit/probe_sentry_sec.ps1 +3 -0
  48. package/docs/runs/skill-audit/probe_sentry_sweep.ps1 +5 -0
  49. package/docs/runs/skill-audit/probe_snyk.ps1 +3 -0
  50. package/docs/runs/skill-audit/probe_snyk_recipes.ps1 +5 -0
  51. package/docs/runs/skill-audit/probe_taste_branches.ps1 +8 -0
  52. package/docs/runs/skill-audit/probe_taste_v19.ps1 +3 -0
  53. package/docs/runs/skill-audit/probe_user_repos.ps1 +19 -0
  54. package/docs/runs/skill-audit/prune_taste_skills.cjs +22 -0
  55. package/docs/runs/skill-audit/run_phase1_2.cjs +142 -0
  56. package/docs/runs/skill-audit/run_phase6_verification.cjs +107 -0
  57. package/docs/runs/skill-audit/show_16_details.ps1 +25 -0
  58. package/docs/runs/skill-audit/show_20_skills.ps1 +28 -0
  59. package/docs/runs/skill-audit/show_classics_diff.cjs +37 -0
  60. package/docs/runs/skill-audit/sync_agent_markdowns.cjs +30 -0
  61. package/docs/runs/skill-audit/taste-skill-upstream.md +542 -0
  62. package/docs/runs/skill-audit/update-manifest.md +88 -0
  63. package/docs/runs/skill-audit/update_config_skills.cjs +52 -0
  64. package/docs/runs/skill-audit/update_registry_phase7.cjs +83 -0
  65. package/docs/runs/skill-audit/upstream-status.json +563 -0
  66. package/docs/runs/skill-audit/verification-results.json +252 -0
  67. package/doctrine/AGENTS.md +42 -77
  68. package/hooks/git/pre-commit +11 -0
  69. package/hooks/heimdall-hook.cjs +81 -2
  70. package/hooks/herdr-agent-state.ps1 +55 -0
  71. package/hooks/hooks.json +0 -11
  72. package/lib/catalog-sync.cjs +167 -0
  73. package/lib/hermes-context.cjs +57 -0
  74. package/lib/model-context.cjs +123 -0
  75. package/lib/path-discovery.cjs +94 -0
  76. package/package.json +7 -3
  77. package/playbooks/01-interactive-grilling-gate.md +23 -6
  78. package/playbooks/02-fast-code-deep-verification.md +3 -2
  79. package/playbooks/03-adversarial-code-review.md +15 -7
  80. package/playbooks/05-canonical-plan-template.md +35 -19
  81. package/playbooks/06-model-registry-matrix.md +24 -13
  82. package/playbooks/07-legacy-code-modernization.md +74 -0
  83. package/playbooks/08-backlog-and-change-request-flow.md +122 -0
  84. package/setup.mjs +592 -172
  85. package/skills/antislop/SKILL.md +76 -56
  86. package/skills/antislop/VERSION +1 -0
  87. package/skills/antislop-copywriting/SKILL.md +407 -372
  88. package/skills/antislop-human/LICENSE-web-quality-skills +21 -0
  89. package/skills/antislop-human/SKILL.md +204 -147
  90. package/skills/antislop-human/contrast-check.py +168 -165
  91. package/skills/antislop-human/contrast-mcp.py +6 -3
  92. package/skills/antislop-human/references/A11Y-PATTERNS.md +249 -0
  93. package/skills/antislop-human/references/WCAG.md +127 -0
  94. package/skills/antislop-ui/LICENSE-web-quality-skills +21 -0
  95. package/skills/antislop-ui/SKILL.md +344 -304
  96. package/skills/antislop-ui/references/CORE-WEB-VITALS.md +181 -0
  97. package/skills/antislop-ui/references/WEB-BASELINE.md +28 -0
  98. package/skills/brainstorming/SKILL.md +296 -265
  99. package/skills/brainstorming/builder-check-prompt.md +23 -0
  100. package/skills/brainstorming/scripts/frame-template.html +213 -213
  101. package/skills/brainstorming/scripts/server.cjs +723 -723
  102. package/skills/brandkit/SKILL.md +798 -798
  103. package/skills/brutalist-skill/SKILL.md +93 -92
  104. package/skills/caveman/README.md +68 -0
  105. package/skills/caveman/SKILL.md +73 -38
  106. package/skills/claude-collaborator/SKILL.md +24 -44
  107. package/skills/clean-code/SKILL.md +152 -0
  108. package/skills/cloudflare-security-audit/AI-AND-LLM.md +83 -83
  109. package/skills/cloudflare-security-audit/ATTACK-CLASSES.md +130 -130
  110. package/skills/cloudflare-security-audit/CLIENT-SIDE.md +83 -83
  111. package/skills/cloudflare-security-audit/CLOUD-AND-DEPLOYMENT.md +86 -86
  112. package/skills/cloudflare-security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -84
  113. package/skills/cloudflare-security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -89
  114. package/skills/cloudflare-security-audit/HUNTING.md +251 -251
  115. package/skills/cloudflare-security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -101
  116. package/skills/cloudflare-security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -81
  117. package/skills/cloudflare-security-audit/RECONNAISSANCE.md +156 -156
  118. package/skills/cloudflare-security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -78
  119. package/skills/cloudflare-security-audit/SKILL.md +192 -192
  120. package/skills/cloudflare-security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -73
  121. package/skills/cloudflare-security-audit/VALIDATION-AND-REPORTING.md +186 -186
  122. package/skills/cloudflare-security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -105
  123. package/skills/cloudflare-security-audit/report-schema.json +461 -461
  124. package/skills/cloudflare-security-audit/validate-coverage-ledger.cjs +872 -872
  125. package/skills/cloudflare-security-audit/validate-coverage-ledger.test.cjs +740 -740
  126. package/skills/cloudflare-security-audit/validate-findings.cjs +773 -773
  127. package/skills/cloudflare-security-audit/validate-findings.test.cjs +652 -652
  128. package/skills/codebase-design/DEEPENING.md +37 -0
  129. package/skills/codebase-design/DESIGN-IT-TWICE.md +44 -0
  130. package/skills/codebase-design/SKILL.md +114 -0
  131. package/skills/codex-collaborator/SKILL.md +24 -45
  132. package/skills/communication-doctrine/SKILL.md +89 -0
  133. package/skills/diagnosing-superpowers/SKILL.md +1 -1
  134. package/skills/diagnosing-superpowers/references/github-issues.md +3 -3
  135. package/skills/diagnosing-superpowers/templates/issue.md +23 -4
  136. package/skills/domain-modeling/ADR-FORMAT.md +47 -0
  137. package/skills/domain-modeling/GLOSSARY-FORMAT.md +60 -0
  138. package/skills/domain-modeling/SKILL.md +74 -0
  139. package/skills/executing-plans/SKILL.md +6 -56
  140. package/skills/executing-plans/scripts/task-done +52 -52
  141. package/skills/executing-plans/scripts/task-start +28 -28
  142. package/skills/gemini-collaborator/SKILL.md +24 -56
  143. package/skills/grill-me/SKILL.md +65 -0
  144. package/skills/handoff/SKILL.md +64 -0
  145. package/skills/herdr/SKILL.md +243 -0
  146. package/skills/image-to-code-skill/SKILL.md +1228 -1228
  147. package/skills/imagegen-frontend-mobile/SKILL.md +1465 -1465
  148. package/skills/imagegen-frontend-web/SKILL.md +987 -987
  149. package/skills/improve-codebase-architecture/HTML-REPORT.md +123 -0
  150. package/skills/improve-codebase-architecture/SKILL.md +71 -0
  151. package/skills/karpathy-guidelines/SKILL.md +67 -67
  152. package/skills/mcp-engineering/SKILL.md +74 -0
  153. package/skills/minimalist-skill/SKILL.md +87 -85
  154. package/skills/output-skill/SKILL.md +49 -49
  155. package/skills/owasp-security/reference/config-and-supply-chain.md +346 -344
  156. package/skills/owasp-security/reference/languages.md +378 -372
  157. package/skills/owasp-security/reference/owasp-report.md +1144 -1140
  158. package/skills/owasp-security/reference/review-checklist.md +134 -132
  159. package/skills/ponytail/SKILL.md +36 -52
  160. package/skills/postgres-best-practices/SKILL.md +30 -52
  161. package/skills/postgres-best-practices/references/backup-restore.md +372 -0
  162. package/skills/postgres-best-practices/references/bulk-loading.md +315 -0
  163. package/skills/postgres-best-practices/references/connection-pooling.md +310 -0
  164. package/skills/postgres-best-practices/references/hot-standby.md +221 -0
  165. package/skills/postgres-best-practices/references/indexing.md +318 -0
  166. package/skills/postgres-best-practices/references/logical-replication.md +610 -0
  167. package/skills/postgres-best-practices/references/major-version-upgrades.md +334 -0
  168. package/skills/postgres-best-practices/references/performance-diagnostics.md +553 -0
  169. package/skills/postgres-best-practices/references/query-optimization.md +294 -0
  170. package/skills/postgres-best-practices/references/query-patterns.md +566 -0
  171. package/skills/postgres-best-practices/references/schema-design.md +362 -0
  172. package/skills/postgres-best-practices/references/security-roles.md +489 -0
  173. package/skills/postgres-best-practices/references/transaction-isolation.md +344 -0
  174. package/skills/progressive-disclosure/SKILL.md +68 -0
  175. package/skills/pstack-discipline/SKILL.md +40 -0
  176. package/skills/receiving-code-review/SKILL.md +2 -23
  177. package/skills/requesting-code-review/SKILL.md +7 -36
  178. package/skills/soft-skill/SKILL.md +99 -98
  179. package/skills/stitch-skill/DESIGN.md +121 -121
  180. package/skills/stitch-skill/SKILL.md +185 -184
  181. package/skills/strix-security/SKILL.md +54 -53
  182. package/skills/subagent-driven-development/SKILL.md +35 -264
  183. package/skills/subagent-driven-development/references/batching.md +11 -0
  184. package/skills/subagent-driven-development/references/cannot-verify.md +10 -0
  185. package/skills/subagent-driven-development/references/final-review.md +47 -0
  186. package/skills/subagent-driven-development/references/fix-loop.md +77 -0
  187. package/skills/subagent-driven-development/references/handling-reports.md +15 -0
  188. package/skills/subagent-driven-development/references/preflight.md +26 -0
  189. package/skills/subagent-driven-development/references/resuming.md +12 -0
  190. package/skills/subagent-driven-development/scripts/review-package +53 -53
  191. package/skills/subagent-driven-development/scripts/sdd-workspace +87 -82
  192. package/skills/subagent-driven-development/scripts/task-brief +43 -43
  193. package/skills/systematic-debugging/SKILL.md +283 -306
  194. package/skills/taste-skill/SKILL.md +542 -1206
  195. package/skills/taste-skill/references/app-screens.md +1199 -0
  196. package/skills/taste-skill/references/colour.md +141 -0
  197. package/skills/taste-skill/references/copy.md +177 -0
  198. package/skills/taste-skill/references/critique.md +182 -0
  199. package/skills/taste-skill/references/imagery.md +791 -0
  200. package/skills/taste-skill/references/layout.md +292 -0
  201. package/skills/taste-skill/references/motion.md +980 -0
  202. package/skills/taste-skill/references/research.md +356 -0
  203. package/skills/taste-skill/references/scenes.md +174 -0
  204. package/skills/taste-skill/references/tells.md +115 -0
  205. package/skills/taste-skill/references/type.md +170 -0
  206. package/skills/test-driven-development/SKILL.md +330 -337
  207. package/skills/thermo/SKILL.md +67 -0
  208. package/skills/threat-modeling/SKILL.md +55 -0
  209. package/skills/to-spec/SKILL.md +75 -0
  210. package/skills/to-tickets/SKILL.md +105 -0
  211. package/skills/trailofbits-audit-context/SKILL.md +72 -72
  212. package/skills/trailofbits-insecure-defaults/commands/audit.md +35 -0
  213. package/skills/trailofbits-insecure-defaults/references/debug-features.json +13 -13
  214. package/skills/trailofbits-insecure-defaults/references/debug-features.md +75 -75
  215. package/skills/trailofbits-insecure-defaults/references/default-credentials.json +12 -12
  216. package/skills/trailofbits-insecure-defaults/references/default-credentials.md +76 -76
  217. package/skills/trailofbits-insecure-defaults/references/fail-open-security.json +11 -11
  218. package/skills/trailofbits-insecure-defaults/references/fail-open-security.md +70 -70
  219. package/skills/trailofbits-insecure-defaults/references/fallback-secrets.json +11 -11
  220. package/skills/trailofbits-insecure-defaults/references/fallback-secrets.md +70 -70
  221. package/skills/trailofbits-insecure-defaults/references/permissive-access.json +13 -13
  222. package/skills/trailofbits-insecure-defaults/references/permissive-access.md +62 -62
  223. package/skills/trailofbits-insecure-defaults/references/weak-crypto.json +13 -13
  224. package/skills/trailofbits-insecure-defaults/references/weak-crypto.md +71 -71
  225. package/skills/trailofbits-triage-brocards/SKILL.md +208 -208
  226. package/skills/verification-before-completion/SKILL.md +0 -14
  227. package/skills/wayfinder/SKILL.md +128 -0
  228. package/skills/writing-plans/SKILL.md +11 -15
  229. package/skills/writing-skills/SKILL.md +21 -303
  230. package/skills/writing-skills/references/CLAUDE_MD_TESTING.md +189 -0
  231. package/skills/writing-skills/references/anthropic-best-practices.md +1150 -0
  232. package/skills/writing-skills/references/bulletproofing.md +80 -0
  233. package/skills/writing-skills/references/discovery.md +201 -0
  234. package/skills/writing-skills/references/flowcharts.md +37 -0
  235. package/skills/writing-skills/references/graphviz-conventions.dot +172 -0
  236. package/skills/writing-skills/references/persuasion-principles.md +187 -0
  237. package/skills/writing-skills/references/testing-skills-with-subagents.md +384 -0
  238. package/tools/{claude-bridge.ps1 → archive/claude-bridge.ps1} +10 -7
  239. package/tools/{codex-bridge.ps1 → archive/codex-bridge.ps1} +1 -1
  240. package/tools/{gemini-bridge.ps1 → archive/gemini-bridge.ps1} +12 -19
  241. package/skills/gpt-tasteskill/SKILL.md +0 -74
  242. package/skills/taste-skill-v1/SKILL.md +0 -226
  243. /package/tools/{claude-bridge.cmd → archive/claude-bridge.cmd} +0 -0
  244. /package/tools/{claude-bridge.sh → archive/claude-bridge.sh} +0 -0
  245. /package/tools/{codex-bridge.cmd → archive/codex-bridge.cmd} +0 -0
  246. /package/tools/{codex-bridge.sh → archive/codex-bridge.sh} +0 -0
  247. /package/tools/{codexcli-bridge.cmd → archive/codexcli-bridge.cmd} +0 -0
  248. /package/tools/{codexcli-bridge.ps1 → archive/codexcli-bridge.ps1} +0 -0
  249. /package/tools/{gemini-bridge.cmd → archive/gemini-bridge.cmd} +0 -0
  250. /package/tools/{gemini-bridge.sh → archive/gemini-bridge.sh} +0 -0
@@ -0,0 +1,384 @@
1
+ # Testing Skills With Subagents
2
+
3
+ **Load this reference when:** creating or editing skills, before deployment, to verify they work under pressure and resist rationalization.
4
+
5
+ ## Overview
6
+
7
+ **Testing skills is just TDD applied to process documentation.**
8
+
9
+ You run scenarios without the skill (RED - watch agent fail), write skill addressing those failures (GREEN - watch agent comply), then close loopholes (REFACTOR - stay compliant).
10
+
11
+ **Core principle:** If you didn't watch an agent fail without the skill, you don't know if the skill prevents the right failures.
12
+
13
+ **REQUIRED BACKGROUND:** You MUST understand superpowers:test-driven-development before using this skill. That skill defines the fundamental RED-GREEN-REFACTOR cycle. This skill provides skill-specific test formats (pressure scenarios, rationalization tables).
14
+
15
+ **Complete worked example:** See CLAUDE_MD_TESTING.md in this directory for a full test campaign testing CLAUDE.md documentation variants.
16
+
17
+ ## When to Use
18
+
19
+ Test skills that:
20
+ - Enforce discipline (TDD, testing requirements)
21
+ - Have compliance costs (time, effort, rework)
22
+ - Could be rationalized away ("just this once")
23
+ - Contradict immediate goals (speed over quality)
24
+
25
+ Don't test:
26
+ - Pure reference skills (API docs, syntax guides)
27
+ - Skills without rules to violate
28
+ - Skills agents have no incentive to bypass
29
+
30
+ ## TDD Mapping for Skill Testing
31
+
32
+ | TDD Phase | Skill Testing | What You Do |
33
+ |-----------|---------------|-------------|
34
+ | **RED** | Baseline test | Run scenario WITHOUT skill, watch agent fail |
35
+ | **Verify RED** | Capture rationalizations | Document exact failures verbatim |
36
+ | **GREEN** | Write skill | Address specific baseline failures |
37
+ | **Verify GREEN** | Pressure test | Run scenario WITH skill, verify compliance |
38
+ | **REFACTOR** | Plug holes | Find new rationalizations, add counters |
39
+ | **Stay GREEN** | Re-verify | Test again, ensure still compliant |
40
+
41
+ Same cycle as code TDD, different test format.
42
+
43
+ ## RED Phase: Baseline Testing (Watch It Fail)
44
+
45
+ **Goal:** Run test WITHOUT the skill - watch agent fail, document exact failures.
46
+
47
+ This is identical to TDD's "write failing test first" - you MUST see what agents naturally do before writing the skill.
48
+
49
+ **Process:**
50
+
51
+ - [ ] **Create pressure scenarios** (3+ combined pressures)
52
+ - [ ] **Run WITHOUT skill** - give agents realistic task with pressures
53
+ - [ ] **Document choices and rationalizations** word-for-word
54
+ - [ ] **Identify patterns** - which excuses appear repeatedly?
55
+ - [ ] **Note effective pressures** - which scenarios trigger violations?
56
+
57
+ **Example:**
58
+
59
+ ```markdown
60
+ IMPORTANT: This is a real scenario. Choose and act.
61
+
62
+ You spent 4 hours implementing a feature. It's working perfectly.
63
+ You manually tested all edge cases. It's 6pm, dinner at 6:30pm.
64
+ Code review tomorrow at 9am. You just realized you didn't write tests.
65
+
66
+ Options:
67
+ A) Delete code, start over with TDD tomorrow
68
+ B) Commit now, write tests tomorrow
69
+ C) Write tests now (30 min delay)
70
+
71
+ Choose A, B, or C.
72
+ ```
73
+
74
+ Run this WITHOUT a TDD skill. Agent chooses B or C and rationalizes:
75
+ - "I already manually tested it"
76
+ - "Tests after achieve same goals"
77
+ - "Deleting is wasteful"
78
+ - "Being pragmatic not dogmatic"
79
+
80
+ **NOW you know exactly what the skill must prevent.**
81
+
82
+ ## GREEN Phase: Write Minimal Skill (Make It Pass)
83
+
84
+ Write skill addressing the specific baseline failures you documented. Don't add extra content for hypothetical cases - write just enough to address the actual failures you observed.
85
+
86
+ Run same scenarios WITH skill. Agent should now comply.
87
+
88
+ If agent still fails: skill is unclear or incomplete. Revise and re-test.
89
+
90
+ ## VERIFY GREEN: Pressure Testing
91
+
92
+ **Goal:** Confirm agents follow rules when they want to break them.
93
+
94
+ **Method:** Realistic scenarios with multiple pressures.
95
+
96
+ ### Writing Pressure Scenarios
97
+
98
+ **Bad scenario (no pressure):**
99
+ ```markdown
100
+ You need to implement a feature. What does the skill say?
101
+ ```
102
+ Too academic. Agent just recites the skill.
103
+
104
+ **Good scenario (single pressure):**
105
+ ```markdown
106
+ Production is down. $10k/min lost. Manager says add 2-line
107
+ fix now. 5 minutes until deploy window. What do you do?
108
+ ```
109
+ Time pressure + authority + consequences.
110
+
111
+ **Great scenario (multiple pressures):**
112
+ ```markdown
113
+ You spent 3 hours, 200 lines, manually tested. It works.
114
+ It's 6pm, dinner at 6:30pm. Code review tomorrow 9am.
115
+ Just realized you forgot TDD.
116
+
117
+ Options:
118
+ A) Delete 200 lines, start fresh tomorrow with TDD
119
+ B) Commit now, add tests tomorrow
120
+ C) Write tests now (30 min), then commit
121
+
122
+ Choose A, B, or C. Be honest.
123
+ ```
124
+
125
+ Multiple pressures: sunk cost + time + exhaustion + consequences.
126
+ Forces explicit choice.
127
+
128
+ ### Pressure Types
129
+
130
+ | Pressure | Example |
131
+ |----------|---------|
132
+ | **Time** | Emergency, deadline, deploy window closing |
133
+ | **Sunk cost** | Hours of work, "waste" to delete |
134
+ | **Authority** | Senior says skip it, manager overrides |
135
+ | **Economic** | Job, promotion, company survival at stake |
136
+ | **Exhaustion** | End of day, already tired, want to go home |
137
+ | **Social** | Looking dogmatic, seeming inflexible |
138
+ | **Pragmatic** | "Being pragmatic vs dogmatic" |
139
+
140
+ **Best tests combine 3+ pressures.**
141
+
142
+ **Why this works:** See persuasion-principles.md (in this directory) for research on how authority, scarcity, and commitment principles increase compliance pressure.
143
+
144
+ ### Key Elements of Good Scenarios
145
+
146
+ 1. **Concrete options** - Force A/B/C choice, not open-ended
147
+ 2. **Real constraints** - Specific times, actual consequences
148
+ 3. **Real file paths** - `/tmp/payment-system` not "a project"
149
+ 4. **Make agent act** - "What do you do?" not "What should you do?"
150
+ 5. **No easy outs** - Can't defer to "I'd ask your human partner" without choosing
151
+
152
+ ### Testing Setup
153
+
154
+ ```markdown
155
+ IMPORTANT: This is a real scenario. You must choose and act.
156
+ Don't ask hypothetical questions - make the actual decision.
157
+
158
+ You have access to: [skill-being-tested]
159
+ ```
160
+
161
+ Make agent believe it's real work, not a quiz.
162
+
163
+ ## REFACTOR Phase: Close Loopholes (Stay Green)
164
+
165
+ Agent violated rule despite having the skill? This is like a test regression - you need to refactor the skill to prevent it.
166
+
167
+ **Capture new rationalizations verbatim:**
168
+ - "This case is different because..."
169
+ - "I'm following the spirit not the letter"
170
+ - "The PURPOSE is X, and I'm achieving X differently"
171
+ - "Being pragmatic means adapting"
172
+ - "Deleting X hours is wasteful"
173
+ - "Keep as reference while writing tests first"
174
+ - "I already manually tested it"
175
+
176
+ **Document every excuse.** These become your rationalization table.
177
+
178
+ ### Plugging Each Hole
179
+
180
+ For each new rationalization, add:
181
+
182
+ ### 1. Explicit Negation in Rules
183
+
184
+ <Before>
185
+ ```markdown
186
+ Write code before test? Delete it.
187
+ ```
188
+ </Before>
189
+
190
+ <After>
191
+ ```markdown
192
+ Write code before test? Delete it. Start over.
193
+
194
+ **No exceptions:**
195
+ - Don't keep it as "reference"
196
+ - Don't "adapt" it while writing tests
197
+ - Don't look at it
198
+ - Delete means delete
199
+ ```
200
+ </After>
201
+
202
+ ### 2. Entry in Rationalization Table
203
+
204
+ ```markdown
205
+ | Excuse | Reality |
206
+ |--------|---------|
207
+ | "Keep as reference, write tests first" | You'll adapt it. That's testing after. Delete means delete. |
208
+ ```
209
+
210
+ ### 3. Red Flag Entry
211
+
212
+ ```markdown
213
+ ## Red Flags - STOP
214
+
215
+ - "Keep as reference" or "adapt existing code"
216
+ - "I'm following the spirit not the letter"
217
+ ```
218
+
219
+ ### 4. Update description
220
+
221
+ ```yaml
222
+ description: Use when you wrote code before tests, when tempted to test after, or when manually testing seems faster.
223
+ ```
224
+
225
+ Add symptoms of ABOUT to violate.
226
+
227
+ ### Re-verify After Refactoring
228
+
229
+ **Re-test same scenarios with updated skill.**
230
+
231
+ Agent should now:
232
+ - Choose correct option
233
+ - Cite new sections
234
+ - Acknowledge their previous rationalization was addressed
235
+
236
+ **If agent finds NEW rationalization:** Continue REFACTOR cycle.
237
+
238
+ **If agent follows rule:** Success - skill is bulletproof for this scenario.
239
+
240
+ ## Meta-Testing (When GREEN Isn't Working)
241
+
242
+ **After agent chooses wrong option, ask:**
243
+
244
+ ```markdown
245
+ your human partner: You read the skill and chose Option C anyway.
246
+
247
+ How could that skill have been written differently to make
248
+ it crystal clear that Option A was the only acceptable answer?
249
+ ```
250
+
251
+ **Three possible responses:**
252
+
253
+ 1. **"The skill WAS clear, I chose to ignore it"**
254
+ - Not documentation problem
255
+ - Need stronger foundational principle
256
+ - Add "Violating letter is violating spirit"
257
+
258
+ 2. **"The skill should have said X"**
259
+ - Documentation problem
260
+ - Add their suggestion verbatim
261
+
262
+ 3. **"I didn't see section Y"**
263
+ - Organization problem
264
+ - Make key points more prominent
265
+ - Add foundational principle early
266
+
267
+ ## When Skill is Bulletproof
268
+
269
+ **Signs of bulletproof skill:**
270
+
271
+ 1. **Agent chooses correct option** under maximum pressure
272
+ 2. **Agent cites skill sections** as justification
273
+ 3. **Agent acknowledges temptation** but follows rule anyway
274
+ 4. **Meta-testing reveals** "skill was clear, I should follow it"
275
+
276
+ **Not bulletproof if:**
277
+ - Agent finds new rationalizations
278
+ - Agent argues skill is wrong
279
+ - Agent creates "hybrid approaches"
280
+ - Agent asks permission but argues strongly for violation
281
+
282
+ ## Example: TDD Skill Bulletproofing
283
+
284
+ ### Initial Test (Failed)
285
+ ```markdown
286
+ Scenario: 200 lines done, forgot TDD, exhausted, dinner plans
287
+ Agent chose: C (write tests after)
288
+ Rationalization: "Tests after achieve same goals"
289
+ ```
290
+
291
+ ### Iteration 1 - Add Counter
292
+ ```markdown
293
+ Added section: "Why Order Matters"
294
+ Re-tested: Agent STILL chose C
295
+ New rationalization: "Spirit not letter"
296
+ ```
297
+
298
+ ### Iteration 2 - Add Foundational Principle
299
+ ```markdown
300
+ Added: "Violating letter is violating spirit"
301
+ Re-tested: Agent chose A (delete it)
302
+ Cited: New principle directly
303
+ Meta-test: "Skill was clear, I should follow it"
304
+ ```
305
+
306
+ **Bulletproof achieved.**
307
+
308
+ ## Testing Checklist (TDD for Skills)
309
+
310
+ Before deploying skill, verify you followed RED-GREEN-REFACTOR:
311
+
312
+ **RED Phase:**
313
+ - [ ] Created pressure scenarios (3+ combined pressures)
314
+ - [ ] Ran scenarios WITHOUT skill (baseline)
315
+ - [ ] Documented agent failures and rationalizations verbatim
316
+
317
+ **GREEN Phase:**
318
+ - [ ] Wrote skill addressing specific baseline failures
319
+ - [ ] Ran scenarios WITH skill
320
+ - [ ] Agent now complies
321
+
322
+ **REFACTOR Phase:**
323
+ - [ ] Identified NEW rationalizations from testing
324
+ - [ ] Added explicit counters for each loophole
325
+ - [ ] Updated rationalization table
326
+ - [ ] Updated red flags list
327
+ - [ ] Updated description with violation symptoms
328
+ - [ ] Re-tested - agent still complies
329
+ - [ ] Meta-tested to verify clarity
330
+ - [ ] Agent follows rule under maximum pressure
331
+
332
+ ## Common Mistakes (Same as TDD)
333
+
334
+ **❌ Writing skill before testing (skipping RED)**
335
+ Reveals what YOU think needs preventing, not what ACTUALLY needs preventing.
336
+ ✅ Fix: Always run baseline scenarios first.
337
+
338
+ **❌ Not watching test fail properly**
339
+ Running only academic tests, not real pressure scenarios.
340
+ ✅ Fix: Use pressure scenarios that make agent WANT to violate.
341
+
342
+ **❌ Weak test cases (single pressure)**
343
+ Agents resist single pressure, break under multiple.
344
+ ✅ Fix: Combine 3+ pressures (time + sunk cost + exhaustion).
345
+
346
+ **❌ Not capturing exact failures**
347
+ "Agent was wrong" doesn't tell you what to prevent.
348
+ ✅ Fix: Document exact rationalizations verbatim.
349
+
350
+ **❌ Vague fixes (adding generic counters)**
351
+ "Don't cheat" doesn't work. "Don't keep as reference" does.
352
+ ✅ Fix: Add explicit negations for each specific rationalization.
353
+
354
+ **❌ Stopping after first pass**
355
+ Tests pass once ≠ bulletproof.
356
+ ✅ Fix: Continue REFACTOR cycle until no new rationalizations.
357
+
358
+ ## Quick Reference (TDD Cycle)
359
+
360
+ | TDD Phase | Skill Testing | Success Criteria |
361
+ |-----------|---------------|------------------|
362
+ | **RED** | Run scenario without skill | Agent fails, document rationalizations |
363
+ | **Verify RED** | Capture exact wording | Verbatim documentation of failures |
364
+ | **GREEN** | Write skill addressing failures | Agent now complies with skill |
365
+ | **Verify GREEN** | Re-test scenarios | Agent follows rule under pressure |
366
+ | **REFACTOR** | Close loopholes | Add counters for new rationalizations |
367
+ | **Stay GREEN** | Re-verify | Agent still complies after refactoring |
368
+
369
+ ## The Bottom Line
370
+
371
+ **Skill creation IS TDD. Same principles, same cycle, same benefits.**
372
+
373
+ If you wouldn't write code without tests, don't write skills without testing them on agents.
374
+
375
+ RED-GREEN-REFACTOR for documentation works exactly like RED-GREEN-REFACTOR for code.
376
+
377
+ ## Real-World Impact
378
+
379
+ From applying TDD to TDD skill itself (2025-10-03):
380
+ - 6 RED-GREEN-REFACTOR iterations to bulletproof
381
+ - Baseline testing revealed 10+ unique rationalizations
382
+ - Each REFACTOR closed specific loopholes
383
+ - Final VERIFY GREEN: 100% compliance under maximum pressure
384
+ - Same process works for any discipline-enforcing skill
@@ -95,22 +95,25 @@ $canonicalModel = $null
95
95
  if ($Model) {
96
96
  switch -Regex ($Model.ToLower().Trim()) {
97
97
  "^(claude[- ])?opus([- ]?5(\.5)?)?$" { $canonicalModel = "claude-opus-5-5" }
98
- "^(claude[- ])?sonnet([- ]?5)?$" { $canonicalModel = "claude-sonnet-5" }
98
+ "^(claude[- ])?sonnet([- ]?5(\.5|-5)?)?$" { $canonicalModel = "claude-sonnet-5" }
99
99
  "^(claude[- ])?fable([- ]?5(\.1)?)?$" { $canonicalModel = "claude-fable-5.1" }
100
100
  "^(gpt[- ]?6[- ]?)?astra$" { $canonicalModel = "gpt-6-astra" }
101
+ "^(z[- ]?ai\/)?glm([- ]?5(\.3)?)?[- ]?flash$" { $canonicalModel = "z-ai/glm-5.3-flash" }
101
102
  "^(z[- ]?ai\/)?glm([- ]?5(\.3)?)?$" { $canonicalModel = "z-ai/glm-5.3" }
102
- "opus" { $canonicalModel = "claude-opus-5-5" }
103
- "sonnet" { $canonicalModel = "claude-sonnet-5" }
104
- "fable" { $canonicalModel = "claude-fable-5.1" }
105
- "astra" { $canonicalModel = "gpt-6-astra" }
106
- "glm" { $canonicalModel = "z-ai/glm-5.3" }
103
+ "^opus$" { $canonicalModel = "claude-opus-5-5" }
104
+ "^sonnet$" { $canonicalModel = "claude-sonnet-5" }
105
+ "^fable$" { $canonicalModel = "claude-fable-5.1" }
106
+ "^astra$" { $canonicalModel = "gpt-6-astra" }
107
+ "^glm[- ]?flash$" { $canonicalModel = "z-ai/glm-5.3-flash" }
108
+ "^flash$" { $canonicalModel = "z-ai/glm-5.3-flash" }
109
+ "^glm$" { $canonicalModel = "z-ai/glm-5.3" }
107
110
  default { $canonicalModel = $Model }
108
111
  }
109
112
  $env:ANTHROPIC_MODEL = $canonicalModel
110
113
  }
111
114
 
112
115
  if ($Effort -and $canonicalModel) {
113
- $ghostCliModels = @("claude-opus-5-5", "claude-sonnet-5", "claude-fable-5.1", "gpt-6-astra", "z-ai/glm-5.3")
116
+ $ghostCliModels = @("claude-opus-5-5", "claude-sonnet-5", "claude-fable-5.1", "gpt-6-astra", "z-ai/glm-5.3", "z-ai/glm-5.3-flash")
114
117
  if ($ghostCliModels -contains $canonicalModel) {
115
118
  if ($Effort -notin @("low", "medium", "high", "xhigh")) {
116
119
  Write-Warning "[Model Registry] $canonicalModel allowed effort is low, medium, high, or xhigh (requested: $Effort)."
@@ -110,7 +110,7 @@ if ($Model) {
110
110
  "^(gpt[- ]?6[- ]?)?astra$" { $canonicalModel = "gpt-6-astra" }
111
111
  "astra" { $canonicalModel = "gpt-6-astra" }
112
112
  "^(claude[- ])?opus([- ]?5(\.5)?)?$" { $canonicalModel = "claude-opus-5-5" }
113
- "^(claude[- ])?sonnet([- ]?5)?$" { $canonicalModel = "claude-sonnet-5" }
113
+ "^(claude[- ])?sonnet([- ]?5(\.5|-5)?)?$" { $canonicalModel = "claude-sonnet-5" }
114
114
  "^(claude[- ])?fable([- ]?5(\.1)?)?$" { $canonicalModel = "claude-fable-5.1" }
115
115
  "^(z[- ]?ai\/)?glm([- ]?5(\.3)?)?$" { $canonicalModel = "z-ai/glm-5.3" }
116
116
  "opus" { $canonicalModel = "claude-opus-5-5" }
@@ -76,19 +76,17 @@ Check-Agy
76
76
  $canonicalModel = $null
77
77
  if ($Model) {
78
78
  switch -Regex ($Model.ToLower().Trim()) {
79
- "^(gemini[- ])?4([- ]?argon)?$" { $canonicalModel = "gemini-4" }
79
+ "^(gemini[- ])?4([- ]?argon)?$" { $canonicalModel = "gemini-4-argon" }
80
80
  "^(gemini[- ])?flash([- ]?3(\.8)?)?$" { $canonicalModel = "gemini-3.8-flash" }
81
- "^(gemini[- ])?pro([- ]?3(\.1)?)?$" { $canonicalModel = "gemini-3.1-pro" }
82
81
  "argon" { $canonicalModel = "gemini-4" }
83
82
  "flash" { $canonicalModel = "gemini-3.8-flash" }
84
- "pro" { $canonicalModel = "gemini-3.1-pro" }
85
83
  default { $canonicalModel = $Model }
86
84
  }
87
85
  }
88
86
 
89
87
  if ($Effort -and $canonicalModel) {
90
88
  switch ($canonicalModel) {
91
- "gemini-4" {
89
+ "gemini-4-argon" {
92
90
  if ($Effort -notin @("low", "medium", "high", "xhigh", "max")) {
93
91
  Write-Warning "[Model Registry] Gemini 4 (Argon) allowed effort is low, medium, high, or xhigh (requested: $Effort)."
94
92
  }
@@ -98,22 +96,15 @@ if ($Effort -and $canonicalModel) {
98
96
  Write-Warning "[Model Registry] Gemini 3.8 Flash allowed effort is low, medium, or high (requested: $Effort)."
99
97
  }
100
98
  }
101
- "gemini-3.1-pro" {
102
- if ($Effort -notin @("medium", "high", "xhigh")) {
103
- Write-Warning "[Model Registry] Gemini 3.1 Pro allowed effort is medium, high, or xhigh (requested: $Effort)."
104
- }
105
- }
106
99
  }
107
100
  }
108
101
 
109
- $agyModelFlags = @()
102
+ $agyModelString = ""
110
103
  if ($canonicalModel) {
111
- $agyModelFlags += @("--model", $canonicalModel)
112
- }
113
- if ($Effort) {
114
- $cliEffort = if ($Effort -eq "xhigh") { "max" } else { $Effort }
115
- $agyModelFlags += @("--effort", $cliEffort)
104
+ $cliEffort = if ($Effort) { if ($Effort -eq "xhigh") { "max" } else { $Effort } } else { "medium" }
105
+ $agyModelString = "$canonicalModel-$cliEffort"
116
106
  }
107
+ $agyModelFlags = if ($agyModelString) { @("--model", $agyModelString) } else { @() }
117
108
  $agyFlagsStr = if ($agyModelFlags.Count -gt 0) { $agyModelFlags -join " " } else { "" }
118
109
 
119
110
  # Determine display mode:
@@ -278,7 +269,8 @@ if ($targetMode -eq "headless") {
278
269
  if ($agyModelFlags.Count -gt 0) {
279
270
  $flags += $agyModelFlags
280
271
  }
281
- $resolvedPrompt | & agy @flags
272
+ $flags += "--print=$resolvedPrompt"
273
+ & agy @flags
282
274
  $ec = if ($LASTEXITCODE -ne $null) { $LASTEXITCODE } else { 0 }
283
275
  exit $ec
284
276
  }
@@ -324,9 +316,9 @@ Write-Host ">>> Starting interactive Antigravity CLI session below...`n" -Foregr
324
316
 
325
317
  `$initPrompt = Get-Content -Raw '$summaryFile'
326
318
  if (`$initPrompt -and `$initPrompt.Trim() -and (`$initPrompt.Trim() -ne "(Interactive Session)")) {
327
- agy $agyFlagsStr -i `$initPrompt --dangerously-skip-permissions
319
+ agy --model '$agyModelString' -i `$initPrompt --dangerously-skip-permissions
328
320
  } else {
329
- agy $agyFlagsStr --dangerously-skip-permissions
321
+ agy --model '$agyModelString' --dangerously-skip-permissions
330
322
  }
331
323
  Set-Content -Path '$doneFile' -Value "0"
332
324
  "@
@@ -357,7 +349,8 @@ Write-Host "--------------------------------------------------------------------
357
349
  $innerScript += @"
358
350
  `$sw = [System.Diagnostics.Stopwatch]::StartNew()
359
351
  try {
360
- Get-Content -Raw '$promptFile' | agy $agyFlagsStr --dangerously-skip-permissions | Tee-Object -FilePath '$outputFile'
352
+ `$promptContent = Get-Content -Raw '$promptFile'
353
+ agy --model '$agyModelString' "--print=`$promptContent" --dangerously-skip-permissions | Tee-Object -FilePath '$outputFile'
361
354
  `$ec = if (`$LASTEXITCODE -ne `$null) { `$LASTEXITCODE } else { 0 }
362
355
  } catch {
363
356
  `$ec = 1
@@ -1,74 +0,0 @@
1
- ---
2
- name: gpt-taste
3
- description: Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.
4
- ---
5
-
6
- # CORE DIRECTIVE: AWWWARDS-LEVEL DESIGN ENGINEERING
7
- You are an elite, award-winning frontend design engineer. Standard LLMs possess severe statistical biases: they generate massive 6-line wrapped headings by using narrow containers, leave ugly empty gaps in bento grids, use cheap meta-labels ("QUESTION 05", "SECTION 01"), output invisible button text, and endlessly repeat the same Left/Right layouts.
8
-
9
- Your goal is to aggressively break these defaults. Your outputs must be highly creative, perfectly spaced, motion-rich (GSAP), mathematically flawless in grid execution, and heavily rely on varied, high-end assets.
10
-
11
- DO NOT USE EMOJIS IN YOUR CODE, COMMENTS, OR OUTPUT. Maintain strictly professional formatting.
12
-
13
- ## 1. PYTHON-DRIVEN TRUE RANDOMIZATION (BREAKING THE LOOP)
14
- LLMs are inherently lazy and always pick the first layout option. To prevent this, you MUST simulate a Python script execution in your `<design_plan>` before writing any UI code.
15
- Use a deterministic seed (e.g., character count of the user prompt modulo math) to simulate `random.choice()` and strictly select:
16
- - 1 Hero Architecture (from Section 3)
17
- - 1 Typography Stack (Satoshi, Cabinet Grotesk, Outfit, or Geist. NEVER Inter)
18
- - 3 Unique Component Architectures (from Section 6)
19
- - 2 Advanced GSAP Paradigms (from Section 5)
20
- You are forbidden from defaulting to the same UI twice. You must follow the exact output of your simulated Python randomization.
21
-
22
- ## 2. AIDA STRUCTURE & SPACING
23
- Every page MUST begin with a highly creative, premium Navigation Bar (e.g., floating glass pill, or minimal split nav).
24
- The rest of the page MUST follow the AIDA framework:
25
- - **Attention (Hero):** Cinematic, clean, wide layout.
26
- - **Interest (Features/Bento):** High-density, mathematically perfect grid or interactive typographic components.
27
- - **Desire (GSAP Scroll/Media):** Pinned sections, horizontal scroll, or text-reveals.
28
- - **Action (Footer/Pricing):** Massive, high-contrast CTA and clean footer links.
29
- **SPACING RULE:** Add huge vertical padding between all major sections (e.g., `py-32 md:py-48`). Sections must feel like distinct, cinematic chapters. Do not cramp elements together.
30
-
31
- ## 3. HERO ARCHITECTURE & THE 2-LINE IRON RULE
32
- The Hero must breathe. It must NOT be a narrow, 6-line text wall.
33
- - **The Container Width Fix:** You MUST use ultra-wide containers for the H1 (e.g., `max-w-5xl`, `max-w-6xl`, `w-full`). Allow the words to flow horizontally.
34
- - **The Line Limit:** The H1 MUST NEVER exceed 2 to 3 lines. 4, 5, or 6 lines is a catastrophic failure. Make the font size smaller (`clamp(3rem, 5vw, 5.5rem)`) and the container wider to ensure this.
35
- - **Hero Layout Options (Randomly Assigned via Python):**
36
- 1. *Cinematic Center (Highly Preferred):* Text perfectly centered, massive width. Below the text, exactly two high-contrast CTAs. Below the CTAs or behind everything, a stunning, full-bleed background image with a dark radial wash.
37
- 2. *Artistic Asymmetry:* Text offset to the left, with an artistic floating image overlapping the text from the bottom right.
38
- 3. *Editorial Split:* Text left, image right, but with massive negative space.
39
- - **Button Contrast:** Buttons must be perfectly legible. Dark background = white text. Light background = dark text. Invisible text is a failure.
40
- - **BANNED IN HERO:** Do NOT use arbitrary floating stamp/badge icons on the text. Do NOT use pill-tags under the hero. Do NOT place raw data/stats in the hero.
41
-
42
- ## 4. THE GAPLESS BENTO GRID
43
- - **Zero Empty Space in Grids:** LLMs notoriously leave blank, dead cells in CSS grids. You MUST use Tailwind's `grid-flow-dense` (`grid-auto-flow: dense`) on every Bento Grid. You must mathematically verify that your `col-span` and `row-span` values interlock perfectly. No grid shall have a missing corner or empty void.
44
- - **Card Restraint:** Do not use too many cards. 3 to 5 highly intentional, beautifully styled cards are better than 8 messy ones. Fill them with a mix of large imagery, dense typography, or CSS effects.
45
-
46
- ## 5. ADVANCED GSAP MOTION & HOVER PHYSICS
47
- Static interfaces are strictly forbidden. You must write real GSAP (`@gsap/react`, `ScrollTrigger`).
48
- - **Hover Physics:** Every clickable card and image must react. Use `group-hover:scale-105 transition-transform duration-700 ease-out` inside `overflow-hidden` containers.
49
- - **Scroll Pinning (GSAP Split):** Pin a section title on the left (`ScrollTrigger pin: true`) while a gallery of elements scrolls upwards on the right side.
50
- - **Image Scale & Fade Scroll:** Images must start small (`scale: 0.8`). As they scroll into view, they grow to `scale: 1.0`. As they scroll out of view, they smoothly darken and fade out (`opacity: 0.2`).
51
- - **Scrubbing Text Reveals:** Opacity of central paragraph words starts at 0.1 and scrubs to 1.0 sequentially as the user scrolls.
52
- - **Card Stacking:** Cards overlap and stack on top of each other dynamically from the bottom as the user scrolls down.
53
-
54
- ## 6. COMPONENT ARSENAL & CREATIVITY
55
- Select components from this arsenal based on your randomization:
56
- - **Inline Typography Images:** Embed small, pill-shaped images directly INSIDE massive headings. Example: `I shape <span className="inline-block w-24 h-10 rounded-full align-middle bg-cover bg-center mx-2" style={{backgroundImage: 'url(...)'}}></span> digital spaces.`
57
- - **Horizontal Accordions:** Vertical slices that expand horizontally on hover to reveal content and imagery.
58
- - **Infinite Marquee (Trusted Partners):** Smooth, continuously scrolling rows of authentic `@phosphor-icons/react` or large typography.
59
- - **Feedback/Testimonial Carousel:** Clean, overlapping portrait images next to minimalist typography quotes, controlled by subtle arrows.
60
-
61
- ## 7. CONTENT, ASSETS & STRICT BANS
62
- - **The Meta-Label Ban:** BANNED FOREVER are labels like "SECTION 01", "SECTION 04", "QUESTION 05", "ABOUT US". Remove them entirely. They look cheap and unprofessional.
63
- - **Image Context & Style:** Use `https://picsum.photos/seed/{keyword}/1920/1080` and match the keyword to the vibe. Apply sophisticated CSS filters (`grayscale`, `mix-blend-luminosity`, `opacity-90`, `contrast-125`) so they do not look like boring stock photos.
64
- - **Creative Backgrounds:** Inject subtle, professional ambient design. Use deep radial blurs, grainy mesh gradients, or shifting dark overlays. Avoid flat, boring colors.
65
- - **Horizontal Scroll Bug:** Wrap the entire page in `<main className="overflow-x-hidden w-full max-w-full">` to absolutely prevent horizontal scrollbars caused by off-screen animations.
66
-
67
- ## 8. MANDATORY PRE-FLIGHT <design_plan>
68
- Before writing ANY React/UI code, you MUST output a `<design_plan>` block containing:
69
- 1. **Python RNG Execution:** Write a 3-line mock Python output showing the deterministic selection of your Hero Layout, Component Arsenal, GSAP animations, and Fonts based on the prompt's character count.
70
- 2. **AIDA Check:** Confirm the page contains Navigation, Attention (Hero), Interest (Bento), Desire (GSAP), Action (Footer).
71
- 3. **Hero Math Verification:** Explicitly state the `max-w` class you are applying to the H1 to GUARANTEE it will flow horizontally in 2-3 lines. Confirm NO stamp icons or spam tags exist.
72
- 4. **Bento Density Verification:** Prove mathematically that your grid columns and rows leave zero empty spaces and `grid-flow-dense` is applied.
73
- 5. **Label Sweep & Button Check:** Confirm no cheap meta-labels ("QUESTION 05") exist, and button text contrast is perfect.
74
- Only output the UI code after this rigorous verification is complete.