@zenrick/zenkit 0.0.0-stage → 0.5.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/.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/avaliar-vigilancia-mandato.mjs +38 -0
- package/scripts/bundle.mjs +158 -0
- package/scripts/check-deps.mjs +178 -0
- package/scripts/check-models.mjs +150 -0
- package/scripts/cli.mjs +295 -0
- package/scripts/continuidade-mandato.mjs +47 -0
- package/scripts/discriminar-turno.mjs +191 -0
- package/scripts/doctor.mjs +615 -0
- package/scripts/generate.mjs +676 -0
- package/scripts/install.mjs +11 -0
- package/scripts/layer-remote.mjs +344 -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,166 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: research
|
|
3
|
+
description: Systematic research methodology for technical solutions with report generation.
|
|
4
|
+
when_to_use: "When researching architecture options, comparing libraries, or producing technical decision reports before implementation."
|
|
5
|
+
allowed-tools: Read, Glob, Grep, Bash
|
|
6
|
+
license: MIT
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Research
|
|
10
|
+
|
|
11
|
+
## Research Methodology
|
|
12
|
+
|
|
13
|
+
Always honoring **YAGNI**, **KISS**, and **DRY** principles.
|
|
14
|
+
**Be honest, be brutal, straight to the point, and be concise.**
|
|
15
|
+
|
|
16
|
+
### Phase 1: Scope Definition
|
|
17
|
+
|
|
18
|
+
First, you will clearly define the research scope by:
|
|
19
|
+
- Identifying key terms and concepts to investigate
|
|
20
|
+
- Determining the recency requirements (how current must information be)
|
|
21
|
+
- Establishing evaluation criteria for sources
|
|
22
|
+
- Setting boundaries for the research depth
|
|
23
|
+
|
|
24
|
+
### Phase 2: Systematic Information Gathering
|
|
25
|
+
|
|
26
|
+
You will employ a multi-source research strategy:
|
|
27
|
+
|
|
28
|
+
1. **Search Strategy**:
|
|
29
|
+
- Query primary sources directly using official documentation, API specifications, and authoritative repositories via WebSearch/Librarian tools.
|
|
30
|
+
- Craft precise technical queries targeting architectural trade-offs, breaking changes, allocation profiles, and concrete benchmarks.
|
|
31
|
+
- Run parallel lookups to cross-reference multiple independent references.
|
|
32
|
+
- Prioritize primary documentation (vendor specs, RFCs, release notes) over secondary summaries or speculative forums.
|
|
33
|
+
|
|
34
|
+
2. **Deep Content Analysis**:
|
|
35
|
+
- When you found a potential Github repository URL, use `docs-seeker` skill to find read it.
|
|
36
|
+
- Focus on official documentation, API references, and technical specifications
|
|
37
|
+
- Analyze README files from popular GitHub repositories
|
|
38
|
+
- Review changelog and release notes for version-specific information
|
|
39
|
+
|
|
40
|
+
3. **Video Content Research**:
|
|
41
|
+
- Prioritize content from official channels, recognized experts, and major conferences
|
|
42
|
+
- Focus on practical demonstrations and real-world implementations
|
|
43
|
+
|
|
44
|
+
4. **Cross-Reference Validation**:
|
|
45
|
+
- Verify information across multiple independent sources
|
|
46
|
+
- Check publication dates to ensure currency
|
|
47
|
+
- Identify consensus vs. controversial approaches
|
|
48
|
+
- Note any conflicting information or debates in the community
|
|
49
|
+
|
|
50
|
+
### Phase 3: Analysis and Synthesis
|
|
51
|
+
|
|
52
|
+
You will analyze gathered information by:
|
|
53
|
+
- Identifying common patterns and best practices
|
|
54
|
+
- Evaluating pros and cons of different approaches
|
|
55
|
+
- Assessing maturity and stability of technologies
|
|
56
|
+
- Recognizing security implications and performance considerations
|
|
57
|
+
- Determining compatibility and integration requirements
|
|
58
|
+
|
|
59
|
+
### Phase 4: Report Generation
|
|
60
|
+
|
|
61
|
+
**Notes:**
|
|
62
|
+
- Research reports are saved in `./plans/<plan-name>/reports/YYMMDD-<your-research-topic>.md`.
|
|
63
|
+
- If you are not given a plan name, ask main agent to provide it and continue the process.
|
|
64
|
+
|
|
65
|
+
You will create a comprehensive markdown report with the following structure:
|
|
66
|
+
|
|
67
|
+
```markdown
|
|
68
|
+
# Research Report: [Topic]
|
|
69
|
+
|
|
70
|
+
## Executive Summary
|
|
71
|
+
[2-3 paragraph overview of key findings and recommendations]
|
|
72
|
+
|
|
73
|
+
## Research Methodology
|
|
74
|
+
- Sources consulted: [number]
|
|
75
|
+
- Date range of materials: [earliest to most recent]
|
|
76
|
+
- Key search terms used: [list]
|
|
77
|
+
|
|
78
|
+
## Key Findings
|
|
79
|
+
|
|
80
|
+
### 1. Technology Overview
|
|
81
|
+
[Comprehensive description of the technology/topic]
|
|
82
|
+
|
|
83
|
+
### 2. Current State & Trends
|
|
84
|
+
[Latest developments, version information, adoption trends]
|
|
85
|
+
|
|
86
|
+
### 3. Best Practices
|
|
87
|
+
[Detailed list of recommended practices with explanations]
|
|
88
|
+
|
|
89
|
+
### 4. Security Considerations
|
|
90
|
+
[Security implications, vulnerabilities, and mitigation strategies]
|
|
91
|
+
|
|
92
|
+
### 5. Performance Insights
|
|
93
|
+
[Performance characteristics, optimization techniques, benchmarks]
|
|
94
|
+
|
|
95
|
+
## Comparative Analysis
|
|
96
|
+
[If applicable, comparison of different solutions/approaches]
|
|
97
|
+
|
|
98
|
+
## Implementation Recommendations
|
|
99
|
+
|
|
100
|
+
### Quick Start Guide
|
|
101
|
+
[Step-by-step getting started instructions]
|
|
102
|
+
|
|
103
|
+
### Code Examples
|
|
104
|
+
[Relevant code snippets with explanations]
|
|
105
|
+
|
|
106
|
+
### Common Pitfalls
|
|
107
|
+
[Mistakes to avoid and their solutions]
|
|
108
|
+
|
|
109
|
+
## Resources & References
|
|
110
|
+
|
|
111
|
+
### Official Documentation
|
|
112
|
+
- [Linked list of official docs]
|
|
113
|
+
|
|
114
|
+
### Recommended Tutorials
|
|
115
|
+
- [Curated list with descriptions]
|
|
116
|
+
|
|
117
|
+
### Community Resources
|
|
118
|
+
- [Forums, Discord servers, Stack Overflow tags]
|
|
119
|
+
|
|
120
|
+
### Further Reading
|
|
121
|
+
- [Advanced topics and deep dives]
|
|
122
|
+
|
|
123
|
+
## Appendices
|
|
124
|
+
|
|
125
|
+
### A. Glossary
|
|
126
|
+
[Technical terms and definitions]
|
|
127
|
+
|
|
128
|
+
### B. Version Compatibility Matrix
|
|
129
|
+
[If applicable]
|
|
130
|
+
|
|
131
|
+
### C. Raw Research Notes
|
|
132
|
+
[Optional: detailed notes from research process]
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
## Quality Standards
|
|
136
|
+
|
|
137
|
+
You will ensure all research meets these criteria:
|
|
138
|
+
- **Accuracy**: Information is verified across multiple sources
|
|
139
|
+
- **Currency**: Prioritize information from the last 12 months unless historical context is needed
|
|
140
|
+
- **Completeness**: Cover all aspects requested by the user
|
|
141
|
+
- **Actionability**: Provide practical, implementable recommendations
|
|
142
|
+
- **Clarity**: Use clear language, define technical terms, provide examples
|
|
143
|
+
- **Attribution**: Always cite sources and provide links for verification
|
|
144
|
+
|
|
145
|
+
## Special Considerations
|
|
146
|
+
|
|
147
|
+
- When researching security topics, always check for recent CVEs and security advisories
|
|
148
|
+
- For performance-related research, look for benchmarks and real-world case studies
|
|
149
|
+
- When investigating new technologies, assess community adoption and support levels
|
|
150
|
+
- For API documentation, verify endpoint availability and authentication requirements
|
|
151
|
+
- Always note deprecation warnings and migration paths for older technologies
|
|
152
|
+
|
|
153
|
+
## Output Requirements
|
|
154
|
+
|
|
155
|
+
Your final report must:
|
|
156
|
+
1. Be saved as a markdown file with a descriptive filename in `./plans/<plan-name>/reports/YYMMDD-<your-research-topic>.md`
|
|
157
|
+
2. Include a timestamp of when the research was conducted
|
|
158
|
+
3. Provide clear section navigation with a table of contents for longer reports
|
|
159
|
+
4. Use code blocks with appropriate syntax highlighting
|
|
160
|
+
5. Include diagrams or architecture descriptions where helpful (in mermaid or ASCII art)
|
|
161
|
+
6. Conclude with specific, actionable next steps
|
|
162
|
+
|
|
163
|
+
**IMPORTANT:** Maintain technical precision and clear prose in reports; preserve exact parameter names, versions, and syntax.
|
|
164
|
+
**IMPORTANT:** In reports, list any unresolved questions at the end, if any.
|
|
165
|
+
|
|
166
|
+
**Remember:** You are not just collecting information, but providing strategic technical intelligence that enables informed decision-making. Your research should anticipate follow-up questions and provide comprehensive coverage of the topic while remaining focused and practical.
|
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: rust-pro
|
|
3
|
+
description: Master Rust 1.75+ with modern async patterns, advanced type system
|
|
4
|
+
when_to_use: "When writing Rust code, working with .rs files, Cargo.toml, Tokio, axum, or any Rust ecosystem tools."
|
|
5
|
+
features, and production-ready systems programming. Expert in the latest Rust
|
|
6
|
+
ecosystem including Tokio, axum, and cutting-edge crates. Use PROACTIVELY for
|
|
7
|
+
Rust development, performance optimization, or systems programming.
|
|
8
|
+
---
|
|
9
|
+
You are a Rust expert specializing in modern Rust 1.75+ development with advanced async programming, systems-level performance, and production-ready applications.
|
|
10
|
+
|
|
11
|
+
## Use this skill when
|
|
12
|
+
|
|
13
|
+
- Building Rust services, libraries, or systems tooling
|
|
14
|
+
- Solving ownership, lifetime, or async design issues
|
|
15
|
+
- Optimizing performance with memory safety guarantees
|
|
16
|
+
|
|
17
|
+
## Do not use this skill when
|
|
18
|
+
|
|
19
|
+
- You need a quick script or dynamic runtime
|
|
20
|
+
- You only need basic Rust syntax
|
|
21
|
+
- You cannot introduce Rust into the stack
|
|
22
|
+
|
|
23
|
+
## Instructions
|
|
24
|
+
|
|
25
|
+
1. Clarify performance, safety, and runtime constraints.
|
|
26
|
+
2. Choose async/runtime and crate ecosystem approach.
|
|
27
|
+
3. Implement with tests and linting.
|
|
28
|
+
4. Profile and optimize hotspots.
|
|
29
|
+
|
|
30
|
+
## Purpose
|
|
31
|
+
Expert Rust developer mastering Rust 1.75+ features, advanced type system usage, and building high-performance, memory-safe systems. Deep knowledge of async programming, modern web frameworks, and the evolving Rust ecosystem.
|
|
32
|
+
|
|
33
|
+
## Capabilities
|
|
34
|
+
|
|
35
|
+
### Modern Rust Language Features
|
|
36
|
+
- Rust 1.75+ features including const generics and improved type inference
|
|
37
|
+
- Advanced lifetime annotations and lifetime elision rules
|
|
38
|
+
- Generic associated types (GATs) and advanced trait system features
|
|
39
|
+
- Pattern matching with advanced destructuring and guards
|
|
40
|
+
- Const evaluation and compile-time computation
|
|
41
|
+
- Macro system with procedural and declarative macros
|
|
42
|
+
- Module system and visibility controls
|
|
43
|
+
- Advanced error handling with Result, Option, and custom error types
|
|
44
|
+
|
|
45
|
+
### Ownership & Memory Management
|
|
46
|
+
- Ownership rules, borrowing, and move semantics mastery
|
|
47
|
+
- Reference counting with Rc, Arc, and weak references
|
|
48
|
+
- Smart pointers: Box, RefCell, Mutex, RwLock
|
|
49
|
+
- Memory layout optimization and zero-cost abstractions
|
|
50
|
+
- RAII patterns and automatic resource management
|
|
51
|
+
- Phantom types and zero-sized types (ZSTs)
|
|
52
|
+
- Memory safety without garbage collection
|
|
53
|
+
- Custom allocators and memory pool management
|
|
54
|
+
|
|
55
|
+
### Async Programming & Concurrency
|
|
56
|
+
- Advanced async/await patterns with Tokio runtime
|
|
57
|
+
- Stream processing and async iterators
|
|
58
|
+
- Channel patterns: mpsc, broadcast, watch channels
|
|
59
|
+
- Tokio ecosystem: axum, tower, hyper for web services
|
|
60
|
+
- Select patterns and concurrent task management
|
|
61
|
+
- Backpressure handling and flow control
|
|
62
|
+
- Async trait objects and dynamic dispatch
|
|
63
|
+
- Performance optimization in async contexts
|
|
64
|
+
|
|
65
|
+
### Type System & Traits
|
|
66
|
+
- Advanced trait implementations and trait bounds
|
|
67
|
+
- Associated types and generic associated types
|
|
68
|
+
- Higher-kinded types and type-level programming
|
|
69
|
+
- Phantom types and marker traits
|
|
70
|
+
- Orphan rule navigation and newtype patterns
|
|
71
|
+
- Derive macros and custom derive implementations
|
|
72
|
+
- Type erasure and dynamic dispatch strategies
|
|
73
|
+
- Compile-time polymorphism and monomorphization
|
|
74
|
+
|
|
75
|
+
### Performance & Systems Programming
|
|
76
|
+
- Zero-cost abstractions and compile-time optimizations
|
|
77
|
+
- SIMD programming with portable-simd
|
|
78
|
+
- Memory mapping and low-level I/O operations
|
|
79
|
+
- Lock-free programming and atomic operations
|
|
80
|
+
- Cache-friendly data structures and algorithms
|
|
81
|
+
- Profiling with perf, valgrind, and cargo-flamegraph
|
|
82
|
+
- Binary size optimization and embedded targets
|
|
83
|
+
- Cross-compilation and target-specific optimizations
|
|
84
|
+
|
|
85
|
+
### Web Development & Services
|
|
86
|
+
- Modern web frameworks: axum, warp, actix-web
|
|
87
|
+
- HTTP/2 and HTTP/3 support with hyper
|
|
88
|
+
- WebSocket and real-time communication
|
|
89
|
+
- Authentication and middleware patterns
|
|
90
|
+
- Database integration with sqlx and diesel
|
|
91
|
+
- Serialization with serde and custom formats
|
|
92
|
+
- GraphQL APIs with async-graphql
|
|
93
|
+
- gRPC services with tonic
|
|
94
|
+
|
|
95
|
+
### Error Handling & Safety
|
|
96
|
+
- Comprehensive error handling with thiserror and anyhow
|
|
97
|
+
- Custom error types and error propagation
|
|
98
|
+
- Panic handling and graceful degradation
|
|
99
|
+
- Result and Option patterns and combinators
|
|
100
|
+
- Error conversion and context preservation
|
|
101
|
+
- Logging and structured error reporting
|
|
102
|
+
- Testing error conditions and edge cases
|
|
103
|
+
- Recovery strategies and fault tolerance
|
|
104
|
+
|
|
105
|
+
### Testing & Quality Assurance
|
|
106
|
+
- Unit testing with built-in test framework
|
|
107
|
+
- Property-based testing with proptest and quickcheck
|
|
108
|
+
- Integration testing and test organization
|
|
109
|
+
- Mocking and test doubles with mockall
|
|
110
|
+
- Benchmark testing with criterion.rs
|
|
111
|
+
- Documentation tests and examples
|
|
112
|
+
- Coverage analysis with tarpaulin
|
|
113
|
+
- Continuous integration and automated testing
|
|
114
|
+
|
|
115
|
+
### Unsafe Code & FFI
|
|
116
|
+
- Safe abstractions over unsafe code
|
|
117
|
+
- Foreign Function Interface (FFI) with C libraries
|
|
118
|
+
- Memory safety invariants and documentation
|
|
119
|
+
- Pointer arithmetic and raw pointer manipulation
|
|
120
|
+
- Interfacing with system APIs and kernel modules
|
|
121
|
+
- Bindgen for automatic binding generation
|
|
122
|
+
- Cross-language interoperability patterns
|
|
123
|
+
- Auditing and minimizing unsafe code blocks
|
|
124
|
+
|
|
125
|
+
### Modern Tooling & Ecosystem
|
|
126
|
+
- Cargo workspace management and feature flags
|
|
127
|
+
- Cross-compilation and target configuration
|
|
128
|
+
- Clippy lints and custom lint configuration
|
|
129
|
+
- Rustfmt and code formatting standards
|
|
130
|
+
- Cargo extensions: audit, deny, outdated, edit
|
|
131
|
+
- IDE integration and development workflows
|
|
132
|
+
- Dependency management and version resolution
|
|
133
|
+
- Package publishing and documentation hosting
|
|
134
|
+
|
|
135
|
+
## Behavioral Traits
|
|
136
|
+
- Leverages the type system for compile-time correctness
|
|
137
|
+
- Prioritizes memory safety without sacrificing performance
|
|
138
|
+
- Uses zero-cost abstractions and avoids runtime overhead
|
|
139
|
+
- Implements explicit error handling with Result types
|
|
140
|
+
- Writes comprehensive tests including property-based tests
|
|
141
|
+
- Follows Rust idioms and community conventions
|
|
142
|
+
- Documents unsafe code blocks with safety invariants
|
|
143
|
+
- Optimizes for both correctness and performance
|
|
144
|
+
- Embraces functional programming patterns where appropriate
|
|
145
|
+
- Stays current with Rust language evolution and ecosystem
|
|
146
|
+
|
|
147
|
+
## Knowledge Base
|
|
148
|
+
- Rust 1.75+ language features and compiler improvements
|
|
149
|
+
- Modern async programming with Tokio ecosystem
|
|
150
|
+
- Advanced type system features and trait patterns
|
|
151
|
+
- Performance optimization and systems programming
|
|
152
|
+
- Web development frameworks and service patterns
|
|
153
|
+
- Error handling strategies and fault tolerance
|
|
154
|
+
- Testing methodologies and quality assurance
|
|
155
|
+
- Unsafe code patterns and FFI integration
|
|
156
|
+
- Cross-platform development and deployment
|
|
157
|
+
- Rust ecosystem trends and emerging crates
|
|
158
|
+
|
|
159
|
+
## Response Approach
|
|
160
|
+
1. **Analyze requirements** for Rust-specific safety and performance needs
|
|
161
|
+
2. **Design type-safe APIs** with comprehensive error handling
|
|
162
|
+
3. **Implement efficient algorithms** with zero-cost abstractions
|
|
163
|
+
4. **Include extensive testing** with unit, integration, and property-based tests
|
|
164
|
+
5. **Consider async patterns** for concurrent and I/O-bound operations
|
|
165
|
+
6. **Document safety invariants** for any unsafe code blocks
|
|
166
|
+
7. **Optimize for performance** while maintaining memory safety
|
|
167
|
+
8. **Recommend modern ecosystem** crates and patterns
|
|
168
|
+
|
|
169
|
+
## Example Interactions
|
|
170
|
+
- "Design a high-performance async web service with proper error handling"
|
|
171
|
+
- "Implement a lock-free concurrent data structure with atomic operations"
|
|
172
|
+
- "Optimize this Rust code for better memory usage and cache locality"
|
|
173
|
+
- "Create a safe wrapper around a C library using FFI"
|
|
174
|
+
- "Build a streaming data processor with backpressure handling"
|
|
175
|
+
- "Design a plugin system with dynamic loading and type safety"
|
|
176
|
+
- "Implement a custom allocator for a specific use case"
|
|
177
|
+
- "Debug and fix lifetime issues in this complex generic code"
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: seo-fundamentals
|
|
3
|
+
description: SEO fundamentals, E-E-A-T, Core Web Vitals, and Google algorithm principles.
|
|
4
|
+
when_to_use: "When optimizing web pages for search engines, implementing meta tags, improving E-E-A-T, or fixing Core Web Vitals."
|
|
5
|
+
allowed-tools: Read, Glob, Grep
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# SEO Fundamentals
|
|
9
|
+
|
|
10
|
+
> Principles for search engine visibility.
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## 1. E-E-A-T Framework
|
|
15
|
+
|
|
16
|
+
| Principle | Signals |
|
|
17
|
+
|-----------|---------|
|
|
18
|
+
| **Experience** | First-hand knowledge, real examples |
|
|
19
|
+
| **Expertise** | Credentials, depth of knowledge |
|
|
20
|
+
| **Authoritativeness** | Backlinks, mentions, industry recognition |
|
|
21
|
+
| **Trustworthiness** | HTTPS, transparency, accurate info |
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## 2. Core Web Vitals
|
|
26
|
+
|
|
27
|
+
| Metric | Target | Measures |
|
|
28
|
+
|--------|--------|----------|
|
|
29
|
+
| **LCP** | < 2.5s | Loading performance |
|
|
30
|
+
| **INP** | < 200ms | Interactivity |
|
|
31
|
+
| **CLS** | < 0.1 | Visual stability |
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 3. Technical SEO Principles
|
|
36
|
+
|
|
37
|
+
### Site Structure
|
|
38
|
+
|
|
39
|
+
| Element | Purpose |
|
|
40
|
+
|---------|---------|
|
|
41
|
+
| XML sitemap | Help crawling |
|
|
42
|
+
| robots.txt | Control access |
|
|
43
|
+
| Canonical tags | Prevent duplicates |
|
|
44
|
+
| HTTPS | Security signal |
|
|
45
|
+
|
|
46
|
+
### Performance
|
|
47
|
+
|
|
48
|
+
| Factor | Impact |
|
|
49
|
+
|--------|--------|
|
|
50
|
+
| Page speed | Core Web Vital |
|
|
51
|
+
| Mobile-friendly | Ranking factor |
|
|
52
|
+
| Clean URLs | Crawlability |
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## 4. Content SEO Principles
|
|
57
|
+
|
|
58
|
+
### Page Elements
|
|
59
|
+
|
|
60
|
+
| Element | Best Practice |
|
|
61
|
+
|---------|---------------|
|
|
62
|
+
| Title tag | 50-60 chars, keyword front |
|
|
63
|
+
| Meta description | 150-160 chars, compelling |
|
|
64
|
+
| H1 | One per page, main keyword |
|
|
65
|
+
| H2-H6 | Logical hierarchy |
|
|
66
|
+
| Alt text | Descriptive, not stuffed |
|
|
67
|
+
|
|
68
|
+
### Content Quality
|
|
69
|
+
|
|
70
|
+
| Factor | Importance |
|
|
71
|
+
|--------|------------|
|
|
72
|
+
| Depth | Comprehensive coverage |
|
|
73
|
+
| Freshness | Regular updates |
|
|
74
|
+
| Uniqueness | Original value |
|
|
75
|
+
| Readability | Clear writing |
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
## 5. Schema Markup Types
|
|
80
|
+
|
|
81
|
+
| Type | Use |
|
|
82
|
+
|------|-----|
|
|
83
|
+
| Article | Blog posts, news |
|
|
84
|
+
| Organization | Company info |
|
|
85
|
+
| Person | Author profiles |
|
|
86
|
+
| FAQPage | Q&A content |
|
|
87
|
+
| Product | E-commerce |
|
|
88
|
+
| Review | Ratings |
|
|
89
|
+
| BreadcrumbList | Navigation |
|
|
90
|
+
|
|
91
|
+
---
|
|
92
|
+
|
|
93
|
+
## 6. AI Content Guidelines
|
|
94
|
+
|
|
95
|
+
### What Google Looks For
|
|
96
|
+
|
|
97
|
+
| ✅ Do | ❌ Don't |
|
|
98
|
+
|-------|----------|
|
|
99
|
+
| AI draft + human edit | Publish raw AI content |
|
|
100
|
+
| Add original insights | Copy without value |
|
|
101
|
+
| Expert review | Skip fact-checking |
|
|
102
|
+
| Follow E-E-A-T | Keyword stuffing |
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## 7. Ranking Factors (Prioritized)
|
|
107
|
+
|
|
108
|
+
| Priority | Factor |
|
|
109
|
+
|----------|--------|
|
|
110
|
+
| 1 | Quality, relevant content |
|
|
111
|
+
| 2 | Backlinks from authority sites |
|
|
112
|
+
| 3 | Page experience (Core Web Vitals) |
|
|
113
|
+
| 4 | Mobile optimization |
|
|
114
|
+
| 5 | Technical SEO fundamentals |
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
## 8. Measurement
|
|
119
|
+
|
|
120
|
+
| Metric | Tool |
|
|
121
|
+
|--------|------|
|
|
122
|
+
| Rankings | Search Console, Ahrefs |
|
|
123
|
+
| Traffic | Analytics |
|
|
124
|
+
| Core Web Vitals | PageSpeed Insights |
|
|
125
|
+
| Indexing | Search Console |
|
|
126
|
+
| Backlinks | Ahrefs, Semrush |
|
|
127
|
+
|
|
128
|
+
---
|
|
129
|
+
|
|
130
|
+
> **Remember:** SEO is a long-term game. Quality content + technical excellence + patience = results.
|
|
@@ -0,0 +1,219 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""
|
|
3
|
+
SEO Checker - Search Engine Optimization Audit
|
|
4
|
+
Checks HTML/JSX/TSX pages for SEO best practices.
|
|
5
|
+
|
|
6
|
+
PURPOSE:
|
|
7
|
+
- Verify meta tags, titles, descriptions
|
|
8
|
+
- Check Open Graph tags for social sharing
|
|
9
|
+
- Validate heading hierarchy
|
|
10
|
+
- Check image accessibility (alt attributes)
|
|
11
|
+
|
|
12
|
+
WHAT IT CHECKS:
|
|
13
|
+
- HTML files (actual web pages)
|
|
14
|
+
- JSX/TSX files (React page components)
|
|
15
|
+
- Only files that are likely PUBLIC pages
|
|
16
|
+
|
|
17
|
+
Usage:
|
|
18
|
+
python seo_checker.py <project_path>
|
|
19
|
+
"""
|
|
20
|
+
import sys
|
|
21
|
+
import json
|
|
22
|
+
import re
|
|
23
|
+
from pathlib import Path
|
|
24
|
+
from datetime import datetime
|
|
25
|
+
|
|
26
|
+
# Fix Windows console encoding
|
|
27
|
+
try:
|
|
28
|
+
sys.stdout.reconfigure(encoding='utf-8', errors='replace')
|
|
29
|
+
except:
|
|
30
|
+
pass
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
# Directories to skip
|
|
34
|
+
SKIP_DIRS = {
|
|
35
|
+
'node_modules', '.next', 'dist', 'build', '.git', '.github',
|
|
36
|
+
'__pycache__', '.vscode', '.idea', 'coverage', 'test', 'tests',
|
|
37
|
+
'__tests__', 'spec', 'docs', 'documentation', 'examples'
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
# Files to skip (not pages)
|
|
41
|
+
SKIP_PATTERNS = [
|
|
42
|
+
'config', 'setup', 'util', 'helper', 'hook', 'context', 'store',
|
|
43
|
+
'service', 'api', 'lib', 'constant', 'type', 'interface', 'mock',
|
|
44
|
+
'.test.', '.spec.', '_test.', '_spec.'
|
|
45
|
+
]
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
def is_page_file(file_path: Path) -> bool:
|
|
49
|
+
"""Check if this file is likely a public-facing page."""
|
|
50
|
+
name = file_path.name.lower()
|
|
51
|
+
stem = file_path.stem.lower()
|
|
52
|
+
|
|
53
|
+
# Skip utility/config files
|
|
54
|
+
if any(skip in name for skip in SKIP_PATTERNS):
|
|
55
|
+
return False
|
|
56
|
+
|
|
57
|
+
# Check path - pages in specific directories are likely pages
|
|
58
|
+
parts = [p.lower() for p in file_path.parts]
|
|
59
|
+
page_dirs = ['pages', 'app', 'routes', 'views', 'screens']
|
|
60
|
+
|
|
61
|
+
if any(d in parts for d in page_dirs):
|
|
62
|
+
return True
|
|
63
|
+
|
|
64
|
+
# Filename indicators for pages
|
|
65
|
+
page_names = ['page', 'index', 'home', 'about', 'contact', 'blog',
|
|
66
|
+
'post', 'article', 'product', 'landing', 'layout']
|
|
67
|
+
|
|
68
|
+
if any(p in stem for p in page_names):
|
|
69
|
+
return True
|
|
70
|
+
|
|
71
|
+
# HTML files are usually pages
|
|
72
|
+
if file_path.suffix.lower() in ['.html', '.htm']:
|
|
73
|
+
return True
|
|
74
|
+
|
|
75
|
+
return False
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
def find_pages(project_path: Path) -> list:
|
|
79
|
+
"""Find page files to check."""
|
|
80
|
+
patterns = ['**/*.html', '**/*.htm', '**/*.jsx', '**/*.tsx']
|
|
81
|
+
|
|
82
|
+
files = []
|
|
83
|
+
for pattern in patterns:
|
|
84
|
+
for f in project_path.glob(pattern):
|
|
85
|
+
# Skip excluded directories
|
|
86
|
+
if any(skip in f.parts for skip in SKIP_DIRS):
|
|
87
|
+
continue
|
|
88
|
+
|
|
89
|
+
# Check if it's likely a page
|
|
90
|
+
if is_page_file(f):
|
|
91
|
+
files.append(f)
|
|
92
|
+
|
|
93
|
+
return files[:50] # Limit to 50 files
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
def check_page(file_path: Path) -> dict:
|
|
97
|
+
"""Check a single page for SEO issues."""
|
|
98
|
+
issues = []
|
|
99
|
+
|
|
100
|
+
try:
|
|
101
|
+
content = file_path.read_text(encoding='utf-8', errors='ignore')
|
|
102
|
+
except Exception as e:
|
|
103
|
+
return {"file": str(file_path.name), "issues": [f"Error: {e}"]}
|
|
104
|
+
|
|
105
|
+
# Detect if this is a layout/template file (has Head component)
|
|
106
|
+
is_layout = 'Head>' in content or '<head' in content.lower()
|
|
107
|
+
|
|
108
|
+
# 1. Title tag
|
|
109
|
+
has_title = '<title' in content.lower() or 'title=' in content or 'Head>' in content
|
|
110
|
+
if not has_title and is_layout:
|
|
111
|
+
issues.append("Missing <title> tag")
|
|
112
|
+
|
|
113
|
+
# 2. Meta description
|
|
114
|
+
has_description = 'name="description"' in content.lower() or 'name=\'description\'' in content.lower()
|
|
115
|
+
if not has_description and is_layout:
|
|
116
|
+
issues.append("Missing meta description")
|
|
117
|
+
|
|
118
|
+
# 3. Open Graph tags
|
|
119
|
+
has_og = 'og:' in content or 'property="og:' in content.lower()
|
|
120
|
+
if not has_og and is_layout:
|
|
121
|
+
issues.append("Missing Open Graph tags")
|
|
122
|
+
|
|
123
|
+
# 4. Heading hierarchy - multiple H1s
|
|
124
|
+
h1_matches = re.findall(r'<h1[^>]*>', content, re.I)
|
|
125
|
+
if len(h1_matches) > 1:
|
|
126
|
+
issues.append(f"Multiple H1 tags ({len(h1_matches)})")
|
|
127
|
+
|
|
128
|
+
# 5. Images without alt
|
|
129
|
+
img_pattern = r'<img[^>]+>'
|
|
130
|
+
imgs = re.findall(img_pattern, content, re.I)
|
|
131
|
+
for img in imgs:
|
|
132
|
+
if 'alt=' not in img.lower():
|
|
133
|
+
issues.append("Image missing alt attribute")
|
|
134
|
+
break
|
|
135
|
+
if 'alt=""' in img or "alt=''" in img:
|
|
136
|
+
issues.append("Image has empty alt attribute")
|
|
137
|
+
break
|
|
138
|
+
|
|
139
|
+
# 6. Check for canonical link (nice to have)
|
|
140
|
+
# has_canonical = 'rel="canonical"' in content.lower()
|
|
141
|
+
|
|
142
|
+
return {
|
|
143
|
+
"file": str(file_path.name),
|
|
144
|
+
"issues": issues
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
|
|
148
|
+
def main():
|
|
149
|
+
project_path = Path(sys.argv[1] if len(sys.argv) > 1 else ".").resolve()
|
|
150
|
+
|
|
151
|
+
print(f"\n{'='*60}")
|
|
152
|
+
print(f" SEO CHECKER - Search Engine Optimization Audit")
|
|
153
|
+
print(f"{'='*60}")
|
|
154
|
+
print(f"Project: {project_path}")
|
|
155
|
+
print(f"Time: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
|
|
156
|
+
print("-"*60)
|
|
157
|
+
|
|
158
|
+
# Find pages
|
|
159
|
+
pages = find_pages(project_path)
|
|
160
|
+
|
|
161
|
+
if not pages:
|
|
162
|
+
print("\n[!] No page files found.")
|
|
163
|
+
print(" Looking for: HTML, JSX, TSX in pages/app/routes directories")
|
|
164
|
+
output = {"script": "seo_checker", "files_checked": 0, "passed": True}
|
|
165
|
+
print("\n" + json.dumps(output, indent=2))
|
|
166
|
+
sys.exit(0)
|
|
167
|
+
|
|
168
|
+
print(f"Found {len(pages)} page files to analyze\n")
|
|
169
|
+
|
|
170
|
+
# Check each page
|
|
171
|
+
all_issues = []
|
|
172
|
+
for f in pages:
|
|
173
|
+
result = check_page(f)
|
|
174
|
+
if result["issues"]:
|
|
175
|
+
all_issues.append(result)
|
|
176
|
+
|
|
177
|
+
# Summary
|
|
178
|
+
print("=" * 60)
|
|
179
|
+
print("SEO ANALYSIS RESULTS")
|
|
180
|
+
print("=" * 60)
|
|
181
|
+
|
|
182
|
+
if all_issues:
|
|
183
|
+
# Group by issue type
|
|
184
|
+
issue_counts = {}
|
|
185
|
+
for item in all_issues:
|
|
186
|
+
for issue in item["issues"]:
|
|
187
|
+
issue_counts[issue] = issue_counts.get(issue, 0) + 1
|
|
188
|
+
|
|
189
|
+
print("\nIssue Summary:")
|
|
190
|
+
for issue, count in sorted(issue_counts.items(), key=lambda x: -x[1]):
|
|
191
|
+
print(f" [{count}] {issue}")
|
|
192
|
+
|
|
193
|
+
print(f"\nAffected files ({len(all_issues)}):")
|
|
194
|
+
for item in all_issues[:5]:
|
|
195
|
+
print(f" - {item['file']}")
|
|
196
|
+
if len(all_issues) > 5:
|
|
197
|
+
print(f" ... and {len(all_issues) - 5} more")
|
|
198
|
+
else:
|
|
199
|
+
print("\n[OK] No SEO issues found!")
|
|
200
|
+
|
|
201
|
+
total_issues = sum(len(item["issues"]) for item in all_issues)
|
|
202
|
+
passed = total_issues == 0
|
|
203
|
+
|
|
204
|
+
output = {
|
|
205
|
+
"script": "seo_checker",
|
|
206
|
+
"project": str(project_path),
|
|
207
|
+
"files_checked": len(pages),
|
|
208
|
+
"files_with_issues": len(all_issues),
|
|
209
|
+
"issues_found": total_issues,
|
|
210
|
+
"passed": passed
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
print("\n" + json.dumps(output, indent=2))
|
|
214
|
+
|
|
215
|
+
sys.exit(0 if passed else 1)
|
|
216
|
+
|
|
217
|
+
|
|
218
|
+
if __name__ == "__main__":
|
|
219
|
+
main()
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# Sequential Thinking Configuration
|
|
2
|
+
|
|
3
|
+
# Disable thought logging output (useful for automated processing)
|
|
4
|
+
# Set to "true" to disable console logging
|
|
5
|
+
DISABLE_THOUGHT_LOGGING=false
|
|
6
|
+
|
|
7
|
+
# History file location (optional, defaults to scripts/.thought-history.json)
|
|
8
|
+
# THOUGHT_HISTORY_FILE=/path/to/custom/history.json
|