tribunal-kit 5.8.5 → 6.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (298) hide show
  1. package/.agent/ARCHITECTURE.md +219 -215
  2. package/.agent/agents/accessibility-reviewer.md +66 -151
  3. package/.agent/agents/ai-code-reviewer.md +22 -2
  4. package/.agent/agents/anti-pattern-reviewer.md +99 -0
  5. package/.agent/agents/api-architect.md +19 -2
  6. package/.agent/agents/backend-specialist.md +25 -3
  7. package/.agent/agents/cloud-engineer.md +21 -0
  8. package/.agent/agents/code-archaeologist.md +20 -3
  9. package/.agent/agents/complexity-reviewer.md +22 -2
  10. package/.agent/agents/database-architect.md +24 -3
  11. package/.agent/agents/db-latency-auditor.md +22 -2
  12. package/.agent/agents/debugger.md +19 -3
  13. package/.agent/agents/dependency-reviewer.md +19 -2
  14. package/.agent/agents/devops-engineer.md +24 -3
  15. package/.agent/agents/documentation-writer.md +21 -3
  16. package/.agent/agents/explorer-agent.md +21 -3
  17. package/.agent/agents/frontend-reviewer.md +19 -3
  18. package/.agent/agents/frontend-specialist.md +72 -224
  19. package/.agent/agents/game-developer.md +22 -3
  20. package/.agent/agents/interaction-reviewer.md +118 -0
  21. package/.agent/agents/logic-reviewer.md +18 -3
  22. package/.agent/agents/minimalist-reviewer.md +98 -0
  23. package/.agent/agents/mobile-developer.md +21 -3
  24. package/.agent/agents/mobile-reviewer.md +22 -2
  25. package/.agent/agents/orchestrator.md +19 -3
  26. package/.agent/agents/penetration-tester.md +22 -3
  27. package/.agent/agents/performance-optimizer.md +21 -3
  28. package/.agent/agents/performance-reviewer.md +2 -0
  29. package/.agent/agents/precedence-reviewer.md +19 -5
  30. package/.agent/agents/product-manager.md +20 -3
  31. package/.agent/agents/product-owner.md +22 -1
  32. package/.agent/agents/product-reviewer.md +98 -0
  33. package/.agent/agents/project-planner.md +19 -3
  34. package/.agent/agents/qa-automation-engineer.md +24 -3
  35. package/.agent/agents/resilience-reviewer.md +21 -2
  36. package/.agent/agents/schema-reviewer.md +21 -2
  37. package/.agent/agents/security-auditor.md +7 -1
  38. package/.agent/agents/seo-specialist.md +18 -3
  39. package/.agent/agents/sql-reviewer.md +22 -2
  40. package/.agent/agents/supervisor-agent.md +22 -3
  41. package/.agent/agents/swarm-worker-registry.md +7 -0
  42. package/.agent/agents/system-architect.md +19 -0
  43. package/.agent/agents/test-coverage-reviewer.md +22 -2
  44. package/.agent/agents/test-engineer.md +21 -2
  45. package/.agent/agents/throughput-optimizer.md +22 -2
  46. package/.agent/agents/type-safety-reviewer.md +21 -2
  47. package/.agent/agents/ui-ux-auditor.md +44 -242
  48. package/.agent/agents/ui-visual-auditor.md +99 -0
  49. package/.agent/agents/ux-reviewer.md +104 -0
  50. package/.agent/agents/visual-reviewer.md +98 -0
  51. package/.agent/agents/vitals-reviewer.md +23 -2
  52. package/.agent/history/README.md +53 -0
  53. package/.agent/history/case-law/cases/template-case.json +19 -0
  54. package/.agent/history/integrity_manifest.json +63 -33
  55. package/.agent/history/memory/.memory.idx +517 -1
  56. package/.agent/history/memory/MEMORY.md +35 -1
  57. package/.agent/routing_index.json +272 -690
  58. package/.agent/rules/GEMINI.md +10 -12
  59. package/.agent/rules/GEMINI_PLANNER.md +84 -0
  60. package/.agent/scripts/case_law_manager.js +2 -0
  61. package/.agent/scripts/context_broker.js +152 -0
  62. package/.agent/scripts/guardrail_engine.js +59 -4
  63. package/.agent/scripts/impact_classifier.js +167 -0
  64. package/.agent/scripts/minimal_change_engine.js +437 -0
  65. package/.agent/scripts/pipeline_engine.js +856 -0
  66. package/.agent/scripts/socratic_gate_policy.js +60 -0
  67. package/.agent/scripts/token_budget_broker.js +52 -0
  68. package/.agent/scripts/verify_all.js +13 -0
  69. package/.agent/scripts/visual_audit.js +92 -0
  70. package/.agent/skills/12-principles-of-animation/SKILL.md +19 -10
  71. package/.agent/skills/60fps-animation/SKILL.md +19 -10
  72. package/.agent/skills/accessible-animation/SKILL.md +19 -10
  73. package/.agent/skills/adapt/SKILL.md +19 -10
  74. package/.agent/skills/advanced-rag-pipelines/SKILL.md +21 -3
  75. package/.agent/skills/agent-organizer/SKILL.md +21 -7
  76. package/.agent/skills/agentic-patterns/SKILL.md +19 -7
  77. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +21 -7
  78. package/.agent/skills/animation-on-scroll/SKILL.md +19 -10
  79. package/.agent/skills/animation-systems/SKILL.md +19 -10
  80. package/.agent/skills/antfu-conventions/SKILL.md +21 -10
  81. package/.agent/skills/api-patterns/SKILL.md +21 -7
  82. package/.agent/skills/api-security-auditor/SKILL.md +21 -7
  83. package/.agent/skills/app-builder/SKILL.md +21 -7
  84. package/.agent/skills/apple-design/SKILL.md +19 -10
  85. package/.agent/skills/architecture/SKILL.md +21 -7
  86. package/.agent/skills/audit-and-fix/SKILL.md +19 -10
  87. package/.agent/skills/authentication-best-practices/SKILL.md +21 -7
  88. package/.agent/skills/backend-security-expert/SKILL.md +21 -7
  89. package/.agent/skills/baseline-ui/SKILL.md +19 -10
  90. package/.agent/skills/bash-linux/SKILL.md +21 -7
  91. package/.agent/skills/behavioral-modes/SKILL.md +19 -7
  92. package/.agent/skills/better-colors/SKILL.md +19 -10
  93. package/.agent/skills/better-ui/SKILL.md +19 -10
  94. package/.agent/skills/bolder/SKILL.md +19 -10
  95. package/.agent/skills/brainstorming/SKILL.md +17 -7
  96. package/.agent/skills/browser-native-ai/SKILL.md +19 -3
  97. package/.agent/skills/build-primitive/SKILL.md +19 -10
  98. package/.agent/skills/building-native-ui/SKILL.md +21 -7
  99. package/.agent/skills/cicd-pro/SKILL.md +21 -10
  100. package/.agent/skills/clarify/SKILL.md +19 -10
  101. package/.agent/skills/clean-code/SKILL.md +21 -7
  102. package/.agent/skills/cloud-architect/SKILL.md +21 -10
  103. package/.agent/skills/cobejs/SKILL.md +19 -10
  104. package/.agent/skills/code-review-checklist/SKILL.md +21 -7
  105. package/.agent/skills/codebase-design/SKILL.md +21 -10
  106. package/.agent/skills/colorize/SKILL.md +19 -10
  107. package/.agent/skills/compact-landing/SKILL.md +19 -10
  108. package/.agent/skills/company-logos/SKILL.md +19 -10
  109. package/.agent/skills/config-validator/SKILL.md +21 -7
  110. package/.agent/skills/containerization-pro/SKILL.md +21 -10
  111. package/.agent/skills/create-design-md/SKILL.md +19 -10
  112. package/.agent/skills/critique/SKILL.md +19 -10
  113. package/.agent/skills/csharp-developer/SKILL.md +21 -7
  114. package/.agent/skills/data-validation-schemas/SKILL.md +21 -7
  115. package/.agent/skills/database-design/SKILL.md +21 -7
  116. package/.agent/skills/delight/SKILL.md +19 -10
  117. package/.agent/skills/deployment-procedures/SKILL.md +21 -7
  118. package/.agent/skills/design-lab/SKILL.md +21 -10
  119. package/.agent/skills/devops-engineer/SKILL.md +21 -7
  120. package/.agent/skills/devops-incident-responder/SKILL.md +21 -7
  121. package/.agent/skills/diagnosing-bugs/SKILL.md +21 -10
  122. package/.agent/skills/distill/SKILL.md +19 -10
  123. package/.agent/skills/documentation-templates/SKILL.md +21 -7
  124. package/.agent/skills/domain-modeling/SKILL.md +21 -10
  125. package/.agent/skills/edge-computing/SKILL.md +21 -7
  126. package/.agent/skills/emil-design-eng/SKILL.md +19 -10
  127. package/.agent/skills/error-resilience/SKILL.md +21 -7
  128. package/.agent/skills/extract-design-system/SKILL.md +21 -7
  129. package/.agent/skills/fabel-protocol/SKILL.md +19 -2
  130. package/.agent/skills/fixing-accessibility/SKILL.md +19 -10
  131. package/.agent/skills/fixing-metadata/SKILL.md +19 -10
  132. package/.agent/skills/fixing-motion-performance/SKILL.md +19 -10
  133. package/.agent/skills/framer-motion-expert/SKILL.md +19 -6
  134. package/.agent/skills/frontend-design/SKILL.md +64 -201
  135. package/.agent/skills/frontend-security-expert/SKILL.md +21 -7
  136. package/.agent/skills/game-design-expert/SKILL.md +21 -7
  137. package/.agent/skills/game-engineering-expert/SKILL.md +21 -7
  138. package/.agent/skills/generative-ui-expert/SKILL.md +19 -3
  139. package/.agent/skills/geo-fundamentals/SKILL.md +21 -7
  140. package/.agent/skills/git-pro/SKILL.md +21 -10
  141. package/.agent/skills/github-operations/SKILL.md +21 -7
  142. package/.agent/skills/gpt-taste/SKILL.md +19 -10
  143. package/.agent/skills/gsap-core/SKILL.md +21 -4
  144. package/.agent/skills/gsap-frameworks/SKILL.md +21 -4
  145. package/.agent/skills/gsap-performance/SKILL.md +20 -5
  146. package/.agent/skills/gsap-plugins/SKILL.md +20 -5
  147. package/.agent/skills/gsap-react/SKILL.md +20 -5
  148. package/.agent/skills/gsap-scrolltrigger/SKILL.md +21 -4
  149. package/.agent/skills/gsap-timeline/SKILL.md +20 -5
  150. package/.agent/skills/gsap-utils/SKILL.md +20 -5
  151. package/.agent/skills/harden/SKILL.md +19 -10
  152. package/.agent/skills/harness-protocol/SKILL.md +20 -4
  153. package/.agent/skills/i18n-localization/SKILL.md +21 -7
  154. package/.agent/skills/impeccable/SKILL.md +19 -10
  155. package/.agent/skills/improve-codebase-architecture/SKILL.md +21 -10
  156. package/.agent/skills/improve-ui/SKILL.md +19 -10
  157. package/.agent/skills/intelligent-routing/SKILL.md +19 -7
  158. package/.agent/skills/knowledge-graph/SKILL.md +20 -4
  159. package/.agent/skills/landing-page/SKILL.md +20 -10
  160. package/.agent/skills/lint-and-validate/SKILL.md +21 -7
  161. package/.agent/skills/llm-engineering/SKILL.md +21 -7
  162. package/.agent/skills/local-first/SKILL.md +21 -7
  163. package/.agent/skills/local-first-architecture/SKILL.md +19 -10
  164. package/.agent/skills/lottie-animation/SKILL.md +19 -10
  165. package/.agent/skills/marquee-loop/SKILL.md +19 -10
  166. package/.agent/skills/masked-reveal/SKILL.md +19 -10
  167. package/.agent/skills/mcp-builder/SKILL.md +21 -7
  168. package/.agent/skills/micro-interaction/SKILL.md +19 -10
  169. package/.agent/skills/mobile-design/SKILL.md +21 -6
  170. package/.agent/skills/monorepo-management/SKILL.md +21 -7
  171. package/.agent/skills/morphing-icons/SKILL.md +19 -10
  172. package/.agent/skills/motion-engineering/SKILL.md +20 -7
  173. package/.agent/skills/nextjs-react-expert/SKILL.md +19 -7
  174. package/.agent/skills/nodejs-best-practices/SKILL.md +21 -7
  175. package/.agent/skills/observability/SKILL.md +21 -7
  176. package/.agent/skills/page-transition-animation/SKILL.md +19 -10
  177. package/.agent/skills/parallel-agents/SKILL.md +23 -7
  178. package/.agent/skills/performance-profiling/SKILL.md +21 -7
  179. package/.agent/skills/plan-writing/SKILL.md +21 -7
  180. package/.agent/skills/platform-engineer/SKILL.md +21 -7
  181. package/.agent/skills/playwright-best-practices/SKILL.md +21 -7
  182. package/.agent/skills/polish/SKILL.md +19 -10
  183. package/.agent/skills/powershell-windows/SKILL.md +21 -7
  184. package/.agent/skills/pricing-page/SKILL.md +19 -10
  185. package/.agent/skills/product-aware-heuristics/SKILL.md +358 -0
  186. package/.agent/skills/progressive-blur/SKILL.md +19 -10
  187. package/.agent/skills/project-idioms/SKILL.md +20 -8
  188. package/.agent/skills/python-patterns/SKILL.md +21 -7
  189. package/.agent/skills/python-pro/SKILL.md +21 -6
  190. package/.agent/skills/quieter/SKILL.md +19 -10
  191. package/.agent/skills/react-doctor/SKILL.md +19 -10
  192. package/.agent/skills/react-specialist/SKILL.md +19 -6
  193. package/.agent/skills/readme-builder/SKILL.md +21 -7
  194. package/.agent/skills/realtime-patterns/SKILL.md +21 -7
  195. package/.agent/skills/red-team-tactics/SKILL.md +21 -7
  196. package/.agent/skills/redesign-skill/SKILL.md +19 -10
  197. package/.agent/skills/review-animations/SKILL.md +21 -10
  198. package/.agent/skills/rust-pro/SKILL.md +21 -7
  199. package/.agent/skills/seo-fundamentals/SKILL.md +21 -7
  200. package/.agent/skills/server-management/SKILL.md +21 -7
  201. package/.agent/skills/shadcn-ui-expert/SKILL.md +21 -7
  202. package/.agent/skills/shape/SKILL.md +19 -10
  203. package/.agent/skills/skill-creator/SKILL.md +21 -7
  204. package/.agent/skills/soft-skill/SKILL.md +19 -10
  205. package/.agent/skills/sounds-on-the-web/SKILL.md +19 -10
  206. package/.agent/skills/sql-pro/SKILL.md +21 -7
  207. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +21 -7
  208. package/.agent/skills/svg-animation/SKILL.md +19 -10
  209. package/.agent/skills/swiftui-expert/SKILL.md +21 -7
  210. package/.agent/skills/swiss-design/SKILL.md +19 -10
  211. package/.agent/skills/system-design-pro/SKILL.md +21 -9
  212. package/.agent/skills/systematic-debugging/SKILL.md +21 -7
  213. package/.agent/skills/tailwind-patterns/SKILL.md +21 -7
  214. package/.agent/skills/taste-skill/SKILL.md +19 -10
  215. package/.agent/skills/tdd-workflow/SKILL.md +21 -10
  216. package/.agent/skills/test-result-analyzer/SKILL.md +18 -6
  217. package/.agent/skills/testing-patterns/SKILL.md +21 -7
  218. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +21 -10
  219. package/.agent/skills/thinking-protocol/SKILL.md +20 -8
  220. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +19 -10
  221. package/.agent/skills/transitions-dev/SKILL.md +19 -10
  222. package/.agent/skills/trend-researcher/SKILL.md +17 -6
  223. package/.agent/skills/typescript-advanced/SKILL.md +21 -7
  224. package/.agent/skills/typeset/SKILL.md +19 -10
  225. package/.agent/skills/ui-reasoning-engine/SKILL.md +154 -0
  226. package/.agent/skills/ui-skill-packs/SKILL.md +77 -0
  227. package/.agent/skills/ui-skills-root/SKILL.md +21 -9
  228. package/.agent/skills/ui-ux-pro-max/SKILL.md +62 -583
  229. package/.agent/skills/ui-ux-researcher/SKILL.md +17 -6
  230. package/.agent/skills/vue-expert/SKILL.md +19 -6
  231. package/.agent/skills/vulnerability-scanner/SKILL.md +21 -7
  232. package/.agent/skills/web-accessibility-auditor/SKILL.md +21 -7
  233. package/.agent/skills/web-design-guidelines/SKILL.md +32 -206
  234. package/.agent/skills/web-quality-audit/SKILL.md +19 -10
  235. package/.agent/skills/webapp-testing/SKILL.md +21 -7
  236. package/.agent/skills/webgpu-performance/SKILL.md +19 -3
  237. package/.agent/skills/whimsy-injector/SKILL.md +20 -10
  238. package/.agent/skills/workflow-optimizer/SKILL.md +16 -6
  239. package/.agent/templates/DESIGN.md +292 -0
  240. package/.agent/templates/design-tokens.json +137 -0
  241. package/.agent/workflows/acf.md +13 -6
  242. package/.agent/workflows/api-tester.md +15 -8
  243. package/.agent/workflows/audit.md +19 -8
  244. package/.agent/workflows/brainstorm.md +14 -9
  245. package/.agent/workflows/changelog.md +14 -8
  246. package/.agent/workflows/create.md +16 -8
  247. package/.agent/workflows/debug.md +15 -10
  248. package/.agent/workflows/deploy.md +16 -8
  249. package/.agent/workflows/enhance.md +15 -10
  250. package/.agent/workflows/fix.md +15 -8
  251. package/.agent/workflows/generate.md +17 -11
  252. package/.agent/workflows/marathon.md +15 -8
  253. package/.agent/workflows/migrate.md +16 -8
  254. package/.agent/workflows/minimal.md +94 -0
  255. package/.agent/workflows/orchestrate.md +15 -8
  256. package/.agent/workflows/performance-benchmarker.md +15 -8
  257. package/.agent/workflows/pipeline.md +155 -0
  258. package/.agent/workflows/plan.md +14 -10
  259. package/.agent/workflows/preview.md +14 -7
  260. package/.agent/workflows/refactor.md +16 -8
  261. package/.agent/workflows/review-ai.md +15 -7
  262. package/.agent/workflows/review.md +15 -7
  263. package/.agent/workflows/session.md +14 -7
  264. package/.agent/workflows/status.md +13 -7
  265. package/.agent/workflows/strengthen-skills.md +15 -6
  266. package/.agent/workflows/super-prompt.md +19 -10
  267. package/.agent/workflows/swarm.md +15 -7
  268. package/.agent/workflows/test.md +15 -8
  269. package/.agent/workflows/tribunal-backend.md +16 -9
  270. package/.agent/workflows/tribunal-database.md +15 -8
  271. package/.agent/workflows/tribunal-frontend.md +26 -11
  272. package/.agent/workflows/tribunal-full.md +29 -14
  273. package/.agent/workflows/tribunal-mobile.md +15 -8
  274. package/.agent/workflows/tribunal-performance.md +15 -8
  275. package/.agent/workflows/tribunal-speed.md +16 -9
  276. package/.agent/workflows/tribunal-ui.md +82 -0
  277. package/.agent/workflows/ui-ux-pro-max.md +51 -107
  278. package/CONTRIBUTING.md +2 -2
  279. package/README.md +5 -5
  280. package/bin/mcp-server.js +81 -31
  281. package/bin/wrapper.js +17 -6
  282. package/dist/cli.js +9 -1
  283. package/dist/commands/compile.js +7 -0
  284. package/dist/commands/context.js +8 -3
  285. package/dist/commands/graph.js +8 -2
  286. package/dist/commands/init.js +13 -2
  287. package/dist/commands/memory.js +119 -68
  288. package/dist/commands/minimal.js +71 -0
  289. package/dist/commands/optimize.js +15 -5
  290. package/dist/esm/index.mjs +26 -32
  291. package/dist/utils/fs.js +10 -4
  292. package/dist/utils/helpers.js +10 -1
  293. package/dist/utils/version.js +9 -2
  294. package/mcp_config.json +10 -1
  295. package/package.json +17 -14
  296. package/scripts/benchmark.js +16 -0
  297. package/scripts/sync-version.js +1 -1
  298. package/scripts/visual_audit.js +126 -0
@@ -0,0 +1,60 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * socratic_gate_policy.js — Adaptive Socratic Gate Evaluator
4
+ * =============================================================
5
+ * Determines whether the Socratic Gate should block execution with interactive questions.
6
+ *
7
+ * Rules:
8
+ * - Tier 0 & Tier 1: Always BYPASS Socratic Gate (0 blocking questions).
9
+ * - Tier 2: Bypass UNLESS Ambiguity Score > 0.5 or explicit ambiguities are present.
10
+ * - Tier 3: Trigger Socratic Gate unless explicitly overridden with --no-gate or --express.
11
+ */
12
+
13
+ "use strict";
14
+
15
+ const { parseArgs } = require("./_utils");
16
+
17
+ /**
18
+ * Evaluates whether the Socratic Gate should be engaged.
19
+ * @param {Object} opts - Options { tier, ambiguityScore, flags, task }
20
+ * @returns {Object} { shouldBlock, reason }
21
+ */
22
+ function evaluateSocraticGate(opts = {}) {
23
+ const tier = typeof opts.tier === "number" ? opts.tier : 1;
24
+ const ambiguityScore = typeof opts.ambiguityScore === "number" ? opts.ambiguityScore : 0.2;
25
+ const flags = opts.flags || {};
26
+
27
+ if (flags["no-gate"] || flags.express || flags.force) {
28
+ return { shouldBlock: false, reason: "Explicit user override (--no-gate / --express)" };
29
+ }
30
+
31
+ if (tier === 0) {
32
+ return { shouldBlock: false, reason: "Tier 0 Fast-Pass (low impact)" };
33
+ }
34
+
35
+ if (tier === 1) {
36
+ return { shouldBlock: false, reason: "Tier 1 Express Pass (single component / logic edit)" };
37
+ }
38
+
39
+ if (tier === 2) {
40
+ if (ambiguityScore > 0.5) {
41
+ return { shouldBlock: true, reason: `Tier 2 ambiguity exceeds threshold (${ambiguityScore} > 0.5)` };
42
+ }
43
+ return { shouldBlock: false, reason: "Tier 2 low-ambiguity edit (gate bypassed)" };
44
+ }
45
+
46
+ // Tier 3
47
+ return { shouldBlock: true, reason: "Tier 3 Full Gauntlet (high risk / architectural change)" };
48
+ }
49
+
50
+ if (require.main === module) {
51
+ const args = parseArgs(process.argv);
52
+ const result = evaluateSocraticGate({
53
+ tier: args.tier ? parseInt(args.tier, 10) : 1,
54
+ ambiguityScore: args.ambiguity ? parseFloat(args.ambiguity) : 0.2,
55
+ flags: args
56
+ });
57
+ console.log(JSON.stringify(result, null, 2));
58
+ }
59
+
60
+ module.exports = { evaluateSocraticGate };
@@ -0,0 +1,52 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * token_budget_broker.js — Token Budget & Persona Optimizer
4
+ * ============================================================
5
+ * Calculates and caps context window budgets based on Governance Impact Tiers.
6
+ *
7
+ * Tier Budgets:
8
+ * - Tier 0: 0 tokens (No LLM call required)
9
+ * - Tier 1: Max 2,000 tokens (diff context + 1 skill rule)
10
+ * - Tier 2: Max 8,000 tokens (diff + 2 skill rules + context summary)
11
+ * - Tier 3: Full budget (up to model context limit)
12
+ */
13
+
14
+ "use strict";
15
+
16
+ const { parseArgs } = require("./_utils");
17
+
18
+ const TIER_TOKEN_LIMITS = {
19
+ 0: 0,
20
+ 1: 2000,
21
+ 2: 8000,
22
+ 3: 32000
23
+ };
24
+
25
+ /**
26
+ * Returns context budget constraints for a given impact tier
27
+ * @param {number} tier - Governance Impact Tier (0-3)
28
+ * @returns {Object} { maxTokens, includeFullRepo, maxSkills, maxReviewers }
29
+ */
30
+ function getTokenBudget(tier = 1) {
31
+ // Normalize tier to a valid integer in [0, 3]
32
+ const normalizedTier = (typeof tier === "number" && Number.isFinite(tier))
33
+ ? Math.max(0, Math.min(3, Math.round(tier)))
34
+ : 1;
35
+ const maxTokens = TIER_TOKEN_LIMITS[normalizedTier];
36
+
37
+ return {
38
+ tier: normalizedTier,
39
+ maxTokens,
40
+ includeFullRepo: normalizedTier >= 2,
41
+ maxSkills: normalizedTier === 0 ? 0 : normalizedTier === 1 ? 1 : normalizedTier === 2 ? 3 : 10,
42
+ maxReviewers: normalizedTier === 0 ? 0 : normalizedTier === 1 ? 1 : normalizedTier === 2 ? 2 : 8
43
+ };
44
+ }
45
+
46
+ if (require.main === module) {
47
+ const args = parseArgs(process.argv);
48
+ const tier = args.tier ? parseInt(args.tier, 10) : 1;
49
+ console.log(JSON.stringify(getTokenBudget(tier), null, 2));
50
+ }
51
+
52
+ module.exports = { getTokenBudget, TIER_TOKEN_LIMITS };
@@ -213,6 +213,19 @@ function verifyAll(cwd, skipped) {
213
213
  trackSkip("Dependency audit", "skipped by flag");
214
214
  }
215
215
 
216
+ console.log(sectionHeader("Rust Core Tests", 7));
217
+ if (!skipped.includes("rust")) {
218
+ const cargoToml = path.join(cwd, "crates", "core", "Cargo.toml");
219
+ if (fs.existsSync(cargoToml)) {
220
+ if (!run("Rust Core Tests", ["cargo", "test", "--manifest-path", "crates/core/Cargo.toml"], cwd))
221
+ failures++;
222
+ } else {
223
+ trackSkip("Rust Core Tests", "crates/core/Cargo.toml not found in project");
224
+ }
225
+ } else {
226
+ trackSkip("Rust Core Tests", "skipped by flag");
227
+ }
228
+
216
229
  // ━━━ Summary Table ━━━
217
230
  const totalMs = totalTimer();
218
231
  console.log(`\n${BOLD}${CYAN}━━━ Verification Summary ━━━${RESET}`);
@@ -0,0 +1,92 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * visual_audit.js — Visual Design & UI Engineering Auditor
4
+ *
5
+ * Verifies OKLCH color compliance, surface depth layering (hairline borders, ambient shadows),
6
+ * and interactive state polish on UI components and style definitions.
7
+ *
8
+ * Usage:
9
+ * node .agent/scripts/visual_audit.js .
10
+ * node .agent/scripts/visual_audit.js --file src/components/Button.tsx
11
+ */
12
+
13
+ "use strict";
14
+
15
+ const fs = require("fs");
16
+ const path = require("path");
17
+
18
+ const {
19
+ GREEN,
20
+ YELLOW,
21
+ BOLD,
22
+ DIM,
23
+ RESET,
24
+ banner,
25
+ timer,
26
+ formatMs,
27
+ } = require("./_colors");
28
+
29
+ const { walkDir, SOURCE_EXTENSIONS } = require("./_utils");
30
+
31
+ function auditFile(filePath) {
32
+ let content;
33
+ try {
34
+ content = fs.readFileSync(filePath, "utf8");
35
+ } catch {
36
+ return [];
37
+ }
38
+
39
+ const issues = [];
40
+ const lines = content.split("\n");
41
+
42
+ for (let i = 0; i < lines.length; i++) {
43
+ const line = lines[i];
44
+
45
+ // Check for hardcoded hex colors when oklch or CSS variables are expected
46
+ if (/#([0-9a-fA-F]{3}){1,2}\b/.test(line) && !line.includes("// ignore-color")) {
47
+ issues.push({
48
+ line: i + 1,
49
+ rule: "oklch-color",
50
+ message: `Hardcoded hex color found: "${line.trim()}". Prefer OKLCH or design token CSS variables.`,
51
+ });
52
+ }
53
+ }
54
+
55
+ return issues;
56
+ }
57
+
58
+ function main() {
59
+ const cwd = process.cwd();
60
+ const elapsed = timer();
61
+
62
+ console.log(banner("visual_audit.js", { Target: cwd }));
63
+
64
+ const files = walkDir(cwd, { extensions: SOURCE_EXTENSIONS });
65
+ let totalIssues = 0;
66
+
67
+ for (const file of files) {
68
+ const issues = auditFile(file);
69
+ if (issues.length > 0) {
70
+ totalIssues += issues.length;
71
+ const rel = path.relative(cwd, file);
72
+ console.log(`\n 📄 ${BOLD}${rel}${RESET}`);
73
+ for (const iss of issues) {
74
+ console.log(` ${YELLOW}⚠ line ${iss.line}:${RESET} ${iss.message}`);
75
+ }
76
+ }
77
+ }
78
+
79
+ console.log(`\n ${DIM}Audited ${files.length} files in ${formatMs(elapsed())}${RESET}`);
80
+
81
+ if (totalIssues === 0) {
82
+ console.log(` ${GREEN}${BOLD}✔ Visual audit complete — zero design violations found.${RESET}\n`);
83
+ } else {
84
+ console.log(` ${YELLOW}${BOLD}⚠ Visual audit completed with ${totalIssues} advisory issue(s).${RESET}\n`);
85
+ }
86
+ }
87
+
88
+ module.exports = { auditFile };
89
+
90
+ if (require.main === module) {
91
+ main();
92
+ }
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: 12-principles-of-animation
3
3
  description: Application of Disney's 12 Principles of Animation (Squash & Stretch, Anticipation, Staging, Follow Through, Slow In & Slow Out, Arc, Secondary Action, Timing, Exaggeration, Solid Drawing, Appeal) to modern web UI motion.
4
- version: 1.0.0
5
- last-updated: 2026-07-22
6
- applies-to-model: gemini-3-6-flash, claude-3-7-sonnet
7
- routing:
8
- domain: UI Animation Theory & Disney Principles
9
- tier: pro
10
- co-requires: [emil-design-eng, motion-engineering, 60fps-animation]
11
- trigger-signals:
12
- strong: [12-principles-of-animation, Disney animation principles, squash and stretch UI, anticipation animation, staging UI motion, follow through web]
13
- weak: [animation principles, ui animation theory]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - motion-engineering
8
+ - 60fps-animation
9
+ - accessible-animation
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
14
  ---
15
15
 
16
16
  # 12 Principles of Animation — Web UI Motion Theory
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before applying animation principles to web components, you MUST inspect:
23
+ 1. Target interaction pattern → Identify applicability of Squash & Stretch, Anticipation, Slow In/Out, or Follow Through
24
+ 2. Volume-Preservation Rule (Section 26) → Keep UI squash/stretch subtle (max 2%-4%); if height scales to 0.97, width MUST scale to 1.03
25
+ 3. Staging Rules (Section 31) → Direct user focus with sequential motion rather than competing simultaneous animations
26
+
18
27
  Translate Disney's 12 classic principles of animation into modern CSS, Web API, and Framer Motion code patterns.
19
28
 
20
29
  ---
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: 60fps-animation
3
3
  description: Web animation performance guidance for avoiding layout thrashing, achieving 60/120fps motion, and using GPU compositor-friendly properties (transform, opacity).
4
- version: 1.0.0
5
- last-updated: 2026-07-22
6
- applies-to-model: gemini-3-6-flash, claude-3-7-sonnet
7
- routing:
8
- domain: Animation Performance & GPU Hardware Acceleration
9
- tier: pro
10
- co-requires: [fixing-motion-performance, framer-motion-expert, gsap-performance]
11
- trigger-signals:
12
- strong: [60fps-animation, animation performance, layout thrashing, compositor properties, GPU acceleration, 120fps animation, smooth motion]
13
- weak: [fast animation, fix laggy animation]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - motion-engineering
8
+ - accessible-animation
9
+ - fixing-motion-performance
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
14
  ---
15
15
 
16
16
  # 60fps Animation — GPU Compositor & High-Performance Motion
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before writing animation CSS or JS, you MUST inspect:
23
+ 1. Target animated properties → Strictly enforce GPU compositor-only properties (`transform`, `opacity`) and ban layout-triggering properties (`width`, `height`, `top`, `left`)
24
+ 2. Scale Math Replacement (Section 29) → Use `transform: scaleX(2)` instead of animating `width`
25
+ 3. `will-change` VRAM Management (Section 45) → Apply `will-change` dynamically during active animation and remove upon completion
26
+
18
27
  Eliminate jank, layout thrashing, and frame drops to achieve locked 60fps / 120fps UI animations.
19
28
 
20
29
  ---
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: accessible-animation
3
3
  description: Tiered reduced-motion patterns for CSS, GSAP, Framer Motion, Lenis, and View Transitions API to ensure full WCAG 2.2 accessibility compliance for motion.
4
- version: 1.0.0
5
- last-updated: 2026-07-22
6
- applies-to-model: gemini-3-6-flash, claude-3-7-sonnet
7
- routing:
8
- domain: Accessible Motion & Reduced Motion Patterns
9
- tier: pro
10
- co-requires: [web-accessibility-auditor, framer-motion-expert, 60fps-animation]
11
- trigger-signals:
12
- strong: [accessible-animation, prefers-reduced-motion, accessible motion, WCAG animation, motion accessibility]
13
- weak: [disable animation, reduced motion]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - 60fps-animation
8
+ - motion-engineering
9
+ - framer-motion-expert
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
14
  ---
15
15
 
16
16
  # Accessible Animation — Tiered Reduced-Motion Patterns
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before implementing UI animation code, you MUST inspect:
23
+ 1. CSS stylesheets → Verify presence of `@media (prefers-reduced-motion: reduce)` rules
24
+ 2. Framer Motion / GSAP components → Query `useReducedMotion()` or `matchMedia('(prefers-reduced-motion: reduce)')`
25
+ 3. Vestibular Trigger Replacement (Section 57) → Replace parallax scroll and 3D rotations with instant opacity cross-fades (`0 -> 1`)
26
+
18
27
  Ensure UI motion respects user accessibility preferences (`prefers-reduced-motion: reduce`) without stripping functional state updates.
19
28
 
20
29
  ---
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: adapt
3
3
  description: Adapt designs across breakpoints, devices, platform constraints, touch vs mouse input, and container queries. Use when making a UI responsive or optimizing for mobile/tablet.
4
- version: 1.0.0
5
- last-updated: 2026-07-22
6
- applies-to-model: gemini-3-6-flash, claude-3-7-sonnet
7
- routing:
8
- domain: Responsive Design & Cross-Device Adaptation
9
- tier: pro
10
- co-requires: [mobile-design, building-native-ui]
11
- trigger-signals:
12
- strong: [adapt, responsive design, container queries, mobile adaptation, responsive layout, touch target size, responsive breakpoints]
13
- weak: [mobile friendly, responsive UI]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - mobile-design
8
+ - building-native-ui
9
+ - tailwind-patterns
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
14
  ---
15
15
 
16
16
  # Adapt — Responsive Adaptation & Container Queries
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before engineering responsive layouts or cross-device UIs, you MUST inspect:
23
+ 1. Container Queries (`@container`) over Viewport Media Queries (Section 24) → Adapt component layouts based on parent container width (`container-type: inline-size`)
24
+ 2. Touch Target Sizing (Section 39) → Ensure interactive controls meet min `44x44px` target size on touch devices
25
+ 3. Fluid Clamp Scaling (Section 45) → Use `clamp()` for smooth fluid typography and spacing without abrupt media query jumps
26
+
18
27
  Architect UIs that adapt fluidly to screen dimensions, container boundaries, input devices (touch vs pointer), and orientation.
19
28
 
20
29
  ---
@@ -1,13 +1,31 @@
1
1
  ---
2
2
  name: advanced-rag-pipelines
3
3
  description: Production-grade Retrieval-Augmented Generation (RAG) mastery. Semantic chunking, Hybrid Search (Dense + Sparse/BM25), Cross-Encoder Reranking, and architecture-agnostic vector database management.
4
- routing:
5
- domain: general
6
- tier: basic
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - llm-engineering
9
+ - ai-prompt-injection-defense
10
+ - database-design
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
7
14
  ---
8
15
 
9
16
  # Advanced RAG Pipelines (Production AI Data)
10
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before building RAG pipelines or vector search components, you MUST inspect:
23
+ 1. Hybrid Search Requirement (Section 16) → Always combine Dense Vector Search with Sparse BM25 Search to catch exact keyword matches (IDs, versions)
24
+ 2. Two-Stage Reranking Pipeline (Section 29) → Retrieve top ~50 candidate chunks, then rerank with a Cross-Encoder down to top 3-5 before feeding the LLM
25
+ 3. Context XML Framing (Section 59) → Wrap retrieved chunks inside explicit `<context>` XML tags in the prompt to prevent indirect prompt injection
26
+
27
+ # Advanced RAG Pipelines (Production AI Data)
28
+
11
29
  You are an expert in building production-grade Retrieval-Augmented Generation (RAG) data pipelines. You understand that naive RAG (fixed chunking + Cosine similarity) fails in production. You architect systems that retrieve context with high precision using hybrid search, reranking, and semantic strategies.
12
30
 
13
31
  ## 1. Core Principles
@@ -1,15 +1,29 @@
1
1
  ---
2
2
  name: agent-organizer
3
3
  description: Master Agent orchestration framework. Coordination of sub-agents, workflow definitions, delegation patterns, state management across conversations, memory distillation, and execution loops. Use when assembling multi-agent systems or managing complex agent-to-agent architectures.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 2.0.0
6
- last-updated: 2026-04-02
7
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
8
- routing:
9
- domain: general
10
- tier: basic
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - parallel-agents
9
+ - fabel-protocol
10
+ - agentic-patterns
11
+ scripts-binding:
12
+ - .agent/scripts/swarm_dispatcher.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
16
+ # Agent Organizer — Multi-Agent Orchestration Mastery
17
+
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before dispatching multi-agent tasks, you MUST inspect:
23
+ 1. `swarm-worker-registry.md` / `task.md` → Verify target worker agents and global execution state
24
+ 2. Context Window Budget rules (Section 1) → Trim worker payload context to max 3 files per dispatch
25
+ 3. Handoff state signals (`COMPLETE`, `BLOCKED`, `ERROR`) → Verify terminal status handling rules
26
+
13
27
  ## Hallucination Traps (Read First)
14
28
 
15
29
  - ❌ Dispatching sub-agents without a context_summary -> ✅ Always send a trimmed context, never the full conversation
@@ -1,19 +1,31 @@
1
1
  ---
2
2
  name: agentic-patterns
3
3
  description: AI agent design principles. Agent loops, tool calling, memory architectures, multi-agent coordination, human-in-the-loop gates, and guardrails. Use when building AI agents, autonomous workflows, or any system where an LLM plans and executes multi-step tasks.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 1.0.0
6
- last-updated: 2026-03-12
7
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
8
- routing:
9
- domain: general
10
- tier: basic
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - agent-organizer
9
+ - fabel-protocol
10
+ - thinking-protocol
11
+ scripts-binding:
12
+ - .agent/scripts/swarm_dispatcher.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
13
16
  # Agentic Patterns
14
17
 
15
18
  ---
16
19
 
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before designing agentic loops, tool schemas, or memory architectures, you MUST inspect:
23
+ 1. `package.json` / LLM SDK definitions → Check tool calling syntax (Zod schemas, OpenAI/Anthropic function calling API)
24
+ 2. Agent Loop boundaries (Section 1) → Define hard caps on `MAX_STEPS` (default: 10) and explicit termination reasons
25
+ 3. Human-in-the-loop gates (Section 5) → Ensure approval gates for destructive, data-deleting, or high-cost API calls
26
+
27
+ ---
28
+
17
29
  ## The Agent Loop
18
30
 
19
31
  Every AI agent follows this fundamental pattern:
@@ -1,15 +1,29 @@
1
1
  ---
2
2
  name: ai-prompt-injection-defense
3
3
  description: Prompt Injection and Jailbreak defense mastery. Mitigation strategies for direct injection, indirect injection via data poisoning, delimiter separation, XML framing, output validation, and LLM circuit breakers. Use when building AI systems that process untrusted user input or fetch external data.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- version: 2.0.0
6
- last-updated: 2026-04-02
7
- applies-to-model: gemini-2.5-pro, claude-3-7-sonnet
8
- routing:
9
- domain: general
10
- tier: basic
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - backend-security-expert
9
+ - vulnerability-scanner
10
+ - llm-engineering
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
11
14
  ---
12
15
 
16
+ # Prompt Injection Defense — AI Security Mastery
17
+
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before engineering LLM prompts or processing untrusted user input, you MUST inspect:
23
+ 1. Message Role Isolation (Section 15) → Place user input exclusively in `role: "user"` messages; never concatenate user input into `role: "system"`
24
+ 2. Delimiter Sandboxing (Section 49) → Frame untrusted input inside XML tags (`<user_input>`) or randomized nonces (`<data_a8b4f1c9>`)
25
+ 3. Human-in-the-Loop Gate (Section 119) → Require explicit human approval before executing state-changing tool operations (`delete_user`, `process_payment`)
26
+
13
27
  ## Hallucination Traps (Read First)
14
28
 
15
29
  - ❌ Putting user input into role:'system' messages -> ✅ User input MUST go in role:'user' only
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: animation-on-scroll
3
3
  description: Intentional scroll-driven motion using modern CSS scroll-timeline, view-timeline, or GSAP ScrollTrigger without scroll jank or performance degradation.
4
- version: 1.0.0
5
- last-updated: 2026-07-22
6
- applies-to-model: gemini-3-6-flash, claude-3-7-sonnet
7
- routing:
8
- domain: Scroll-Driven Motion & Storytelling
9
- tier: pro
10
- co-requires: [gsap-scrolltrigger, 60fps-animation]
11
- trigger-signals:
12
- strong: [animation-on-scroll, scroll-driven motion, CSS scroll-timeline, view-timeline, GSAP ScrollTrigger, scrollytelling]
13
- weak: [scroll animation, scroll effect]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - motion-engineering
8
+ - 60fps-animation
9
+ - accessible-animation
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
14
  ---
15
15
 
16
16
  # Animation On Scroll — Intentional Scroll Motion
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before implementing scroll-driven animations, you MUST inspect:
23
+ 1. Target browser support → Prefer pure CSS `animation-timeline: view()` / `scroll()` when possible
24
+ 2. Pinning & Scrubbing rules (Section 45) → Use `scrub: 1` in GSAP ScrollTrigger timelines for smooth inertia
25
+ 3. Anti-Scrolljacking rule (Section 88) → Never hijack native scroll wheel momentum or override browser scrolling velocity
26
+
18
27
  Architect performant scroll-linked motion and scrollytelling sequences that feel natural, fluid, and non-intrusive.
19
28
 
20
29
  ---
@@ -1,20 +1,29 @@
1
1
  ---
2
2
  name: animation-systems
3
3
  description: Systematize animation tokens (durations, easings, keyframes) across a full codebase for consistent motion design and maintenance.
4
- version: 1.0.0
5
- last-updated: 2026-07-22
6
- applies-to-model: gemini-3-6-flash, claude-3-7-sonnet
7
- routing:
8
- domain: Motion Systems & Token Design
9
- tier: pro
10
- co-requires: [motion-engineering, emil-design-eng, 60fps-animation]
11
- trigger-signals:
12
- strong: [animation-systems, motion tokens, animation design system, easing tokens, duration scale]
13
- weak: [motion tokens, animation variables]
4
+ version: 3.0.0
5
+ last-updated: 2026-07-30
6
+ skills:
7
+ - motion-engineering
8
+ - 60fps-animation
9
+ - baseline-ui
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
14
  ---
15
15
 
16
16
  # Animation Systems — Global Motion Tokens & System Architecture
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before defining animation tokens or styling transitions, you MUST inspect:
23
+ 1. `index.css` / `DESIGN.md` → Verify presence of centralized `--duration-*` and `--ease-*` CSS custom properties
24
+ 2. Centralized Motion Tokens Schema (Section 26) → Enforce standardized duration tiers (80ms instant to 500ms delight)
25
+ 3. Anti-Ad-Hoc Easing Rule (Section 48) → Strictly prohibit inline custom cubic-bezier curves; reference motion tokens instead
26
+
18
27
  Architect a unified, scalable motion system with centralized CSS easing curves, duration tiers, and standardized keyframes.
19
28
 
20
29
  ---
@@ -1,20 +1,31 @@
1
1
  ---
2
2
  name: antfu-conventions
3
3
  description: Anthony Fu's opinionated tooling and conventions for JavaScript/TypeScript projects: ESM-first, zero-config, type-safe, and clean tooling standards.
4
- version: 1.0.0
5
- last-updated: 2026-07-22
6
- applies-to-model: gemini-3-6-flash, claude-3-7-sonnet
7
- routing:
8
- domain: Tooling Conventions & ESM Standards
9
- tier: pro
10
- co-requires: [clean-code, typescript-advanced]
11
- trigger-signals:
12
- strong: [antfu-conventions, antfu ESLint, ESM first, zero-config tooling, pnpm catalogs, Anthony Fu tooling]
13
- weak: [eslint config, pnpm setup]
4
+ tools: Read, Grep, Glob, Bash, Edit, Write
5
+ version: 3.0.0
6
+ last-updated: 2026-07-30
7
+ skills:
8
+ - clean-code
9
+ - typescript-advanced
10
+ - monorepo-management
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
14
  ---
15
15
 
16
16
  # Antfu Conventions — ESM-First & Opinionated Modern Tooling
17
17
 
18
+ ---
19
+
20
+ ## Mandatory Pre-Flight Context Inspection
21
+
22
+ Before configuring JS/TS tooling or lint rules, you MUST inspect:
23
+ 1. Pure ESM-First Requirement (Section 24) → Set `"type": "module"` in `package.json`; ban CommonJS `require()` or `module.exports`
24
+ 2. ESLint Flat Config (`eslint.config.js`) (Section 28) → Use `@antfu/eslint-config` with flat config format; ban legacy `.eslintrc.json`
25
+ 3. Explicit Type Imports (`import type`) (Section 45) → Enforce `import type` for type-only symbols to allow clean tree-shaking compilation
26
+
27
+ # Antfu Conventions — ESM-First & Opinionated Modern Tooling
28
+
18
29
  Enforce Anthony Fu's modern JavaScript/TypeScript engineering conventions: ESM-first, zero-config, pnpm workspaces, and strict type safety.
19
30
 
20
31
  ---