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.
Files changed (354) hide show
  1. package/.agent/.shared/{technical/ai-master → ai-master}/README.md +1 -12
  2. package/.agent/.shared/{technical/api-standards → api-standards}/README.md +1 -12
  3. package/.agent/.shared/compliance/README.md +19 -0
  4. package/.agent/.shared/{technical/database-master → database-master}/README.md +2 -12
  5. package/.agent/.shared/{core/design-philosophy → design-philosophy}/README.md +1 -12
  6. package/.agent/.shared/design-system/README.md +18 -0
  7. package/.agent/.shared/domain-blueprints/README.md +18 -0
  8. package/.agent/.shared/dx-toolkit/README.md +19 -0
  9. package/.agent/.shared/i18n-master/README.md +18 -0
  10. package/.agent/.shared/infra-blueprints/README.md +18 -0
  11. package/.agent/.shared/metrics/README.md +17 -0
  12. package/.agent/.shared/resilience-patterns/README.md +19 -0
  13. package/.agent/.shared/security-armor/README.md +25 -0
  14. package/.agent/.shared/{technical/seo-master → seo-master}/README.md +1 -12
  15. package/.agent/.shared/testing-master/README.md +20 -0
  16. package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/README.md +1 -12
  17. package/.agent/.shared/vitals-templates/README.md +18 -0
  18. package/.agent/ARCHITECTURE.md +7 -10
  19. package/.agent/ARCHITECTURE.vi.md +8 -8
  20. package/.agent/RESOURCES.md +1 -0
  21. package/.agent/agents/accessibility-expert.md +22 -0
  22. package/.agent/agents/api-architect.md +22 -0
  23. package/.agent/agents/backend-specialist.eco.md +19 -0
  24. package/.agent/agents/backend-specialist.instant.md +19 -0
  25. package/.agent/agents/backend-specialist.md +19 -154
  26. package/.agent/agents/cloud-architect.md +189 -108
  27. package/.agent/agents/codebase-expert.md +23 -0
  28. package/.agent/agents/compliance-expert.md +22 -0
  29. package/.agent/agents/data-scientist.md +22 -0
  30. package/.agent/agents/debugger.eco.md +20 -0
  31. package/.agent/agents/debugger.instant.md +20 -0
  32. package/.agent/agents/debugger.md +182 -83
  33. package/.agent/agents/deep-thinker.ultra.md +23 -0
  34. package/.agent/agents/devex-optimizer.md +22 -0
  35. package/.agent/agents/devops-architect.md +22 -0
  36. package/.agent/agents/documentation-writer.md +72 -125
  37. package/.agent/agents/frontend-specialist.eco.md +19 -0
  38. package/.agent/agents/frontend-specialist.instant.md +19 -0
  39. package/.agent/agents/frontend-specialist.md +7 -40
  40. package/.agent/agents/game-developer.md +116 -111
  41. package/.agent/agents/growth-engineer.md +22 -0
  42. package/.agent/agents/i18n-specialist.md +21 -0
  43. package/.agent/agents/legacy-modernizer.md +22 -0
  44. package/.agent/agents/microservices-specialist.md +22 -0
  45. package/.agent/agents/mobile-developer.md +321 -108
  46. package/.agent/agents/motion-designer.md +22 -0
  47. package/.agent/agents/orchestrator.creative.md +28 -0
  48. package/.agent/agents/orchestrator.eco.md +29 -0
  49. package/.agent/agents/orchestrator.instant.md +29 -0
  50. package/.agent/agents/orchestrator.md +366 -106
  51. package/.agent/agents/orchestrator.ultra.md +28 -0
  52. package/.agent/agents/performance-benchmarker.md +22 -0
  53. package/.agent/agents/performance-optimizer.md +136 -105
  54. package/.agent/agents/project-planner.eco.md +19 -0
  55. package/.agent/agents/project-planner.instant.md +19 -0
  56. package/.agent/agents/project-planner.md +39 -132
  57. package/.agent/agents/quality-inspector.md +32 -136
  58. package/.agent/agents/security-auditor.md +15 -138
  59. package/.agent/agents/security-pentester.md +22 -0
  60. package/.agent/agents/seo-specialist.md +72 -118
  61. package/.agent/agents/serverless-expert.md +22 -0
  62. package/.agent/agents/test-engineer.md +11 -142
  63. package/.agent/fastcode_index.json +1038 -0
  64. package/.agent/mcp_config.json +24 -0
  65. package/.agent/rules/GEMINI.eco.md +37 -0
  66. package/.agent/rules/GEMINI.instant.md +37 -0
  67. package/.agent/rules/GEMINI.md +31 -62
  68. package/.agent/rules/api-spec.md +28 -0
  69. package/.agent/rules/code-quality.md +3 -34
  70. package/.agent/rules/database.md +24 -0
  71. package/.agent/rules/devops.md +23 -0
  72. package/.agent/rules/frontend.md +3 -3
  73. package/.agent/rules/growth-strategy.md +22 -0
  74. package/.agent/rules/logging-monitoring.md +22 -0
  75. package/.agent/rules/quality-assurance.md +22 -0
  76. package/.agent/rules/strict-protocol.md +3 -44
  77. package/.agent/rules/system-reasoning.md +20 -0
  78. package/.agent/rules/system-update.md +3 -56
  79. package/.agent/rules/ui-design.md +23 -0
  80. package/.agent/rules/ux-patterns.md +23 -0
  81. package/.agent/scripts/auto_preview.py +148 -0
  82. package/.agent/scripts/checklist.py +252 -0
  83. package/.agent/scripts/session_manager.py +120 -0
  84. package/.agent/scripts/simulation_install.js +59 -0
  85. package/.agent/scripts/sync_to_global.py +78 -0
  86. package/.agent/scripts/translate_workflows.py +53 -0
  87. package/.agent/scripts/verify_all.py +327 -0
  88. package/.agent/scripts/verify_shared_modules.js +126 -0
  89. package/.agent/skills/agent-backend-patterns/SKILL.md +6 -13
  90. package/.agent/skills/ai-engineer/SKILL.md +16 -29
  91. package/.agent/skills/api-documenter/SKILL.md +4 -4
  92. package/.agent/skills/app-builder/SKILL.md +1 -1
  93. package/.agent/skills/app-builder/tech-stack.md +2 -2
  94. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +79 -39
  95. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +75 -53
  96. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +119 -56
  97. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +94 -61
  98. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +82 -56
  99. package/.agent/skills/cloud-architect-master/SKILL.md +4 -9
  100. package/.agent/skills/cro-expert-kit/SKILL.md +4 -9
  101. package/.agent/skills/database-migration/SKILL.md +3 -9
  102. package/.agent/skills/deployment-engineer/SKILL.md +3 -9
  103. package/.agent/skills/fastcode-search/SKILL.md +46 -0
  104. package/.agent/skills/fastcode-search/fastcode_config.example.json +17 -0
  105. package/.agent/skills/frontend-design/ux-psychology.md +585 -10
  106. package/.agent/skills/frontend-trends-2026/SKILL.md +78 -0
  107. package/.agent/skills/frontend-trends-2026/formulas/BentoGrid.tsx +42 -0
  108. package/.agent/skills/frontend-trends-2026/formulas/LiquidCard.tsx +32 -0
  109. package/.agent/skills/frontend-trends-2026/formulas/NeoButton.tsx +27 -0
  110. package/.agent/skills/full-stack-scaffold/SKILL.md +4 -4
  111. package/.agent/skills/game-development/2d-games/SKILL.md +2 -4
  112. package/.agent/skills/game-development/3d-games/SKILL.md +2 -4
  113. package/.agent/skills/game-development/SKILL.md +149 -18
  114. package/.agent/skills/game-development/game-art/SKILL.md +2 -4
  115. package/.agent/skills/game-development/game-audio/SKILL.md +2 -4
  116. package/.agent/skills/game-development/game-design/SKILL.md +2 -4
  117. package/.agent/skills/game-development/mobile-games/SKILL.md +2 -4
  118. package/.agent/skills/game-development/multiplayer/SKILL.md +2 -4
  119. package/.agent/skills/game-development/pc-games/SKILL.md +2 -4
  120. package/.agent/skills/game-development/vr-ar/SKILL.md +2 -4
  121. package/.agent/skills/game-development/web-games/SKILL.md +2 -4
  122. package/.agent/skills/geo-fundamentals/SKILL.md +136 -9
  123. package/.agent/skills/git-collaboration-master/SKILL.md +4 -9
  124. package/.agent/skills/i18n-localization/SKILL.md +118 -10
  125. package/.agent/skills/incident-responder/SKILL.md +6 -9
  126. package/.agent/skills/legacy-modernizer/SKILL.md +4 -9
  127. package/.agent/skills/lint-and-validate/scripts/lint_runner.py +14 -2
  128. package/.agent/skills/mcp-builder/SKILL.md +164 -21
  129. package/.agent/skills/mobile-design/SKILL.md +369 -21
  130. package/.agent/skills/mobile-design/mobile-performance.md +1 -1
  131. package/.agent/skills/modern-web-architect/SKILL.md +6 -12
  132. package/.agent/skills/nextjs-react-expert/scripts/convert_rules.py +1 -1
  133. package/.agent/skills/penetration-tester-master/SKILL.md +4 -9
  134. package/.agent/skills/performance-engineer/SKILL.md +5 -4
  135. package/.agent/skills/production-code-audit/SKILL.md +0 -6
  136. package/.agent/skills/rust-pro/SKILL.md +177 -0
  137. package/.agent/skills/security-auditor/SKILL.md +27 -35
  138. package/.agent/skills/seo-expert-kit/SKILL.md +4 -9
  139. package/.agent/skills/tdd-master-workflow/SKILL.md +3 -9
  140. package/.agent/workflows/audit.md +16 -30
  141. package/.agent/workflows/brainstorm.md +96 -33
  142. package/.agent/workflows/create.md +45 -37
  143. package/.agent/workflows/debug.md +84 -45
  144. package/.agent/workflows/deep-security-audit.md +9 -0
  145. package/.agent/workflows/deploy.md +158 -33
  146. package/.agent/workflows/document.md +15 -38
  147. package/.agent/workflows/enhance.md +48 -33
  148. package/.agent/workflows/growth-max.md +9 -0
  149. package/.agent/workflows/monitor.md +14 -35
  150. package/.agent/workflows/orchestrate.md +218 -31
  151. package/.agent/workflows/performance-max.md +9 -0
  152. package/.agent/workflows/plan.md +70 -39
  153. package/.agent/workflows/security.md +14 -35
  154. package/.agent/workflows/seo.md +16 -39
  155. package/.agent/workflows/status.md +72 -33
  156. package/.agent/workflows/test.md +127 -30
  157. package/.agent/workflows/ui-ux-pro-max.md +283 -24
  158. package/.editorconfig +21 -0
  159. package/.gitattributes +7 -0
  160. package/CHANGELOG.md +32 -0
  161. package/ERRORS.md +67 -0
  162. package/{.agent/GEMINI.md → GEMINI.md} +5 -4
  163. package/LICENSE +8 -22
  164. package/README.md +72 -102
  165. package/README.vi.md +110 -90
  166. package/action.yml +32 -0
  167. package/antigravity-ide-logo.png +0 -0
  168. package/antigravity-ide-logo.svg +24 -0
  169. package/assets/skills-bundle.json +1 -0
  170. package/cli/create.js +413 -275
  171. package/cli/index.js +24 -28
  172. package/cli/lib/auto-update.js +21 -14
  173. package/cli/logic/skill-definitions.js +39 -0
  174. package/cli/manifest.js +524 -0
  175. package/cli/prompts.js +145 -151
  176. package/cli/skills/fastcode.js +181 -0
  177. package/docs/AGENTS_GUIDE.vi.md +45 -38
  178. package/docs/AGENT_FLOW.md +608 -0
  179. package/docs/CONTRIBUTING.md +46 -0
  180. package/docs/CONTRIBUTING.vi.md +3 -12
  181. package/docs/COPYRIGHT.md +57 -0
  182. package/docs/DEPLOYMENT.md +77 -0
  183. package/docs/{GEMINI_USAGE.md → GEMINI_GUIDE.md} +6 -6
  184. package/docs/GLOSSARY.md +109 -0
  185. package/docs/GLOSSARY.vi.md +30 -49
  186. package/docs/HOW_ANTIGRAVITY_THINKS.vi.md +1 -1
  187. package/docs/MASTER_GUIDE.md +103 -0
  188. package/docs/OPERATIONAL_FLOW.md +147 -0
  189. package/docs/OPERATIONAL_FLOW.vi.md +0 -15
  190. package/docs/PLAN-upgrade-core-architecture.md +71 -0
  191. package/docs/{PUBLISHING_GUIDE.md → PUBLISHING.md} +3 -31
  192. package/docs/RULES_GUIDE.vi.md +31 -67
  193. package/docs/SHARED_LIBRARY_GUIDE.vi.md +22 -18
  194. package/docs/SKILLS.md +610 -0
  195. package/docs/SKILLS_GUIDE.vi.md +32 -118
  196. package/docs/TROUBLESHOOTING.md +43 -0
  197. package/docs/TROUBLESHOOTING.vi.md +2 -10
  198. package/docs/WORKFLOW_GUIDE.vi.md +9 -57
  199. package/jest.config.js +8 -0
  200. package/package.json +8 -31
  201. package/scripts/bump.js +93 -0
  202. package/scripts/bundle-skills.js +59 -0
  203. package/scripts/internal/automation/auto-release.js +177 -0
  204. package/scripts/internal/fractalize-skills.js +89 -0
  205. package/scripts/internal/generate-skill-definitions.js +134 -0
  206. package/scripts/internal/internal/update-docs.js +115 -0
  207. package/scripts/internal/refactor-skill-content.js +127 -0
  208. package/scripts/internal/rename-skills.js +96 -0
  209. package/scripts/internal/sync-skills.js +112 -0
  210. package/scripts/internal/update-frontmatter-names.js +99 -0
  211. package/scripts/internal/verification/audit-dna.js +56 -0
  212. package/scripts/internal/verification/audit-skills.js +65 -0
  213. package/setup.js +114 -147
  214. package/web/src/app/docs/guide/examples/brainstorm/page.mdx +91 -0
  215. package/web/src/app/docs/guide/examples/create/page.mdx +84 -0
  216. package/web/src/app/docs/guide/examples/debugging/page.mdx +83 -0
  217. package/web/src/app/docs/guide/examples/deployment/page.mdx +93 -0
  218. package/web/src/app/docs/guide/examples/new-feature/page.mdx +102 -0
  219. package/web/src/app/docs/guide/examples/orchestration/page.mdx +99 -0
  220. package/web/src/app/docs/guide/examples/plan/page.mdx +76 -0
  221. package/web/src/app/docs/guide/examples/preview/page.mdx +77 -0
  222. package/web/src/app/docs/guide/examples/status/page.mdx +78 -0
  223. package/web/src/app/docs/guide/examples/test/page.mdx +80 -0
  224. package/web/src/app/docs/guide/examples/ui-design/page.mdx +90 -0
  225. package/web/src/components/mdx/Callout.tsx +60 -0
  226. package/web/src/components/mdx/FeatureGrid.tsx +38 -0
  227. package/web/src/components/mdx/ProTips.tsx +29 -0
  228. package/web/src/components/mdx/StepList.tsx +33 -0
  229. package/web/src/components/mdx/Terminal.tsx +58 -0
  230. package/web/src/components/mdx/index.ts +5 -0
  231. package/web/src/mdx-components.tsx +98 -0
  232. package/.agent/skills/brand-guidelines-anthropic/LICENSE.txt +0 -202
  233. package/.agent/skills/brand-guidelines-anthropic/SKILL.md +0 -26
  234. package/.agent/skills/brand-guidelines-anthropic/sub-skills/color-application.md +0 -5
  235. package/.agent/skills/brand-guidelines-anthropic/sub-skills/colors.md +0 -14
  236. package/.agent/skills/brand-guidelines-anthropic/sub-skills/font-management.md +0 -6
  237. package/.agent/skills/brand-guidelines-anthropic/sub-skills/shape-and-accent-colors.md +0 -7
  238. package/.agent/skills/brand-guidelines-anthropic/sub-skills/smart-font-application.md +0 -6
  239. package/.agent/skills/brand-guidelines-anthropic/sub-skills/text-styling.md +0 -6
  240. package/.agent/skills/brand-guidelines-anthropic/sub-skills/typography.md +0 -7
  241. package/.agent/skills/internal-comms-anthropic/LICENSE.txt +0 -202
  242. package/.agent/skills/internal-comms-anthropic/SKILL.md +0 -33
  243. package/.agent/skills/internal-comms-anthropic/examples/3p-updates.md +0 -47
  244. package/.agent/skills/internal-comms-anthropic/examples/company-newsletter.md +0 -65
  245. package/.agent/skills/internal-comms-anthropic/examples/faq-answers.md +0 -30
  246. package/.agent/skills/internal-comms-anthropic/examples/general-comms.md +0 -16
  247. package/.agent/skills/last30days/tests/__init__.py +0 -1
  248. package/.agent/skills/last30days/tests/test_cache.py +0 -59
  249. package/.agent/skills/last30days/tests/test_dates.py +0 -114
  250. package/.agent/skills/last30days/tests/test_dedupe.py +0 -111
  251. package/.agent/skills/last30days/tests/test_models.py +0 -135
  252. package/.agent/skills/last30days/tests/test_normalize.py +0 -138
  253. package/.agent/skills/last30days/tests/test_render.py +0 -116
  254. package/.agent/skills/last30days/tests/test_score.py +0 -168
  255. package/.agent/skills/loki-mode/.github/workflows/claude-code-review.yml +0 -57
  256. package/.agent/skills/loki-mode/.github/workflows/claude.yml +0 -50
  257. package/.agent/skills/loki-mode/.github/workflows/release.yml +0 -128
  258. package/.agent/skills/loki-mode/tests/run-all-tests.sh +0 -78
  259. package/.agent/skills/loki-mode/tests/test-agent-timeout.sh +0 -348
  260. package/.agent/skills/loki-mode/tests/test-bootstrap.sh +0 -196
  261. package/.agent/skills/loki-mode/tests/test-circuit-breaker.sh +0 -389
  262. package/.agent/skills/loki-mode/tests/test-state-recovery.sh +0 -393
  263. package/.agent/skills/loki-mode/tests/test-task-queue.sh +0 -396
  264. package/.agent/skills/loki-mode/tests/test-wrapper.sh +0 -314
  265. package/.agent/skills/shopify-development/scripts/tests/test_shopify_init.py +0 -379
  266. package/cli/logic/product-skills.js +0 -58
  267. /package/.agent/.shared/{technical/ai-master → ai-master}/best_patterns.md +0 -0
  268. /package/.agent/.shared/{technical/ai-master → ai-master}/checklists/prompt_audit.md +0 -0
  269. /package/.agent/.shared/{technical/ai-master → ai-master}/presets/model_configs.json +0 -0
  270. /package/.agent/.shared/{technical/api-standards → api-standards}/data +0 -0
  271. /package/.agent/.shared/{technical/api-standards → api-standards}/endpoints_naming.md +0 -0
  272. /package/.agent/.shared/{technical/api-standards → api-standards}/error_codes.csv +0 -0
  273. /package/.agent/.shared/{technical/api-standards → api-standards}/pagination_sorting.md +0 -0
  274. /package/.agent/.shared/{technical/api-standards → api-standards}/response_format.json +0 -0
  275. /package/.agent/.shared/{verticals/compliance → compliance}/legal_templates.md +0 -0
  276. /package/.agent/.shared/{technical/database-master → database-master}/schemas/auth_rbac.sql +0 -0
  277. /package/.agent/.shared/{technical/database-master → database-master}/schemas/cms.sql +0 -0
  278. /package/.agent/.shared/{technical/database-master → database-master}/schemas/ecommerce.sql +0 -0
  279. /package/.agent/.shared/{core/design-philosophy → design-philosophy}/MANIFESTO.md +0 -0
  280. /package/.agent/.shared/{core/design-philosophy → design-philosophy}/checklists/tactile_audit.md +0 -0
  281. /package/.agent/.shared/{core/design-philosophy → design-philosophy}/checklists/visual_audit.md +0 -0
  282. /package/.agent/.shared/{core/design-philosophy → design-philosophy}/presets/linear_glow.json +0 -0
  283. /package/.agent/.shared/{technical/design-system → design-system}/brand_presets.json +0 -0
  284. /package/.agent/.shared/{technical/design-system → design-system}/micro_interactions.md +0 -0
  285. /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/edtech.md +0 -0
  286. /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/fintech.md +0 -0
  287. /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/fnb_restaurant.md +0 -0
  288. /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/freelance_marketplace.md +0 -0
  289. /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/healthcare.md +0 -0
  290. /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/hospitality_tourism.md +0 -0
  291. /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/logistics.md +0 -0
  292. /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/marketing_automation.md +0 -0
  293. /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/personal_branding.md +0 -0
  294. /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/real_estate.md +0 -0
  295. /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/retail_ecommerce.md +0 -0
  296. /package/.agent/.shared/{verticals/domain-blueprints → domain-blueprints}/standard-pro-agents.md +0 -0
  297. /package/.agent/.shared/{core/dx-toolkit → dx-toolkit}/checklists/code_review.md +0 -0
  298. /package/.agent/.shared/{core/dx-toolkit → dx-toolkit}/presets/vscode_settings.json +0 -0
  299. /package/.agent/.shared/{technical/i18n-master → i18n-master}/vi_tech_dictionary.csv +0 -0
  300. /package/.agent/.shared/{technical/i18n-master → i18n-master}/workflows.json +0 -0
  301. /package/.agent/.shared/{verticals/infra-blueprints → infra-blueprints}/deployment_specs.md +0 -0
  302. /package/.agent/.shared/{core/metrics → metrics}/benchmarks.json +0 -0
  303. /package/.agent/.shared/{technical/resilience-patterns → resilience-patterns}/checklists/chaos_engineering.md +0 -0
  304. /package/.agent/.shared/{technical/resilience-patterns → resilience-patterns}/presets/circuit_breaker.json +0 -0
  305. /package/.agent/.shared/{technical/security-armor → security-armor}/checklists/vuln_scan.md +0 -0
  306. /package/.agent/.shared/{technical/security-armor → security-armor}/hardening.md +0 -0
  307. /package/.agent/.shared/{technical/security-armor → security-armor}/presets/helmet_config.json +0 -0
  308. /package/.agent/.shared/{technical/seo-master → seo-master}/checklists/technical_seo.md +0 -0
  309. /package/.agent/.shared/{technical/seo-master → seo-master}/presets/json_ld_schema.json +0 -0
  310. /package/.agent/.shared/{technical/testing-master → testing-master}/checklists/pre_release.md +0 -0
  311. /package/.agent/.shared/{technical/testing-master → testing-master}/scenarios.md +0 -0
  312. /package/.agent/{skills → .shared}/ui-ux-pro-max/data/charts.csv +0 -0
  313. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/colors.csv +0 -0
  314. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/icons.csv +0 -0
  315. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/landing.csv +0 -0
  316. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/products.csv +0 -0
  317. /package/.agent/{skills → .shared}/ui-ux-pro-max/data/prompts.csv +0 -0
  318. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/react-performance.csv +0 -0
  319. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/flutter.csv +0 -0
  320. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/html-tailwind.csv +0 -0
  321. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/jetpack-compose.csv +0 -0
  322. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/nextjs.csv +0 -0
  323. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/nuxt-ui.csv +0 -0
  324. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/nuxtjs.csv +0 -0
  325. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/react-native.csv +0 -0
  326. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/react.csv +0 -0
  327. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/shadcn.csv +0 -0
  328. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/svelte.csv +0 -0
  329. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/swiftui.csv +0 -0
  330. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/stacks/vue.csv +0 -0
  331. /package/.agent/{skills → .shared}/ui-ux-pro-max/data/styles.csv +0 -0
  332. /package/.agent/{skills → .shared}/ui-ux-pro-max/data/typography.csv +0 -0
  333. /package/.agent/{skills → .shared}/ui-ux-pro-max/data/ui-reasoning.csv +0 -0
  334. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/ux-guidelines.csv +0 -0
  335. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/data/web-interface.csv +0 -0
  336. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/scripts/__pycache__/core.cpython-313.pyc +0 -0
  337. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/scripts/__pycache__/design_system.cpython-313.pyc +0 -0
  338. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/scripts/core.py +0 -0
  339. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/scripts/design_system.py +0 -0
  340. /package/.agent/.shared/{technical/ui-ux-pro-max → ui-ux-pro-max}/scripts/search.py +0 -0
  341. /package/.agent/.shared/{core/vitals-templates → vitals-templates}/audit_report.md +0 -0
  342. /package/.agent/.shared/{core/vitals-templates → vitals-templates}/plan_prd.md +0 -0
  343. /package/.agent/skills/ai-engineer/{sub-skills → resources}/ai_infra_stack.md +0 -0
  344. /package/.agent/skills/cloud-architect-master/{sub-skills → resources}/cost_optimization_checklist.md +0 -0
  345. /package/.agent/skills/cro-expert-kit/{sub-skills → resources}/psychological_triggers.md +0 -0
  346. /package/.agent/skills/database-migration/{sub-skills → resources}/zero_downtime_strategy.md +0 -0
  347. /package/.agent/skills/deployment-engineer/{sub-skills → resources}/k8s_best_practices.md +0 -0
  348. /package/.agent/skills/git-collaboration-master/{sub-skills → resources}/pr_template.md +0 -0
  349. /package/.agent/skills/incident-responder/{sub-skills → resources}/incident_severity_levels.md +0 -0
  350. /package/.agent/skills/legacy-modernizer/{sub-skills → resources}/strangler_fig_pattern.md +0 -0
  351. /package/.agent/skills/penetration-tester-master/{sub-skills → resources}/owasp_top_10_2025.md +0 -0
  352. /package/.agent/skills/production-code-audit/{sub-skills → resources}/solid_principles_cheat_sheet.md +0 -0
  353. /package/.agent/skills/seo-expert-kit/{sub-skills → resources}/technical_seo_checklist.md +0 -0
  354. /package/.agent/skills/tdd-master-workflow/{sub-skills → resources}/unit_test_naming_convention.md +0 -0
@@ -1,66 +1,65 @@
1
1
  ---
2
2
  name: nuxt-app
3
- description: Nuxt 3 full-stack template. Vue 3, Pinia, Tailwind, Prisma.
3
+ description: Nuxt 4 full-stack template. Vue 3 (Vapor), Pinia, Tailwind v4, Prisma.
4
4
  ---
5
5
 
6
- # Nuxt 3 Full-Stack Template
6
+ # Nuxt 4 Full-Stack Template (2026 Edition)
7
+
8
+ Mẫu template Full-Stack hiện đại cho Nuxt 4, tối ưu hóa hiệu suất với Vue Vapor Mode và Tailwind v4.
7
9
 
8
10
  ## Tech Stack
9
11
 
10
- | Component | Technology |
11
- |-----------|------------|
12
- | Framework | Nuxt 3 |
13
- | Language | TypeScript |
14
- | UI | Vue 3 (Composition API) |
15
- | State | Pinia |
16
- | Database | PostgreSQL + Prisma |
17
- | Styling | Tailwind CSS |
18
- | Validation | Zod |
12
+ | Component | Technology | Version / Notes |
13
+ |-----------|------------|-----------------|
14
+ | Framework | Nuxt | v4.0+ (App Directory structure) |
15
+ | UI Engine | Vue | v3.6+ (Vapor Mode enabled) |
16
+ | Language | TypeScript | v5+ (Strict Mode) |
17
+ | State | Pinia | v3+ (Store syntax) |
18
+ | Database | PostgreSQL | Prisma ORM |
19
+ | Styling | Tailwind CSS | v4.0 (Vite Plugin, Zero-config) |
20
+ | UI Lib | Nuxt UI | v3 (Tailwind v4 native) |
21
+ | Validation | Zod | Schema validation |
19
22
 
20
23
  ---
21
24
 
22
- ## Directory Structure
25
+ ## Directory Structure (Nuxt 4 Standard)
26
+
27
+ Sử dụng cấu trúc `app/` để giữ thư mục gốc gọn gàng.
23
28
 
24
29
  ```
25
30
  project-name/
31
+ ├── app/ # Application Source
32
+ │ ├── assets/
33
+ │ │ └── css/
34
+ │ │ └── main.css # Tailwind v4 imports
35
+ │ ├── components/ # Auto-imported components
36
+ │ ├── composables/ # Auto-imported logic
37
+ │ ├── layouts/
38
+ │ ├── pages/ # File-based routing
39
+ │ ├── app.vue # Root component
40
+ │ └── router.options.ts
41
+ ├── server/ # Nitro Server Engine
42
+ │ ├── api/ # API Routes (e.g. /api/users)
43
+ │ ├── routes/ # Server Routes
44
+ │ └── utils/ # Server-only helpers (Prisma)
26
45
  ├── prisma/
27
46
  │ └── schema.prisma
28
- ├── server/
29
- ├── api/
30
- │ │ └── [resource]/
31
- │ │ └── index.ts
32
- │ └── utils/
33
- │ └── db.ts # Prisma client
34
- ├── composables/
35
- │ └── useAuth.ts
36
- ├── stores/
37
- │ └── user.ts # Pinia store
38
- ├── components/
39
- │ └── ui/
40
- ├── pages/
41
- │ ├── index.vue
42
- │ └── [...slug].vue
43
- ├── layouts/
44
- │ └── default.vue
45
- ├── assets/
46
- │ └── css/
47
- │ └── main.css
48
- ├── .env.example
49
- ├── nuxt.config.ts
47
+ ├── public/
48
+ ├── nuxt.config.ts # Main Config
50
49
  └── package.json
51
50
  ```
52
51
 
53
52
  ---
54
53
 
55
- ## Key Concepts
54
+ ## Key Concepts (2026)
56
55
 
57
- | Concept | Description |
58
- |---------|-------------|
59
- | Auto-imports | Components, composables, utils |
60
- | File-based routing | pages/ routes |
61
- | Server Routes | server/api/ API endpoints |
62
- | Composables | Reusable reactive logic |
63
- | Pinia | State management |
56
+ | Concept | Description | Future Update |
57
+ |---------|-------------|---------------|
58
+ | **App Directory** | `app/` | Tách biệt mã nguồn ứng dụng và file cấu hình root. |
59
+ | **Vapor Mode** | Opt-in performance | Render không cần Virtual DOM (như SolidJS). Bật trong `nuxt.config`. |
60
+ | **Server Functions** | RPC-style calls | Gọi hàm server trực tiếp từ client (thay thế dần API routes thủ công). |
61
+ | **Tailwind v4** | CSS-first | Cấu hình theme trực tiếp trong CSS, không cần `tailwind.config.js`. |
62
+ | **Nuxt Islands** | Server Components | Render component cô lập trên server (`<NuxtIsland name="..." />`). |
64
63
 
65
64
  ---
66
65
 
@@ -68,34 +67,68 @@ project-name/
68
67
 
69
68
  | Variable | Purpose |
70
69
  |----------|---------|
71
- | DATABASE_URL | Prisma connection |
72
- | NUXT_PUBLIC_APP_URL | Public URL |
70
+ | DATABASE_URL | Prisma connection string (PostgreSQL) |
71
+ | NUXT_PUBLIC_APP_URL | Canonical URL |
72
+ | NUXT_SESSION_PASSWORD | Session encryption key |
73
73
 
74
74
  ---
75
75
 
76
76
  ## Setup Steps
77
77
 
78
- 1. `npx nuxi@latest init {{name}}`
79
- 2. `cd {{name}}`
80
- 3. `npm install @pinia/nuxt @prisma/client prisma zod`
81
- 4. `npm install -D @nuxtjs/tailwindcss`
82
- 5. Add modules to `nuxt.config.ts`:
78
+ 1. Initialize Project:
79
+ ```bash
80
+ npx nuxi@latest init my-app
81
+ # Select "Nuxt 4 structure" if prompted
82
+ ```
83
+
84
+ 2. Install Core Deps:
85
+ ```bash
86
+ npm install @pinia/nuxt @prisma/client zod
87
+ npm install -D prisma
88
+ ```
89
+
90
+ 3. Setup Tailwind v4:
91
+ Install the Vite plugin (new standard):
92
+ ```bash
93
+ npm install tailwindcss @tailwindcss/vite
94
+ ```
95
+
96
+ Add to `nuxt.config.ts`:
83
97
  ```ts
84
- modules: ['@pinia/nuxt', '@nuxtjs/tailwindcss']
98
+ import tailwindcss from '@tailwindcss/vite'
99
+ export default defineNuxtConfig({
100
+ vite: {
101
+ plugins: [tailwindcss()]
102
+ },
103
+ css: ['~/assets/css/main.css']
104
+ })
105
+ ```
106
+
107
+ 4. Configure CSS:
108
+ In `app/assets/css/main.css`:
109
+ ```css
110
+ @import "tailwindcss";
111
+ @theme {
112
+ --color-primary: oklch(0.6 0.15 150);
113
+ }
114
+ ```
115
+
116
+ 5. Run Development:
117
+ ```bash
118
+ npm run dev
119
+ # Runs with Turbo/Vite
85
120
  ```
86
- 6. `npx prisma init`
87
- 7. Configure schema
88
- 8. `npx prisma db push`
89
- 9. `npm run dev`
90
121
 
91
122
  ---
92
123
 
93
124
  ## Best Practices
94
125
 
95
- - Use `<script setup>` for components
96
- - Composables for reusable logic
97
- - Pinia stores in `stores/` folder
98
- - Server routes for API logic
99
- - Auto-import for clean code
100
- - TypeScript for type safety
101
- - See `@[skills/vue-expert]` for Vue patterns
126
+ - **Vapor Mode**: Kích hoạt cho các component nặng về render:
127
+ ```ts
128
+ <script setup lang="ts" vapor>
129
+ // Component này sẽ compile sang chế độ Vapor (No VDOM)
130
+ </script>
131
+ ```
132
+ - **Data Fetching**: Sử dụng `useFetch` với `server: false` cho các tác vụ client-only, hoặc dùng Server Functions để type-safety tốt hơn.
133
+ - **State**: Dùng `defineStore` (Pinia) cho global state, `useState` của Nuxt cho state đơn giản chia sẻ giữa Server/Client.
134
+ - **Type Safety**: Tự động tạo type cho API routes (`$fetch` typed automatically).
@@ -3,91 +3,117 @@ name: react-native-app
3
3
  description: React Native mobile app template principles. Expo, TypeScript, navigation.
4
4
  ---
5
5
 
6
- # React Native App Template
6
+ # React Native App Template (2026 Edition)
7
+
8
+ Modern mobile app template, optimized for New Architecture and React 19.
7
9
 
8
10
  ## Tech Stack
9
11
 
10
- | Component | Technology |
11
- |-----------|------------|
12
- | Framework | React Native + Expo |
13
- | Language | TypeScript |
14
- | Navigation | Expo Router |
15
- | State | Zustand + React Query |
16
- | Styling | NativeWind |
17
- | Testing | Jest + RNTL |
12
+ | Component | Technology | Version / Notes |
13
+ |-----------|------------|-----------------|
14
+ | Core | React Native + Expo | SDK 52+ (New Architecture Enabled) |
15
+ | Language | TypeScript | v5+ (Strict Mode) |
16
+ | UI Logic | React | v19 (React Compiler, auto-memoization) |
17
+ | Navigation | Expo Router | v4+ (File-based, Universal Links) |
18
+ | Styling | NativeWind | v4.0 (Tailwind v4, CSS-first config) |
19
+ | State | Zustand + React Query | v5+ (Async State Management) |
20
+ | Storage | Expo SecureStore | Encrypted local storage |
18
21
 
19
22
  ---
20
23
 
21
24
  ## Directory Structure
22
25
 
26
+ Standardized structure for Expo Router and NativeWind v4.
27
+
23
28
  ```
24
29
  project-name/
25
- ├── app/ # Expo Router (file-based)
26
- │ ├── _layout.tsx # Root layout
27
- │ ├── index.tsx # Home
28
- │ ├── (tabs)/ # Tab navigation
29
- └── [id].tsx # Dynamic route
30
+ ├── app/ # Expo Router (File-based routing)
31
+ │ ├── _layout.tsx # Root Layout (Stack/Tabs config)
32
+ │ ├── index.tsx # Main Screen
33
+ │ ├── (tabs)/ # Route Group for Tab Bar
34
+ │ ├── _layout.tsx
35
+ │ │ ├── home.tsx
36
+ │ │ └── profile.tsx
37
+ │ ├── +not-found.tsx # 404 Page
38
+ │ └── [id].tsx # Dynamic Route (Typed)
30
39
  ├── components/
31
- │ ├── ui/ # Reusable
32
- │ └── features/
33
- ├── hooks/
40
+ │ ├── ui/ # Primitive Components (Button, Text)
41
+ │ └── features/ # Complex Components
42
+ ├── hooks/ # Custom Hooks
34
43
  ├── lib/
35
- │ ├── api.ts
36
- │ └── storage.ts
37
- ├── store/
38
- ├── constants/
39
- └── app.json
44
+ │ ├── api.ts # Axios/Fetch client
45
+ │ └── storage.ts # SecureStore wrapper
46
+ ├── store/ # Zustand stores
47
+ ├── constants/ # Colors, Theme config
48
+ ├── assets/ # Fonts, Images
49
+ ├── global.css # Entry point for NativeWind v4
50
+ ├── tailwind.config.ts # Tailwind Config (if custom theme needed)
51
+ ├── babel.config.js # NativeWind Babel Plugin
52
+ └── app.json # Expo Config
40
53
  ```
41
54
 
42
55
  ---
43
56
 
44
- ## Navigation Patterns
57
+ ## Navigation Patterns (Expo Router)
45
58
 
46
- | Pattern | Use |
47
- |---------|-----|
48
- | Stack | Page hierarchy |
49
- | Tabs | Bottom navigation |
50
- | Drawer | Side menu |
51
- | Modal | Overlay screens |
59
+ | Pattern | Description | Implement |
60
+ |---------|-------------|-----------|
61
+ | Stack | Hierarchical navigation (Push/Pop) | `<Stack />` in `_layout.tsx` |
62
+ | Tabs | Bottom navigation bar | `<Tabs />` in `(tabs)/_layout.tsx` |
63
+ | Drawer | Side slide-out menu | `expo-router/drawer` |
64
+ | Modals | Overlay screens | `presentation: 'modal'` in Stack screen |
52
65
 
53
66
  ---
54
67
 
55
- ## State Management
68
+ ## Key Packages & Purpose
56
69
 
57
- | Type | Tool |
58
- |------|------|
59
- | Local | Zustand |
60
- | Server | React Query |
61
- | Forms | React Hook Form |
62
- | Storage | Expo SecureStore |
70
+ | Package | Purpose |
71
+ |---------|---------|
72
+ | expo-router | File-based routing (Next.js like) |
73
+ | nativewind | Use Tailwind CSS classes in React Native |
74
+ | react-native-reanimated | Smooth animations (runs on UI thread) |
75
+ | @tanstack/react-query | Server state management, caching, pre-fetching |
76
+ | zustand | Global state management (lighter than Redux) |
77
+ | expo-image | Optimized image rendering for performance |
63
78
 
64
79
  ---
65
80
 
66
- ## Key Packages
81
+ ## Setup Steps (2026 Standard)
67
82
 
68
- | Package | Purpose |
69
- |---------|---------|
70
- | expo-router | File-based routing |
71
- | zustand | Local state |
72
- | @tanstack/react-query | Server state |
73
- | nativewind | Tailwind styling |
74
- | expo-secure-store | Secure storage |
83
+ 1. Initialize Project:
84
+ ```bash
85
+ npx create-expo-app@latest my-app --template default
86
+ cd my-app
87
+ ```
75
88
 
76
- ---
89
+ 2. Install Core Dependencies:
90
+ ```bash
91
+ npx expo install expo-router react-native-safe-area-context react-native-screens expo-link expo-constants expo-status-bar
92
+ ```
93
+
94
+ 3. Install NativeWind v4:
95
+ ```bash
96
+ npm install nativewind tailwindcss react-native-reanimated
97
+ ```
77
98
 
78
- ## Setup Steps
99
+ 4. Configure NativeWind (Babel & CSS):
100
+ - Add plugin to `babel.config.js`: `plugins: ["nativewind/babel"]`.
101
+ - Create `global.css` with: `@import "tailwindcss";`.
102
+ - Import `global.css` in `app/_layout.tsx`.
79
103
 
80
- 1. `npx create-expo-app {{name}} -t expo-template-blank-typescript`
81
- 2. `npx expo install expo-router react-native-safe-area-context`
82
- 3. Install state: `npm install zustand @tanstack/react-query`
83
- 4. `npx expo start`
104
+ 5. Run Project:
105
+ ```bash
106
+ npx expo start -c
107
+ # Press 'i' for iOS simulator or 'a' for Android emulator
108
+ ```
84
109
 
85
110
  ---
86
111
 
87
- ## Best Practices
112
+ ## Best Practices (Updated)
88
113
 
89
- - Expo Router for navigation
90
- - Zustand for local, React Query for server state
91
- - NativeWind for consistent styling
92
- - Expo SecureStore for tokens
93
- - Test on both iOS and Android
114
+ - **New Architecture**: Ensure `newArchEnabled: true` in `app.json` to leverage TurboModules and Fabric Renderer.
115
+ - **Typed Routes**: Use Expo Router's "Typed Routes" feature for type-safe routing (e.g., `router.push('/path')`).
116
+ - **React 19**: Reduce usage of `useMemo` or `useCallback` thanks to React Compiler (if enabled).
117
+ - **Components**: Build UI primitives (Box, Text) with NativeWind className for reusability.
118
+ - **Assets**: Use `expo-image` instead of default `<Image />` for better caching and performance.
119
+ - **API**: Always wrap API calls with TanStack Query, avoid direct calls in `useEffect`.
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  name: cloud-architect-master
3
- description: Elite Cloud and Multi-Cloud Architect Master Skill.
4
- category: infrastructure
5
- version: 4.1.0-fractal
6
- layer: master-skill
3
+ description: >
4
+ Elite Cloud and Multi-Cloud Architect Master Skill. Covers AWS/Azure/GCP, hybrid clouds,
5
+ cloud-native networking, security audits, and infrastructure cost optimization.
6
+ Replaces all fragmented cloud architecture skills.
7
7
  ---
8
8
 
9
9
  # ☁️ Cloud Architect Master Kit
@@ -70,8 +70,3 @@ You are a **Principal Cloud Architect and Infrastructure Engineer**. You design
70
70
 
71
71
  ---
72
72
  *Merged and optimized from 5 legacy cloud architecture and networking skills.*
73
-
74
-
75
- ## 🧠 Knowledge Modules (Fractal Skills)
76
-
77
- ### 1. [cost_optimization_checklist](./sub-skills/cost_optimization_checklist.md)
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  name: cro-expert-kit
3
- description: Elite Conversion Rate Optimization Toolkit.
4
- category: marketing
5
- version: 4.1.0-fractal
6
- layer: master-skill
3
+ description: >
4
+ Elite Conversion Rate Optimization Toolkit. Covers Page CRO, Signup Flows,
5
+ Onboarding, Form Optimization, Paywalls, and Popups. Focuses on psychological
6
+ leverage and friction reduction to increase revenue and retention.
7
7
  ---
8
8
 
9
9
  # 📈 CRO Expert Kit (Master Skill)
@@ -80,8 +80,3 @@ You are an **Elite Growth Engineer and CRO Specialist**. Your mission is to iden
80
80
 
81
81
  ---
82
82
  *Merged and optimized from 6 legacy conversion optimization skills.*
83
-
84
-
85
- ## 🧠 Knowledge Modules (Fractal Skills)
86
-
87
- ### 1. [psychological_triggers](./sub-skills/psychological_triggers.md)
@@ -1,9 +1,8 @@
1
1
  ---
2
2
  name: database-migration
3
- description: MASTER DB: Zero-Downtime, Schema Design (3NF), SQL/NoSQL.
4
- category: database
5
- version: 4.1.0-fractal
6
- layer: master-skill
3
+ description: >
4
+ MASTER DB: Zero-Downtime, Schema Design (3NF), SQL/NoSQL, Data Sync,
5
+ Rollback strategies. Use for DB changes, migrations, and performance tuning.
7
6
  ---
8
7
 
9
8
  # 🗄️ Database Migration Master Skill
@@ -23,8 +22,3 @@ You are a **Senior Database Administrator and Schema Architect**. You ensure dat
23
22
 
24
23
  ---
25
24
  *Merged and optimized from 3 legacy database migration skills.*
26
-
27
-
28
- ## 🧠 Knowledge Modules (Fractal Skills)
29
-
30
- ### 1. [zero_downtime_strategy](./sub-skills/zero_downtime_strategy.md)
@@ -1,9 +1,8 @@
1
1
  ---
2
2
  name: deployment-engineer
3
- description: MASTER DEPLOY: CI/CD Pipelines, Docker, K8s, GitOps.
4
- category: infrastructure
5
- version: 4.1.0-fractal
6
- layer: master-skill
3
+ description: >
4
+ MASTER DEPLOY: CI/CD Pipelines, Docker, K8s, GitOps (Flux/ArgoCD),
5
+ Progressive Delivery (Canary). Use for Infra setup, pipelines, and releases.
7
6
  ---
8
7
 
9
8
  # 🛳️ Deployment & Infrastructure Master
@@ -23,8 +22,3 @@ You are an **Elite Platform Engineer and DevOps Specialist**. You build robust,
23
22
 
24
23
  ---
25
24
  *Merged and optimized from 5 legacy deployment and DevOps skills.*
26
-
27
-
28
- ## 🧠 Knowledge Modules (Fractal Skills)
29
-
30
- ### 1. [k8s_best_practices](./sub-skills/k8s_best_practices.md)
@@ -0,0 +1,46 @@
1
+ ---
2
+ name: fastcode-search
3
+ description: Native Node.js semantic search for Agent. No external dependencies.
4
+ category: research-analysis
5
+ version: 2.0.0
6
+ layer: core-skill
7
+ ---
8
+
9
+ # FastCode Search (Native)
10
+
11
+ > **Core Capability**: Lightning-fast codebase navigation using local Node.js indexing.
12
+ > **Zero Cost**: Runs locally. No API calls.
13
+
14
+ ## 🤖 Agent Instructions (MANDATORY)
15
+
16
+ **Rule: BEFORE reading any file content to understand logic, you MUST use FastCode.**
17
+
18
+ ### 1. When to use?
19
+ - User asks "Where is the login logic?"
20
+ - You need to fix a bug but don't know the exact file.
21
+ - You want to understand the project structure.
22
+
23
+ ### 2. How to use?
24
+ Run the internal Node.js script. **Do not ask user to install anything.**
25
+
26
+ #### Step 1: Search
27
+ ```bash
28
+ node cli/skills/fastcode.js search "your_query_here"
29
+ ```
30
+
31
+ #### Step 2: Analyze Results
32
+ The script returns a JSON list of most relevant files.
33
+ - **Action**: Read ONLY the top 1-3 files returned.
34
+ - **Benefit**: Saves tokens (don't read the whole repo).
35
+
36
+ ### 3. Maintenance (Auto-Index)
37
+ If search returns nothing or "Index not found", run indexing first:
38
+ ```bash
39
+ node cli/skills/fastcode.js index
40
+ ```
41
+
42
+ ---
43
+
44
+ ## 🛠️ For Humans (Optional)
45
+ You can also run this manually if you want:
46
+ `node cli/skills/fastcode.js search "auth"`
@@ -0,0 +1,17 @@
1
+ {
2
+ "note": "FastCode configuration template. Use environment variables for current version.",
3
+ "llm": {
4
+ "provider_options": ["openai", "ollama", "openrouter"],
5
+ "defaults": {
6
+ "ollama": {
7
+ "base_url": "http://localhost:11434/v1",
8
+ "api_key": "ollama",
9
+ "model": "qwen2.5-coder"
10
+ },
11
+ "openrouter": {
12
+ "base_url": "https://openrouter.ai/api/v1",
13
+ "model": "google/gemini-2.0-flash-exp:free"
14
+ }
15
+ }
16
+ }
17
+ }