@zenrick/zenkit 0.0.0-stage → 0.5.1
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/.claude-plugin/marketplace.json +19 -0
- package/.cursor-plugin/marketplace.json +22 -0
- package/INSTALL.md +73 -0
- package/LICENSE +202 -0
- package/NOTICE +5 -0
- package/README.md +69 -3
- package/TERMS.md +48 -0
- package/THIRD-PARTY-NOTICES.md +109 -0
- package/kit/agents/backend-specialist.md +263 -0
- package/kit/agents/code-archaeologist.md +106 -0
- package/kit/agents/database-architect.md +226 -0
- package/kit/agents/debugger.md +226 -0
- package/kit/agents/devops-engineer.md +242 -0
- package/kit/agents/documentation-writer.md +104 -0
- package/kit/agents/explorer-agent.md +73 -0
- package/kit/agents/frontend-specialist.md +593 -0
- package/kit/agents/game-developer.md +162 -0
- package/kit/agents/mobile-developer.md +377 -0
- package/kit/agents/orchestrator.md +489 -0
- package/kit/agents/penetration-tester.md +188 -0
- package/kit/agents/performance-optimizer.md +187 -0
- package/kit/agents/product-manager.md +112 -0
- package/kit/agents/product-owner.md +95 -0
- package/kit/agents/project-planner.md +409 -0
- package/kit/agents/qa-automation-engineer.md +103 -0
- package/kit/agents/security-auditor.md +170 -0
- package/kit/agents/seo-specialist.md +111 -0
- package/kit/agents/test-engineer.md +158 -0
- package/kit/bundles/agent-building.yaml +26 -0
- package/kit/bundles/backend-data.yaml +14 -0
- package/kit/bundles/base.yaml +10 -0
- package/kit/bundles/core.yaml +21 -0
- package/kit/bundles/kit-engenharia.yaml +8 -0
- package/kit/bundles/kit-lite.yaml +9 -0
- package/kit/bundles/security.yaml +11 -0
- package/kit/bundles/ship-run.yaml +16 -0
- package/kit/bundles/web-ui.yaml +18 -0
- package/kit/commands/docs.md +33 -0
- package/kit/commands/explain.md +41 -0
- package/kit/commands/fix.md +65 -0
- package/kit/commands/implement.md +35 -0
- package/kit/commands/refactor.md +59 -0
- package/kit/commands/review.md +55 -0
- package/kit/commands/test.md +63 -0
- package/kit/modules/bridge/rules/cross-ide-bridge.mdc +73 -0
- package/kit/modules/bridge/zenkit-layer.yaml +1 -0
- package/kit/modules/nexuscore/sections/convivencia.md +12 -0
- package/kit/modules/nexuscore/sections/memoria.md +9 -0
- package/kit/modules/nexuscore/skills/quadro-agentes/SKILL.md +186 -0
- package/kit/modules/nexuscore/zenkit-layer.yaml +1 -0
- package/kit/rules/ZENKIT.mdc +294 -0
- package/kit/rules/git.mdc +51 -0
- package/kit/rules/karpathy-guidelines.mdc +70 -0
- package/kit/rules/model-routing.mdc +89 -0
- package/kit/rules/security-headers.mdc +41 -0
- package/kit/rules/social-automation.mdc +69 -0
- package/kit/rules/toc.mdc +40 -0
- package/kit/skills/api-patterns/SKILL.md +95 -0
- package/kit/skills/api-patterns/api-style.md +42 -0
- package/kit/skills/api-patterns/auth.md +24 -0
- package/kit/skills/api-patterns/documentation.md +26 -0
- package/kit/skills/api-patterns/graphql.md +41 -0
- package/kit/skills/api-patterns/rate-limiting.md +31 -0
- package/kit/skills/api-patterns/references/backend/backend-api-design.md +495 -0
- package/kit/skills/api-patterns/references/backend/backend-architecture.md +454 -0
- package/kit/skills/api-patterns/references/backend/backend-authentication.md +338 -0
- package/kit/skills/api-patterns/references/backend/backend-code-quality.md +659 -0
- package/kit/skills/api-patterns/references/backend/backend-debugging.md +904 -0
- package/kit/skills/api-patterns/references/backend/backend-devops.md +494 -0
- package/kit/skills/api-patterns/references/backend/backend-mindset.md +387 -0
- package/kit/skills/api-patterns/references/backend/backend-performance.md +397 -0
- package/kit/skills/api-patterns/references/backend/backend-security.md +290 -0
- package/kit/skills/api-patterns/references/backend/backend-technologies.md +256 -0
- package/kit/skills/api-patterns/references/backend/backend-testing.md +429 -0
- package/kit/skills/api-patterns/response.md +37 -0
- package/kit/skills/api-patterns/rest.md +40 -0
- package/kit/skills/api-patterns/scripts/api_validator.py +211 -0
- package/kit/skills/api-patterns/security-testing.md +122 -0
- package/kit/skills/api-patterns/trpc.md +41 -0
- package/kit/skills/api-patterns/versioning.md +22 -0
- package/kit/skills/app-builder/SKILL.md +76 -0
- package/kit/skills/app-builder/agent-coordination.md +71 -0
- package/kit/skills/app-builder/feature-building.md +53 -0
- package/kit/skills/app-builder/project-detection.md +34 -0
- package/kit/skills/app-builder/scaffolding.md +118 -0
- package/kit/skills/app-builder/tech-stack.md +41 -0
- package/kit/skills/app-builder/templates/SKILL.md +39 -0
- package/kit/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
- package/kit/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
- package/kit/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
- package/kit/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
- package/kit/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
- package/kit/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
- package/kit/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
- package/kit/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +122 -0
- package/kit/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +122 -0
- package/kit/skills/app-builder/templates/nextjs-static/TEMPLATE.md +169 -0
- package/kit/skills/app-builder/templates/nuxt-app/TEMPLATE.md +134 -0
- package/kit/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
- package/kit/skills/app-builder/templates/react-native-app/TEMPLATE.md +119 -0
- package/kit/skills/architecture/SKILL.md +56 -0
- package/kit/skills/architecture/context-discovery.md +43 -0
- package/kit/skills/architecture/examples.md +94 -0
- package/kit/skills/architecture/pattern-selection.md +68 -0
- package/kit/skills/architecture/patterns-reference.md +50 -0
- package/kit/skills/architecture/trade-off-analysis.md +77 -0
- package/kit/skills/bash-linux/SKILL.md +203 -0
- package/kit/skills/batch-operations/SKILL.md +112 -0
- package/kit/skills/behavioral-modes/SKILL.md +255 -0
- package/kit/skills/brainstorming/SKILL.md +189 -0
- package/kit/skills/brainstorming/dynamic-questioning.md +350 -0
- package/kit/skills/brainstorming/references/problem-solving/attribution.md +69 -0
- package/kit/skills/brainstorming/references/problem-solving/collision-zone-thinking.md +79 -0
- package/kit/skills/brainstorming/references/problem-solving/inversion-exercise.md +91 -0
- package/kit/skills/brainstorming/references/problem-solving/meta-pattern-recognition.md +87 -0
- package/kit/skills/brainstorming/references/problem-solving/scale-game.md +95 -0
- package/kit/skills/brainstorming/references/problem-solving/simplification-cascades.md +80 -0
- package/kit/skills/brainstorming/references/problem-solving/when-stuck.md +72 -0
- package/kit/skills/claude-exec/SKILL.md +185 -0
- package/kit/skills/clean-code/SKILL.md +210 -0
- package/kit/skills/code-review-checklist/SKILL.md +115 -0
- package/kit/skills/code-review-graph/SKILL.md +50 -0
- package/kit/skills/code-review-graph/references/alternatives-comparison.md +12 -0
- package/kit/skills/code-review-graph/references/best-practices.md +9 -0
- package/kit/skills/code-review-graph/references/configuration.md +43 -0
- package/kit/skills/code-review-graph/references/core-workflows.md +61 -0
- package/kit/skills/code-review-graph/references/how-it-works-4-layers.md +20 -0
- package/kit/skills/code-review-graph/references/installation.md +67 -0
- package/kit/skills/code-review-graph/references/integration-with-zenkit.md +23 -0
- package/kit/skills/code-review-graph/references/known-limitations.md +13 -0
- package/kit/skills/code-review-graph/references/when-to-use-vs-when-to-skip.md +21 -0
- package/kit/skills/codex-exec/SKILL.md +161 -0
- package/kit/skills/context-compression/SKILL.md +145 -0
- package/kit/skills/coordinator-mode/SKILL.md +215 -0
- package/kit/skills/cursor-exec/SKILL.md +152 -0
- package/kit/skills/database-design/SKILL.md +53 -0
- package/kit/skills/database-design/database-selection.md +43 -0
- package/kit/skills/database-design/indexing.md +39 -0
- package/kit/skills/database-design/migrations.md +48 -0
- package/kit/skills/database-design/optimization.md +36 -0
- package/kit/skills/database-design/orm-selection.md +30 -0
- package/kit/skills/database-design/schema-design.md +56 -0
- package/kit/skills/database-design/scripts/schema_validator.py +172 -0
- package/kit/skills/deployment-procedures/SKILL.md +242 -0
- package/kit/skills/deprecation-and-migration/SKILL.md +149 -0
- package/kit/skills/documentation-templates/SKILL.md +195 -0
- package/kit/skills/entrega-com-agentes/SKILL.md +177 -0
- package/kit/skills/frontend-design/NOTICE.md +6 -0
- package/kit/skills/frontend-design/SKILL.md +456 -0
- package/kit/skills/frontend-design/animation-guide.md +331 -0
- package/kit/skills/frontend-design/color-system.md +311 -0
- package/kit/skills/frontend-design/decision-trees.md +418 -0
- package/kit/skills/frontend-design/motion-graphics.md +306 -0
- package/kit/skills/frontend-design/references/aesthetic/design-guideline-template.md +163 -0
- package/kit/skills/frontend-design/references/aesthetic/design-principles.md +62 -0
- package/kit/skills/frontend-design/references/aesthetic/design-resources.md +75 -0
- package/kit/skills/frontend-design/references/aesthetic/design-story-template.md +135 -0
- package/kit/skills/frontend-design/references/aesthetic/micro-interactions.md +53 -0
- package/kit/skills/frontend-design/references/aesthetic/storytelling-design.md +50 -0
- package/kit/skills/frontend-design/scripts/accessibility_checker.py +183 -0
- package/kit/skills/frontend-design/scripts/ux_audit.py +722 -0
- package/kit/skills/frontend-design/typography-system.md +345 -0
- package/kit/skills/frontend-design/ux-psychology.md +1116 -0
- package/kit/skills/frontend-design/visual-effects.md +383 -0
- package/kit/skills/game-development/2d-games/SKILL.md +119 -0
- package/kit/skills/game-development/3d-games/SKILL.md +135 -0
- package/kit/skills/game-development/SKILL.md +168 -0
- package/kit/skills/game-development/game-art/SKILL.md +185 -0
- package/kit/skills/game-development/game-audio/SKILL.md +190 -0
- package/kit/skills/game-development/game-design/SKILL.md +129 -0
- package/kit/skills/game-development/mobile-games/SKILL.md +108 -0
- package/kit/skills/game-development/multiplayer/SKILL.md +132 -0
- package/kit/skills/game-development/pc-games/SKILL.md +144 -0
- package/kit/skills/game-development/vr-ar/SKILL.md +123 -0
- package/kit/skills/game-development/web-games/SKILL.md +150 -0
- package/kit/skills/gemini-exec/SKILL.md +80 -0
- package/kit/skills/geo-fundamentals/SKILL.md +157 -0
- package/kit/skills/geo-fundamentals/scripts/geo_checker.py +289 -0
- package/kit/skills/git-worktrees/SKILL.md +107 -0
- package/kit/skills/i18n-localization/SKILL.md +145 -0
- package/kit/skills/i18n-localization/scripts/i18n_checker.py +241 -0
- package/kit/skills/intelligent-routing/SKILL.md +128 -0
- package/kit/skills/intelligent-routing/references/4-response-format.md +16 -0
- package/kit/skills/intelligent-routing/references/complexity-assessment.md +29 -0
- package/kit/skills/intelligent-routing/references/debug-intelligent-routing.md +9 -0
- package/kit/skills/intelligent-routing/references/debugging-agent-selection.md +7 -0
- package/kit/skills/intelligent-routing/references/domain-detection-rules.md +29 -0
- package/kit/skills/intelligent-routing/references/edge-cases.md +29 -0
- package/kit/skills/intelligent-routing/references/implementation-rules.md +35 -0
- package/kit/skills/intelligent-routing/references/integration-with-existing-workflows.md +21 -0
- package/kit/skills/intelligent-routing/references/performance-considerations.md +14 -0
- package/kit/skills/intelligent-routing/references/summary.md +16 -0
- package/kit/skills/intelligent-routing/references/testing-the-system.md +36 -0
- package/kit/skills/intelligent-routing/references/tier-0-automatic-analysis-always-active.md +27 -0
- package/kit/skills/intelligent-routing/references/user-education.md +12 -0
- package/kit/skills/karpathy-guidelines/SKILL.md +67 -0
- package/kit/skills/karpathy-guidelines/references/EXAMPLES.md +522 -0
- package/kit/skills/lint-and-validate/SKILL.md +46 -0
- package/kit/skills/lint-and-validate/scripts/lint_runner.py +184 -0
- package/kit/skills/lint-and-validate/scripts/type_coverage.py +173 -0
- package/kit/skills/mcp-atuacao/SKILL.md +238 -0
- package/kit/skills/mcp-builder/NOTICE.md +6 -0
- package/kit/skills/mcp-builder/SKILL.md +259 -0
- package/kit/skills/memory-system/SKILL.md +181 -0
- package/kit/skills/mobile-design/SKILL.md +395 -0
- package/kit/skills/mobile-design/decision-trees.md +516 -0
- package/kit/skills/mobile-design/mobile-backend.md +491 -0
- package/kit/skills/mobile-design/mobile-color-system.md +420 -0
- package/kit/skills/mobile-design/mobile-debugging.md +122 -0
- package/kit/skills/mobile-design/mobile-design-thinking.md +357 -0
- package/kit/skills/mobile-design/mobile-navigation.md +458 -0
- package/kit/skills/mobile-design/mobile-performance.md +767 -0
- package/kit/skills/mobile-design/mobile-testing.md +356 -0
- package/kit/skills/mobile-design/mobile-typography.md +433 -0
- package/kit/skills/mobile-design/platform-android.md +666 -0
- package/kit/skills/mobile-design/platform-ios.md +561 -0
- package/kit/skills/mobile-design/scripts/mobile_audit.py +670 -0
- package/kit/skills/mobile-design/touch-psychology.md +537 -0
- package/kit/skills/negocio-agente-conversa/SKILL.md +168 -0
- package/kit/skills/negocio-atendimento/SKILL.md +134 -0
- package/kit/skills/negocio-linguagem/SKILL.md +166 -0
- package/kit/skills/negocio-preco/SKILL.md +174 -0
- package/kit/skills/negocio-preco/scripts/preco.mjs +160 -0
- package/kit/skills/negocio-qualificacao/SKILL.md +140 -0
- package/kit/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +351 -0
- package/kit/skills/nextjs-react-expert/2-bundle-bundle-size-optimization.md +240 -0
- package/kit/skills/nextjs-react-expert/3-server-server-side-performance.md +490 -0
- package/kit/skills/nextjs-react-expert/4-client-client-side-data-fetching.md +264 -0
- package/kit/skills/nextjs-react-expert/5-rerender-re-render-optimization.md +581 -0
- package/kit/skills/nextjs-react-expert/6-rendering-rendering-performance.md +432 -0
- package/kit/skills/nextjs-react-expert/7-js-javascript-performance.md +684 -0
- package/kit/skills/nextjs-react-expert/8-advanced-advanced-patterns.md +150 -0
- package/kit/skills/nextjs-react-expert/9-cache-components.md +103 -0
- package/kit/skills/nextjs-react-expert/SKILL.md +308 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/common-patterns.md +331 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/complete-examples.md +872 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/component-patterns.md +502 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/data-fetching.md +767 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/file-organization.md +502 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/loading-and-error-states.md +501 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/performance.md +406 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/routing-guide.md +364 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/styling-guide.md +428 -0
- package/kit/skills/nextjs-react-expert/resources/app-patterns/typescript-standards.md +418 -0
- package/kit/skills/nextjs-react-expert/scripts/convert_rules.py +222 -0
- package/kit/skills/nextjs-react-expert/scripts/react_performance_checker.py +252 -0
- package/kit/skills/nodejs-best-practices/SKILL.md +78 -0
- package/kit/skills/nodejs-best-practices/references/10-anti-patterns-to-avoid.md +21 -0
- package/kit/skills/nodejs-best-practices/references/11-decision-checklist.md +14 -0
- package/kit/skills/nodejs-best-practices/references/2-runtime-considerations-2025.md +36 -0
- package/kit/skills/nodejs-best-practices/references/3-architecture-principles.md +35 -0
- package/kit/skills/nodejs-best-practices/references/4-error-handling-principles.md +42 -0
- package/kit/skills/nodejs-best-practices/references/5-async-patterns-principles.md +35 -0
- package/kit/skills/nodejs-best-practices/references/6-validation-principles.md +29 -0
- package/kit/skills/nodejs-best-practices/references/7-security-principles.md +29 -0
- package/kit/skills/nodejs-best-practices/references/8-testing-principles.md +28 -0
- package/kit/skills/observability-and-instrumentation/SKILL.md +150 -0
- package/kit/skills/opencode-go-exec/SKILL.md +101 -0
- package/kit/skills/parallel-agents/SKILL.md +184 -0
- package/kit/skills/performance-profiling/SKILL.md +145 -0
- package/kit/skills/performance-profiling/scripts/lighthouse_audit.py +76 -0
- package/kit/skills/plan-writing/SKILL.md +213 -0
- package/kit/skills/powershell-windows/SKILL.md +196 -0
- package/kit/skills/provider-orchestration/SKILL.md +269 -0
- package/kit/skills/python-patterns/SKILL.md +80 -0
- package/kit/skills/python-patterns/references/10-decision-checklist.md +14 -0
- package/kit/skills/python-patterns/references/11-anti-patterns-to-avoid.md +20 -0
- package/kit/skills/python-patterns/references/2-async-vs-sync-decision.md +44 -0
- package/kit/skills/python-patterns/references/3-type-hints-strategy.md +56 -0
- package/kit/skills/python-patterns/references/4-project-structure-principles.md +56 -0
- package/kit/skills/python-patterns/references/5-django-principles-2025.md +40 -0
- package/kit/skills/python-patterns/references/6-fastapi-principles.md +50 -0
- package/kit/skills/python-patterns/references/7-background-tasks.md +31 -0
- package/kit/skills/python-patterns/references/8-error-handling-principles.md +29 -0
- package/kit/skills/python-patterns/references/9-testing-principles.md +37 -0
- package/kit/skills/red-team-tactics/SKILL.md +201 -0
- package/kit/skills/research/SKILL.md +166 -0
- package/kit/skills/rust-pro/SKILL.md +177 -0
- package/kit/skills/seo-fundamentals/SKILL.md +130 -0
- package/kit/skills/seo-fundamentals/scripts/seo_checker.py +219 -0
- package/kit/skills/sequential-thinking/.env.example +8 -0
- package/kit/skills/sequential-thinking/README.md +183 -0
- package/kit/skills/sequential-thinking/SKILL.md +95 -0
- package/kit/skills/sequential-thinking/package.json +31 -0
- package/kit/skills/sequential-thinking/references/advanced-strategies.md +79 -0
- package/kit/skills/sequential-thinking/references/advanced-techniques.md +76 -0
- package/kit/skills/sequential-thinking/references/core-patterns.md +95 -0
- package/kit/skills/sequential-thinking/references/examples-api.md +88 -0
- package/kit/skills/sequential-thinking/references/examples-architecture.md +94 -0
- package/kit/skills/sequential-thinking/references/examples-debug.md +90 -0
- package/kit/skills/sequential-thinking/scripts/format-thought.js +159 -0
- package/kit/skills/sequential-thinking/scripts/process-thought.js +236 -0
- package/kit/skills/server-management/SKILL.md +162 -0
- package/kit/skills/simplify-code/SKILL.md +133 -0
- package/kit/skills/skillify/SKILL.md +116 -0
- package/kit/skills/system-design-interview/SKILL.md +268 -0
- package/kit/skills/systematic-debugging/SKILL.md +110 -0
- package/kit/skills/tailwind-patterns/SKILL.md +283 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/canvas-design-system.md +320 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-accessibility.md +471 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-components.md +424 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-theming.md +373 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-customization.md +483 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-responsive.md +382 -0
- package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-utilities.md +455 -0
- package/kit/skills/tdd-workflow/SKILL.md +150 -0
- package/kit/skills/testing-patterns/SKILL.md +196 -0
- package/kit/skills/testing-patterns/scripts/test_runner.py +219 -0
- package/kit/skills/ui-ux-pro-max/SKILL.md +135 -0
- package/kit/skills/verify-changes/SKILL.md +125 -0
- package/kit/skills/vulnerability-scanner/SKILL.md +278 -0
- package/kit/skills/vulnerability-scanner/checklists.md +121 -0
- package/kit/skills/vulnerability-scanner/scripts/security_scan.py +458 -0
- package/kit/skills/web-design-guidelines/SKILL.md +58 -0
- package/kit/skills/webapp-testing/NOTICE.md +6 -0
- package/kit/skills/webapp-testing/SKILL.md +188 -0
- package/kit/skills/webapp-testing/scripts/playwright_runner.py +173 -0
- package/kit/workflows/brainstorm.md +113 -0
- package/kit/workflows/coordinate.md +72 -0
- package/kit/workflows/create.md +59 -0
- package/kit/workflows/debug.md +103 -0
- package/kit/workflows/deploy.md +176 -0
- package/kit/workflows/enhance.md +63 -0
- package/kit/workflows/orchestrate.md +237 -0
- package/kit/workflows/plan.md +89 -0
- package/kit/workflows/preview.md +81 -0
- package/kit/workflows/remember.md +67 -0
- package/kit/workflows/status.md +86 -0
- package/kit/workflows/test.md +144 -0
- package/kit/workflows/ui-ux-pro-max.md +296 -0
- package/kit/workflows/verify.md +72 -0
- package/licenses/Apache-2.0.txt +202 -0
- package/package.json +60 -6
- package/scripts/archive-codex-rollouts.ps1 +35 -0
- package/scripts/avaliar-vigilancia-mandato.mjs +38 -0
- package/scripts/bundle.mjs +170 -0
- package/scripts/check-deps.mjs +178 -0
- package/scripts/check-models.mjs +150 -0
- package/scripts/cli.mjs +313 -0
- package/scripts/content-checks.mjs +18 -0
- package/scripts/continuidade-mandato.mjs +47 -0
- package/scripts/discriminar-turno.mjs +191 -0
- package/scripts/doctor.mjs +611 -0
- package/scripts/generate.mjs +688 -0
- package/scripts/install.mjs +11 -0
- package/scripts/layer-remote.mjs +407 -0
- package/scripts/layers.mjs +208 -0
- package/scripts/marketplace.mjs +77 -0
- package/scripts/product.mjs +32 -0
- package/scripts/ruleset-core.mjs +68 -0
- package/scripts/social-hooks.mjs +293 -0
- package/scripts/social-pacer.mjs +219 -0
- package/scripts/validate-bundles.mjs +14 -0
- package/scripts/validate-skills.mjs +174 -0
- package/scripts/zenkit-daemon-task.cmd +3 -0
|
@@ -0,0 +1,455 @@
|
|
|
1
|
+
# Tailwind CSS Utility Reference
|
|
2
|
+
|
|
3
|
+
Core utility classes for layout, spacing, typography, colors, borders, and shadows.
|
|
4
|
+
|
|
5
|
+
## Layout Utilities
|
|
6
|
+
|
|
7
|
+
### Display
|
|
8
|
+
|
|
9
|
+
```html
|
|
10
|
+
<div class="block">Block</div>
|
|
11
|
+
<div class="inline-block">Inline Block</div>
|
|
12
|
+
<div class="inline">Inline</div>
|
|
13
|
+
<div class="flex">Flexbox</div>
|
|
14
|
+
<div class="inline-flex">Inline Flex</div>
|
|
15
|
+
<div class="grid">Grid</div>
|
|
16
|
+
<div class="inline-grid">Inline Grid</div>
|
|
17
|
+
<div class="hidden">Hidden</div>
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
### Flexbox
|
|
21
|
+
|
|
22
|
+
**Container:**
|
|
23
|
+
```html
|
|
24
|
+
<div class="flex flex-row">Row (default)</div>
|
|
25
|
+
<div class="flex flex-col">Column</div>
|
|
26
|
+
<div class="flex flex-row-reverse">Reverse row</div>
|
|
27
|
+
<div class="flex flex-col-reverse">Reverse column</div>
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
**Justify (main axis):**
|
|
31
|
+
```html
|
|
32
|
+
<div class="flex justify-start">Start</div>
|
|
33
|
+
<div class="flex justify-center">Center</div>
|
|
34
|
+
<div class="flex justify-end">End</div>
|
|
35
|
+
<div class="flex justify-between">Space between</div>
|
|
36
|
+
<div class="flex justify-around">Space around</div>
|
|
37
|
+
<div class="flex justify-evenly">Space evenly</div>
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
**Align (cross axis):**
|
|
41
|
+
```html
|
|
42
|
+
<div class="flex items-start">Start</div>
|
|
43
|
+
<div class="flex items-center">Center</div>
|
|
44
|
+
<div class="flex items-end">End</div>
|
|
45
|
+
<div class="flex items-baseline">Baseline</div>
|
|
46
|
+
<div class="flex items-stretch">Stretch</div>
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
**Gap:**
|
|
50
|
+
```html
|
|
51
|
+
<div class="flex gap-4">All sides</div>
|
|
52
|
+
<div class="flex gap-x-6 gap-y-2">X and Y</div>
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
**Wrap:**
|
|
56
|
+
```html
|
|
57
|
+
<div class="flex flex-wrap">Wrap</div>
|
|
58
|
+
<div class="flex flex-nowrap">No wrap</div>
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### Grid
|
|
62
|
+
|
|
63
|
+
**Columns:**
|
|
64
|
+
```html
|
|
65
|
+
<div class="grid grid-cols-1">1 column</div>
|
|
66
|
+
<div class="grid grid-cols-2">2 columns</div>
|
|
67
|
+
<div class="grid grid-cols-3">3 columns</div>
|
|
68
|
+
<div class="grid grid-cols-4">4 columns</div>
|
|
69
|
+
<div class="grid grid-cols-12">12 columns</div>
|
|
70
|
+
<div class="grid grid-cols-[1fr_500px_2fr]">Custom</div>
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
**Rows:**
|
|
74
|
+
```html
|
|
75
|
+
<div class="grid grid-rows-3">3 rows</div>
|
|
76
|
+
<div class="grid grid-rows-[auto_1fr_auto]">Custom</div>
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
**Span:**
|
|
80
|
+
```html
|
|
81
|
+
<div class="col-span-2">Span 2 columns</div>
|
|
82
|
+
<div class="row-span-3">Span 3 rows</div>
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
**Gap:**
|
|
86
|
+
```html
|
|
87
|
+
<div class="grid gap-4">All sides</div>
|
|
88
|
+
<div class="grid gap-x-8 gap-y-4">X and Y</div>
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
### Positioning
|
|
92
|
+
|
|
93
|
+
```html
|
|
94
|
+
<div class="static">Static (default)</div>
|
|
95
|
+
<div class="relative">Relative</div>
|
|
96
|
+
<div class="absolute">Absolute</div>
|
|
97
|
+
<div class="fixed">Fixed</div>
|
|
98
|
+
<div class="sticky">Sticky</div>
|
|
99
|
+
|
|
100
|
+
<!-- Position values -->
|
|
101
|
+
<div class="absolute top-0 right-0">Top right</div>
|
|
102
|
+
<div class="absolute inset-0">All sides 0</div>
|
|
103
|
+
<div class="absolute inset-x-4">Left/right 4</div>
|
|
104
|
+
<div class="absolute inset-y-8">Top/bottom 8</div>
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
### Z-Index
|
|
108
|
+
|
|
109
|
+
```html
|
|
110
|
+
<div class="z-0">z-index: 0</div>
|
|
111
|
+
<div class="z-10">z-index: 10</div>
|
|
112
|
+
<div class="z-20">z-index: 20</div>
|
|
113
|
+
<div class="z-50">z-index: 50</div>
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
## Spacing Utilities
|
|
117
|
+
|
|
118
|
+
### Padding
|
|
119
|
+
|
|
120
|
+
```html
|
|
121
|
+
<div class="p-4">All sides</div>
|
|
122
|
+
<div class="px-6">Left and right</div>
|
|
123
|
+
<div class="py-3">Top and bottom</div>
|
|
124
|
+
<div class="pt-8">Top</div>
|
|
125
|
+
<div class="pr-4">Right</div>
|
|
126
|
+
<div class="pb-2">Bottom</div>
|
|
127
|
+
<div class="pl-6">Left</div>
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
### Margin
|
|
131
|
+
|
|
132
|
+
```html
|
|
133
|
+
<div class="m-4">All sides</div>
|
|
134
|
+
<div class="mx-auto">Center horizontally</div>
|
|
135
|
+
<div class="my-6">Top and bottom</div>
|
|
136
|
+
<div class="mt-8">Top</div>
|
|
137
|
+
<div class="-mt-4">Negative top</div>
|
|
138
|
+
<div class="ml-auto">Push to right</div>
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
### Space Between
|
|
142
|
+
|
|
143
|
+
```html
|
|
144
|
+
<div class="space-x-4">Horizontal spacing</div>
|
|
145
|
+
<div class="space-y-6">Vertical spacing</div>
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
### Spacing Scale
|
|
149
|
+
|
|
150
|
+
- `0`: 0px
|
|
151
|
+
- `px`: 1px
|
|
152
|
+
- `0.5`: 0.125rem (2px)
|
|
153
|
+
- `1`: 0.25rem (4px)
|
|
154
|
+
- `2`: 0.5rem (8px)
|
|
155
|
+
- `3`: 0.75rem (12px)
|
|
156
|
+
- `4`: 1rem (16px)
|
|
157
|
+
- `6`: 1.5rem (24px)
|
|
158
|
+
- `8`: 2rem (32px)
|
|
159
|
+
- `12`: 3rem (48px)
|
|
160
|
+
- `16`: 4rem (64px)
|
|
161
|
+
- `24`: 6rem (96px)
|
|
162
|
+
|
|
163
|
+
## Typography
|
|
164
|
+
|
|
165
|
+
### Font Size
|
|
166
|
+
|
|
167
|
+
```html
|
|
168
|
+
<p class="text-xs">Extra small (12px)</p>
|
|
169
|
+
<p class="text-sm">Small (14px)</p>
|
|
170
|
+
<p class="text-base">Base (16px)</p>
|
|
171
|
+
<p class="text-lg">Large (18px)</p>
|
|
172
|
+
<p class="text-xl">XL (20px)</p>
|
|
173
|
+
<p class="text-2xl">2XL (24px)</p>
|
|
174
|
+
<p class="text-3xl">3XL (30px)</p>
|
|
175
|
+
<p class="text-4xl">4XL (36px)</p>
|
|
176
|
+
<p class="text-5xl">5XL (48px)</p>
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
### Font Weight
|
|
180
|
+
|
|
181
|
+
```html
|
|
182
|
+
<p class="font-thin">Thin (100)</p>
|
|
183
|
+
<p class="font-light">Light (300)</p>
|
|
184
|
+
<p class="font-normal">Normal (400)</p>
|
|
185
|
+
<p class="font-medium">Medium (500)</p>
|
|
186
|
+
<p class="font-semibold">Semibold (600)</p>
|
|
187
|
+
<p class="font-bold">Bold (700)</p>
|
|
188
|
+
<p class="font-black">Black (900)</p>
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
### Text Alignment
|
|
192
|
+
|
|
193
|
+
```html
|
|
194
|
+
<p class="text-left">Left</p>
|
|
195
|
+
<p class="text-center">Center</p>
|
|
196
|
+
<p class="text-right">Right</p>
|
|
197
|
+
<p class="text-justify">Justify</p>
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
### Line Height
|
|
201
|
+
|
|
202
|
+
```html
|
|
203
|
+
<p class="leading-none">1</p>
|
|
204
|
+
<p class="leading-tight">1.25</p>
|
|
205
|
+
<p class="leading-normal">1.5</p>
|
|
206
|
+
<p class="leading-relaxed">1.75</p>
|
|
207
|
+
<p class="leading-loose">2</p>
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
### Combined Font Utilities
|
|
211
|
+
|
|
212
|
+
```html
|
|
213
|
+
<h1 class="text-4xl/tight font-bold">
|
|
214
|
+
Font size 4xl with tight line height
|
|
215
|
+
</h1>
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
### Text Transform
|
|
219
|
+
|
|
220
|
+
```html
|
|
221
|
+
<p class="uppercase">UPPERCASE</p>
|
|
222
|
+
<p class="lowercase">lowercase</p>
|
|
223
|
+
<p class="capitalize">Capitalize</p>
|
|
224
|
+
<p class="normal-case">Normal</p>
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
### Text Decoration
|
|
228
|
+
|
|
229
|
+
```html
|
|
230
|
+
<p class="underline">Underline</p>
|
|
231
|
+
<p class="line-through">Line through</p>
|
|
232
|
+
<p class="no-underline">No underline</p>
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
### Text Overflow
|
|
236
|
+
|
|
237
|
+
```html
|
|
238
|
+
<p class="truncate">Truncate with ellipsis...</p>
|
|
239
|
+
<p class="line-clamp-3">Clamp to 3 lines...</p>
|
|
240
|
+
<p class="text-ellipsis overflow-hidden">Ellipsis</p>
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
## Colors
|
|
244
|
+
|
|
245
|
+
### Text Colors
|
|
246
|
+
|
|
247
|
+
```html
|
|
248
|
+
<p class="text-black">Black</p>
|
|
249
|
+
<p class="text-white">White</p>
|
|
250
|
+
<p class="text-gray-500">Gray 500</p>
|
|
251
|
+
<p class="text-red-600">Red 600</p>
|
|
252
|
+
<p class="text-blue-500">Blue 500</p>
|
|
253
|
+
<p class="text-green-600">Green 600</p>
|
|
254
|
+
```
|
|
255
|
+
|
|
256
|
+
### Background Colors
|
|
257
|
+
|
|
258
|
+
```html
|
|
259
|
+
<div class="bg-white">White</div>
|
|
260
|
+
<div class="bg-gray-100">Gray 100</div>
|
|
261
|
+
<div class="bg-blue-500">Blue 500</div>
|
|
262
|
+
<div class="bg-red-600">Red 600</div>
|
|
263
|
+
```
|
|
264
|
+
|
|
265
|
+
### Color Scale
|
|
266
|
+
|
|
267
|
+
Each color has 11 shades (50-950):
|
|
268
|
+
- `50`: Lightest
|
|
269
|
+
- `100-400`: Light variations
|
|
270
|
+
- `500`: Base color
|
|
271
|
+
- `600-800`: Dark variations
|
|
272
|
+
- `950`: Darkest
|
|
273
|
+
|
|
274
|
+
### Opacity Modifiers
|
|
275
|
+
|
|
276
|
+
```html
|
|
277
|
+
<div class="bg-black/75">75% opacity</div>
|
|
278
|
+
<div class="text-blue-500/30">30% opacity</div>
|
|
279
|
+
<div class="bg-purple-500/[0.87]">87% opacity</div>
|
|
280
|
+
```
|
|
281
|
+
|
|
282
|
+
### Gradients
|
|
283
|
+
|
|
284
|
+
```html
|
|
285
|
+
<div class="bg-gradient-to-r from-blue-500 to-purple-600">
|
|
286
|
+
Left to right gradient
|
|
287
|
+
</div>
|
|
288
|
+
<div class="bg-gradient-to-br from-pink-500 via-red-500 to-yellow-500">
|
|
289
|
+
With via color
|
|
290
|
+
</div>
|
|
291
|
+
```
|
|
292
|
+
|
|
293
|
+
Directions: `to-t | to-tr | to-r | to-br | to-b | to-bl | to-l | to-tl`
|
|
294
|
+
|
|
295
|
+
## Borders
|
|
296
|
+
|
|
297
|
+
### Border Width
|
|
298
|
+
|
|
299
|
+
```html
|
|
300
|
+
<div class="border">1px all sides</div>
|
|
301
|
+
<div class="border-2">2px all sides</div>
|
|
302
|
+
<div class="border-t">Top only</div>
|
|
303
|
+
<div class="border-r-4">Right 4px</div>
|
|
304
|
+
<div class="border-b-2">Bottom 2px</div>
|
|
305
|
+
<div class="border-l">Left only</div>
|
|
306
|
+
<div class="border-0">No border</div>
|
|
307
|
+
```
|
|
308
|
+
|
|
309
|
+
### Border Color
|
|
310
|
+
|
|
311
|
+
```html
|
|
312
|
+
<div class="border border-gray-300">Gray</div>
|
|
313
|
+
<div class="border-2 border-blue-500">Blue</div>
|
|
314
|
+
<div class="border border-red-600/50">Red with opacity</div>
|
|
315
|
+
```
|
|
316
|
+
|
|
317
|
+
### Border Radius
|
|
318
|
+
|
|
319
|
+
```html
|
|
320
|
+
<div class="rounded">0.25rem</div>
|
|
321
|
+
<div class="rounded-md">0.375rem</div>
|
|
322
|
+
<div class="rounded-lg">0.5rem</div>
|
|
323
|
+
<div class="rounded-xl">0.75rem</div>
|
|
324
|
+
<div class="rounded-2xl">1rem</div>
|
|
325
|
+
<div class="rounded-full">9999px</div>
|
|
326
|
+
|
|
327
|
+
<!-- Individual corners -->
|
|
328
|
+
<div class="rounded-t-lg">Top corners</div>
|
|
329
|
+
<div class="rounded-br-xl">Bottom right</div>
|
|
330
|
+
```
|
|
331
|
+
|
|
332
|
+
### Border Style
|
|
333
|
+
|
|
334
|
+
```html
|
|
335
|
+
<div class="border border-solid">Solid</div>
|
|
336
|
+
<div class="border-2 border-dashed">Dashed</div>
|
|
337
|
+
<div class="border border-dotted">Dotted</div>
|
|
338
|
+
```
|
|
339
|
+
|
|
340
|
+
## Shadows
|
|
341
|
+
|
|
342
|
+
```html
|
|
343
|
+
<div class="shadow-sm">Small</div>
|
|
344
|
+
<div class="shadow">Default</div>
|
|
345
|
+
<div class="shadow-md">Medium</div>
|
|
346
|
+
<div class="shadow-lg">Large</div>
|
|
347
|
+
<div class="shadow-xl">Extra large</div>
|
|
348
|
+
<div class="shadow-2xl">2XL</div>
|
|
349
|
+
<div class="shadow-none">No shadow</div>
|
|
350
|
+
```
|
|
351
|
+
|
|
352
|
+
### Colored Shadows
|
|
353
|
+
|
|
354
|
+
```html
|
|
355
|
+
<div class="shadow-lg shadow-blue-500/50">Blue shadow</div>
|
|
356
|
+
```
|
|
357
|
+
|
|
358
|
+
## Width & Height
|
|
359
|
+
|
|
360
|
+
### Width
|
|
361
|
+
|
|
362
|
+
```html
|
|
363
|
+
<div class="w-full">100%</div>
|
|
364
|
+
<div class="w-1/2">50%</div>
|
|
365
|
+
<div class="w-1/3">33.333%</div>
|
|
366
|
+
<div class="w-64">16rem</div>
|
|
367
|
+
<div class="w-[500px]">500px</div>
|
|
368
|
+
<div class="w-screen">100vw</div>
|
|
369
|
+
|
|
370
|
+
<!-- Min/Max width -->
|
|
371
|
+
<div class="min-w-0">min-width: 0</div>
|
|
372
|
+
<div class="max-w-md">max-width: 28rem</div>
|
|
373
|
+
<div class="max-w-screen-xl">max-width: 1280px</div>
|
|
374
|
+
```
|
|
375
|
+
|
|
376
|
+
### Height
|
|
377
|
+
|
|
378
|
+
```html
|
|
379
|
+
<div class="h-full">100%</div>
|
|
380
|
+
<div class="h-screen">100vh</div>
|
|
381
|
+
<div class="h-64">16rem</div>
|
|
382
|
+
<div class="h-[500px]">500px</div>
|
|
383
|
+
|
|
384
|
+
<!-- Min/Max height -->
|
|
385
|
+
<div class="min-h-screen">min-height: 100vh</div>
|
|
386
|
+
<div class="max-h-96">max-height: 24rem</div>
|
|
387
|
+
```
|
|
388
|
+
|
|
389
|
+
## Arbitrary Values
|
|
390
|
+
|
|
391
|
+
Use square brackets for custom values:
|
|
392
|
+
|
|
393
|
+
```html
|
|
394
|
+
<!-- Spacing -->
|
|
395
|
+
<div class="p-[17px]">Custom padding</div>
|
|
396
|
+
<div class="top-[117px]">Custom position</div>
|
|
397
|
+
|
|
398
|
+
<!-- Colors -->
|
|
399
|
+
<div class="bg-[#bada55]">Hex color</div>
|
|
400
|
+
<div class="text-[rgb(123,45,67)]">RGB</div>
|
|
401
|
+
|
|
402
|
+
<!-- Sizes -->
|
|
403
|
+
<div class="w-[500px]">Custom width</div>
|
|
404
|
+
<div class="text-[22px]">Custom font size</div>
|
|
405
|
+
|
|
406
|
+
<!-- CSS variables -->
|
|
407
|
+
<div class="bg-[var(--brand-color)]">CSS var</div>
|
|
408
|
+
|
|
409
|
+
<!-- Complex values -->
|
|
410
|
+
<div class="grid-cols-[1fr_500px_2fr]">Custom grid</div>
|
|
411
|
+
```
|
|
412
|
+
|
|
413
|
+
## Aspect Ratio
|
|
414
|
+
|
|
415
|
+
```html
|
|
416
|
+
<div class="aspect-square">1:1</div>
|
|
417
|
+
<div class="aspect-video">16:9</div>
|
|
418
|
+
<div class="aspect-[4/3]">4:3</div>
|
|
419
|
+
```
|
|
420
|
+
|
|
421
|
+
## Overflow
|
|
422
|
+
|
|
423
|
+
```html
|
|
424
|
+
<div class="overflow-auto">Auto scroll</div>
|
|
425
|
+
<div class="overflow-hidden">Hidden</div>
|
|
426
|
+
<div class="overflow-scroll">Always scroll</div>
|
|
427
|
+
<div class="overflow-x-auto">Horizontal scroll</div>
|
|
428
|
+
<div class="overflow-y-hidden">No vertical scroll</div>
|
|
429
|
+
```
|
|
430
|
+
|
|
431
|
+
## Opacity
|
|
432
|
+
|
|
433
|
+
```html
|
|
434
|
+
<div class="opacity-0">0%</div>
|
|
435
|
+
<div class="opacity-50">50%</div>
|
|
436
|
+
<div class="opacity-75">75%</div>
|
|
437
|
+
<div class="opacity-100">100%</div>
|
|
438
|
+
```
|
|
439
|
+
|
|
440
|
+
## Cursor
|
|
441
|
+
|
|
442
|
+
```html
|
|
443
|
+
<div class="cursor-pointer">Pointer</div>
|
|
444
|
+
<div class="cursor-wait">Wait</div>
|
|
445
|
+
<div class="cursor-not-allowed">Not allowed</div>
|
|
446
|
+
<div class="cursor-default">Default</div>
|
|
447
|
+
```
|
|
448
|
+
|
|
449
|
+
## User Select
|
|
450
|
+
|
|
451
|
+
```html
|
|
452
|
+
<div class="select-none">No select</div>
|
|
453
|
+
<div class="select-text">Text selectable</div>
|
|
454
|
+
<div class="select-all">Select all</div>
|
|
455
|
+
```
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: tdd-workflow
|
|
3
|
+
description: Test-Driven Development workflow principles. RED-GREEN-REFACTOR cycle.
|
|
4
|
+
when_to_use: "When practicing Test-Driven Development, following RED-GREEN-REFACTOR cycle, or writing tests before implementation."
|
|
5
|
+
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# TDD Workflow
|
|
9
|
+
|
|
10
|
+
> Write tests first, code second.
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## 1. The TDD Cycle
|
|
15
|
+
|
|
16
|
+
```
|
|
17
|
+
🔴 RED → Write failing test
|
|
18
|
+
↓
|
|
19
|
+
🟢 GREEN → Write minimal code to pass
|
|
20
|
+
↓
|
|
21
|
+
🔵 REFACTOR → Improve code quality
|
|
22
|
+
↓
|
|
23
|
+
Repeat...
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## 2. The Three Laws of TDD
|
|
29
|
+
|
|
30
|
+
1. Write production code only to make a failing test pass
|
|
31
|
+
2. Write only enough test to demonstrate failure
|
|
32
|
+
3. Write only enough code to make the test pass
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## 3. RED Phase Principles
|
|
37
|
+
|
|
38
|
+
### What to Write
|
|
39
|
+
|
|
40
|
+
| Focus | Example |
|
|
41
|
+
|-------|---------|
|
|
42
|
+
| Behavior | "should add two numbers" |
|
|
43
|
+
| Edge cases | "should handle empty input" |
|
|
44
|
+
| Error states | "should throw for invalid data" |
|
|
45
|
+
|
|
46
|
+
### RED Phase Rules
|
|
47
|
+
|
|
48
|
+
- Test must fail first for the expected reason (assert failure, not syntax/import crash)
|
|
49
|
+
- Test name describes expected behavior
|
|
50
|
+
- Assert single invariant or atomic outcome (inspect multiple fields of the same result when needed)
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## 4. GREEN Phase Principles
|
|
55
|
+
|
|
56
|
+
### Minimum Code
|
|
57
|
+
|
|
58
|
+
| Principle | Meaning |
|
|
59
|
+
|-----------|---------|
|
|
60
|
+
| **YAGNI** | You Aren't Gonna Need It |
|
|
61
|
+
| **Simplest thing** | Write the minimum to pass |
|
|
62
|
+
| **No optimization** | Just make it work |
|
|
63
|
+
|
|
64
|
+
### GREEN Phase Rules
|
|
65
|
+
|
|
66
|
+
- Don't write unneeded code
|
|
67
|
+
- Don't optimize yet
|
|
68
|
+
- Pass the test, nothing more
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## 5. REFACTOR Phase Principles
|
|
73
|
+
|
|
74
|
+
### What to Improve
|
|
75
|
+
|
|
76
|
+
| Area | Action |
|
|
77
|
+
|------|--------|
|
|
78
|
+
| Duplication | Extract common code |
|
|
79
|
+
| Naming | Make intent clear |
|
|
80
|
+
| Structure | Improve organization |
|
|
81
|
+
| Complexity | Simplify logic |
|
|
82
|
+
|
|
83
|
+
### REFACTOR Rules
|
|
84
|
+
|
|
85
|
+
- All tests must stay green
|
|
86
|
+
- Small incremental changes
|
|
87
|
+
- Commit atomic, tested units (avoid noisy micro-commits on intermediate red/green steps)
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## 6. AAA Pattern
|
|
92
|
+
|
|
93
|
+
Every test follows:
|
|
94
|
+
|
|
95
|
+
| Step | Purpose |
|
|
96
|
+
|------|---------|
|
|
97
|
+
| **Arrange** | Set up test data |
|
|
98
|
+
| **Act** | Execute code under test |
|
|
99
|
+
| **Assert** | Verify expected outcome |
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## 7. When to Use TDD
|
|
104
|
+
|
|
105
|
+
| Scenario | TDD Value |
|
|
106
|
+
|----------|-----------|
|
|
107
|
+
| New feature | High |
|
|
108
|
+
| Bug fix | High (write test first) |
|
|
109
|
+
| Complex logic | High |
|
|
110
|
+
| Exploratory | Low (spike, then TDD) |
|
|
111
|
+
| UI layout | Low |
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
## 8. Test Prioritization
|
|
116
|
+
|
|
117
|
+
| Priority | Test Type |
|
|
118
|
+
|----------|-----------|
|
|
119
|
+
| 1 | Happy path |
|
|
120
|
+
| 2 | Error cases |
|
|
121
|
+
| 3 | Edge cases |
|
|
122
|
+
| 4 | Performance |
|
|
123
|
+
|
|
124
|
+
---
|
|
125
|
+
|
|
126
|
+
## 9. Anti-Patterns
|
|
127
|
+
|
|
128
|
+
| ❌ Don't | ✅ Do |
|
|
129
|
+
|----------|-------|
|
|
130
|
+
| Skip the RED phase | Watch test fail first |
|
|
131
|
+
| Write tests after | Write tests before |
|
|
132
|
+
| Over-engineer initial | Keep it simple |
|
|
133
|
+
| Multiple asserts | One behavior per test |
|
|
134
|
+
| Test implementation | Test behavior |
|
|
135
|
+
|
|
136
|
+
---
|
|
137
|
+
|
|
138
|
+
## 10. AI-Augmented TDD
|
|
139
|
+
|
|
140
|
+
### Multi-Agent Pattern
|
|
141
|
+
|
|
142
|
+
| Agent | Role |
|
|
143
|
+
|-------|------|
|
|
144
|
+
| Agent A | Write failing tests (RED) |
|
|
145
|
+
| Agent B | Implement to pass (GREEN) |
|
|
146
|
+
| Agent C | Optimize (REFACTOR) |
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
> **Remember:** The test is the specification. If you can't write a test, you don't understand the requirement.
|