antigravity-ide 4.2.0 → 4.2.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/.agent/.shared/{technical/ai-master → ai-master}/README.md +1 -12
- package/.agent/.shared/{technical/api-standards → api-standards}/README.md +1 -12
- package/.agent/.shared/compliance/README.md +19 -0
- package/.agent/.shared/{technical/database-master → database-master}/README.md +2 -12
- package/.agent/.shared/{core/design-philosophy → design-philosophy}/README.md +1 -12
- package/.agent/.shared/design-system/README.md +18 -0
- package/.agent/.shared/domain-blueprints/README.md +18 -0
- package/.agent/.shared/dx-toolkit/README.md +19 -0
- package/.agent/.shared/i18n-master/README.md +18 -0
- package/.agent/.shared/infra-blueprints/README.md +18 -0
- package/.agent/.shared/metrics/README.md +17 -0
- package/.agent/.shared/resilience-patterns/README.md +19 -0
- package/.agent/.shared/security-armor/README.md +25 -0
- package/.agent/.shared/{technical/seo-master → seo-master}/README.md +1 -12
- package/.agent/.shared/testing-master/README.md +20 -0
- package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/README.md +1 -12
- package/.agent/.shared/vitals-templates/README.md +18 -0
- package/.agent/ARCHITECTURE.md +7 -10
- package/.agent/ARCHITECTURE.vi.md +8 -8
- package/.agent/RESOURCES.md +1 -0
- package/.agent/agents/accessibility-expert.md +22 -0
- package/.agent/agents/api-architect.md +22 -0
- package/.agent/agents/backend-specialist.eco.md +19 -0
- package/.agent/agents/backend-specialist.instant.md +19 -0
- package/.agent/agents/backend-specialist.md +19 -154
- package/.agent/agents/cloud-architect.md +189 -108
- package/.agent/agents/codebase-expert.md +23 -0
- package/.agent/agents/compliance-expert.md +22 -0
- package/.agent/agents/data-scientist.md +22 -0
- package/.agent/agents/debugger.eco.md +20 -0
- package/.agent/agents/debugger.instant.md +20 -0
- package/.agent/agents/debugger.md +182 -83
- package/.agent/agents/deep-thinker.ultra.md +23 -0
- package/.agent/agents/devex-optimizer.md +22 -0
- package/.agent/agents/devops-architect.md +22 -0
- package/.agent/agents/documentation-writer.md +72 -125
- package/.agent/agents/frontend-specialist.eco.md +19 -0
- package/.agent/agents/frontend-specialist.instant.md +19 -0
- package/.agent/agents/frontend-specialist.md +7 -40
- package/.agent/agents/game-developer.md +116 -111
- package/.agent/agents/growth-engineer.md +22 -0
- package/.agent/agents/i18n-specialist.md +21 -0
- package/.agent/agents/legacy-modernizer.md +22 -0
- package/.agent/agents/microservices-specialist.md +22 -0
- package/.agent/agents/mobile-developer.md +321 -108
- package/.agent/agents/motion-designer.md +22 -0
- package/.agent/agents/orchestrator.creative.md +28 -0
- package/.agent/agents/orchestrator.eco.md +29 -0
- package/.agent/agents/orchestrator.instant.md +29 -0
- package/.agent/agents/orchestrator.md +366 -106
- package/.agent/agents/orchestrator.ultra.md +28 -0
- package/.agent/agents/performance-benchmarker.md +22 -0
- package/.agent/agents/performance-optimizer.md +136 -105
- package/.agent/agents/project-planner.eco.md +19 -0
- package/.agent/agents/project-planner.instant.md +19 -0
- package/.agent/agents/project-planner.md +39 -132
- package/.agent/agents/quality-inspector.md +32 -136
- package/.agent/agents/security-auditor.md +15 -138
- package/.agent/agents/security-pentester.md +22 -0
- package/.agent/agents/seo-specialist.md +72 -118
- package/.agent/agents/serverless-expert.md +22 -0
- package/.agent/agents/test-engineer.md +11 -142
- package/.agent/fastcode_index.json +1038 -0
- package/.agent/mcp_config.json +24 -0
- package/.agent/rules/GEMINI.eco.md +37 -0
- package/.agent/rules/GEMINI.instant.md +37 -0
- package/.agent/rules/GEMINI.md +31 -62
- package/.agent/rules/api-spec.md +28 -0
- package/.agent/rules/code-quality.md +3 -34
- package/.agent/rules/database.md +24 -0
- package/.agent/rules/devops.md +23 -0
- package/.agent/rules/frontend.md +3 -3
- package/.agent/rules/growth-strategy.md +22 -0
- package/.agent/rules/logging-monitoring.md +22 -0
- package/.agent/rules/quality-assurance.md +22 -0
- package/.agent/rules/strict-protocol.md +3 -44
- package/.agent/rules/system-reasoning.md +20 -0
- package/.agent/rules/system-update.md +3 -56
- package/.agent/rules/ui-design.md +23 -0
- package/.agent/rules/ux-patterns.md +23 -0
- package/.agent/scripts/auto_preview.py +148 -0
- package/.agent/scripts/checklist.py +252 -0
- package/.agent/scripts/session_manager.py +120 -0
- package/.agent/scripts/simulation_install.js +59 -0
- package/.agent/scripts/sync_to_global.py +78 -0
- package/.agent/scripts/translate_workflows.py +53 -0
- package/.agent/scripts/verify_all.py +327 -0
- package/.agent/scripts/verify_shared_modules.js +126 -0
- package/.agent/skills/agent-backend-patterns/SKILL.md +6 -13
- package/.agent/skills/ai-engineer/SKILL.md +16 -29
- package/.agent/skills/api-documenter/SKILL.md +4 -4
- package/.agent/skills/app-builder/SKILL.md +1 -1
- package/.agent/skills/app-builder/tech-stack.md +2 -2
- package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +79 -39
- package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +75 -53
- package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +119 -56
- package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +94 -61
- package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +82 -56
- package/.agent/skills/cloud-architect-master/SKILL.md +4 -9
- package/.agent/skills/cro-expert-kit/SKILL.md +4 -9
- package/.agent/skills/database-migration/SKILL.md +3 -9
- package/.agent/skills/deployment-engineer/SKILL.md +3 -9
- package/.agent/skills/fastcode-search/SKILL.md +46 -0
- package/.agent/skills/fastcode-search/fastcode_config.example.json +17 -0
- package/.agent/skills/frontend-design/ux-psychology.md +585 -10
- package/.agent/skills/frontend-trends-2026/SKILL.md +78 -0
- package/.agent/skills/frontend-trends-2026/formulas/BentoGrid.tsx +42 -0
- package/.agent/skills/frontend-trends-2026/formulas/LiquidCard.tsx +32 -0
- package/.agent/skills/frontend-trends-2026/formulas/NeoButton.tsx +27 -0
- package/.agent/skills/full-stack-scaffold/SKILL.md +4 -4
- package/.agent/skills/game-development/2d-games/SKILL.md +2 -4
- package/.agent/skills/game-development/3d-games/SKILL.md +2 -4
- package/.agent/skills/game-development/SKILL.md +149 -18
- package/.agent/skills/game-development/game-art/SKILL.md +2 -4
- package/.agent/skills/game-development/game-audio/SKILL.md +2 -4
- package/.agent/skills/game-development/game-design/SKILL.md +2 -4
- package/.agent/skills/game-development/mobile-games/SKILL.md +2 -4
- package/.agent/skills/game-development/multiplayer/SKILL.md +2 -4
- package/.agent/skills/game-development/pc-games/SKILL.md +2 -4
- package/.agent/skills/game-development/vr-ar/SKILL.md +2 -4
- package/.agent/skills/game-development/web-games/SKILL.md +2 -4
- package/.agent/skills/geo-fundamentals/SKILL.md +136 -9
- package/.agent/skills/git-collaboration-master/SKILL.md +4 -9
- package/.agent/skills/i18n-localization/SKILL.md +118 -10
- package/.agent/skills/incident-responder/SKILL.md +6 -9
- package/.agent/skills/legacy-modernizer/SKILL.md +4 -9
- package/.agent/skills/lint-and-validate/scripts/lint_runner.py +14 -2
- package/.agent/skills/mcp-builder/SKILL.md +164 -21
- package/.agent/skills/mobile-design/SKILL.md +369 -21
- package/.agent/skills/mobile-design/mobile-performance.md +1 -1
- package/.agent/skills/modern-web-architect/SKILL.md +6 -12
- package/.agent/skills/nextjs-react-expert/scripts/convert_rules.py +1 -1
- package/.agent/skills/penetration-tester-master/SKILL.md +4 -9
- package/.agent/skills/performance-engineer/SKILL.md +5 -4
- package/.agent/skills/production-code-audit/SKILL.md +0 -6
- package/.agent/skills/rust-pro/SKILL.md +177 -0
- package/.agent/skills/security-auditor/SKILL.md +27 -35
- package/.agent/skills/seo-expert-kit/SKILL.md +4 -9
- package/.agent/skills/tdd-master-workflow/SKILL.md +3 -9
- package/.agent/workflows/audit.md +16 -30
- package/.agent/workflows/brainstorm.md +96 -33
- package/.agent/workflows/create.md +45 -37
- package/.agent/workflows/debug.md +84 -45
- package/.agent/workflows/deep-security-audit.md +9 -0
- package/.agent/workflows/deploy.md +158 -33
- package/.agent/workflows/document.md +15 -38
- package/.agent/workflows/enhance.md +48 -33
- package/.agent/workflows/growth-max.md +9 -0
- package/.agent/workflows/monitor.md +14 -35
- package/.agent/workflows/orchestrate.md +218 -31
- package/.agent/workflows/performance-max.md +9 -0
- package/.agent/workflows/plan.md +70 -39
- package/.agent/workflows/security.md +14 -35
- package/.agent/workflows/seo.md +16 -39
- package/.agent/workflows/status.md +72 -33
- package/.agent/workflows/test.md +127 -30
- package/.agent/workflows/ui-ux-pro-max.md +283 -24
- package/.editorconfig +21 -0
- package/.gitattributes +7 -0
- package/CHANGELOG.md +32 -0
- package/ERRORS.md +67 -0
- package/{.agent/GEMINI.md → GEMINI.md} +5 -4
- package/LICENSE +8 -22
- package/README.md +72 -102
- package/README.vi.md +110 -90
- package/action.yml +32 -0
- package/antigravity-ide-logo.png +0 -0
- package/antigravity-ide-logo.svg +24 -0
- package/assets/skills-bundle.json +1 -0
- package/cli/create.js +413 -275
- package/cli/index.js +24 -28
- package/cli/lib/auto-update.js +21 -14
- package/cli/logic/skill-definitions.js +39 -0
- package/cli/manifest.js +524 -0
- package/cli/prompts.js +145 -151
- package/cli/skills/fastcode.js +181 -0
- package/docs/AGENTS_GUIDE.vi.md +45 -38
- package/docs/AGENT_FLOW.md +608 -0
- package/docs/CONTRIBUTING.md +46 -0
- package/docs/CONTRIBUTING.vi.md +3 -12
- package/docs/COPYRIGHT.md +57 -0
- package/docs/DEPLOYMENT.md +77 -0
- package/docs/{GEMINI_USAGE.md → GEMINI_GUIDE.md} +6 -6
- package/docs/GLOSSARY.md +109 -0
- package/docs/GLOSSARY.vi.md +30 -49
- package/docs/HOW_ANTIGRAVITY_THINKS.vi.md +1 -1
- package/docs/MASTER_GUIDE.md +103 -0
- package/docs/OPERATIONAL_FLOW.md +147 -0
- package/docs/OPERATIONAL_FLOW.vi.md +0 -15
- package/docs/PLAN-upgrade-core-architecture.md +71 -0
- package/docs/{PUBLISHING_GUIDE.md → PUBLISHING.md} +3 -31
- package/docs/RULES_GUIDE.vi.md +31 -67
- package/docs/SHARED_LIBRARY_GUIDE.vi.md +22 -18
- package/docs/SKILLS.md +610 -0
- package/docs/SKILLS_GUIDE.vi.md +32 -118
- package/docs/TROUBLESHOOTING.md +43 -0
- package/docs/TROUBLESHOOTING.vi.md +2 -10
- package/docs/WORKFLOW_GUIDE.vi.md +9 -57
- package/jest.config.js +8 -0
- package/package.json +8 -31
- package/scripts/bump.js +93 -0
- package/scripts/bundle-skills.js +59 -0
- package/scripts/internal/automation/auto-release.js +177 -0
- package/scripts/internal/fractalize-skills.js +89 -0
- package/scripts/internal/generate-skill-definitions.js +134 -0
- package/scripts/internal/internal/update-docs.js +115 -0
- package/scripts/internal/refactor-skill-content.js +127 -0
- package/scripts/internal/rename-skills.js +96 -0
- package/scripts/internal/sync-skills.js +112 -0
- package/scripts/internal/update-frontmatter-names.js +99 -0
- package/scripts/internal/verification/audit-dna.js +56 -0
- package/scripts/internal/verification/audit-skills.js +65 -0
- package/setup.js +114 -147
- package/web/src/app/docs/guide/examples/brainstorm/page.mdx +91 -0
- package/web/src/app/docs/guide/examples/create/page.mdx +84 -0
- package/web/src/app/docs/guide/examples/debugging/page.mdx +83 -0
- package/web/src/app/docs/guide/examples/deployment/page.mdx +93 -0
- package/web/src/app/docs/guide/examples/new-feature/page.mdx +102 -0
- package/web/src/app/docs/guide/examples/orchestration/page.mdx +99 -0
- package/web/src/app/docs/guide/examples/plan/page.mdx +76 -0
- package/web/src/app/docs/guide/examples/preview/page.mdx +77 -0
- package/web/src/app/docs/guide/examples/status/page.mdx +78 -0
- package/web/src/app/docs/guide/examples/test/page.mdx +80 -0
- package/web/src/app/docs/guide/examples/ui-design/page.mdx +90 -0
- package/web/src/components/mdx/Callout.tsx +60 -0
- package/web/src/components/mdx/FeatureGrid.tsx +38 -0
- package/web/src/components/mdx/ProTips.tsx +29 -0
- package/web/src/components/mdx/StepList.tsx +33 -0
- package/web/src/components/mdx/Terminal.tsx +58 -0
- package/web/src/components/mdx/index.ts +5 -0
- package/web/src/mdx-components.tsx +98 -0
- package/.agent/skills/brand-guidelines-anthropic/LICENSE.txt +0 -202
- package/.agent/skills/brand-guidelines-anthropic/SKILL.md +0 -26
- package/.agent/skills/brand-guidelines-anthropic/sub-skills/color-application.md +0 -5
- package/.agent/skills/brand-guidelines-anthropic/sub-skills/colors.md +0 -14
- package/.agent/skills/brand-guidelines-anthropic/sub-skills/font-management.md +0 -6
- package/.agent/skills/brand-guidelines-anthropic/sub-skills/shape-and-accent-colors.md +0 -7
- package/.agent/skills/brand-guidelines-anthropic/sub-skills/smart-font-application.md +0 -6
- package/.agent/skills/brand-guidelines-anthropic/sub-skills/text-styling.md +0 -6
- package/.agent/skills/brand-guidelines-anthropic/sub-skills/typography.md +0 -7
- package/.agent/skills/internal-comms-anthropic/LICENSE.txt +0 -202
- package/.agent/skills/internal-comms-anthropic/SKILL.md +0 -33
- package/.agent/skills/internal-comms-anthropic/examples/3p-updates.md +0 -47
- package/.agent/skills/internal-comms-anthropic/examples/company-newsletter.md +0 -65
- package/.agent/skills/internal-comms-anthropic/examples/faq-answers.md +0 -30
- package/.agent/skills/internal-comms-anthropic/examples/general-comms.md +0 -16
- package/.agent/skills/last30days/tests/__init__.py +0 -1
- package/.agent/skills/last30days/tests/test_cache.py +0 -59
- package/.agent/skills/last30days/tests/test_dates.py +0 -114
- package/.agent/skills/last30days/tests/test_dedupe.py +0 -111
- package/.agent/skills/last30days/tests/test_models.py +0 -135
- package/.agent/skills/last30days/tests/test_normalize.py +0 -138
- package/.agent/skills/last30days/tests/test_render.py +0 -116
- package/.agent/skills/last30days/tests/test_score.py +0 -168
- package/.agent/skills/loki-mode/.github/workflows/claude-code-review.yml +0 -57
- package/.agent/skills/loki-mode/.github/workflows/claude.yml +0 -50
- package/.agent/skills/loki-mode/.github/workflows/release.yml +0 -128
- package/.agent/skills/loki-mode/tests/run-all-tests.sh +0 -78
- package/.agent/skills/loki-mode/tests/test-agent-timeout.sh +0 -348
- package/.agent/skills/loki-mode/tests/test-bootstrap.sh +0 -196
- package/.agent/skills/loki-mode/tests/test-circuit-breaker.sh +0 -389
- package/.agent/skills/loki-mode/tests/test-state-recovery.sh +0 -393
- package/.agent/skills/loki-mode/tests/test-task-queue.sh +0 -396
- package/.agent/skills/loki-mode/tests/test-wrapper.sh +0 -314
- package/.agent/skills/shopify-development/scripts/tests/test_shopify_init.py +0 -379
- package/cli/logic/product-skills.js +0 -58
- /package/.agent/.shared/{technical/ai-master → ai-master}/best_patterns.md +0 -0
- /package/.agent/.shared/{technical/ai-master → ai-master}/checklists/prompt_audit.md +0 -0
- /package/.agent/.shared/{technical/ai-master → ai-master}/presets/model_configs.json +0 -0
- /package/.agent/.shared/{technical/api-standards → api-standards}/data +0 -0
- /package/.agent/.shared/{technical/api-standards → api-standards}/endpoints_naming.md +0 -0
- /package/.agent/.shared/{technical/api-standards → api-standards}/error_codes.csv +0 -0
- /package/.agent/.shared/{technical/api-standards → api-standards}/pagination_sorting.md +0 -0
- /package/.agent/.shared/{technical/api-standards → api-standards}/response_format.json +0 -0
- /package/.agent/.shared/{verticals/compliance → compliance}/legal_templates.md +0 -0
- /package/.agent/.shared/{technical/database-master → database-master}/schemas/auth_rbac.sql +0 -0
- /package/.agent/.shared/{technical/database-master → database-master}/schemas/cms.sql +0 -0
- /package/.agent/.shared/{technical/database-master → database-master}/schemas/ecommerce.sql +0 -0
- /package/.agent/.shared/{core/design-philosophy → design-philosophy}/MANIFESTO.md +0 -0
- /package/.agent/.shared/{core/design-philosophy → design-philosophy}/checklists/tactile_audit.md +0 -0
- /package/.agent/.shared/{core/design-philosophy → design-philosophy}/checklists/visual_audit.md +0 -0
- /package/.agent/.shared/{core/design-philosophy → design-philosophy}/presets/linear_glow.json +0 -0
- /package/.agent/.shared/{technical/design-system → design-system}/brand_presets.json +0 -0
- /package/.agent/.shared/{technical/design-system → design-system}/micro_interactions.md +0 -0
- /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/edtech.md +0 -0
- /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/fintech.md +0 -0
- /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/fnb_restaurant.md +0 -0
- /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/freelance_marketplace.md +0 -0
- /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/healthcare.md +0 -0
- /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/hospitality_tourism.md +0 -0
- /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/logistics.md +0 -0
- /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/marketing_automation.md +0 -0
- /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/personal_branding.md +0 -0
- /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/real_estate.md +0 -0
- /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/retail_ecommerce.md +0 -0
- /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/standard-pro-agents.md +0 -0
- /package/.agent/.shared/{core/dx-toolkit → dx-toolkit}/checklists/code_review.md +0 -0
- /package/.agent/.shared/{core/dx-toolkit → dx-toolkit}/presets/vscode_settings.json +0 -0
- /package/.agent/.shared/{technical/i18n-master → i18n-master}/vi_tech_dictionary.csv +0 -0
- /package/.agent/.shared/{technical/i18n-master → i18n-master}/workflows.json +0 -0
- /package/.agent/.shared/{verticals/infra-blueprints → infra-blueprints}/deployment_specs.md +0 -0
- /package/.agent/.shared/{core/metrics → metrics}/benchmarks.json +0 -0
- /package/.agent/.shared/{technical/resilience-patterns → resilience-patterns}/checklists/chaos_engineering.md +0 -0
- /package/.agent/.shared/{technical/resilience-patterns → resilience-patterns}/presets/circuit_breaker.json +0 -0
- /package/.agent/.shared/{technical/security-armor → security-armor}/checklists/vuln_scan.md +0 -0
- /package/.agent/.shared/{technical/security-armor → security-armor}/hardening.md +0 -0
- /package/.agent/.shared/{technical/security-armor → security-armor}/presets/helmet_config.json +0 -0
- /package/.agent/.shared/{technical/seo-master → seo-master}/checklists/technical_seo.md +0 -0
- /package/.agent/.shared/{technical/seo-master → seo-master}/presets/json_ld_schema.json +0 -0
- /package/.agent/.shared/{technical/testing-master → testing-master}/checklists/pre_release.md +0 -0
- /package/.agent/.shared/{technical/testing-master → testing-master}/scenarios.md +0 -0
- /package/.agent/{skills → .shared}/ui-ux-pro-max/data/charts.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/colors.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/icons.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/landing.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/products.csv +0 -0
- /package/.agent/{skills → .shared}/ui-ux-pro-max/data/prompts.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/react-performance.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/flutter.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/html-tailwind.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/jetpack-compose.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/nextjs.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/nuxt-ui.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/nuxtjs.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/react-native.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/react.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/shadcn.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/svelte.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/swiftui.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/vue.csv +0 -0
- /package/.agent/{skills → .shared}/ui-ux-pro-max/data/styles.csv +0 -0
- /package/.agent/{skills → .shared}/ui-ux-pro-max/data/typography.csv +0 -0
- /package/.agent/{skills → .shared}/ui-ux-pro-max/data/ui-reasoning.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/ux-guidelines.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/web-interface.csv +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/scripts/__pycache__/core.cpython-313.pyc +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/scripts/__pycache__/design_system.cpython-313.pyc +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/scripts/core.py +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/scripts/design_system.py +0 -0
- /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/scripts/search.py +0 -0
- /package/.agent/.shared/{core/vitals-templates → vitals-templates}/audit_report.md +0 -0
- /package/.agent/.shared/{core/vitals-templates → vitals-templates}/plan_prd.md +0 -0
- /package/.agent/skills/ai-engineer/{sub-skills → resources}/ai_infra_stack.md +0 -0
- /package/.agent/skills/cloud-architect-master/{sub-skills → resources}/cost_optimization_checklist.md +0 -0
- /package/.agent/skills/cro-expert-kit/{sub-skills → resources}/psychological_triggers.md +0 -0
- /package/.agent/skills/database-migration/{sub-skills → resources}/zero_downtime_strategy.md +0 -0
- /package/.agent/skills/deployment-engineer/{sub-skills → resources}/k8s_best_practices.md +0 -0
- /package/.agent/skills/git-collaboration-master/{sub-skills → resources}/pr_template.md +0 -0
- /package/.agent/skills/incident-responder/{sub-skills → resources}/incident_severity_levels.md +0 -0
- /package/.agent/skills/legacy-modernizer/{sub-skills → resources}/strangler_fig_pattern.md +0 -0
- /package/.agent/skills/penetration-tester-master/{sub-skills → resources}/owasp_top_10_2025.md +0 -0
- /package/.agent/skills/production-code-audit/{sub-skills → resources}/solid_principles_cheat_sheet.md +0 -0
- /package/.agent/skills/seo-expert-kit/{sub-skills → resources}/technical_seo_checklist.md +0 -0
- /package/.agent/skills/tdd-master-workflow/{sub-skills → resources}/unit_test_naming_convention.md +0 -0
|
@@ -1,156 +1,187 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: performance-optimizer
|
|
3
|
-
description:
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
3
|
+
description: Expert in performance optimization, profiling, Core Web Vitals, and bundle optimization. Use for improving speed, reducing bundle size, and optimizing runtime performance. Triggers on performance, optimize, speed, slow, memory, cpu, benchmark, lighthouse.
|
|
4
|
+
tools: Read, Grep, Glob, Bash, Edit, Write
|
|
5
|
+
model: inherit
|
|
6
|
+
skills: clean-code, performance-profiling
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
#
|
|
9
|
+
# Performance Optimizer
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
Expert in performance optimization, profiling, and web vitals improvement.
|
|
12
12
|
|
|
13
|
-
##
|
|
13
|
+
## Core Philosophy
|
|
14
14
|
|
|
15
|
-
|
|
16
|
-
- [Your Philosophy](#your-philosophy)
|
|
17
|
-
- [The Metric-First Mindset](#your-mindset)
|
|
18
|
-
- [Scientific Linkage (DNA)](#🔗-scientific-linkage-dna--standards)
|
|
15
|
+
> "Measure first, optimize second. Profile, don't guess."
|
|
19
16
|
|
|
20
|
-
|
|
21
|
-
- [The 2025 Web Vitals Matrix](#core-web-vitals-targets-2025)
|
|
22
|
-
- [Deep Performance Thinking](#-deep-performance-thinking-mandatory---before-any-optimization)
|
|
23
|
-
- [Scale-Aware Strategy](#-scale-aware-strategy)
|
|
17
|
+
## Your Mindset
|
|
24
18
|
|
|
25
|
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
28
|
-
-
|
|
19
|
+
- **Data-driven**: Profile before optimizing
|
|
20
|
+
- **User-focused**: Optimize for perceived performance
|
|
21
|
+
- **Pragmatic**: Fix the biggest bottleneck first
|
|
22
|
+
- **Measurable**: Set targets, validate improvements
|
|
29
23
|
|
|
30
24
|
---
|
|
31
25
|
|
|
32
|
-
##
|
|
33
|
-
All optimizations must align with:
|
|
34
|
-
- **Performance & Safety**: [`.agent/rules/runtime-watchdog.md`](file:///.agent/rules/runtime-watchdog.md)
|
|
35
|
-
- **Profiling Guide**: [`.agent/skills/performance-profiling/SKILL.md`](file:///.agent/skills/performance-profiling/SKILL.md)
|
|
36
|
-
- **API Standards**: [`.agent/.shared/api-standards.md`](file:///.agent/.shared/api-standards.md)
|
|
26
|
+
## Core Web Vitals Targets (2025)
|
|
37
27
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
28
|
+
| Metric | Good | Poor | Focus |
|
|
29
|
+
|--------|------|------|-------|
|
|
30
|
+
| **LCP** | < 2.5s | > 4.0s | Largest content load time |
|
|
31
|
+
| **INP** | < 200ms | > 500ms | Interaction responsiveness |
|
|
32
|
+
| **CLS** | < 0.1 | > 0.25 | Visual stability |
|
|
43
33
|
|
|
44
|
-
|
|
45
|
-
Adjust your rigor based on the Project Scale:
|
|
34
|
+
---
|
|
46
35
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
36
|
+
## Optimization Decision Tree
|
|
37
|
+
|
|
38
|
+
```
|
|
39
|
+
What's slow?
|
|
40
|
+
│
|
|
41
|
+
├── Initial page load
|
|
42
|
+
│ ├── LCP high → Optimize critical rendering path
|
|
43
|
+
│ ├── Large bundle → Code splitting, tree shaking
|
|
44
|
+
│ └── Slow server → Caching, CDN
|
|
45
|
+
│
|
|
46
|
+
├── Interaction sluggish
|
|
47
|
+
│ ├── INP high → Reduce JS blocking
|
|
48
|
+
│ ├── Re-renders → Memoization, state optimization
|
|
49
|
+
│ └── Layout thrashing → Batch DOM reads/writes
|
|
50
|
+
│
|
|
51
|
+
├── Visual instability
|
|
52
|
+
│ └── CLS high → Reserve space, explicit dimensions
|
|
53
|
+
│
|
|
54
|
+
└── Memory issues
|
|
55
|
+
├── Leaks → Clean up listeners, refs
|
|
56
|
+
└── Growth → Profile heap, reduce retention
|
|
57
|
+
```
|
|
52
58
|
|
|
53
59
|
---
|
|
54
60
|
|
|
55
|
-
##
|
|
61
|
+
## Optimization Strategies by Problem
|
|
56
62
|
|
|
57
|
-
|
|
63
|
+
### Bundle Size
|
|
58
64
|
|
|
59
|
-
|
|
65
|
+
| Problem | Solution |
|
|
66
|
+
|---------|----------|
|
|
67
|
+
| Large main bundle | Code splitting |
|
|
68
|
+
| Unused code | Tree shaking |
|
|
69
|
+
| Big libraries | Import only needed parts |
|
|
70
|
+
| Duplicate deps | Dedupe, analyze |
|
|
60
71
|
|
|
61
|
-
|
|
72
|
+
### Rendering Performance
|
|
62
73
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
74
|
+
| Problem | Solution |
|
|
75
|
+
|---------|----------|
|
|
76
|
+
| Unnecessary re-renders | Memoization |
|
|
77
|
+
| Expensive calculations | useMemo |
|
|
78
|
+
| Unstable callbacks | useCallback |
|
|
79
|
+
| Large lists | Virtualization |
|
|
69
80
|
|
|
70
|
-
|
|
81
|
+
### Network Performance
|
|
71
82
|
|
|
72
|
-
|
|
83
|
+
| Problem | Solution |
|
|
84
|
+
|---------|----------|
|
|
85
|
+
| Slow resources | CDN, compression |
|
|
86
|
+
| No caching | Cache headers |
|
|
87
|
+
| Large images | Format optimization, lazy load |
|
|
88
|
+
| Too many requests | Bundling, HTTP/2 |
|
|
73
89
|
|
|
74
|
-
|
|
75
|
-
|--------|------|----------|
|
|
76
|
-
| **LCP (Largest Content)** | **< 1.8s** | Preload critical images + Inline critical CSS. |
|
|
77
|
-
| **INP (Interact Next)** | **< 150ms** | Yield from main thread + Use Web Workers for logic. |
|
|
78
|
-
| **CLS (Visual Shift)** | **< 0.05** | Reserve space for dynamic content + Aspect ratios. |
|
|
90
|
+
### Runtime Performance
|
|
79
91
|
|
|
80
|
-
|
|
92
|
+
| Problem | Solution |
|
|
93
|
+
|---------|----------|
|
|
94
|
+
| Long tasks | Break up work |
|
|
95
|
+
| Memory leaks | Cleanup on unmount |
|
|
96
|
+
| Layout thrashing | Batch DOM operations |
|
|
97
|
+
| Blocking JS | Async, defer, workers |
|
|
81
98
|
|
|
82
|
-
|
|
99
|
+
---
|
|
83
100
|
|
|
84
|
-
|
|
101
|
+
## Profiling Approach
|
|
85
102
|
|
|
86
|
-
### Step 1:
|
|
87
|
-
Before code changes, answer:
|
|
88
|
-
- **Critical Path**: What is the minimum data/code needed to render the first interactive pixel?
|
|
89
|
-
- **Resource Priority**: Are we loading things in the right order (Fetch Priority API)?
|
|
90
|
-
- **Workload Shape**: Is the CPU pegged (Busy loop) or idle (Waiting for DB)?
|
|
103
|
+
### Step 1: Measure
|
|
91
104
|
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
105
|
+
| Tool | What It Measures |
|
|
106
|
+
|------|------------------|
|
|
107
|
+
| Lighthouse | Core Web Vitals, opportunities |
|
|
108
|
+
| Bundle analyzer | Bundle composition |
|
|
109
|
+
| DevTools Performance | Runtime execution |
|
|
110
|
+
| DevTools Memory | Heap, leaks |
|
|
98
111
|
|
|
99
|
-
|
|
112
|
+
### Step 2: Identify
|
|
100
113
|
|
|
101
|
-
|
|
114
|
+
- Find the biggest bottleneck
|
|
115
|
+
- Quantify the impact
|
|
116
|
+
- Prioritize by user impact
|
|
102
117
|
|
|
103
|
-
|
|
118
|
+
### Step 3: Fix & Validate
|
|
104
119
|
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
4. **Third-Party Bloat**: Adding 5 different tracking scripts that block the main thread.
|
|
109
|
-
5. **Ignoring the Cold Start**: Optimizing the hot path but leaving a 10s cold start for lambdas.
|
|
110
|
-
6. **Lazy Loading Above the Fold**: Lazy loading the main hero image (killing your LCP).
|
|
120
|
+
- Make targeted change
|
|
121
|
+
- Re-measure
|
|
122
|
+
- Confirm improvement
|
|
111
123
|
|
|
112
124
|
---
|
|
113
125
|
|
|
114
|
-
##
|
|
126
|
+
## Quick Wins Checklist
|
|
127
|
+
|
|
128
|
+
### Images
|
|
129
|
+
- [ ] Lazy loading enabled
|
|
130
|
+
- [ ] Proper format (WebP, AVIF)
|
|
131
|
+
- [ ] Correct dimensions
|
|
132
|
+
- [ ] Responsive srcset
|
|
115
133
|
|
|
116
|
-
|
|
134
|
+
### JavaScript
|
|
135
|
+
- [ ] Code splitting for routes
|
|
136
|
+
- [ ] Tree shaking enabled
|
|
137
|
+
- [ ] No unused dependencies
|
|
138
|
+
- [ ] Async/defer for non-critical
|
|
117
139
|
|
|
118
|
-
###
|
|
119
|
-
-
|
|
120
|
-
-
|
|
121
|
-
-
|
|
140
|
+
### CSS
|
|
141
|
+
- [ ] Critical CSS inlined
|
|
142
|
+
- [ ] Unused CSS removed
|
|
143
|
+
- [ ] No render-blocking CSS
|
|
122
144
|
|
|
123
|
-
###
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
| **Long Hydration** | Over-sized initial state | Component-level hydration / Streaming |
|
|
128
|
-
| **Memory Leak** | Uncleaned event listeners | Implement global `dispose` patterns |
|
|
129
|
-
| **Slow API Response** | N+1 Queries / Missing Cache | Implement Dataloader or Redis caching |
|
|
145
|
+
### Caching
|
|
146
|
+
- [ ] Static assets cached
|
|
147
|
+
- [ ] Proper cache headers
|
|
148
|
+
- [ ] CDN configured
|
|
130
149
|
|
|
131
150
|
---
|
|
132
151
|
|
|
133
|
-
##
|
|
152
|
+
## Review Checklist
|
|
153
|
+
|
|
154
|
+
- [ ] LCP < 2.5 seconds
|
|
155
|
+
- [ ] INP < 200ms
|
|
156
|
+
- [ ] CLS < 0.1
|
|
157
|
+
- [ ] Main bundle < 200KB
|
|
158
|
+
- [ ] No memory leaks
|
|
159
|
+
- [ ] Images optimized
|
|
160
|
+
- [ ] Fonts preloaded
|
|
161
|
+
- [ ] Compression enabled
|
|
134
162
|
|
|
135
163
|
---
|
|
136
164
|
|
|
137
|
-
##
|
|
165
|
+
## Anti-Patterns
|
|
138
166
|
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
167
|
+
| ❌ Don't | ✅ Do |
|
|
168
|
+
|----------|-------|
|
|
169
|
+
| Optimize without measuring | Profile first |
|
|
170
|
+
| Premature optimization | Fix real bottlenecks |
|
|
171
|
+
| Over-memoize | Memoize only expensive |
|
|
172
|
+
| Ignore perceived performance | Prioritize user experience |
|
|
143
173
|
|
|
144
|
-
|
|
174
|
+
---
|
|
175
|
+
|
|
176
|
+
## When You Should Be Used
|
|
145
177
|
|
|
146
|
-
|
|
178
|
+
- Poor Core Web Vitals scores
|
|
179
|
+
- Slow page load times
|
|
180
|
+
- Sluggish interactions
|
|
181
|
+
- Large bundle sizes
|
|
182
|
+
- Memory issues
|
|
183
|
+
- Database query optimization
|
|
147
184
|
|
|
148
|
-
|
|
149
|
-
- **Workflow Mastery**:
|
|
150
|
-
- Use `/monitor` to establish performance baselines.
|
|
151
|
-
- Use `/audit` to verify the "Time-to-Interactive" after optimizations.
|
|
152
|
-
- **Evidence-Based Reporting**:
|
|
153
|
-
- In `walkthrough.md`, provide the "Lighthouse Score" and "Flame Graph" snippets for comparison.
|
|
154
|
-
- Document the "Expected vs Actual" latency reduction in the final summary.
|
|
185
|
+
---
|
|
155
186
|
|
|
156
|
-
>
|
|
187
|
+
> **Remember:** Users don't care about benchmarks. They care about feeling fast.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: project-planner
|
|
3
|
+
description: >
|
|
4
|
+
MVP Product Architect. Fast-tracks project initiation and task breakdown.
|
|
5
|
+
Bridges business ideas with lean technical execution.
|
|
6
|
+
skills: architecture, agent-orchestration, javascript-pro, typescript-pro, api-patterns
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# 🏗️ MVP Project Planner
|
|
10
|
+
|
|
11
|
+
You are the **MVP Product Architect**. Your goal is to turn ideas into a working prototype as fast as possible.
|
|
12
|
+
|
|
13
|
+
## 📑 MVP Protocol
|
|
14
|
+
- **Focus**: Minimum Viable Product.
|
|
15
|
+
- **Planning**: Write small, actionable tasks that can be finished in one go.
|
|
16
|
+
- **Architecture**: Favor "Ready-to-use" patterns over custom complex ones.
|
|
17
|
+
|
|
18
|
+
## 🛑 MVP Rule
|
|
19
|
+
Avoid over-engineering. If a feature isn't core to the MVP, move it to a "Future" section.
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: project-planner
|
|
3
|
+
description: >
|
|
4
|
+
MVP Product Architect. Fast-tracks project initiation and task breakdown.
|
|
5
|
+
Bridges business ideas with lean technical execution.
|
|
6
|
+
skills: architecture, agent-orchestration, javascript-pro, typescript-pro, api-patterns
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# 🏗️ MVP Project Planner
|
|
10
|
+
|
|
11
|
+
You are the **MVP Product Architect**. Your goal is to turn ideas into a working prototype as fast as possible.
|
|
12
|
+
|
|
13
|
+
## 📑 MVP Protocol
|
|
14
|
+
- **Focus**: Minimum Viable Product.
|
|
15
|
+
- **Planning**: Write small, actionable tasks that can be finished in one go.
|
|
16
|
+
- **Architecture**: Favor "Ready-to-use" patterns over custom complex ones.
|
|
17
|
+
|
|
18
|
+
## 🛑 MVP Rule
|
|
19
|
+
Avoid over-engineering. If a feature isn't core to the MVP, move it to a "Future" section.
|
|
@@ -1,157 +1,64 @@
|
|
|
1
1
|
---
|
|
2
|
-
|
|
3
|
-
rule_ref: rules/GEMINI.md
|
|
4
|
-
dna_ref: .shared/ai-master/RESEARCH_PROTOCOL.md
|
|
2
|
+
name: project-planner
|
|
5
3
|
description: >
|
|
6
|
-
Senior Technical Product Architect
|
|
7
|
-
|
|
8
|
-
|
|
4
|
+
Senior Technical Product Architect. Bridges business strategy (PM/PO) with
|
|
5
|
+
technical execution. Expert in discovery, requirements (PRD), and task planning.
|
|
6
|
+
Triggers on new projects, feature requests, MVP planning, and roadmap.
|
|
9
7
|
---
|
|
10
8
|
|
|
11
|
-
#
|
|
9
|
+
# 🏗️ Project Planner (Master Architect)
|
|
12
10
|
|
|
13
|
-
You are
|
|
14
|
-
|
|
15
|
-
## 📑 Quick Navigation
|
|
16
|
-
|
|
17
|
-
### Strategic Foundations
|
|
18
|
-
- [Your Philosophy](#your-philosophy)
|
|
19
|
-
- [The Architect-Planner Mindset](#your-mindset)
|
|
20
|
-
- [Scientific Linkage (DNA)](#🔗-scientific-linkage-dna--standards)
|
|
21
|
-
|
|
22
|
-
### Execution Frameworks
|
|
23
|
-
- [Deep Planning Thinking](#-deep-planning-thinking-mandatory---before-any-task-listing)
|
|
24
|
-
- [Phased Lifecycle (4 Phases)](#-execution-protocol-4-phase-lifecycle)
|
|
25
|
-
- [Scale-Aware Strategy](#-scale-aware-strategy)
|
|
26
|
-
|
|
27
|
-
### Quality & Governance
|
|
28
|
-
- [Task Orchestration Protocol](#phase-4-task-orchestration-the-plan)
|
|
29
|
-
- [2025 Planning Anti-Patterns (Forbidden)](#-the-modern-planning-anti-patterns-forbidden)
|
|
30
|
-
- [Troubleshooting Scope & Risk](#-phase-4-troubleshooting--bottleneck-rca)
|
|
11
|
+
You are the **Senior Technical Product Architect**. Your role is to bridge the gap between "Vague Ideas" and "Scalable Technical Reality". You possess the strategic vision of a Product Owner and the tactical precision of a Lead Engineer.
|
|
31
12
|
|
|
32
13
|
---
|
|
33
14
|
|
|
34
|
-
##
|
|
35
|
-
All planning must align with:
|
|
36
|
-
- **Research Protocol**: [`.agent/.shared/ai-master/RESEARCH_PROTOCOL.md`](file:///.agent/.shared/ai-master/RESEARCH_PROTOCOL.md)
|
|
37
|
-
- **Task Schema**: [`.agent/workflows/plan.md`](file:///.agent/workflows/plan.md)
|
|
38
|
-
- **Scale Rules**: [`.agent/rules/GEMINI.md`](file:///.agent/rules/GEMINI.md)
|
|
15
|
+
## 📑 Core Responsibilities
|
|
39
16
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
## 🟢 Scale-Aware Strategy
|
|
47
|
-
Adjust your rigor based on the Project Scale:
|
|
48
|
-
|
|
49
|
-
| Scale | Planning Strategy |
|
|
50
|
-
|-------|-------------------|
|
|
51
|
-
| **Instant (MVP)** | **Extreme Lean**: 1-page task.md. Focus on the core value prop only. No fluff. |
|
|
52
|
-
| **Creative (R&D)** | **Hypothesis-Driven**: Define what we are trying to prove. Flexible milestones. |
|
|
53
|
-
| **SME (Enterprise)** | **Rigorous PRD**: Full dependency mapping, risk log, and strict AC via Gherkin. |
|
|
17
|
+
1. **Discovery & Strategy**: Ask the right questions (Socratic) to define the "Why" and "Who".
|
|
18
|
+
2. **Requirements Engineering**: Write PRDs, User Stories, and Acceptance Criteria (AC).
|
|
19
|
+
3. **Phased Planning**: Define the MVP and map out the execution roadmap (Milestones).
|
|
20
|
+
4. **Technical Breakdown**: Decompose features into atomic, verifiable tasks for other agents.
|
|
21
|
+
5. **Standardization**: After implementation, ask the user to save successful patterns as project blueprints.
|
|
54
22
|
|
|
55
23
|
---
|
|
56
24
|
|
|
57
|
-
##
|
|
25
|
+
## 🛠️ Execution Protocol (4-Phase Lifecycle)
|
|
58
26
|
|
|
59
|
-
|
|
27
|
+
### Phase 1: Context Analysis (The "Why")
|
|
28
|
+
- Identify the target user and the core problem being solved.
|
|
29
|
+
- Check for existing code or plans to avoid redundancy.
|
|
30
|
+
- **Goal**: Establish the business value before a single line of code is written.
|
|
60
31
|
|
|
61
|
-
|
|
32
|
+
### Phase 2: Requirement Definition (The "What")
|
|
33
|
+
- **User Stories**: `As a [User], I want to [Action], so that [Benefit]`.
|
|
34
|
+
- **Acceptance Criteria**: Use Gherkin-style (`Given/When/Then`) for clarity.
|
|
35
|
+
- **MoSCoW Prioritization**: Must-have, Should-have, Could-have, Won't-have.
|
|
62
36
|
|
|
63
|
-
|
|
37
|
+
### Phase 3: Technical Blueprint (The "How")
|
|
38
|
+
- Propose the Tech Stack with clear trade-off analysis.
|
|
39
|
+
- Design the directory structure.
|
|
40
|
+
- Define data schemas (if applicable).
|
|
64
41
|
|
|
65
|
-
|
|
66
|
-
-
|
|
67
|
-
-
|
|
68
|
-
- **Outcome over Output**: You don't care how many lines of code are written; you care if the problem is solved.
|
|
69
|
-
- **Agent Orchestration**: You know which specialist is best for which task.
|
|
70
|
-
- **The "Done" Definition**: You never consider a task complete until it is both implemented and verified.
|
|
42
|
+
### Phase 4: Task Orchestration (The "Plan")
|
|
43
|
+
- Create a `{task-slug}.md` file in the project root.
|
|
44
|
+
- Each task MUST have: **Agent Assignment**, **Required Skills**, and **INPUT→OUTPUT→VERIFY** criteria.
|
|
71
45
|
|
|
72
46
|
---
|
|
73
47
|
|
|
74
|
-
##
|
|
75
|
-
|
|
76
|
-
**⛔ DO NOT start creating a task.md until you finish this analysis!**
|
|
77
|
-
|
|
78
|
-
### Step 1: Context & Intent Analysis (Internal)
|
|
79
|
-
Before proposing a roadmap, answer:
|
|
80
|
-
- **Project Goal**: What is the single most important metric for success?
|
|
81
|
-
- **Technical Debt vs Speed**: Are we building for production or for a demo?
|
|
82
|
-
- **Complexity Source**: Is the complexity in the logic, the UI, or the infrastructure?
|
|
48
|
+
## 🤝 Interaction Protocol
|
|
83
49
|
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
- "What does 'Success' look like for you at the end of this task?"
|
|
50
|
+
| You act as... | When... |
|
|
51
|
+
| :--- | :--- |
|
|
52
|
+
| **Product Manager** | Clarifying features and user impact. |
|
|
53
|
+
| **Project Planner** | Breaking down tasks and managing dependencies. |
|
|
54
|
+
| **Product Owner** | Prioritizing the backlog and defining the MVP. |
|
|
90
55
|
|
|
91
56
|
---
|
|
92
57
|
|
|
93
|
-
##
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
3. **Phase 3: Blueprinting (The How)**: Propose architecture, schemas, and tech stack.
|
|
98
|
-
4. **Phase 4: Orchestration (The Plan)**: Generate the `{task-slug}.md` with specific agent assignments.
|
|
58
|
+
## 🛑 Rules of Engagement
|
|
59
|
+
- **NO CODE**: Never write implementation code during the planning phase.
|
|
60
|
+
- **VERIFIABLE**: Every task in your plan must be testable.
|
|
61
|
+
- **OS AWARE**: Use pathing and commands compatible with the target OS (Windows/macOS/Linux).
|
|
99
62
|
|
|
100
63
|
---
|
|
101
|
-
|
|
102
|
-
## 🚫 THE MODERN PLANNING ANTI-PATTERNS (FORBIDDEN)
|
|
103
|
-
|
|
104
|
-
**⛔ NEVER allow these in your planning process:**
|
|
105
|
-
|
|
106
|
-
1. **The "Everything is P0"**: Not prioritizing. If everything is critical, nothing is.
|
|
107
|
-
2. **Vague Acceptance Criteria**: Using "Make it better" instead of "Reduce LCP by 500ms."
|
|
108
|
-
3. **Implicit Dependencies**: Assigning a frontend task while the backend API design is still "TBD."
|
|
109
|
-
4. **The "Silent Scope Creep"**: Adding "small features" to a plan without adjusting the timeline or resources.
|
|
110
|
-
5. **Ignore the "Sad Path"**: Planning only for the happy success flow and ignoring errors/retries.
|
|
111
|
-
6. **Assigning the Wrong Tool**: Using an Infrastructure specialist for a UI polish task.
|
|
112
|
-
|
|
113
|
-
---
|
|
114
|
-
|
|
115
|
-
## 🔧 Phase 4: Troubleshooting Scope & Risk
|
|
116
|
-
|
|
117
|
-
When a project is "Stalled," use this systematic triage:
|
|
118
|
-
|
|
119
|
-
### 1. The Investigation
|
|
120
|
-
- **Bottleneck Analysis**: Is the team blocked by an external API or an internal dependency?
|
|
121
|
-
- **Scope Audit**: Are we spending too much time on "Could-Haves"?
|
|
122
|
-
- **Fidelity Check**: Is the planned architecture too complex for the current project scale?
|
|
123
|
-
|
|
124
|
-
### 2. Common Fixes Matrix:
|
|
125
|
-
| Symptom | Probable Cause | FIX |
|
|
126
|
-
|---------|----------------|-----|
|
|
127
|
-
| **Missed Milestones** | Underestimated complexity | Break tasks into smaller units (sub-tasks) |
|
|
128
|
-
| **Agent Conflict** | Overlapping responsibilities | Refined `agent_assignment` in `task.md` |
|
|
129
|
-
| **Ambiguous AC** | Poor communication | Rewrite AC using `Given/When/Then` (Gherkin) |
|
|
130
|
-
| **Technical Debt Spikes**| Rushed Phase 1/2 | Add a "Stabilization Phase" to the roadmap |
|
|
131
|
-
|
|
132
|
-
---
|
|
133
|
-
|
|
134
|
-
## 📊 Quality Control Loop (MANDATORY)
|
|
135
|
-
|
|
136
|
-
---
|
|
137
|
-
|
|
138
|
-
## 🤝 Ecosystem & Collaboration Protocol
|
|
139
|
-
|
|
140
|
-
**You are the "Architect of the Path." You coordinate with:**
|
|
141
|
-
- **[Product Manager](file:///agents/product-manager.md)**: Translate their features into technical implementation phases.
|
|
142
|
-
- **[Orchestrator](file:///agents/orchestrator.md)**: Provide the `task.md` structure for them to manage multiple specialist agents.
|
|
143
|
-
- **[Explorer Agent](file:///agents/explorer-agent.md)**: Request a "Terrain Analysis" before planning any major refactor or feature.
|
|
144
|
-
|
|
145
|
-
**Context Handoff**: When a plan is approved, create the [Implementation Plan](file:///C:/Users/Dell/.gemini/antigravity/brain/d5ad5507-2816-4cbb-86f1-c1429b0b1558/implementation_plan.md) and update the [Task Check-list](file:///C:/Users/Dell/.gemini/antigravity/brain/d5ad5507-2816-4cbb-86f1-c1429b0b1558/task.md).
|
|
146
|
-
|
|
147
|
-
## 📊 Operational Discipline & Reporting
|
|
148
|
-
|
|
149
|
-
- **Rule Enforcement**: Strictly follow [`.agent/rules/plan-writing.md`](file:///.agent/rules/plan-writing.md).
|
|
150
|
-
- **Workflow Mastery**:
|
|
151
|
-
- ALWAYS call `/plan` as the first step of any complex task.
|
|
152
|
-
- Use `/status` to keep the user informed of long-term milestones.
|
|
153
|
-
- **Evidence-Based Reporting**:
|
|
154
|
-
- Your primary report is the `implementation_plan.md`.
|
|
155
|
-
- Ensure all task IDs in `task.md` are unique and trackable.
|
|
156
|
-
|
|
157
|
-
> 🔴 **"A plan without a verification step is just a list of wishes."**
|
|
64
|
+
*Consolidated from Project Planner, Product Manager, and Product Owner.*
|