tribunal-kit 6.0.0 → 7.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.
- package/.agent/.manifest.json +78 -0
- package/.agent/ARCHITECTURE.md +19 -241
- package/.agent/agents/accessibility-reviewer.md +23 -16
- package/.agent/agents/ai-code-reviewer.md +25 -21
- package/.agent/agents/anti-pattern-reviewer.md +12 -7
- package/.agent/agents/api-architect.md +1 -0
- package/.agent/agents/backend-specialist.md +23 -22
- package/.agent/agents/cloud-engineer.md +1 -0
- package/.agent/agents/code-archaeologist.md +1 -0
- package/.agent/agents/complexity-reviewer.md +10 -7
- package/.agent/agents/database-architect.md +3 -2
- package/.agent/agents/db-latency-auditor.md +6 -2
- package/.agent/agents/debugger.md +3 -2
- package/.agent/agents/dependency-reviewer.md +1 -0
- package/.agent/agents/devops-engineer.md +9 -8
- package/.agent/agents/documentation-writer.md +6 -5
- package/.agent/agents/explorer-agent.md +1 -0
- package/.agent/agents/frontend-reviewer.md +21 -17
- package/.agent/agents/frontend-specialist.md +23 -20
- package/.agent/agents/game-developer.md +1 -0
- package/.agent/agents/interaction-reviewer.md +10 -5
- package/.agent/agents/logic-reviewer.md +3 -0
- package/.agent/agents/minimalist-reviewer.md +6 -0
- package/.agent/agents/mobile-developer.md +7 -6
- package/.agent/agents/mobile-reviewer.md +14 -13
- package/.agent/agents/orchestrator.md +3 -0
- package/.agent/agents/penetration-tester.md +1 -0
- package/.agent/agents/performance-optimizer.md +6 -5
- package/.agent/agents/performance-reviewer.md +6 -6
- package/.agent/agents/pipeline-reviewer.md +144 -0
- package/.agent/agents/precedence-reviewer.md +1 -0
- package/.agent/agents/product-manager.md +1 -0
- package/.agent/agents/product-owner.md +1 -0
- package/.agent/agents/product-reviewer.md +12 -7
- package/.agent/agents/project-planner.md +3 -0
- package/.agent/agents/qa-automation-engineer.md +50 -43
- package/.agent/agents/resilience-reviewer.md +1 -0
- package/.agent/agents/schema-reviewer.md +1 -0
- package/.agent/agents/security-auditor.md +24 -24
- package/.agent/agents/seo-specialist.md +33 -23
- package/.agent/agents/sql-reviewer.md +5 -4
- package/.agent/agents/supervisor-agent.md +12 -2
- package/.agent/agents/swarm-worker-contracts.md +13 -13
- package/.agent/agents/swarm-worker-registry.md +51 -51
- package/.agent/agents/system-architect.md +1 -0
- package/.agent/agents/test-coverage-reviewer.md +25 -22
- package/.agent/agents/test-engineer.md +12 -11
- package/.agent/agents/throughput-optimizer.md +45 -40
- package/.agent/agents/type-safety-reviewer.md +5 -4
- package/.agent/agents/ui-ux-auditor.md +6 -4
- package/.agent/agents/ui-visual-auditor.md +3 -0
- package/.agent/agents/ux-reviewer.md +11 -6
- package/.agent/agents/visual-reviewer.md +11 -6
- package/.agent/agents/vitals-reviewer.md +5 -4
- package/.agent/history/memory/.memory.idx +3716 -1
- package/.agent/history/memory/MEMORY.md +246 -1
- package/.agent/mcp_config.json +1 -6
- package/.agent/routing_index.json +2034 -263
- package/.agent/rules/GEMINI.md +12 -10
- package/.agent/rules/GEMINI_PLANNER.md +19 -21
- package/.agent/scripts/_colors.js +52 -54
- package/.agent/scripts/_utils.js +52 -53
- package/.agent/scripts/auto_preview.js +39 -43
- package/.agent/scripts/bundle_analyzer.js +47 -60
- package/.agent/scripts/case_law_manager.js +200 -294
- package/.agent/scripts/checklist.js +73 -94
- package/.agent/scripts/cicd_validator.js +305 -0
- package/.agent/scripts/compile_router.py +4 -111
- package/.agent/scripts/context_broker.js +317 -412
- package/.agent/scripts/contract_engine.js +402 -0
- package/.agent/scripts/dependency_analyzer.js +112 -124
- package/.agent/scripts/graph_builder.js +75 -103
- package/.agent/scripts/graph_visualizer.js +10 -12
- package/.agent/scripts/graph_zoom.js +38 -55
- package/.agent/scripts/guardrail_engine.js +195 -145
- package/.agent/scripts/impact_classifier.js +55 -30
- package/.agent/scripts/inner_loop_validator.js +108 -159
- package/.agent/scripts/integrity_manifest.js +59 -67
- package/.agent/scripts/lint_runner.js +65 -75
- package/.agent/scripts/marathon_harness.js +131 -208
- package/.agent/scripts/migrate_skills_frontmatter.py +4 -63
- package/.agent/scripts/minify_context.js +29 -33
- package/.agent/scripts/minimal_change_engine.js +95 -87
- package/.agent/scripts/mutation_runner.js +46 -62
- package/.agent/scripts/pipeline_engine.js +320 -209
- package/.agent/scripts/prompt_compiler.js +118 -93
- package/.agent/scripts/schema_validator.js +73 -121
- package/.agent/scripts/security_scan.js +88 -117
- package/.agent/scripts/session_manager.js +52 -69
- package/.agent/scripts/signal_detector.js +24 -22
- package/.agent/scripts/skill_evolution.js +184 -245
- package/.agent/scripts/skill_integrator.js +35 -48
- package/.agent/scripts/socratic_gate_policy.js +15 -12
- package/.agent/scripts/strengthen_skills.js +29 -33
- package/.agent/scripts/swarm_dispatcher.js +120 -151
- package/.agent/scripts/test_runner.js +54 -56
- package/.agent/scripts/token_budget_broker.js +9 -7
- package/.agent/scripts/trace_engine.js +126 -0
- package/.agent/scripts/verify_all.js +76 -93
- package/.agent/scripts/visual_audit.js +16 -21
- package/.agent/skill_topic_map.json +237 -0
- package/.agent/skills/12-principles-of-animation/SKILL.md +7 -0
- package/.agent/skills/60fps-animation/SKILL.md +7 -0
- package/.agent/skills/accessible-animation/SKILL.md +5 -1
- package/.agent/skills/adapt/SKILL.md +7 -1
- package/.agent/skills/advanced-rag-pipelines/SKILL.md +1 -0
- package/.agent/skills/agent-organizer/SKILL.md +1 -0
- package/.agent/skills/agentic-patterns/SKILL.md +33 -25
- package/.agent/skills/agentic-workflows-2026/SKILL.md +80 -0
- package/.agent/skills/ai-app-hardening/SKILL.md +59 -0
- package/.agent/skills/ai-prompt-injection-defense/SKILL.md +7 -6
- package/.agent/skills/animation-on-scroll/SKILL.md +24 -15
- package/.agent/skills/animation-systems/SKILL.md +11 -10
- package/.agent/skills/antfu-conventions/SKILL.md +7 -2
- package/.agent/skills/api-patterns/SKILL.md +14 -10
- package/.agent/skills/api-security-auditor/SKILL.md +15 -14
- package/.agent/skills/app-builder/SKILL.md +1 -0
- package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +2 -2
- package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +1 -1
- package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +12 -12
- package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +3 -3
- package/.agent/skills/apple-design/SKILL.md +8 -7
- package/.agent/skills/architecture/SKILL.md +3 -2
- package/.agent/skills/audit-and-fix/SKILL.md +8 -5
- package/.agent/skills/authentication-best-practices/SKILL.md +9 -8
- package/.agent/skills/backend-security-expert/SKILL.md +1 -0
- package/.agent/skills/baseline-ui/SKILL.md +8 -7
- package/.agent/skills/bash-linux/SKILL.md +1 -0
- package/.agent/skills/behavioral-modes/SKILL.md +1 -0
- package/.agent/skills/better-colors/SKILL.md +11 -7
- package/.agent/skills/better-typography/SKILL.md +30 -16
- package/.agent/skills/better-ui/SKILL.md +17 -10
- package/.agent/skills/bolder/SKILL.md +6 -0
- package/.agent/skills/brainstorming/SKILL.md +6 -4
- package/.agent/skills/browser-native-ai/SKILL.md +5 -4
- package/.agent/skills/build-primitive/SKILL.md +5 -0
- package/.agent/skills/building-native-ui/SKILL.md +1 -0
- package/.agent/skills/cicd-pro/SKILL.md +2 -1
- package/.agent/skills/clarify/SKILL.md +19 -14
- package/.agent/skills/clean-code/SKILL.md +16 -15
- package/.agent/skills/cloud-architect/SKILL.md +1 -0
- package/.agent/skills/cobejs/SKILL.md +7 -9
- package/.agent/skills/code-review-checklist/SKILL.md +1 -0
- package/.agent/skills/codebase-design/SKILL.md +7 -2
- package/.agent/skills/colorize/SKILL.md +8 -3
- package/.agent/skills/compact-landing/SKILL.md +8 -3
- package/.agent/skills/company-logos/SKILL.md +6 -0
- package/.agent/skills/config-validator/SKILL.md +10 -9
- package/.agent/skills/containerization-pro/SKILL.md +6 -5
- package/.agent/skills/context-engineering-pro/SKILL.md +70 -0
- package/.agent/skills/create-design-md/SKILL.md +13 -5
- package/.agent/skills/critique/SKILL.md +10 -8
- package/.agent/skills/csharp-developer/SKILL.md +1 -0
- package/.agent/skills/data-validation-schemas/SKILL.md +28 -23
- package/.agent/skills/database-design/SKILL.md +2 -1
- package/.agent/skills/delight/SKILL.md +6 -0
- package/.agent/skills/deployment-procedures/SKILL.md +2 -1
- package/.agent/skills/design-lab/SKILL.md +5 -0
- package/.agent/skills/devops-engineer/SKILL.md +3 -2
- package/.agent/skills/devops-incident-responder/SKILL.md +2 -1
- package/.agent/skills/diagnosing-bugs/SKILL.md +12 -2
- package/.agent/skills/distill/SKILL.md +7 -2
- package/.agent/skills/documentation-templates/SKILL.md +3 -2
- package/.agent/skills/domain-modeling/SKILL.md +12 -4
- package/.agent/skills/duckdb-analytical-sql/SKILL.md +59 -0
- package/.agent/skills/edge-ai-mobile/SKILL.md +50 -0
- package/.agent/skills/edge-computing/SKILL.md +9 -8
- package/.agent/skills/emil-design-eng/SKILL.md +43 -27
- package/.agent/skills/error-resilience/SKILL.md +34 -16
- package/.agent/skills/expo-router-v4/SKILL.md +81 -0
- package/.agent/skills/extract-design-system/SKILL.md +12 -11
- package/.agent/skills/fabel-protocol/SKILL.md +24 -17
- package/.agent/skills/fixing-accessibility/SKILL.md +23 -16
- package/.agent/skills/fixing-metadata/SKILL.md +24 -13
- package/.agent/skills/fixing-motion-performance/SKILL.md +7 -5
- package/.agent/skills/framer-motion-expert/SKILL.md +29 -15
- package/.agent/skills/frontend-design/SKILL.md +21 -13
- package/.agent/skills/frontend-security-expert/SKILL.md +1 -0
- package/.agent/skills/game-design-expert/SKILL.md +1 -0
- package/.agent/skills/game-engineering-expert/SKILL.md +1 -0
- package/.agent/skills/generative-ui-expert/SKILL.md +3 -2
- package/.agent/skills/geo-fundamentals/SKILL.md +2 -1
- package/.agent/skills/git-pro/SKILL.md +10 -9
- package/.agent/skills/github-operations/SKILL.md +2 -1
- package/.agent/skills/gpt-taste/SKILL.md +7 -0
- package/.agent/skills/gsap-core/SKILL.md +26 -22
- package/.agent/skills/gsap-frameworks/SKILL.md +6 -5
- package/.agent/skills/gsap-performance/SKILL.md +4 -3
- package/.agent/skills/gsap-plugins/SKILL.md +34 -33
- package/.agent/skills/gsap-react/SKILL.md +9 -8
- package/.agent/skills/gsap-scrolltrigger/SKILL.md +34 -33
- package/.agent/skills/gsap-timeline/SKILL.md +18 -15
- package/.agent/skills/gsap-utils/SKILL.md +25 -24
- package/.agent/skills/harden/SKILL.md +9 -3
- package/.agent/skills/harness-protocol/SKILL.md +1 -0
- package/.agent/skills/i18n-localization/SKILL.md +10 -9
- package/.agent/skills/impeccable/SKILL.md +5 -0
- package/.agent/skills/improve-codebase-architecture/SKILL.md +10 -5
- package/.agent/skills/improve-ui/SKILL.md +12 -5
- package/.agent/skills/intelligent-routing/SKILL.md +7 -6
- package/.agent/skills/knowledge-graph/SKILL.md +1 -0
- package/.agent/skills/landing-page/SKILL.md +1 -0
- package/.agent/skills/lint-and-validate/SKILL.md +9 -4
- package/.agent/skills/llm-engineering/SKILL.md +55 -54
- package/.agent/skills/local-first/SKILL.md +20 -19
- package/.agent/skills/local-first-architecture/SKILL.md +6 -1
- package/.agent/skills/lottie-animation/SKILL.md +7 -3
- package/.agent/skills/marquee-loop/SKILL.md +1 -0
- package/.agent/skills/masked-reveal/SKILL.md +17 -4
- package/.agent/skills/mcp-builder/SKILL.md +13 -10
- package/.agent/skills/micro-interaction/SKILL.md +20 -5
- package/.agent/skills/mobile-design/SKILL.md +26 -15
- package/.agent/skills/monorepo-management/SKILL.md +3 -2
- package/.agent/skills/morphing-icons/SKILL.md +16 -6
- package/.agent/skills/motion-engineering/SKILL.md +19 -15
- package/.agent/skills/nextjs-react-expert/SKILL.md +26 -21
- package/.agent/skills/nodejs-best-practices/SKILL.md +89 -76
- package/.agent/skills/observability/SKILL.md +45 -44
- package/.agent/skills/opentelemetry-observability/SKILL.md +59 -0
- package/.agent/skills/page-transition-animation/SKILL.md +6 -3
- package/.agent/skills/parallel-agents/SKILL.md +7 -2
- package/.agent/skills/performance-profiling/SKILL.md +24 -13
- package/.agent/skills/plan-writing/SKILL.md +1 -0
- package/.agent/skills/platform-engineer/SKILL.md +3 -2
- package/.agent/skills/platform-engineering-opentofu/SKILL.md +68 -0
- package/.agent/skills/playwright-ai-e2e/SKILL.md +60 -0
- package/.agent/skills/playwright-best-practices/SKILL.md +29 -28
- package/.agent/skills/polish/SKILL.md +13 -12
- package/.agent/skills/powershell-windows/SKILL.md +1 -0
- package/.agent/skills/pricing-page/SKILL.md +8 -3
- package/.agent/skills/product-aware-heuristics/SKILL.md +122 -72
- package/.agent/skills/progressive-blur/SKILL.md +9 -4
- package/.agent/skills/project-idioms/SKILL.md +1 -0
- package/.agent/skills/property-based-testing/SKILL.md +58 -0
- package/.agent/skills/python-patterns/SKILL.md +1 -0
- package/.agent/skills/python-pro/SKILL.md +1 -0
- package/.agent/skills/quieter/SKILL.md +6 -0
- package/.agent/skills/react-doctor/SKILL.md +6 -0
- package/.agent/skills/react-specialist/SKILL.md +32 -28
- package/.agent/skills/readme-builder/SKILL.md +1 -0
- package/.agent/skills/realtime-patterns/SKILL.md +34 -33
- package/.agent/skills/red-team-tactics/SKILL.md +1 -0
- package/.agent/skills/redesign-skill/SKILL.md +6 -0
- package/.agent/skills/review-animations/SKILL.md +5 -2
- package/.agent/skills/review-animations/STANDARDS.md +37 -23
- package/.agent/skills/rust-pro/SKILL.md +1 -0
- package/.agent/skills/seo-fundamentals/SKILL.md +4 -3
- package/.agent/skills/server-management/SKILL.md +1 -0
- package/.agent/skills/shadcn-ui-expert/SKILL.md +28 -22
- package/.agent/skills/shape/SKILL.md +9 -2
- package/.agent/skills/skill-creator/SKILL.md +1 -0
- package/.agent/skills/soft-skill/SKILL.md +6 -0
- package/.agent/skills/sounds-on-the-web/SKILL.md +1 -0
- package/.agent/skills/sql-pro/SKILL.md +1 -0
- package/.agent/skills/supabase-postgres-best-practices/SKILL.md +1 -0
- package/.agent/skills/svg-animation/SKILL.md +16 -7
- package/.agent/skills/swiftui-expert/SKILL.md +1 -0
- package/.agent/skills/swiss-design/SKILL.md +5 -0
- package/.agent/skills/system-design-pro/SKILL.md +1 -0
- package/.agent/skills/systematic-debugging/SKILL.md +1 -0
- package/.agent/skills/tailwind-patterns/SKILL.md +25 -11
- package/.agent/skills/taste-skill/SKILL.md +6 -0
- package/.agent/skills/tdd-workflow/SKILL.md +5 -0
- package/.agent/skills/test-result-analyzer/SKILL.md +1 -0
- package/.agent/skills/testing-patterns/SKILL.md +123 -115
- package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +5 -0
- package/.agent/skills/thinking-protocol/SKILL.md +3 -0
- package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +9 -8
- package/.agent/skills/transitions-dev/SKILL.md +19 -6
- package/.agent/skills/trend-researcher/SKILL.md +1 -0
- package/.agent/skills/typescript-advanced/SKILL.md +23 -18
- package/.agent/skills/typeset/SKILL.md +10 -1
- package/.agent/skills/ui-reasoning-engine/SKILL.md +67 -48
- package/.agent/skills/ui-skill-packs/SKILL.md +6 -1
- package/.agent/skills/ui-skills-root/SKILL.md +39 -38
- package/.agent/skills/ui-ux-pro-max/SKILL.md +34 -26
- package/.agent/skills/ui-ux-researcher/SKILL.md +1 -0
- package/.agent/skills/vector-search-pgvector/SKILL.md +78 -0
- package/.agent/skills/vue-expert/SKILL.md +22 -19
- package/.agent/skills/vulnerability-scanner/SKILL.md +22 -21
- package/.agent/skills/web-accessibility-auditor/SKILL.md +2 -1
- package/.agent/skills/web-design-guidelines/SKILL.md +16 -10
- package/.agent/skills/web-quality-audit/SKILL.md +5 -0
- package/.agent/skills/webapp-testing/SKILL.md +14 -13
- package/.agent/skills/webgpu-performance/SKILL.md +1 -0
- package/.agent/skills/whimsy-injector/SKILL.md +9 -5
- package/.agent/skills/workflow-optimizer/SKILL.md +1 -0
- package/.agent/skills/zero-trust-passkeys/SKILL.md +90 -0
- package/.agent/templates/DESIGN.md +119 -110
- package/.agent/templates/design-tokens.json +9 -6
- package/.agent/workflows/acf.md +1 -0
- package/.agent/workflows/api-tester.md +1 -0
- package/.agent/workflows/audit.md +1 -0
- package/.agent/workflows/brainstorm.md +1 -0
- package/.agent/workflows/changelog.md +1 -0
- package/.agent/workflows/contract.md +60 -0
- package/.agent/workflows/create.md +1 -0
- package/.agent/workflows/debug.md +1 -0
- package/.agent/workflows/deploy.md +1 -0
- package/.agent/workflows/enhance.md +1 -0
- package/.agent/workflows/fix-ci.md +89 -0
- package/.agent/workflows/fix.md +1 -0
- package/.agent/workflows/generate.md +1 -0
- package/.agent/workflows/marathon.md +1 -0
- package/.agent/workflows/migrate.md +1 -0
- package/.agent/workflows/minimal.md +9 -7
- package/.agent/workflows/orchestrate.md +1 -0
- package/.agent/workflows/performance-benchmarker.md +1 -0
- package/.agent/workflows/pipeline.md +26 -21
- package/.agent/workflows/plan.md +1 -0
- package/.agent/workflows/preview.md +1 -0
- package/.agent/workflows/refactor.md +3 -2
- package/.agent/workflows/review-ai.md +4 -3
- package/.agent/workflows/review.md +1 -0
- package/.agent/workflows/session.md +1 -0
- package/.agent/workflows/status.md +1 -0
- package/.agent/workflows/strengthen-skills.md +1 -0
- package/.agent/workflows/super-prompt.md +1 -0
- package/.agent/workflows/swarm.md +15 -3
- package/.agent/workflows/test.md +8 -7
- package/.agent/workflows/tribunal-backend.md +3 -2
- package/.agent/workflows/tribunal-cicd.md +104 -0
- package/.agent/workflows/tribunal-database.md +1 -0
- package/.agent/workflows/tribunal-frontend.md +8 -6
- package/.agent/workflows/tribunal-full.md +15 -14
- package/.agent/workflows/tribunal-mobile.md +6 -5
- package/.agent/workflows/tribunal-performance.md +1 -0
- package/.agent/workflows/tribunal-speed.md +1 -0
- package/.agent/workflows/tribunal-ui.md +29 -21
- package/.agent/workflows/ui-ux-pro-max.md +19 -15
- package/CONTRIBUTING.md +3 -3
- package/README.md +160 -88
- package/SECURITY.md +11 -11
- package/bin/mcp-server.js +512 -233
- package/bin/tribunal-kit.js +29 -30
- package/bin/wrapper.js +45 -48
- package/dist/cli.js +26 -0
- package/dist/commands/case.js +2 -0
- package/dist/commands/contract.js +440 -0
- package/dist/commands/memory.js +3 -2
- package/dist/commands/native.js +36 -0
- package/dist/commands/status.js +6 -0
- package/dist/esm/index.mjs +32 -0
- package/dist/index.d.ts +58 -3
- package/package.json +20 -16
- package/scripts/benchmark.js +62 -86
- package/scripts/changelog.js +67 -73
- package/scripts/fix-vbc.js +13 -15
- package/scripts/fix-vbc.ps1 +2 -118
- package/scripts/stress_benchmark.js +358 -0
- package/scripts/sync-version.js +71 -41
- package/scripts/validate-payload.js +23 -30
- package/scripts/visual_audit.js +23 -13
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
{
|
|
2
|
+
"ARCHITECTURE.md": "260ba64b8bae04d32fdefead90ba0c9c32d667ae93e4179b01fafba79e999977",
|
|
3
|
+
"mcp_config.json": "f6a66c11c396e809c30292cc46c232f2bea01fa2b71c43770df7980f3c5da07d",
|
|
4
|
+
"routing_index.json": "7ed02e81a341ab8f7e213a167c80c088bdbe74564edab038f8e396988b3c0459",
|
|
5
|
+
".shared/ui-ux-pro-max/README.md": "6eef9eb39dcca03d3d5e9ff8269a0fb95f66e7632adc65e5a4d87c7702f8700e",
|
|
6
|
+
"agents/accessibility-reviewer.md": "19a5955c0e2040b5e6bcc182c0a6555b670b8a19506bf2a1fc42d076ec148d5d",
|
|
7
|
+
"agents/ai-code-reviewer.md": "d191c961a5d8007fc23b9a796b8e7c861ddc46c9a6ea9bfda5247d847c860de0",
|
|
8
|
+
"agents/anti-pattern-reviewer.md": "609bdf7a90bdce0af5ca3bc603b9fc8f471bb45b8dd73a2d665ecde693c933dd",
|
|
9
|
+
"agents/api-architect.md": "e835403bf257cf5feb46e66a88d9224ecdada0950f128f06d5360116545689ba",
|
|
10
|
+
"agents/backend-specialist.md": "5800f0f31fe85e7c91306566e5272b355766ab509f5af9b35f1585cd5302eb8a",
|
|
11
|
+
"agents/cloud-engineer.md": "105d3c4c80994691515264eb88ca6ea17badb20c1a2b94248e7b4bcd83396b4a",
|
|
12
|
+
"agents/code-archaeologist.md": "38fd341176a7bd65e43e5431240ec04327fcb78ba97baba8d67fd6cf160e0573",
|
|
13
|
+
"agents/complexity-reviewer.md": "56f7b196f5e090ccf5a91fa2bda39cd6e321fc4d394335b15098e468d92b1c18",
|
|
14
|
+
"agents/database-architect.md": "b83084749dfdd1202211f0921794a1a0d69f15e4fc57b49c8e06ee522eea4558",
|
|
15
|
+
"agents/db-latency-auditor.md": "ad7c234762ece94658896b937746950a01970745dbfe02c96e407910faaf4016",
|
|
16
|
+
"agents/debugger.md": "53efc71ceb04a38f9679c9964f493feba53054730014ebce7a6b3fd294d156bf",
|
|
17
|
+
"agents/dependency-reviewer.md": "ae02377df25412256aade7f717bee11db7213932d7a263dc8e980c1bb3c55c1c",
|
|
18
|
+
"agents/devops-engineer.md": "26aa391279d87e489224d4d1902f7df7c7bf25ed017eecd69d416636a9163114",
|
|
19
|
+
"agents/documentation-writer.md": "6ede8695ac7a305e4fd32d283cab390b41bfcb6ec1f19771af8670d49639f413",
|
|
20
|
+
"agents/explorer-agent.md": "d9864e0f8e2952efb4917e6cdb209e4ac31bbf4d4e4b445a0a75ed323baa98af",
|
|
21
|
+
"agents/frontend-reviewer.md": "8c9f29ecea5d3df2282d449c4305c6856cf3fe9c9687be84058e9eaf2b3b2b4b",
|
|
22
|
+
"agents/frontend-specialist.md": "018c3cb62f28191fd08fd50ba1b80a2e5aa50c93b3b5aff51873a4e2730655cf",
|
|
23
|
+
"agents/game-developer.md": "7d74fdb55c9a83a63ff1fa702891c95db6e5cb98defdd77f275699a012d13182",
|
|
24
|
+
"agents/interaction-reviewer.md": "2ab393869082a28d5c8d8aa462662dbab9f7be494f78b6e3af5e9cbc1b38b14a",
|
|
25
|
+
"agents/logic-reviewer.md": "3c62bf24ced30eda67f89f8db445decc33b6779927d7ff6e5ee203768bda0c95",
|
|
26
|
+
"agents/minimalist-reviewer.md": "b445ed39fb1e9d34496b18c30053143f3d07ef537b1f05fcff5a774ef4f0383d",
|
|
27
|
+
"agents/mobile-developer.md": "a414b6e030c28cab98439ad7d55ee627ab5895ab88aa46ab84d65cb0a8f173ad",
|
|
28
|
+
"agents/mobile-reviewer.md": "2e57830b419029d15f45ea36d07d1336388ced8d4bb474cbcb3727747ece3fad",
|
|
29
|
+
"agents/orchestrator.md": "0709bc2761ba4a72145c4745b441ab0574f8d586e3ba9c44005146dda4d4582a",
|
|
30
|
+
"agents/penetration-tester.md": "c021ae363bc152fea571671d76a5e91d6d0364ab5461eabbce79307262c237ba",
|
|
31
|
+
"agents/performance-optimizer.md": "950892fe759be062e99b24188eff07f9a0880b59fe0f0e9a140a01d8a9d979e1",
|
|
32
|
+
"agents/performance-reviewer.md": "eddb122a486409ab1b8819cbde14ac6cc37d3157726cbddaef8b5e576fa59018",
|
|
33
|
+
"agents/precedence-reviewer.md": "821d755c980c089640027fa98a06e4b72d9ad5870450c857ef899772da575417",
|
|
34
|
+
"agents/product-manager.md": "202850175e29bc7b4cef98735b2590d38005208c997a1ea6d77b8f42e6529aff",
|
|
35
|
+
"agents/product-owner.md": "ebdb9ec76cc375a4c372aeb2606c038e2a200bc7fbeb179803f49bd8382fe733",
|
|
36
|
+
"agents/product-reviewer.md": "2899b10b538121a82c4aad0b56c2ce0f273dcdc859489911372916090853adc2",
|
|
37
|
+
"agents/project-planner.md": "663128b26287931c270659083e4b23bb54af5ce5629a6871fee190a1d785cb36",
|
|
38
|
+
"agents/qa-automation-engineer.md": "4112f9d47e3816387ad4666054d4ed166fa465131f38482c468b16ebd57e3ff1",
|
|
39
|
+
"agents/resilience-reviewer.md": "fd7b0245a149a20347a20c2665b4e9363b2590b964c52667be5a034c69fc05a7",
|
|
40
|
+
"agents/schema-reviewer.md": "8e23c94c9ec96ee995ba54c5af87c6c4bcf455309c7a59188b4b6e115fa64dee",
|
|
41
|
+
"agents/security-auditor.md": "5a23581c041a8be551166c44d9d632d7809c942f818d3f2e86dd1656d11cb73c",
|
|
42
|
+
"agents/seo-specialist.md": "304318b15e7243c50765c9329b1807927b417dab00809b6e4b8b60ad41818482",
|
|
43
|
+
"agents/sql-reviewer.md": "bac1fb217ac1564005b24ccb6d64ff97f8309a43e6e181d4e397e53a0a2ceb4b",
|
|
44
|
+
"agents/supervisor-agent.md": "1e1acf3af5ef0089f2b6f85257fa6e5856d24f1554c31b9e11df16545abb70fc",
|
|
45
|
+
"agents/swarm-worker-contracts.md": "ccd0d905cd47634b5084a0368bde4f8cf2b9191fb0118ef105c3a93a0da6314d",
|
|
46
|
+
"agents/swarm-worker-registry.md": "0bacf1872dfba3a020880c42481c3d1c91546951d8087b7513c98b4ca9dab4e3",
|
|
47
|
+
"agents/system-architect.md": "8dfa980f65ddec9aaf0cd6e91c0be6de442fc8bd487327dbc8401b7d9beae4b3",
|
|
48
|
+
"agents/test-coverage-reviewer.md": "9b0f45fabc8770bb1466cee496921965bad6352e98ff94d5f96e9dbb88afc3d2",
|
|
49
|
+
"agents/test-engineer.md": "95ccf1f2dfb1169914f60d4a58caaaac30cd0c323769b990cfeee44b36f9a6c0",
|
|
50
|
+
"agents/throughput-optimizer.md": "61912f95fd330d0bdb7568bbdf8f56bcf9a23436adef1614eac01ee747117649",
|
|
51
|
+
"agents/type-safety-reviewer.md": "fa53aa125a876bbf79ad8e27530622087b5221832162e9753808250f515aee3e",
|
|
52
|
+
"agents/ui-ux-auditor.md": "eca159306ec3517d263268bd14805bf861c0b2a43538eb887ebf553bc0fe6b4b",
|
|
53
|
+
"agents/ui-visual-auditor.md": "808738bb9beaddbb1a318b5af9375907c694aad79d09ff308fd0cf4ef560f701",
|
|
54
|
+
"agents/ux-reviewer.md": "f7ccfdee74b7167130732e9e4b60f4bc76384e8cbcd346f67d4690a4310cad7a",
|
|
55
|
+
"agents/visual-reviewer.md": "fb1e14e81bdab69ce48629335718b0bceed64be6551ef3217033f233ae523346",
|
|
56
|
+
"agents/vitals-reviewer.md": "1a0c5d212c4260a96353771469f6f23b88d412c1468a6f64708d50ce4a62210a",
|
|
57
|
+
"patterns/generator.md": "009e73216e18aac251390f5d393d8c337f7714f0e5792ee03928f6e5f71c52f4",
|
|
58
|
+
"patterns/inversion.md": "50c23e1e3cd703a6bc9f4f70452dc9df2515d31b5e269d9a2cad8b158a382642",
|
|
59
|
+
"patterns/pipeline.md": "ae7a1cf81b83606887479623e69073bfb841ccf16ab3aff3248942a621cf3bbe",
|
|
60
|
+
"patterns/reviewer.md": "9aefbe2e1d70384c6acd39cf7e7ad7a582237096933069945d863178c5765611",
|
|
61
|
+
"patterns/tool-wrapper.md": "46e9b6b04f911415f0defdd44345570e818dfe6e3c4aafff1028582936f3fb8f",
|
|
62
|
+
"rules/GEMINI.md": "c77c36e6d8011895731deb645e524bdb0b15f1266c0b10f3fcd276824ceda02f",
|
|
63
|
+
"rules/GEMINI_PLANNER.md": "eb189fa733d63e0e87b61be94c35d940e541076161ac134546649d8d4404bced",
|
|
64
|
+
"workflows/tribunal-ui.md": "3ff8ad1d814f08fae8be453be5f4ec7bcdd7cdea36a8a51785018dafde94a8f3",
|
|
65
|
+
"workflows/ui-ux-pro-max.md": "04063384a85f12682ec2d99804dc4a1d90f51c74c4430723a212c27942495dfb",
|
|
66
|
+
"skills/context-engineering-pro/SKILL.md": "a888b0bb671f6a62e81cc23846d80e9a6591bb7968d5d59339bfc76c8424791a",
|
|
67
|
+
"skills/agentic-workflows-2026/SKILL.md": "b96c46d0915e6113e20a5498bbb8d8d79949da28cbdd4b8749a83ac909a5731b",
|
|
68
|
+
"skills/vector-search-pgvector/SKILL.md": "18a3495ea81b52c4c054945ae26e14bfbf59d8a9f893a3cdd6201da5b317a792",
|
|
69
|
+
"skills/duckdb-analytical-sql/SKILL.md": "0d282bf667f3bcaf88d0f71bb7f95c7f6a1e97131f035b88f0a9d28c2e2732ab",
|
|
70
|
+
"skills/expo-router-v4/SKILL.md": "8a0c8ecce143e7686661933af4bf88264ebd7c6074c0b6384711585515940125",
|
|
71
|
+
"skills/edge-ai-mobile/SKILL.md": "f6c75111597175e943291523226ec916ea8e4f21555780a32f60427e04bcc8ed",
|
|
72
|
+
"skills/platform-engineering-opentofu/SKILL.md": "a888b0bb671f6a62e81cc23846d80e9a6591bb7968d5d59339bfc76c8424791a",
|
|
73
|
+
"skills/opentelemetry-observability/SKILL.md": "60024b62cbe8165d0f9c0520675a7c2726ef1d54e81e1be6f65e182e96d9545a",
|
|
74
|
+
"skills/zero-trust-passkeys/SKILL.md": "ba8eaeb9b7957a9b6516532304e5fcd54bce2cee1b351ccf26a614aea7e778d0",
|
|
75
|
+
"skills/ai-app-hardening/SKILL.md": "03cfe2ac052856bd9483f3dc49d1fb848c8bbe0333d778a0f288bbdefd7f698e",
|
|
76
|
+
"skills/playwright-ai-e2e/SKILL.md": "778de79a3ec24a9bd6532d7d2bd5365b433208036d3d45e8783a7a72ee40c149",
|
|
77
|
+
"skills/property-based-testing/SKILL.md": "ed7dfa9119a955282465bc6e118bcd6b2994a90398e994d3547eed91309d3d15"
|
|
78
|
+
}
|
package/.agent/ARCHITECTURE.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# 🏛️ Tribunal Anti-Hallucination Kit
|
|
1
|
+
# 🏛️ Tribunal Anti-Hallucination Kit v6.0.1 — Architecture
|
|
2
2
|
|
|
3
3
|
Works natively in **Antigravity**, **Cursor**, **Windsurf**, and any AI IDE that indexes `.agent/` folders.
|
|
4
4
|
|
|
@@ -34,252 +34,30 @@ flowchart TD
|
|
|
34
34
|
|
|
35
35
|
---
|
|
36
36
|
|
|
37
|
-
## 2.
|
|
37
|
+
## 2. Option A + Option C Hybrid Architecture (v3.0.0 Standard)
|
|
38
38
|
|
|
39
|
-
|
|
39
|
+
### Subsystem A: 2-Tier Lazy Skill Routing Engine
|
|
40
40
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
P1["Task & Context"] --> P2["Classify Task & Stack"]
|
|
45
|
-
P2 --> P3["Select 2-3 Essential Skills"]
|
|
46
|
-
P3 --> P4["Output: Spec JSON"]
|
|
47
|
-
end
|
|
48
|
-
|
|
49
|
-
subgraph Pass2 ["Pass 2: Builder (~2,500 tokens)"]
|
|
50
|
-
B1["Spec JSON + 2-3 Skill Rules"] --> B2["Focus Synthesis (75% Task Context)"]
|
|
51
|
-
B2 --> B3["Generate Clean Code"]
|
|
52
|
-
end
|
|
53
|
-
|
|
54
|
-
subgraph Pass3 ["Pass 3: Validator (0 Tokens - Free)"]
|
|
55
|
-
V1["Generated Code"] --> V2["pipeline_engine.js"]
|
|
56
|
-
V2 --> V3["OWASP & Lint Check"]
|
|
57
|
-
V3 -->|Pass| V4["Human Gate"]
|
|
58
|
-
V3 -->|Fail| V5["Targeted Retry (Max 3)"]
|
|
59
|
-
end
|
|
60
|
-
|
|
61
|
-
Pass1 --> Pass2 --> Pass3
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
---
|
|
65
|
-
|
|
66
|
-
## 3. Swarm / Supervisor Architecture
|
|
67
|
-
|
|
68
|
-
The `/swarm` workflow decomposes complex multi-domain goals into atomic, non-overlapping sub-tasks handled concurrently by specialist Workers.
|
|
69
|
-
|
|
70
|
-
```mermaid
|
|
71
|
-
flowchart TD
|
|
72
|
-
A["/swarm [Multi-domain Goal]"] --> B["supervisor-agent"]
|
|
73
|
-
B --> C["Read: swarm-worker-registry.md"]
|
|
74
|
-
C --> D["Validate Payload: swarm_dispatcher.js"]
|
|
75
|
-
|
|
76
|
-
D --> E1["Worker A: backend-specialist"]
|
|
77
|
-
D --> E2["Worker B: database-architect"]
|
|
78
|
-
D --> E3["Worker C: frontend-specialist"]
|
|
79
|
-
|
|
80
|
-
E1 --> F1["WorkerResult A"]
|
|
81
|
-
E2 --> F2["WorkerResult B"]
|
|
82
|
-
E3 --> F3["WorkerResult C"]
|
|
83
|
-
|
|
84
|
-
F1 & F2 & F3 --> G["Promise.allSettled() Synthesis"]
|
|
85
|
-
G --> H["Human Gate Approval"]
|
|
86
|
-
```
|
|
87
|
-
|
|
88
|
-
---
|
|
89
|
-
|
|
90
|
-
## 4. Context Window Token Budget Breakdown
|
|
91
|
-
|
|
92
|
-
```mermaid
|
|
93
|
-
pie title Monolithic Generation vs Decoupled 3-Pass Pipeline Context Window
|
|
94
|
-
"Generated Code Output" : 75
|
|
95
|
-
"Essential Skill Rules" : 15
|
|
96
|
-
"Task & File Context" : 10
|
|
97
|
-
```
|
|
98
|
-
|
|
99
|
-
* **Monolithic `/generate`**: Uses ~12,000–18,000 tokens per pass (89% spent on system rules & personas).
|
|
100
|
-
* **Decoupled `/pipeline`**: Uses ~2,500 tokens in Pass 2 (75%+ of context window dedicated exclusively to code synthesis).
|
|
101
|
-
|
|
102
|
-
---
|
|
103
|
-
|
|
104
|
-
## 5. The 27 Parallel Tribunal Reviewers
|
|
105
|
-
|
|
106
|
-
When code is generated or audited, domain reviewers evaluate the diff in parallel. Approval requires unanimous pass across all assigned reviewers.
|
|
107
|
-
|
|
108
|
-
| Reviewer Agent | Agent File | Primary Domain & Activation Signals |
|
|
109
|
-
| :--- | :--- | :--- |
|
|
110
|
-
| `logic-reviewer` | `agents/logic-reviewer.md` | **Always Active** — Core logic, boundary conditions, edge cases |
|
|
111
|
-
| `security-auditor` | `agents/security-auditor.md` | **Always Active** — OWASP Top 10, sanitization, secret exposure |
|
|
112
|
-
| `precedence-reviewer` | `agents/precedence-reviewer.md` | **Always Active** — Checks Case Law & project architectural precedents |
|
|
113
|
-
| `complexity-reviewer` | `agents/complexity-reviewer.md` | **Always Active** — Over-engineering, Dependency Ladder enforcement |
|
|
114
|
-
| `type-safety-reviewer` | `agents/type-safety-reviewer.md` | TypeScript strictness, zero `as any` policy, generic constraints |
|
|
115
|
-
| `dependency-reviewer` | `agents/dependency-reviewer.md` | Phantom package detection, `package.json` verification |
|
|
116
|
-
| `resilience-reviewer` | `agents/resilience-reviewer.md` | Fault tolerance, retries, circuit breakers, error boundaries |
|
|
117
|
-
| `schema-reviewer` | `agents/schema-reviewer.md` | Input validation, Zod / Pydantic schemas, contract boundaries |
|
|
118
|
-
| `frontend-reviewer` | `agents/frontend-reviewer.md` | React 19 / Next.js Server Components, hook rules, state mutations |
|
|
119
|
-
| `ui-ux-auditor` | `agents/ui-ux-auditor.md` | Usability heuristics, responsive layouts, spatial systems |
|
|
120
|
-
| `visual-reviewer` | `agents/visual-reviewer.md` | Visual hierarchy, typography scaling, OKLCH color palettes |
|
|
121
|
-
| `interaction-reviewer` | `agents/interaction-reviewer.md` | Micro-interactions, hover/focus/active states, tactile feedback |
|
|
122
|
-
| `anti-pattern-reviewer` | `agents/anti-pattern-reviewer.md` | Banned AI clichés (purple gradients, generic hero grids) |
|
|
123
|
-
| `accessibility-reviewer` | `agents/accessibility-reviewer.md` | WCAG 2.2 AA compliance, ARIA attributes, keyboard navigation |
|
|
124
|
-
| `sql-reviewer` | `agents/sql-reviewer.md` | Parameterized queries, ORM safety, transaction integrity |
|
|
125
|
-
| `db-latency-auditor` | `agents/db-latency-auditor.md` | Slow query detection, index optimization, N+1 query prevention |
|
|
126
|
-
| `mobile-reviewer` | `agents/mobile-reviewer.md` | React Native, Expo Router, 60fps Reanimated worklets, safe areas |
|
|
127
|
-
| `performance-reviewer` | `agents/performance-reviewer.md` | O(n²) bottlenecks, layout thrashing, memory leaks |
|
|
128
|
-
| `vitals-reviewer` | `agents/vitals-reviewer.md` | Core Web Vitals (LCP, CLS, INP, TTFB) depth analysis |
|
|
129
|
-
| `throughput-optimizer` | `agents/throughput-optimizer.md` | Event-loop blocking, server concurrency, streaming optimization |
|
|
130
|
-
| `ai-code-reviewer` | `agents/ai-code-reviewer.md` | LLM SDK parameters, prompt injection defense, token explosion |
|
|
131
|
-
|
|
132
|
-
---
|
|
133
|
-
|
|
134
|
-
## 6. 29 Specialist Domain Agents
|
|
135
|
-
|
|
136
|
-
| Domain Specialist | Agent File | Focus Area & Capabilities |
|
|
137
|
-
| :--- | :--- | :--- |
|
|
138
|
-
| `supervisor-agent` | `agents/supervisor-agent.md` | Swarm triage, Worker dispatch, result synthesis |
|
|
139
|
-
| `orchestrator` | `agents/orchestrator.md` | Multi-agent workflow coordination & fan-out |
|
|
140
|
-
| `agent-organizer` | `agents/agent-organizer.md` | Agent ecosystem management & memory distillation |
|
|
141
|
-
| `project-planner` | `agents/project-planner.md` | 4-phase structured implementation planning |
|
|
142
|
-
| `backend-specialist` | `agents/backend-specialist.md` | Node.js, Express, Hono, API design, Server Actions |
|
|
143
|
-
| `frontend-specialist` | `agents/frontend-specialist.md` | Modern Web UI, CSS systems, component architecture |
|
|
144
|
-
| `react-specialist` | `agents/react-specialist.md` | React 19, Server Components, Zustand, TanStack Query |
|
|
145
|
-
| `nextjs-react-expert` | `agents/nextjs-react-expert.md` | Next.js 15 App Router, PPR, Server Actions, Middleware |
|
|
146
|
-
| `vue-expert` | `agents/vue-expert.md` | Vue 3.5+, Composition API, Nuxt 4, Pinia |
|
|
147
|
-
| `python-pro` | `agents/python-pro.md` | Python 3.12+, FastAPI, Pydantic v2, Asyncio, Pytest |
|
|
148
|
-
| `rust-pro` | `agents/rust-pro.md` | Rust 1.75+, Tokio async, Axum, Serde, memory safety |
|
|
149
|
-
| `csharp-developer` | `agents/csharp-developer.md` | C# 12, .NET 8/9, ASP.NET Core, Blazor architecture |
|
|
150
|
-
| `database-architect` | `agents/database-architect.md` | Data modeling, Prisma/Drizzle schema design, migrations |
|
|
151
|
-
| `sql-pro` | `agents/sql-pro.md` | PostgreSQL, Supabase RLS, complex analytical SQL |
|
|
152
|
-
| `mobile-developer` | `agents/mobile-developer.md` | Expo, React Native, Flutter, native modules |
|
|
153
|
-
| `devops-engineer` | `agents/devops-engineer.md` | Docker, CI/CD pipelines, GitHub Actions, deployment |
|
|
154
|
-
| `platform-engineer` | `agents/platform-engineer.md` | Cloud-native infrastructure, Kubernetes, Terraform |
|
|
155
|
-
| `cloud-engineer` | `agents/cloud-engineer.md` | AWS, Serverless, IaC, edge computing topology |
|
|
156
|
-
| `devops-incident-responder` | `agents/devops-incident-responder.md` | Incident root cause investigation & hotfixes |
|
|
157
|
-
| `debugger` | `agents/debugger.md` | 4-phase systematic debugging & traceback isolation |
|
|
158
|
-
| `system-architect` | `agents/system-architect.md` | Capacity planning, scale estimation, distributed systems |
|
|
159
|
-
| `code-archaeologist` | `agents/code-archaeologist.md` | Legacy codebase analysis, debt mapping, seams |
|
|
160
|
-
| `explorer-agent` | `agents/explorer-agent.md` | Unknown codebase mapping & dependency graph discovery |
|
|
161
|
-
| `documentation-writer` | `agents/documentation-writer.md` | Technical documentation, OpenAPI, README generation |
|
|
162
|
-
| `test-engineer` | `agents/test-engineer.md` | Testing Trophy strategy, behavioral test design |
|
|
163
|
-
| `qa-automation-engineer` | `agents/qa-automation-engineer.md` | E2E Playwright testing, CI test automation |
|
|
164
|
-
| `seo-specialist` | `agents/seo-specialist.md` | Technical SEO, OpenGraph, Core Web Vitals optimization |
|
|
165
|
-
| `product-manager` | `agents/product-manager.md` | Feature prioritization, scope control, user stories |
|
|
166
|
-
| `product-owner` | `agents/product-owner.md` | Backlog management, acceptance criteria verification |
|
|
167
|
-
|
|
168
|
-
---
|
|
169
|
-
|
|
170
|
-
## 7. 37 Slash Commands & Workflows
|
|
171
|
-
|
|
172
|
-
Type any of these commands in your AI IDE chat to trigger specialized workflows:
|
|
41
|
+
- **Lightweight Index (`skill_topic_map.json`):** 183 skills indexed across 9 domain routes and file extensions (~500 tokens).
|
|
42
|
+
- **Startup Overhead:** ~2,500 – 3,500 startup tokens vs 85,000 tokens previously (95% token reduction).
|
|
43
|
+
- **Zero Exclusions:** All 183 skills remain indexed on disk; target skills are fetched dynamically on-demand via `view_file`.
|
|
173
44
|
|
|
174
|
-
|
|
175
|
-
| :--- | :--- | :--- |
|
|
176
|
-
| `/generate` | Full Tribunal: Maker → Parallel Review → Human Gate | [`workflows/generate.md`](workflows/generate.md) |
|
|
177
|
-
| `/review` | Pure read-only hallucination audit | [`workflows/review.md`](workflows/review.md) |
|
|
178
|
-
| `/tribunal-full` | Comprehensive 27-reviewer parallel audit | [`workflows/tribunal-full.md`](workflows/tribunal-full.md) |
|
|
179
|
-
| `/tribunal-backend` | Logic + Security + Deps + Type Safety + Resilience + Schema | [`workflows/tribunal-backend.md`](workflows/tribunal-backend.md) |
|
|
180
|
-
| `/tribunal-frontend` | Logic + Security + Frontend + Types + UI/UX + Motion + Visual | [`workflows/tribunal-frontend.md`](workflows/tribunal-frontend.md) |
|
|
181
|
-
| `/tribunal-database` | Logic + Security + SQL parameterization audit | [`workflows/tribunal-database.md`](workflows/tribunal-database.md) |
|
|
182
|
-
| `/tribunal-mobile` | Logic + Security + Mobile 60fps Reanimated audit | [`workflows/tribunal-mobile.md`](workflows/tribunal-mobile.md) |
|
|
183
|
-
| `/tribunal-performance` | Logic + Performance optimization audit | [`workflows/tribunal-performance.md`](workflows/tribunal-performance.md) |
|
|
184
|
-
| `/tribunal-ui` | Dedicated UI/UX design heuristics audit | [`workflows/tribunal-ui.md`](workflows/tribunal-ui.md) |
|
|
185
|
-
| `/tribunal-speed` | Full-stack parallel performance swarm (max 5 AI calls) | [`workflows/tribunal-speed.md`](workflows/tribunal-speed.md) |
|
|
186
|
-
| `/brainstorm` | Socratic exploration mode — 3 options & tradeoffs | [`workflows/brainstorm.md`](workflows/brainstorm.md) |
|
|
187
|
-
| `/create` | Full application creation from requirements to scaffold | [`workflows/create.md`](workflows/create.md) |
|
|
188
|
-
| `/enhance` | Dependency-safe feature addition & impact analysis | [`workflows/enhance.md`](workflows/enhance.md) |
|
|
189
|
-
| `/debug` | 4-phase systematic root cause investigation | [`workflows/debug.md`](workflows/debug.md) |
|
|
190
|
-
| `/plan` | Strategic 4-phase implementation planning | [`workflows/plan.md`](workflows/plan.md) |
|
|
191
|
-
| `/deploy` | Pre-flight safety checks & production release gates | [`workflows/deploy.md`](workflows/deploy.md) |
|
|
192
|
-
| `/test` | Behavioral test generation & execution | [`workflows/test.md`](workflows/test.md) |
|
|
193
|
-
| `/preview` | Local dev server lifecycle management | [`workflows/preview.md`](workflows/preview.md) |
|
|
194
|
-
| `/status` | Project health dashboard & active execution ledger | [`workflows/status.md`](workflows/status.md) |
|
|
195
|
-
| `/session` | Multi-session state tracking & restoration | [`workflows/session.md`](workflows/session.md) |
|
|
196
|
-
| `/orchestrate` | Multi-agent fan-out/fan-in coordination | [`workflows/orchestrate.md`](workflows/orchestrate.md) |
|
|
197
|
-
| `/swarm` | Multi-agent swarm supervisor & JSON contract dispatcher | [`workflows/swarm.md`](workflows/swarm.md) |
|
|
198
|
-
| `/strengthen-skills` | Skill hardening & Tribunal guardrail injector | [`workflows/strengthen-skills.md`](workflows/strengthen-skills.md) |
|
|
199
|
-
| `/ui-ux-pro-max` | Picasso design specification & 16-step UI engine | [`workflows/ui-ux-pro-max.md`](workflows/ui-ux-pro-max.md) |
|
|
200
|
-
| `/refactor` | Dependency-safe structural code refactoring | [`workflows/refactor.md`](workflows/refactor.md) |
|
|
201
|
-
| `/migrate` | Expand-and-contract database & framework migrations | [`workflows/migrate.md`](workflows/migrate.md) |
|
|
202
|
-
| `/audit` | Full project health assessment & priority script audit | [`workflows/audit.md`](workflows/audit.md) |
|
|
203
|
-
| `/fix` | Automated error resolution & lint diff preview | [`workflows/fix.md`](workflows/fix.md) |
|
|
204
|
-
| `/changelog` | Conventional commit history to changelog compiler | [`workflows/changelog.md`](workflows/changelog.md) |
|
|
205
|
-
| `/review-ai` | LLM integration & prompt injection defense audit | [`workflows/review-ai.md`](workflows/review-ai.md) |
|
|
206
|
-
| `/pipeline` | Token-efficient 3-pass code generation pipeline | [`workflows/pipeline.md`](workflows/pipeline.md) |
|
|
207
|
-
| `/super-prompt` | Zero-token local prompt compiler | [`workflows/super-prompt.md`](workflows/super-prompt.md) |
|
|
208
|
-
| `/marathon` | Multi-session long-running agent harness | [`workflows/marathon.md`](workflows/marathon.md) |
|
|
209
|
-
| `/acf` | Agent Context Format spec distillation | [`workflows/acf.md`](workflows/acf.md) |
|
|
210
|
-
| `/api-tester` | Multi-stage auth-aware API endpoint testing | [`workflows/api-tester.md`](workflows/api-tester.md) |
|
|
211
|
-
| `/performance-benchmarker` | Evidence-based Core Web Vitals measurement | [`workflows/performance-benchmarker.md`](workflows/performance-benchmarker.md) |
|
|
45
|
+
### Subsystem C: Stage-Partitioned Tribunal Pipeline
|
|
212
46
|
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
| Script Name | Primary Function | Command Example |
|
|
220
|
-
| :--- | :--- | :--- |
|
|
221
|
-
| `security_scan.js` | Deep OWASP-aware source code security scanner | `node .agent/scripts/security_scan.js .` |
|
|
222
|
-
| `dependency_analyzer.js` | Unused/phantom dependency audit & npm security audit | `node .agent/scripts/dependency_analyzer.js . --audit` |
|
|
223
|
-
| `lint_runner.js` | Standalone multi-linter runner (ESLint, Prettier, Ruff) | `node .agent/scripts/lint_runner.js . --fix` |
|
|
224
|
-
| `schema_validator.js` | DB schema validator (Prisma, Drizzle, SQL) | `node .agent/scripts/schema_validator.js .` |
|
|
225
|
-
| `test_runner.js` | Auto-detecting test runner (Jest, Vitest, Pytest) | `node .agent/scripts/test_runner.js . --coverage` |
|
|
226
|
-
| `bundle_analyzer.js` | JS/TS production bundle size analyzer | `node .agent/scripts/bundle_analyzer.js . --build` |
|
|
227
|
-
| `verify_all.js` | Comprehensive pre-deploy validation suite | `node .agent/scripts/verify_all.js` |
|
|
228
|
-
| `checklist.js` | Priority audit: Security → Dependencies → Types → Lint | `node .agent/scripts/checklist.js .` |
|
|
229
|
-
| `auto_preview.js` | Local development server lifecycle manager | `node .agent/scripts/auto_preview.js start` |
|
|
230
|
-
| `session_manager.js` | Multi-session state tracking & snapshot restoration | `node .agent/scripts/session_manager.js status` |
|
|
231
|
-
| `swarm_dispatcher.js` | Validates Swarm WorkerRequest/WorkerResult payloads | `node .agent/scripts/swarm_dispatcher.js --file payload.json` |
|
|
232
|
-
| `skill_integrator.js` | Maps active skills to executable scripts | `node .agent/scripts/skill_integrator.js` |
|
|
233
|
-
| `pipeline_engine.js` | 3-pass hybrid pipeline orchestrator (Plan/Build/Validate) | `node .agent/scripts/pipeline_engine.js --task "..." --dry-run` |
|
|
234
|
-
| `prompt_compiler.js` | Zero-token local prompt compiler to dense YAML | `node .agent/scripts/prompt_compiler.js "build login"` |
|
|
235
|
-
| `strengthen_skills.js` | Hardens skills with Pre-Flight & VBC guardrails | `node .agent/scripts/strengthen_skills.js . --dry-run` |
|
|
236
|
-
| `test_swarm_dispatcher.js` | Integration test suite for swarm dispatcher | `npx jest test/integration/swarm_dispatcher.test.js` |
|
|
237
|
-
| `auto_fixer.js` | Automated formatting & import cleanup engine | `node .agent/scripts/auto_fixer.js .` |
|
|
238
|
-
| `context_snapshot.js` | Compacts large codebase graphs for 27x context reduction | `node .agent/scripts/context_snapshot.js .` |
|
|
239
|
-
| `skill_evolution.js` | Extracts project idioms & auto-evolves project-idioms skill | `node .agent/scripts/skill_evolution.js .` |
|
|
240
|
-
|
|
241
|
-
*(Note: Additional internal helper scripts in `.agent/scripts/` handle AST parsing, diff formatting, and IPC message routing).*
|
|
47
|
+
- **52 Specialist Agents** (28 Parallel Reviewers + 24 Domain Specialists).
|
|
48
|
+
- **3 Execution Waves:** Replaces monolithic fan-out with 3 partitioned passes (28 reviewers total):
|
|
49
|
+
- **Wave 1 (Core Integrity):** `precedence-reviewer`, `logic-reviewer`, `schema-reviewer`, `resilience-reviewer`
|
|
50
|
+
- **Wave 2 (Security & Types):** `security-auditor`, `dependency-reviewer`, `type-safety-reviewer`, `complexity-reviewer`, `sql-reviewer`, `pipeline-reviewer`
|
|
51
|
+
- **Wave 3 (Domain & Performance):** `frontend-reviewer`, `performance-reviewer`, `mobile-reviewer`, `ai-code-reviewer`, `test-coverage-reviewer`, `accessibility-reviewer`, `ui-ux-auditor`, `review-animations`, `vitals-reviewer`, `db-latency-auditor`, `throughput-optimizer`
|
|
52
|
+
- **Attention Preservation:** Reviewers execute in scoped evaluation pairs of 4 to 8 specialists, eliminating hallucination risks and attention dilution.
|
|
242
53
|
|
|
243
54
|
---
|
|
244
55
|
|
|
245
|
-
##
|
|
246
|
-
|
|
247
|
-
### Option B Agent Standard (51 Agents)
|
|
248
|
-
* **YAML Frontmatter**: Version `3.0.0`, `last-updated: 2026-07-29`, clean `skills` array, tool declarations, model targets.
|
|
249
|
-
* **Mandatory Pre-Flight Context Inspection**: Grounded list of workspace files inspected prior to action.
|
|
250
|
-
* **Framework Decision Trees & Blueprints**: Version-pinned decision matrices (React 19, Next 15, Prisma 6, Node 20+, Python 3.12+, Expo Router v4).
|
|
251
|
-
* **Hand-Off & Coordination Protocols**: Explicit `@agent` routing contracts.
|
|
56
|
+
## 3. Skill-Script Binding Standard
|
|
252
57
|
|
|
253
|
-
|
|
254
|
-
* **YAML Frontmatter**: Version `3.0.0`, `last-updated: 2026-07-30`, array-style `skills` co-requirements, `tools` declaration, `scripts-binding` array pointing to `.agent/scripts/`.
|
|
255
|
-
* **Mandatory Pre-Flight Context Inspection**: Specific numbered section targets and rules that agents MUST check before executing the skill.
|
|
256
|
-
* **Tribunal Integration & VBC Protocol**: Anti-hallucination guardrails and Verification-Before-Completion evidence validation.
|
|
58
|
+
Every skill in `.agent/skills/` conforms to the Option A+C Hybrid v3.0.0 frontmatter standard:
|
|
257
59
|
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
---
|
|
263
|
-
|
|
264
|
-
## 10. Directory Structure & File Map
|
|
265
|
-
|
|
266
|
-
```
|
|
267
|
-
.agent/
|
|
268
|
-
├── ARCHITECTURE.md ← This file (Kit v3.0.0 Master Architecture)
|
|
269
|
-
├── GEMINI.md ← Master operational rules & auto domain router
|
|
270
|
-
├── agents/ ← 51 Option B v3.0.0 Agents (27 Parallel Reviewers + 24 Domain Specialists)
|
|
271
|
-
│ ├── supervisor-agent.md ← Swarm triage, dispatch, synthesis
|
|
272
|
-
│ ├── swarm-worker-contracts.md ← WorkerRequest/WorkerResult schemas
|
|
273
|
-
│ └── swarm-worker-registry.md ← Task type → agent routing map
|
|
274
|
-
├── rules/
|
|
275
|
-
│ ├── GEMINI.md ← Master rules (P0 priority)
|
|
276
|
-
│ └── GEMINI_PLANNER.md ← Condensed planner rules for /pipeline Pass 1
|
|
277
|
-
├── scripts/ ← 37 automation scripts
|
|
278
|
-
│ └── pipeline_engine.js ← 3-pass hybrid pipeline engine
|
|
279
|
-
├── skills/ ← 171 Option A+C Hybrid v3.0.0 Skills
|
|
280
|
-
├── patterns/ ← 5 ADK skill base patterns
|
|
281
|
-
├── history/ ← Case Law + Skill Evolution data
|
|
282
|
-
└── workflows/ ← 37 Workflow Standard v3.0.0 Slash Commands
|
|
283
|
-
├── swarm.md ← /swarm orchestration procedure
|
|
284
|
-
└── pipeline.md ← /pipeline hybrid generation procedure
|
|
285
|
-
```
|
|
60
|
+
- `version`: `3.0.0`
|
|
61
|
+
- `script`: Primary executable script path in `.agent/scripts/`
|
|
62
|
+
- `scripts-binding`: Array of executable CLI tools (`security_scan.js`, `test_runner.js`, `schema_validator.js`, etc.)
|
|
63
|
+
- `skills`: Array of co-required brother skills for automatic 2-tier lazy resolution
|
|
@@ -18,6 +18,7 @@ skills:
|
|
|
18
18
|
## Mandatory Pre-Flight Context Inspection
|
|
19
19
|
|
|
20
20
|
Before auditing accessibility, you MUST inspect:
|
|
21
|
+
|
|
21
22
|
1. Target size bounds → Verify touch targets on mobile/touch interfaces meet 44x44px minimum (WCAG 2.2 SC 2.5.8)
|
|
22
23
|
2. Interactive element markup → Check for native `<button>` and `<a>` elements instead of unsemantic `<div onClick>`
|
|
23
24
|
3. Form input & Icon-only buttons → Verify `<label htmlFor="...">` bindings and `aria-label` declarations
|
|
@@ -27,39 +28,44 @@ Before auditing accessibility, you MUST inspect:
|
|
|
27
28
|
## What This Reviewer Catches
|
|
28
29
|
|
|
29
30
|
### 1. Target Size (Minimum) (WCAG 2.2 SC 2.5.8 - Level AA)
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
31
|
+
|
|
32
|
+
- **Criterion:** All interactive targets (buttons, links, form fields, checkboxes) must be at least **24x24 CSS pixels** in size.
|
|
33
|
+
- **Coarse Pointers (Touch):** If the UI is used on touch devices (pointer: coarse), targets must meet a minimum size of **44x44px** (Apple HIG) or **48x48dp** (Material Design).
|
|
34
|
+
- **Exception:** Inline text links (e.g., links in paragraphs) are exempt, but must have sufficient visual distinction (e.g., underline).
|
|
35
|
+
- **Spacing Buffer:** Targets smaller than 24x24px must have surrounding spacing buffer so that a 24px diameter circle centered on the target does not intersect another target.
|
|
34
36
|
|
|
35
37
|
### 2. APCA Contrast Guidelines (WCAG 3.0 APCA Base)
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
38
|
+
|
|
39
|
+
- **Lightness Contrast (Lc):** Ensure readability using the APCA scale instead of flat 4.5:1 ratios:
|
|
40
|
+
- **Body text (small size):** Must achieve Lc > 75.
|
|
41
|
+
- **Large display headings (large size):** Must achieve Lc > 60.
|
|
42
|
+
- **Interactive indicators & borders:** Must achieve Lc > 45.
|
|
40
43
|
|
|
41
44
|
### 3. Keyboard Navigation & Focus Visibility
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
+
|
|
46
|
+
- **Focus Ring (WCAG 2.4.13 - Level AA):** Visible focus rings must achieve 3:1 contrast and cannot be hidden (`outline: none` is forbidden).
|
|
47
|
+
- **Focus Trap (WCAG 2.1.2):** All overlay modals, slide-out panels, and drawers must trap focus internally and return it to the trigger element on close.
|
|
48
|
+
- **Semantic Tab Order:** Tab navigation must match the visual layout reading flow.
|
|
45
49
|
|
|
46
50
|
### 4. Semantic Markup & ARIA Semantics (WCAG 4.1.2)
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
51
|
+
|
|
52
|
+
- **Interactive Tags:** Clickable elements must use native `<button>` or `<a>` tags. Avoid `<div onClick>`.
|
|
53
|
+
- **Label Association (WCAG 1.3.1):** All input elements must be linked to a `<label htmlFor="...">`. Placeholders are not labels.
|
|
54
|
+
- **Accessible Name:** Icon-only buttons must declare an `aria-label` or `aria-labelledby` property.
|
|
50
55
|
|
|
51
56
|
---
|
|
52
57
|
|
|
53
58
|
## Code Comparison Examples
|
|
54
59
|
|
|
55
60
|
### Target Size (Minimum) Violation
|
|
61
|
+
|
|
56
62
|
```tsx
|
|
57
63
|
// ❌ REJECTED: Small 14x14px click area, no padding buffer. Fails WCAG 2.5.8.
|
|
58
64
|
<button onClick={onClose} className="w-3.5 h-3.5 bg-red-500 rounded-full" />
|
|
59
65
|
|
|
60
66
|
// ✅ APPROVED: Visual area remains small (w-3.5 h-3.5), but absolute touch target is expanded to 44x44px
|
|
61
|
-
<button
|
|
62
|
-
onClick={onClose}
|
|
67
|
+
<button
|
|
68
|
+
onClick={onClose}
|
|
63
69
|
aria-label="Close alert"
|
|
64
70
|
className="relative p-3 hover:bg-[var(--bg-surface-raised)] rounded-full transition-all"
|
|
65
71
|
>
|
|
@@ -68,6 +74,7 @@ Before auditing accessibility, you MUST inspect:
|
|
|
68
74
|
```
|
|
69
75
|
|
|
70
76
|
### Contrast Violation
|
|
77
|
+
|
|
71
78
|
```tsx
|
|
72
79
|
// ❌ REJECTED: Gray text on white background yields contrast ratio of 2.2:1 (Lc <40).
|
|
73
80
|
<p className="text-gray-300 bg-white text-xs">Secondary description</p>
|
|
@@ -21,6 +21,7 @@ Every piece of code that calls an LLM API must be verified against the actual pr
|
|
|
21
21
|
## Mandatory Pre-Flight Context Inspection
|
|
22
22
|
|
|
23
23
|
Before auditing LLM integration code, you MUST inspect:
|
|
24
|
+
|
|
24
25
|
1. `package.json` / `requirements.txt` → Check LLM SDK versions (`openai`, `@anthropic-ai/sdk`, `@google/genai`, `ai` Vercel AI SDK)
|
|
25
26
|
2. Environment configs → Confirm model name strings are parameterized (`process.env.MODEL_NAME`) rather than hardcoded strings
|
|
26
27
|
3. Prompt templates → Audit user input sanitization delimiters (`<user_input>`) and prompt injection boundaries
|
|
@@ -48,21 +49,21 @@ Flag any model name that cannot be verified in the provider's current model docu
|
|
|
48
49
|
```typescript
|
|
49
50
|
// ❌ HALLUCINATED: Parameters that don't exist in OpenAI SDK
|
|
50
51
|
const response = await openai.chat.completions.create({
|
|
51
|
-
model:
|
|
52
|
+
model: 'gpt-4o',
|
|
52
53
|
messages,
|
|
53
54
|
max_length: 1000, // Hallucinated — use max_tokens
|
|
54
|
-
format:
|
|
55
|
+
format: 'json', // Hallucinated — use response_format: { type: 'json_object' }
|
|
55
56
|
memory: true, // Doesn't exist
|
|
56
|
-
plugins: [
|
|
57
|
-
instructions:
|
|
57
|
+
plugins: ['web-search'], // Doesn't exist in API
|
|
58
|
+
instructions: 'Be helpful', // Hallucinated — belongs in system message
|
|
58
59
|
});
|
|
59
60
|
|
|
60
61
|
// ✅ REAL OpenAI API parameters
|
|
61
62
|
const response = await openai.chat.completions.create({
|
|
62
|
-
model:
|
|
63
|
+
model: 'gpt-4o',
|
|
63
64
|
messages,
|
|
64
65
|
max_tokens: 1000,
|
|
65
|
-
response_format: { type:
|
|
66
|
+
response_format: { type: 'json_object' },
|
|
66
67
|
temperature: 0.7,
|
|
67
68
|
stream: false,
|
|
68
69
|
});
|
|
@@ -71,17 +72,17 @@ const response = await openai.chat.completions.create({
|
|
|
71
72
|
```typescript
|
|
72
73
|
// ❌ HALLUCINATED: Anthropic SDK parameters
|
|
73
74
|
const message = await anthropic.messages.create({
|
|
74
|
-
model:
|
|
75
|
+
model: 'claude-3-5-sonnet-20241022',
|
|
75
76
|
messages,
|
|
76
77
|
max_response: 1024, // Hallucinated — use max_tokens
|
|
77
|
-
system_prompt:
|
|
78
|
+
system_prompt: '...', // Hallucinated — 'system' is a top-level param
|
|
78
79
|
});
|
|
79
80
|
|
|
80
81
|
// ✅ REAL Anthropic API
|
|
81
82
|
const message = await anthropic.messages.create({
|
|
82
|
-
model:
|
|
83
|
+
model: 'claude-3-5-sonnet-20241022',
|
|
83
84
|
max_tokens: 1024,
|
|
84
|
-
system:
|
|
85
|
+
system: 'You are a helpful assistant.',
|
|
85
86
|
messages,
|
|
86
87
|
});
|
|
87
88
|
```
|
|
@@ -97,13 +98,16 @@ const systemPrompt = `You are a helpful assistant. Context: ${userInput}`;
|
|
|
97
98
|
|
|
98
99
|
// ❌ CRITICAL: User content in system role message
|
|
99
100
|
const messages = [
|
|
100
|
-
{ role:
|
|
101
|
+
{ role: 'system', content: userQuery }, // User can override system behavior
|
|
101
102
|
];
|
|
102
103
|
|
|
103
104
|
// ✅ SAFE: Strict role separation
|
|
104
105
|
const messages = [
|
|
105
|
-
{
|
|
106
|
-
|
|
106
|
+
{
|
|
107
|
+
role: 'system',
|
|
108
|
+
content: 'You are a helpful assistant. Only answer questions about our product.',
|
|
109
|
+
},
|
|
110
|
+
{ role: 'user', content: userQuery }, // User input isolated to user role
|
|
107
111
|
];
|
|
108
112
|
|
|
109
113
|
// ✅ SAFE: XML delimiting when injection context unavoidable
|
|
@@ -155,14 +159,14 @@ try {
|
|
|
155
159
|
const allUsers = await prisma.user.findMany(); // 50,000 users
|
|
156
160
|
const response = await openai.chat.completions.create({
|
|
157
161
|
messages: [
|
|
158
|
-
{ role:
|
|
162
|
+
{ role: 'user', content: `Users: ${JSON.stringify(allUsers)}\n${userQuery}` },
|
|
159
163
|
// This could be 200,000 tokens per request!
|
|
160
164
|
],
|
|
161
165
|
});
|
|
162
166
|
|
|
163
167
|
// ❌ COST EXPLOSION: No max_tokens limit on user-facing endpoint
|
|
164
168
|
const response = await anthropic.messages.create({
|
|
165
|
-
model:
|
|
169
|
+
model: 'claude-3-5-sonnet-20241022',
|
|
166
170
|
// Missing max_tokens — model can run indefinitely
|
|
167
171
|
messages,
|
|
168
172
|
});
|
|
@@ -170,11 +174,11 @@ const response = await anthropic.messages.create({
|
|
|
170
174
|
// ✅ APPROVED: Token budgeting + RAG for large datasets
|
|
171
175
|
const relevantChunks = await vectorStore.similaritySearch(userQuery, 5); // Retrieve top 5
|
|
172
176
|
const response = await openai.chat.completions.create({
|
|
173
|
-
model:
|
|
177
|
+
model: 'gpt-4o-mini', // Cost-efficient model for routing
|
|
174
178
|
max_tokens: 500, // Hard cap prevents runaway responses
|
|
175
179
|
messages: [
|
|
176
|
-
{ role:
|
|
177
|
-
{ role:
|
|
180
|
+
{ role: 'system', content: `Context:\n${relevantChunks.map(c => c.content).join('\n')}` },
|
|
181
|
+
{ role: 'user', content: userQuery },
|
|
178
182
|
],
|
|
179
183
|
});
|
|
180
184
|
```
|
|
@@ -186,12 +190,12 @@ const response = await openai.chat.completions.create({
|
|
|
186
190
|
```typescript
|
|
187
191
|
// ❌ REJECTED: Conversation history appended unbounded — will eventually overflow
|
|
188
192
|
const messages = conversationHistory; // Can grow to 100k+ tokens
|
|
189
|
-
messages.push({ role:
|
|
193
|
+
messages.push({ role: 'user', content: newMessage });
|
|
190
194
|
const response = await client.chat(messages);
|
|
191
195
|
|
|
192
196
|
// ✅ APPROVED: Sliding window with token counting
|
|
193
|
-
import { encoding_for_model } from
|
|
194
|
-
const enc = encoding_for_model(
|
|
197
|
+
import { encoding_for_model } from 'tiktoken';
|
|
198
|
+
const enc = encoding_for_model('gpt-4o');
|
|
195
199
|
|
|
196
200
|
function trimToTokenLimit(messages: Message[], limit: number = 100_000): Message[] {
|
|
197
201
|
let totalTokens = 0;
|
|
@@ -17,6 +17,7 @@ You enforce originality and build quality. You systematically block generic AI a
|
|
|
17
17
|
## Mandatory Pre-Flight Context Inspection
|
|
18
18
|
|
|
19
19
|
Before auditing UI aesthetics, you MUST inspect:
|
|
20
|
+
|
|
20
21
|
1. `index.css` / CSS variables / Tailwind config → Check color palette definitions (verify non-purple primary colors and custom design tokens)
|
|
21
22
|
2. UI component library configs (`components.json`, `theme/`) → Verify customized radius, typography, and shadow tokens
|
|
22
23
|
3. Visual layout files → Check for asymmetrical column balance vs generic repetitive cards
|
|
@@ -26,21 +27,24 @@ Before auditing UI aesthetics, you MUST inspect:
|
|
|
26
27
|
## What This Reviewer Catches
|
|
27
28
|
|
|
28
29
|
### ❌ REJECTED Criteria (Blocking)
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
30
|
+
|
|
31
|
+
- **The Purple Primary Cliché:** Using purple/violet (`#7C3AED`, `#8B5CF6`, `oklch(... 280 ... / 290Hue)`) as the primary brand/interaction color.
|
|
32
|
+
- **Mesh Gradient Cliché:** Using radial mesh gradients with multiple high-saturation blur stops as hero backgrounds.
|
|
33
|
+
- **Bento Grid Overuse:** Structuring an entire page layout as a grid of identical rounded cards without visual break or tension.
|
|
34
|
+
- **Glassmorphism Overuse:** Applying backdrop-blur panels and translucent layers for primary containers instead of clean solid surfaces.
|
|
35
|
+
- **Card-inside-Card Overlap:** Embedding cards within cards without distinct backgrounds or border elevations, resulting in muddy visual hierarchy.
|
|
34
36
|
|
|
35
37
|
### ⚠️ WARNING Criteria (Non-blocking)
|
|
36
|
-
|
|
37
|
-
|
|
38
|
+
|
|
39
|
+
- _Default Library Styles:_ Using default, uncustomized colors/radii from tailwind or shadcn/ui.
|
|
40
|
+
- _Centered Hero:_ Uninspired "centered title + centered paragraph + centered CTA button" layouts.
|
|
38
41
|
|
|
39
42
|
---
|
|
40
43
|
|
|
41
44
|
## Code Comparison Examples
|
|
42
45
|
|
|
43
46
|
### Purple Gradient vs. Sophisticated Tinted Depth
|
|
47
|
+
|
|
44
48
|
```css
|
|
45
49
|
/* ❌ REJECTED: Overused purple gradient background */
|
|
46
50
|
.card-ai {
|
|
@@ -56,6 +60,7 @@ Before auditing UI aesthetics, you MUST inspect:
|
|
|
56
60
|
```
|
|
57
61
|
|
|
58
62
|
### Bento Overuse vs. Asymmetrical Grid Balance
|
|
63
|
+
|
|
59
64
|
```tsx
|
|
60
65
|
// ❌ REJECTED: Repetitive, identical rounded bento boxes for layout
|
|
61
66
|
<div className="grid grid-cols-3 gap-4">
|