ai-qakit 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +240 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +208 -0
- package/dist/commands/clean.d.ts +10 -0
- package/dist/commands/clean.js +53 -0
- package/dist/commands/init.d.ts +20 -0
- package/dist/commands/init.js +195 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.js +2 -0
- package/dist/utils/file-operations.d.ts +18 -0
- package/dist/utils/file-operations.js +79 -0
- package/dist/utils/git.d.ts +4 -0
- package/dist/utils/git.js +27 -0
- package/dist/utils/index.d.ts +5 -0
- package/dist/utils/index.js +5 -0
- package/dist/utils/logger.d.ts +22 -0
- package/dist/utils/logger.js +23 -0
- package/dist/utils/manifest.d.ts +37 -0
- package/dist/utils/manifest.js +120 -0
- package/dist/utils/package.d.ts +19 -0
- package/dist/utils/package.js +47 -0
- package/package.json +61 -0
- package/templates/.antigravity/agents/qa-agents.yaml +50 -0
- package/templates/.antigravity/prompts/qa-prompts.md +56 -0
- package/templates/.claude/.scoutignore +33 -0
- package/templates/.claude/CHANGELOG.md +587 -0
- package/templates/.claude/CLAUDE.md +335 -0
- package/templates/.claude/README.md +428 -0
- package/templates/.claude/TROUBLESHOOTING.md +789 -0
- package/templates/.claude/agents/accessibility-tester.md +29 -0
- package/templates/.claude/agents/api-tester.md +29 -0
- package/templates/.claude/agents/automation-engineer.md +30 -0
- package/templates/.claude/agents/brainstormer.md +123 -0
- package/templates/.claude/agents/bug-hunter.md +30 -0
- package/templates/.claude/agents/claude-optimizer.md +221 -0
- package/templates/.claude/agents/code-reviewer.md +176 -0
- package/templates/.claude/agents/code-simplifier.md +103 -0
- package/templates/.claude/agents/coder.md +163 -0
- package/templates/.claude/agents/context-manager.md +110 -0
- package/templates/.claude/agents/cunningham.md +134 -0
- package/templates/.claude/agents/database-admin.md +112 -0
- package/templates/.claude/agents/debugger.md +156 -0
- package/templates/.claude/agents/docs-manager.md +181 -0
- package/templates/.claude/agents/e2e-tester.md +30 -0
- package/templates/.claude/agents/performance-engineer.md +48 -0
- package/templates/.claude/agents/performance-tester.md +29 -0
- package/templates/.claude/agents/planner.md +72 -0
- package/templates/.claude/agents/project-manager.md +152 -0
- package/templates/.claude/agents/qa-scout.md +29 -0
- package/templates/.claude/agents/quality-engineer.md +48 -0
- package/templates/.claude/agents/readme-writer.md +67 -0
- package/templates/.claude/agents/researcher.md +57 -0
- package/templates/.claude/agents/scout.md +125 -0
- package/templates/.claude/agents/security-agent.md +564 -0
- package/templates/.claude/agents/security-tester.md +29 -0
- package/templates/.claude/agents/storage-path-convention.md +102 -0
- package/templates/.claude/agents/tattletale-reporter.md +77 -0
- package/templates/.claude/agents/test-architect.md +32 -0
- package/templates/.claude/agents/test-reviewer.md +29 -0
- package/templates/.claude/agents/tester.md +286 -0
- package/templates/.claude/agents/typescript-pro.md +280 -0
- package/templates/.claude/agents/ui-ux-designer.md +256 -0
- package/templates/.claude/commands/devkit/analyze.md +92 -0
- package/templates/.claude/commands/devkit/ask.md +269 -0
- package/templates/.claude/commands/devkit/backend/create-api.md +220 -0
- package/templates/.claude/commands/devkit/backend/create-migration.md +130 -0
- package/templates/.claude/commands/devkit/backend/create-schema.md +158 -0
- package/templates/.claude/commands/devkit/backend/design-graphql-api.md +302 -0
- package/templates/.claude/commands/devkit/backend/design-rest-api.md +192 -0
- package/templates/.claude/commands/devkit/config/bootstrap.md +137 -0
- package/templates/.claude/commands/devkit/config/init-backend.md +233 -0
- package/templates/.claude/commands/devkit/config/init-frontend.md +911 -0
- package/templates/.claude/commands/devkit/create-test.md +165 -0
- package/templates/.claude/commands/devkit/debug.md +481 -0
- package/templates/.claude/commands/devkit/docs/capture-knowledge.md +424 -0
- package/templates/.claude/commands/devkit/docs/init.md +203 -0
- package/templates/.claude/commands/devkit/docs/summarize.md +33 -0
- package/templates/.claude/commands/devkit/docs/update.md +207 -0
- package/templates/.claude/commands/devkit/fix/fast.md +22 -0
- package/templates/.claude/commands/devkit/fix/hard.md +44 -0
- package/templates/.claude/commands/devkit/fix.md +16 -0
- package/templates/.claude/commands/devkit/frontend/create-api-integration.md +507 -0
- package/templates/.claude/commands/devkit/frontend/create-component.md +461 -0
- package/templates/.claude/commands/devkit/frontend/create-form.md +804 -0
- package/templates/.claude/commands/devkit/frontend/create-page.md +484 -0
- package/templates/.claude/commands/devkit/frontend/create-storybook.md +899 -0
- package/templates/.claude/commands/devkit/frontend/create-table.md +1035 -0
- package/templates/.claude/commands/devkit/help.md +148 -0
- package/templates/.claude/commands/devkit/refactor.md +510 -0
- package/templates/.claude/commands/devkit/research.md +394 -0
- package/templates/.claude/commands/devkit/review/code.md +349 -0
- package/templates/.claude/commands/devkit/review/codebase.md +51 -0
- package/templates/.claude/commands/devkit/scout.md +312 -0
- package/templates/.claude/commands/devkit/skill/add.md +29 -0
- package/templates/.claude/commands/devkit/skill/create.md +22 -0
- package/templates/.claude/commands/devkit/skill/optimize.md +34 -0
- package/templates/.claude/commands/devkit/solve.md +364 -0
- package/templates/.claude/commands/devkit/spec/brainstorm.md +309 -0
- package/templates/.claude/commands/devkit/spec/capture-requirement.md +202 -0
- package/templates/.claude/commands/devkit/spec/cook.md +157 -0
- package/templates/.claude/commands/devkit/spec/deep-capture-requirement.md +393 -0
- package/templates/.claude/commands/devkit/spec/implement.md +350 -0
- package/templates/.claude/commands/devkit/spec/plan.md +269 -0
- package/templates/.claude/commands/devkit/spec/task.md +156 -0
- package/templates/.claude/commands/devkit/spec/test.md +259 -0
- package/templates/.claude/commands/devkit/spec/update-plan.md +263 -0
- package/templates/.claude/commands/devkit/spec/update-requirement.md +239 -0
- package/templates/.claude/commands/devkit/spec-lite/do.md +280 -0
- package/templates/.claude/commands/devkit/spec-lite/plan.md +236 -0
- package/templates/.claude/commands/devkit/spec-lite/task.md +141 -0
- package/templates/.claude/commands/devkit/spec-lite/test.md +171 -0
- package/templates/.claude/commands/devkit/spec-lite/update-plan.md +154 -0
- package/templates/.claude/commands/qakit/a11y/audit.md +38 -0
- package/templates/.claude/commands/qakit/a11y/fix.md +22 -0
- package/templates/.claude/commands/qakit/analyze/full.md +459 -0
- package/templates/.claude/commands/qakit/analyze/quick.md +84 -0
- package/templates/.claude/commands/qakit/api/analyze.md +34 -0
- package/templates/.claude/commands/qakit/api/contract.md +22 -0
- package/templates/.claude/commands/qakit/api/generate.md +20 -0
- package/templates/.claude/commands/qakit/api/run.md +16 -0
- package/templates/.claude/commands/qakit/ask.md +57 -0
- package/templates/.claude/commands/qakit/automation/fix-flaky.md +233 -0
- package/templates/.claude/commands/qakit/automation/health-check.md +192 -0
- package/templates/.claude/commands/qakit/automation/maintenance.md +311 -0
- package/templates/.claude/commands/qakit/automation/scaffold-playwright.md +689 -0
- package/templates/.claude/commands/qakit/automation/scaffold-webdriverio.md +802 -0
- package/templates/.claude/commands/qakit/automation/scaffold.md +447 -0
- package/templates/.claude/commands/qakit/automation/update-deps.md +219 -0
- package/templates/.claude/commands/qakit/bug/investigate.md +96 -0
- package/templates/.claude/commands/qakit/bug/report.md +147 -0
- package/templates/.claude/commands/qakit/bug/reproduce.md +101 -0
- package/templates/.claude/commands/qakit/bug/triage.md +101 -0
- package/templates/.claude/commands/qakit/bug/verify.md +106 -0
- package/templates/.claude/commands/qakit/config/init-qa.md +107 -0
- package/templates/.claude/commands/qakit/confluence/fetch.md +192 -0
- package/templates/.claude/commands/qakit/confluence/search.md +201 -0
- package/templates/.claude/commands/qakit/docs/capture-test-knowledge.md +451 -0
- package/templates/.claude/commands/qakit/docs/update-changelog.md +207 -0
- package/templates/.claude/commands/qakit/docs/update-readme.md +296 -0
- package/templates/.claude/commands/qakit/e2e/generate.md +18 -0
- package/templates/.claude/commands/qakit/e2e/page-object.md +37 -0
- package/templates/.claude/commands/qakit/e2e/run.md +17 -0
- package/templates/.claude/commands/qakit/e2e/scenario.md +20 -0
- package/templates/.claude/commands/qakit/feature/create.md +178 -0
- package/templates/.claude/commands/qakit/feature/enrich-api.md +352 -0
- package/templates/.claude/commands/qakit/feature/enrich-tests.md +243 -0
- package/templates/.claude/commands/qakit/feature/enrich-ui.md +217 -0
- package/templates/.claude/commands/qakit/feature/enrich.md +246 -0
- package/templates/.claude/commands/qakit/feature/from-jira.md +184 -0
- package/templates/.claude/commands/qakit/feature/update.md +136 -0
- package/templates/.claude/commands/qakit/help.md +98 -0
- package/templates/.claude/commands/qakit/jira/analyze.md +329 -0
- package/templates/.claude/commands/qakit/jira/create-tests.md +319 -0
- package/templates/.claude/commands/qakit/kb/add-design.md +258 -0
- package/templates/.claude/commands/qakit/kb/capture.md +325 -0
- package/templates/.claude/commands/qakit/kb/clean.md +157 -0
- package/templates/.claude/commands/qakit/kb/dedupe.md +281 -0
- package/templates/.claude/commands/qakit/kb/init.md +234 -0
- package/templates/.claude/commands/qakit/kb/link.md +124 -0
- package/templates/.claude/commands/qakit/kb/list.md +185 -0
- package/templates/.claude/commands/qakit/kb/resolve.md +234 -0
- package/templates/.claude/commands/qakit/kb/search.md +202 -0
- package/templates/.claude/commands/qakit/kb/sync-confluence.md +474 -0
- package/templates/.claude/commands/qakit/metrics/coverage.md +46 -0
- package/templates/.claude/commands/qakit/metrics/dashboard.md +62 -0
- package/templates/.claude/commands/qakit/metrics/trends.md +42 -0
- package/templates/.claude/commands/qakit/perf/analyze.md +31 -0
- package/templates/.claude/commands/qakit/perf/plan.md +18 -0
- package/templates/.claude/commands/qakit/perf/run.md +17 -0
- package/templates/.claude/commands/qakit/perf/script.md +38 -0
- package/templates/.claude/commands/qakit/rca/analyze.md +166 -0
- package/templates/.claude/commands/qakit/regression/analyze.md +36 -0
- package/templates/.claude/commands/qakit/regression/report.md +30 -0
- package/templates/.claude/commands/qakit/regression/run.md +17 -0
- package/templates/.claude/commands/qakit/regression/select.md +34 -0
- package/templates/.claude/commands/qakit/research/deep.md +328 -0
- package/templates/.claude/commands/qakit/review/coverage.md +116 -0
- package/templates/.claude/commands/qakit/review/quality-gate.md +126 -0
- package/templates/.claude/commands/qakit/review/test-code.md +320 -0
- package/templates/.claude/commands/qakit/review/test-review.md +109 -0
- package/templates/.claude/commands/qakit/scout.md +195 -0
- package/templates/.claude/commands/qakit/setup/confluence.md +140 -0
- package/templates/.claude/commands/qakit/setup/jira.md +154 -0
- package/templates/.claude/commands/qakit/spec/analyze.md +46 -0
- package/templates/.claude/commands/qakit/spec/cook.md +344 -0
- package/templates/.claude/commands/qakit/spec/execute.md +38 -0
- package/templates/.claude/commands/qakit/spec/plan.md +46 -0
- package/templates/.claude/commands/qakit/spec/report.md +40 -0
- package/templates/.claude/commands/qakit/spec/task.md +40 -0
- package/templates/.claude/commands/qakit/test/create-test-case.md +151 -0
- package/templates/.claude/commands/qakit/test/create-test-suite.md +84 -0
- package/templates/.claude/commands/qakit/test/generate-api-tests.md +82 -0
- package/templates/.claude/commands/qakit/test/generate-data.md +114 -0
- package/templates/.claude/commands/qakit/test/generate-e2e.md +99 -0
- package/templates/.claude/commands/qakit/test/generate-ui-tests.md +97 -0
- package/templates/.claude/commands/qakit/testmo/report.md +22 -0
- package/templates/.claude/commands/qakit/testmo/sync.md +31 -0
- package/templates/.claude/doc-templates/bug-report-template.md +247 -0
- package/templates/.claude/doc-templates/code-standards.md +486 -0
- package/templates/.claude/doc-templates/codebase-summary.md +426 -0
- package/templates/.claude/doc-templates/development-rules.md +553 -0
- package/templates/.claude/doc-templates/feature-spec-template.md +167 -0
- package/templates/.claude/doc-templates/performance-report-template.md +49 -0
- package/templates/.claude/doc-templates/project-overview-pdr.md +494 -0
- package/templates/.claude/doc-templates/quality-report-template.md +44 -0
- package/templates/.claude/doc-templates/regression-report-template.md +41 -0
- package/templates/.claude/doc-templates/system-architecture.md +615 -0
- package/templates/.claude/doc-templates/technical-documents.md +127 -0
- package/templates/.claude/doc-templates/test-case-template.md +198 -0
- package/templates/.claude/doc-templates/test-plan-template.md +366 -0
- package/templates/.claude/doc-templates/test-summary-report.md +401 -0
- package/templates/.claude/hooks/dev-rules-reminder.cjs +101 -0
- package/templates/.claude/hooks/dev-rules-reminder.js +96 -0
- package/templates/.claude/hooks/executable_force-agent-skills-eval.sh +38 -0
- package/templates/.claude/hooks/scout-block/scout-block.ps1 +92 -0
- package/templates/.claude/hooks/scout-block/scout-block.sh +119 -0
- package/templates/.claude/hooks/scout-block.cjs +100 -0
- package/templates/.claude/hooks/scout-block.js +104 -0
- package/templates/.claude/repomix.config.json +34 -0
- package/templates/.claude/rules/01-core-principles.md +81 -0
- package/templates/.claude/rules/02-naming-and-constants.md +115 -0
- package/templates/.claude/rules/03-function-design.md +167 -0
- package/templates/.claude/rules/04-error-handling.md +83 -0
- package/templates/.claude/rules/05-testing.md +86 -0
- package/templates/.claude/rules/06-code-quality.md +107 -0
- package/templates/.claude/rules/07-architecture.md +105 -0
- package/templates/.claude/rules/08-performance-security.md +93 -0
- package/templates/.claude/rules/index.md +77 -0
- package/templates/.claude/scripts/README.md +153 -0
- package/templates/.claude/scripts/commands_data.yaml +336 -0
- package/templates/.claude/scripts/generate_catalogs.py +163 -0
- package/templates/.claude/scripts/helper.py +723 -0
- package/templates/.claude/scripts/scan_commands.py +101 -0
- package/templates/.claude/scripts/scan_skills.py +187 -0
- package/templates/.claude/scripts/skills_data.yaml +348 -0
- package/templates/.claude/settings.json +54 -0
- package/templates/.claude/settings.local.README.md +650 -0
- package/templates/.claude/settings.local.json +41 -0
- package/templates/.claude/setup/dependencies/setup-claude-mem.ps1 +534 -0
- package/templates/.claude/setup/dependencies/setup-claude-mem.sh +477 -0
- package/templates/.claude/setup/dependencies/setup-mcp-servers.ps1 +562 -0
- package/templates/.claude/setup/dependencies/setup-mcp-servers.sh +511 -0
- package/templates/.claude/setup/jira-env.example.sh +22 -0
- package/templates/.claude/setup/setup.ps1 +240 -0
- package/templates/.claude/setup/setup.sh +222 -0
- package/templates/.claude/skills/accessibility-testing/SKILL.md +34 -0
- package/templates/.claude/skills/aesthetic/SKILL.md +121 -0
- package/templates/.claude/skills/aesthetic/assets/design-guideline-template.md +163 -0
- package/templates/.claude/skills/aesthetic/assets/design-story-template.md +135 -0
- package/templates/.claude/skills/aesthetic/references/design-principles.md +62 -0
- package/templates/.claude/skills/aesthetic/references/design-resources.md +75 -0
- package/templates/.claude/skills/aesthetic/references/micro-interactions.md +53 -0
- package/templates/.claude/skills/aesthetic/references/storytelling-design.md +50 -0
- package/templates/.claude/skills/aesthetic/skill-creator/LICENSE.txt +202 -0
- package/templates/.claude/skills/aesthetic/skill-creator/SKILL.md +266 -0
- package/templates/.claude/skills/aesthetic/skill-creator/scripts/init_skill.py +303 -0
- package/templates/.claude/skills/aesthetic/skill-creator/scripts/package_skill.py +110 -0
- package/templates/.claude/skills/aesthetic/skill-creator/scripts/quick_validate.py +65 -0
- package/templates/.claude/skills/agent_skills_spec.md +51 -0
- package/templates/.claude/skills/ai-multimodal/.env.example +185 -0
- package/templates/.claude/skills/ai-multimodal/SKILL.md +69 -0
- package/templates/.claude/skills/ai-multimodal/references/audio-processing.md +386 -0
- package/templates/.claude/skills/ai-multimodal/references/image-generation.md +722 -0
- package/templates/.claude/skills/ai-multimodal/references/video-analysis.md +515 -0
- package/templates/.claude/skills/ai-multimodal/references/video-generation.md +457 -0
- package/templates/.claude/skills/ai-multimodal/references/vision-understanding.md +492 -0
- package/templates/.claude/skills/ai-multimodal/scripts/check_setup.py +299 -0
- package/templates/.claude/skills/ai-multimodal/scripts/document_converter.py +395 -0
- package/templates/.claude/skills/ai-multimodal/scripts/gemini_batch_process.py +1067 -0
- package/templates/.claude/skills/ai-multimodal/scripts/media_optimizer.py +506 -0
- package/templates/.claude/skills/ai-multimodal/scripts/requirements.txt +26 -0
- package/templates/.claude/skills/ai-multimodal/scripts/tests/requirements.txt +20 -0
- package/templates/.claude/skills/ai-multimodal/scripts/tests/test_document_converter.py +74 -0
- package/templates/.claude/skills/ai-multimodal/scripts/tests/test_gemini_batch_process.py +362 -0
- package/templates/.claude/skills/ai-multimodal/scripts/tests/test_media_optimizer.py +373 -0
- package/templates/.claude/skills/api-design-principles/SKILL.md +527 -0
- package/templates/.claude/skills/api-design-principles/assets/api-design-checklist.md +136 -0
- package/templates/.claude/skills/api-design-principles/assets/rest-api-template.py +165 -0
- package/templates/.claude/skills/api-design-principles/references/graphql-schema-design.md +566 -0
- package/templates/.claude/skills/api-design-principles/references/rest-best-practices.md +385 -0
- package/templates/.claude/skills/api-testing/SKILL.md +24 -0
- package/templates/.claude/skills/backend-development/SKILL.md +95 -0
- package/templates/.claude/skills/backend-development/references/backend-api-design.md +495 -0
- package/templates/.claude/skills/backend-development/references/backend-architecture.md +454 -0
- package/templates/.claude/skills/backend-development/references/backend-code-quality.md +659 -0
- package/templates/.claude/skills/backend-development/references/backend-debugging.md +904 -0
- package/templates/.claude/skills/backend-development/references/backend-devops.md +494 -0
- package/templates/.claude/skills/backend-development/references/backend-mindset.md +387 -0
- package/templates/.claude/skills/backend-development/references/backend-performance.md +397 -0
- package/templates/.claude/skills/backend-development/references/backend-security.md +290 -0
- package/templates/.claude/skills/backend-development/references/backend-technologies.md +256 -0
- package/templates/.claude/skills/backend-development/references/backend-testing.md +429 -0
- package/templates/.claude/skills/bug-investigation/SKILL.md +24 -0
- package/templates/.claude/skills/chrome-devtools/SKILL.md +472 -0
- package/templates/.claude/skills/chrome-devtools/references/cdp-domains.md +694 -0
- package/templates/.claude/skills/chrome-devtools/references/performance-guide.md +940 -0
- package/templates/.claude/skills/chrome-devtools/references/puppeteer-reference.md +953 -0
- package/templates/.claude/skills/chrome-devtools/scripts/README.md +228 -0
- package/templates/.claude/skills/chrome-devtools/scripts/__tests__/selector.test.js +210 -0
- package/templates/.claude/skills/chrome-devtools/scripts/aria-snapshot.js +362 -0
- package/templates/.claude/skills/chrome-devtools/scripts/click.js +83 -0
- package/templates/.claude/skills/chrome-devtools/scripts/console.js +79 -0
- package/templates/.claude/skills/chrome-devtools/scripts/evaluate.js +53 -0
- package/templates/.claude/skills/chrome-devtools/scripts/fill.js +76 -0
- package/templates/.claude/skills/chrome-devtools/scripts/install-deps.sh +181 -0
- package/templates/.claude/skills/chrome-devtools/scripts/install.sh +83 -0
- package/templates/.claude/skills/chrome-devtools/scripts/lib/browser.js +217 -0
- package/templates/.claude/skills/chrome-devtools/scripts/lib/selector.js +178 -0
- package/templates/.claude/skills/chrome-devtools/scripts/navigate.js +54 -0
- package/templates/.claude/skills/chrome-devtools/scripts/network.js +106 -0
- package/templates/.claude/skills/chrome-devtools/scripts/package.json +16 -0
- package/templates/.claude/skills/chrome-devtools/scripts/performance.js +149 -0
- package/templates/.claude/skills/chrome-devtools/scripts/screenshot.js +194 -0
- package/templates/.claude/skills/chrome-devtools/scripts/select-ref.js +131 -0
- package/templates/.claude/skills/chrome-devtools/scripts/snapshot.js +135 -0
- package/templates/.claude/skills/claude-code-analyzer/SKILL.md +299 -0
- package/templates/.claude/skills/claude-code-analyzer/references/best-practices.md +290 -0
- package/templates/.claude/skills/claude-code-analyzer/scripts/analyze-claude-md.sh +239 -0
- package/templates/.claude/skills/claude-code-analyzer/scripts/analyze.sh +274 -0
- package/templates/.claude/skills/claude-code-analyzer/scripts/fetch-features.sh +69 -0
- package/templates/.claude/skills/claude-code-analyzer/scripts/github-discovery.sh +178 -0
- package/templates/.claude/skills/code-review/SKILL.md +155 -0
- package/templates/.claude/skills/code-review/references/code-review-reception.md +209 -0
- package/templates/.claude/skills/code-review/references/human-code-review-practices.md +370 -0
- package/templates/.claude/skills/code-review/references/requesting-code-review.md +105 -0
- package/templates/.claude/skills/code-review/references/verification-before-completion.md +139 -0
- package/templates/.claude/skills/command-development/README.md +272 -0
- package/templates/.claude/skills/command-development/SKILL.md +834 -0
- package/templates/.claude/skills/command-development/examples/plugin-commands.md +557 -0
- package/templates/.claude/skills/command-development/examples/simple-commands.md +504 -0
- package/templates/.claude/skills/command-development/references/advanced-workflows.md +722 -0
- package/templates/.claude/skills/command-development/references/documentation-patterns.md +739 -0
- package/templates/.claude/skills/command-development/references/frontmatter-reference.md +463 -0
- package/templates/.claude/skills/command-development/references/interactive-commands.md +920 -0
- package/templates/.claude/skills/command-development/references/marketplace-considerations.md +904 -0
- package/templates/.claude/skills/command-development/references/plugin-features-reference.md +609 -0
- package/templates/.claude/skills/command-development/references/testing-strategies.md +702 -0
- package/templates/.claude/skills/confluence-integration/confluence-integration.md +260 -0
- package/templates/.claude/skills/databases/SKILL.md +232 -0
- package/templates/.claude/skills/databases/references/mongodb-aggregation.md +447 -0
- package/templates/.claude/skills/databases/references/mongodb-atlas.md +465 -0
- package/templates/.claude/skills/databases/references/mongodb-crud.md +408 -0
- package/templates/.claude/skills/databases/references/mongodb-indexing.md +442 -0
- package/templates/.claude/skills/databases/references/postgresql-administration.md +594 -0
- package/templates/.claude/skills/databases/references/postgresql-performance.md +527 -0
- package/templates/.claude/skills/databases/references/postgresql-psql-cli.md +467 -0
- package/templates/.claude/skills/databases/references/postgresql-queries.md +475 -0
- package/templates/.claude/skills/databases/scripts/db_backup.py +502 -0
- package/templates/.claude/skills/databases/scripts/db_migrate.py +414 -0
- package/templates/.claude/skills/databases/scripts/db_performance_check.py +444 -0
- package/templates/.claude/skills/databases/scripts/dot_coverage +0 -0
- package/templates/.claude/skills/databases/scripts/requirements.txt +20 -0
- package/templates/.claude/skills/databases/scripts/tests/coverage-db.json +1 -0
- package/templates/.claude/skills/databases/scripts/tests/requirements.txt +4 -0
- package/templates/.claude/skills/databases/scripts/tests/test_db_backup.py +340 -0
- package/templates/.claude/skills/databases/scripts/tests/test_db_migrate.py +277 -0
- package/templates/.claude/skills/databases/scripts/tests/test_db_performance_check.py +370 -0
- package/templates/.claude/skills/debugging/SKILL.md +84 -0
- package/templates/.claude/skills/debugging/references/defense-in-depth.md +124 -0
- package/templates/.claude/skills/debugging/references/root-cause-tracing.md +122 -0
- package/templates/.claude/skills/debugging/references/systematic-debugging.md +102 -0
- package/templates/.claude/skills/debugging/references/verification.md +123 -0
- package/templates/.claude/skills/debugging/scripts/find-polluter.sh +63 -0
- package/templates/.claude/skills/debugging/scripts/find-polluter.test.md +102 -0
- package/templates/.claude/skills/docs-discovery/COMPARISON.md +313 -0
- package/templates/.claude/skills/docs-discovery/README.md +53 -0
- package/templates/.claude/skills/docs-discovery/REFACTORING_SUMMARY.md +144 -0
- package/templates/.claude/skills/docs-discovery/SKILL.md +64 -0
- package/templates/.claude/skills/docs-discovery/archive/dot_env.example +15 -0
- package/templates/.claude/skills/docs-discovery/archive/package.json +24 -0
- package/templates/.claude/skills/docs-discovery/archive/references/advanced.md +79 -0
- package/templates/.claude/skills/docs-discovery/archive/references/context7-patterns.md +68 -0
- package/templates/.claude/skills/docs-discovery/archive/references/errors.md +68 -0
- package/templates/.claude/skills/docs-discovery/archive/scripts/analyze-llms-txt.js +211 -0
- package/templates/.claude/skills/docs-discovery/archive/scripts/detect-topic.js +172 -0
- package/templates/.claude/skills/docs-discovery/archive/scripts/fetch-docs.js +213 -0
- package/templates/.claude/skills/docs-discovery/archive/scripts/tests/run-tests.js +72 -0
- package/templates/.claude/skills/docs-discovery/archive/scripts/tests/test-analyze-llms.js +119 -0
- package/templates/.claude/skills/docs-discovery/archive/scripts/tests/test-detect-topic.js +112 -0
- package/templates/.claude/skills/docs-discovery/archive/scripts/tests/test-fetch-docs.js +84 -0
- package/templates/.claude/skills/docs-discovery/archive/scripts/utils/env-loader.js +94 -0
- package/templates/.claude/skills/docs-discovery/archive/workflows/library-search.md +87 -0
- package/templates/.claude/skills/docs-discovery/archive/workflows/repo-analysis.md +91 -0
- package/templates/.claude/skills/docs-discovery/archive/workflows/topic-search.md +77 -0
- package/templates/.claude/skills/docs-seeker/.env.example +15 -0
- package/templates/.claude/skills/docs-seeker/SKILL.md +97 -0
- package/templates/.claude/skills/docs-seeker/package.json +24 -0
- package/templates/.claude/skills/docs-seeker/references/advanced.md +79 -0
- package/templates/.claude/skills/docs-seeker/references/context7-patterns.md +68 -0
- package/templates/.claude/skills/docs-seeker/references/errors.md +68 -0
- package/templates/.claude/skills/docs-seeker/scripts/analyze-llms-txt.js +211 -0
- package/templates/.claude/skills/docs-seeker/scripts/detect-topic.js +172 -0
- package/templates/.claude/skills/docs-seeker/scripts/fetch-docs.js +213 -0
- package/templates/.claude/skills/docs-seeker/scripts/tests/run-tests.js +72 -0
- package/templates/.claude/skills/docs-seeker/scripts/tests/test-analyze-llms.js +119 -0
- package/templates/.claude/skills/docs-seeker/scripts/tests/test-detect-topic.js +112 -0
- package/templates/.claude/skills/docs-seeker/scripts/tests/test-fetch-docs.js +84 -0
- package/templates/.claude/skills/docs-seeker/scripts/utils/env-loader.js +94 -0
- package/templates/.claude/skills/docs-seeker/workflows/library-search.md +87 -0
- package/templates/.claude/skills/docs-seeker/workflows/repo-analysis.md +91 -0
- package/templates/.claude/skills/docs-seeker/workflows/topic-search.md +77 -0
- package/templates/.claude/skills/document-skills/docx/LICENSE.txt +30 -0
- package/templates/.claude/skills/document-skills/docx/SKILL.md +197 -0
- package/templates/.claude/skills/document-skills/docx/docx-js.md +350 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/mce/mc.xsd +75 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/microsoft/wml-2010.xsd +560 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/microsoft/wml-2012.xsd +67 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/microsoft/wml-2018.xsd +14 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/microsoft/wml-cex-2018.xsd +20 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/microsoft/wml-cid-2016.xsd +13 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/schemas/microsoft/wml-symex-2015.xsd +8 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/scripts/pack.py +159 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/scripts/unpack.py +29 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/scripts/validate.py +69 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/scripts/validation/__init__.py +15 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/scripts/validation/base.py +951 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/scripts/validation/docx.py +274 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/scripts/validation/pptx.py +315 -0
- package/templates/.claude/skills/document-skills/docx/ooxml/scripts/validation/redlining.py +279 -0
- package/templates/.claude/skills/document-skills/docx/ooxml.md +610 -0
- package/templates/.claude/skills/document-skills/docx/scripts/__init__.py +1 -0
- package/templates/.claude/skills/document-skills/docx/scripts/document.py +1276 -0
- package/templates/.claude/skills/document-skills/docx/scripts/templates/comments.xml +3 -0
- package/templates/.claude/skills/document-skills/docx/scripts/templates/commentsExtended.xml +3 -0
- package/templates/.claude/skills/document-skills/docx/scripts/templates/commentsExtensible.xml +3 -0
- package/templates/.claude/skills/document-skills/docx/scripts/templates/commentsIds.xml +3 -0
- package/templates/.claude/skills/document-skills/docx/scripts/templates/people.xml +3 -0
- package/templates/.claude/skills/document-skills/docx/scripts/utilities.py +374 -0
- package/templates/.claude/skills/document-skills/pdf/LICENSE.txt +30 -0
- package/templates/.claude/skills/document-skills/pdf/SKILL.md +294 -0
- package/templates/.claude/skills/document-skills/pdf/forms.md +205 -0
- package/templates/.claude/skills/document-skills/pdf/reference.md +612 -0
- package/templates/.claude/skills/document-skills/pdf/scripts/check_bounding_boxes.py +70 -0
- package/templates/.claude/skills/document-skills/pdf/scripts/check_bounding_boxes_test.py +226 -0
- package/templates/.claude/skills/document-skills/pdf/scripts/check_fillable_fields.py +12 -0
- package/templates/.claude/skills/document-skills/pdf/scripts/convert_pdf_to_images.py +35 -0
- package/templates/.claude/skills/document-skills/pdf/scripts/create_validation_image.py +41 -0
- package/templates/.claude/skills/document-skills/pdf/scripts/extract_form_field_info.py +152 -0
- package/templates/.claude/skills/document-skills/pdf/scripts/fill_fillable_fields.py +114 -0
- package/templates/.claude/skills/document-skills/pdf/scripts/fill_pdf_form_with_annotations.py +108 -0
- package/templates/.claude/skills/document-skills/pptx/LICENSE.txt +30 -0
- package/templates/.claude/skills/document-skills/pptx/SKILL.md +484 -0
- package/templates/.claude/skills/document-skills/pptx/html2pptx.md +625 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/mce/mc.xsd +75 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-2010.xsd +560 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-2012.xsd +67 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-2018.xsd +14 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-cex-2018.xsd +20 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-cid-2016.xsd +13 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/schemas/microsoft/wml-symex-2015.xsd +8 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/scripts/pack.py +159 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/scripts/unpack.py +29 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/scripts/validate.py +69 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/scripts/validation/__init__.py +15 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/scripts/validation/base.py +951 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/scripts/validation/docx.py +274 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/scripts/validation/pptx.py +315 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml/scripts/validation/redlining.py +279 -0
- package/templates/.claude/skills/document-skills/pptx/ooxml.md +427 -0
- package/templates/.claude/skills/document-skills/pptx/scripts/html2pptx.js +979 -0
- package/templates/.claude/skills/document-skills/pptx/scripts/inventory.py +1020 -0
- package/templates/.claude/skills/document-skills/pptx/scripts/rearrange.py +231 -0
- package/templates/.claude/skills/document-skills/pptx/scripts/replace.py +385 -0
- package/templates/.claude/skills/document-skills/pptx/scripts/thumbnail.py +450 -0
- package/templates/.claude/skills/document-skills/xlsx/LICENSE.txt +30 -0
- package/templates/.claude/skills/document-skills/xlsx/SKILL.md +289 -0
- package/templates/.claude/skills/document-skills/xlsx/recalc.py +178 -0
- package/templates/.claude/skills/frontend-development/SKILL.md +208 -0
- package/templates/.claude/skills/frontend-development/references/accessibility.md +720 -0
- package/templates/.claude/skills/frontend-development/references/data-fetching.md +412 -0
- package/templates/.claude/skills/frontend-development/references/forms.md +809 -0
- package/templates/.claude/skills/frontend-development/references/fsd-architecture.md +442 -0
- package/templates/.claude/skills/frontend-development/references/graphql-apollo.md +731 -0
- package/templates/.claude/skills/frontend-development/references/performance.md +417 -0
- package/templates/.claude/skills/frontend-development/references/react-patterns.md +451 -0
- package/templates/.claude/skills/frontend-development/references/routing.md +436 -0
- package/templates/.claude/skills/frontend-development/references/state-management.md +510 -0
- package/templates/.claude/skills/frontend-development/references/tailwind-css.md +397 -0
- package/templates/.claude/skills/frontend-development/references/testing.md +630 -0
- package/templates/.claude/skills/frontend-development/references/typescript-standards.md +363 -0
- package/templates/.claude/skills/frontend-development/references/ui-libraries.md +586 -0
- package/templates/.claude/skills/infra-engineer/SKILL.md +642 -0
- package/templates/.claude/skills/infra-engineer/dot_env.example +76 -0
- package/templates/.claude/skills/infra-engineer/references/aws-overview.md +171 -0
- package/templates/.claude/skills/infra-engineer/references/browser-rendering.md +305 -0
- package/templates/.claude/skills/infra-engineer/references/cicd-github-actions.md +439 -0
- package/templates/.claude/skills/infra-engineer/references/cloudflare-d1-kv.md +123 -0
- package/templates/.claude/skills/infra-engineer/references/cloudflare-platform.md +271 -0
- package/templates/.claude/skills/infra-engineer/references/cloudflare-r2-storage.md +280 -0
- package/templates/.claude/skills/infra-engineer/references/cloudflare-workers-advanced.md +312 -0
- package/templates/.claude/skills/infra-engineer/references/cloudflare-workers-apis.md +309 -0
- package/templates/.claude/skills/infra-engineer/references/cloudflare-workers-basics.md +418 -0
- package/templates/.claude/skills/infra-engineer/references/devsecops-basics.md +361 -0
- package/templates/.claude/skills/infra-engineer/references/docker-basics.md +297 -0
- package/templates/.claude/skills/infra-engineer/references/docker-compose.md +292 -0
- package/templates/.claude/skills/infra-engineer/references/finops-basics.md +278 -0
- package/templates/.claude/skills/infra-engineer/references/gcloud-platform.md +297 -0
- package/templates/.claude/skills/infra-engineer/references/gcloud-services.md +304 -0
- package/templates/.claude/skills/infra-engineer/references/kubernetes-basics.md +295 -0
- package/templates/.claude/skills/infra-engineer/scripts/cloudflare_deploy.py +269 -0
- package/templates/.claude/skills/infra-engineer/scripts/docker_optimize.py +320 -0
- package/templates/.claude/skills/infra-engineer/scripts/requirements.txt +20 -0
- package/templates/.claude/skills/infra-engineer/scripts/tests/requirements.txt +3 -0
- package/templates/.claude/skills/infra-engineer/scripts/tests/test_cloudflare_deploy.py +285 -0
- package/templates/.claude/skills/infra-engineer/scripts/tests/test_docker_optimize.py +436 -0
- package/templates/.claude/skills/javascript-pro/SKILL.md +96 -0
- package/templates/.claude/skills/javascript-pro/references/async-patterns.md +96 -0
- package/templates/.claude/skills/javascript-pro/references/best-practices.md +98 -0
- package/templates/.claude/skills/javascript-pro/references/design-patterns.md +100 -0
- package/templates/.claude/skills/javascript-pro/references/error-handling.md +100 -0
- package/templates/.claude/skills/javascript-pro/references/functional-patterns.md +93 -0
- package/templates/.claude/skills/javascript-pro/references/modern-syntax.md +100 -0
- package/templates/.claude/skills/javascript-pro/references/performance.md +98 -0
- package/templates/.claude/skills/jira-integration/adf-parser.md +338 -0
- package/templates/.claude/skills/jira-integration/jira-integration.md +353 -0
- package/templates/.claude/skills/knowledge-base/knowledge-base.md +212 -0
- package/templates/.claude/skills/mobile-development/SKILL.md +212 -0
- package/templates/.claude/skills/mobile-development/references/mobile-android.md +604 -0
- package/templates/.claude/skills/mobile-development/references/mobile-best-practices.md +545 -0
- package/templates/.claude/skills/mobile-development/references/mobile-debugging.md +1089 -0
- package/templates/.claude/skills/mobile-development/references/mobile-frameworks.md +465 -0
- package/templates/.claude/skills/mobile-development/references/mobile-ios.md +496 -0
- package/templates/.claude/skills/mobile-development/references/mobile-mindset.md +544 -0
- package/templates/.claude/skills/mobile-testing/SKILL.md +24 -0
- package/templates/.claude/skills/performance-testing/SKILL.md +30 -0
- package/templates/.claude/skills/planning/SKILL.md +143 -0
- package/templates/.claude/skills/planning/references/codebase-understanding.md +62 -0
- package/templates/.claude/skills/planning/references/output-standards.md +87 -0
- package/templates/.claude/skills/planning/references/plan-organization.md +137 -0
- package/templates/.claude/skills/planning/references/research-phase.md +47 -0
- package/templates/.claude/skills/planning/references/solution-design.md +63 -0
- package/templates/.claude/skills/playwright/SKILL.md +303 -0
- package/templates/.claude/skills/playwright/examples/auth.fixture.ts +172 -0
- package/templates/.claude/skills/playwright/examples/login.page.ts +232 -0
- package/templates/.claude/skills/playwright/references/config.md +391 -0
- package/templates/.claude/skills/problem-solving/SKILL.md +96 -0
- package/templates/.claude/skills/problem-solving/references/attribution.md +69 -0
- package/templates/.claude/skills/problem-solving/references/collision-zone-thinking.md +79 -0
- package/templates/.claude/skills/problem-solving/references/inversion-exercise.md +91 -0
- package/templates/.claude/skills/problem-solving/references/meta-pattern-recognition.md +87 -0
- package/templates/.claude/skills/problem-solving/references/scale-game.md +95 -0
- package/templates/.claude/skills/problem-solving/references/simplification-cascades.md +80 -0
- package/templates/.claude/skills/problem-solving/references/when-stuck.md +72 -0
- package/templates/.claude/skills/prompt-enhancer/SKILL.md +380 -0
- package/templates/.claude/skills/python-pro/SKILL.md +59 -0
- package/templates/.claude/skills/python-pro/references/async-patterns.md +96 -0
- package/templates/.claude/skills/python-pro/references/error-handling.md +84 -0
- package/templates/.claude/skills/python-pro/references/performance.md +71 -0
- package/templates/.claude/skills/python-pro/references/project-setup.md +78 -0
- package/templates/.claude/skills/python-pro/references/security.md +73 -0
- package/templates/.claude/skills/python-pro/references/testing.md +90 -0
- package/templates/.claude/skills/python-pro/references/type-system.md +88 -0
- package/templates/.claude/skills/qa-standards/SKILL.md +176 -0
- package/templates/.claude/skills/qa-standards/references/naming-conventions.md +262 -0
- package/templates/.claude/skills/quality-metrics/SKILL.md +27 -0
- package/templates/.claude/skills/repomix/SKILL.md +247 -0
- package/templates/.claude/skills/repomix/references/configuration.md +211 -0
- package/templates/.claude/skills/repomix/references/usage-patterns.md +232 -0
- package/templates/.claude/skills/repomix/scripts/README.md +179 -0
- package/templates/.claude/skills/repomix/scripts/repomix_batch.py +455 -0
- package/templates/.claude/skills/repomix/scripts/repos.example.json +15 -0
- package/templates/.claude/skills/repomix/scripts/requirements.txt +15 -0
- package/templates/.claude/skills/repomix/scripts/tests/test_repomix_batch.py +531 -0
- package/templates/.claude/skills/research/SKILL.md +168 -0
- package/templates/.claude/skills/sequential-thinking/.env.example +8 -0
- package/templates/.claude/skills/sequential-thinking/README.md +183 -0
- package/templates/.claude/skills/sequential-thinking/SKILL.md +94 -0
- package/templates/.claude/skills/sequential-thinking/package.json +31 -0
- package/templates/.claude/skills/sequential-thinking/references/advanced-strategies.md +79 -0
- package/templates/.claude/skills/sequential-thinking/references/advanced-techniques.md +76 -0
- package/templates/.claude/skills/sequential-thinking/references/core-patterns.md +95 -0
- package/templates/.claude/skills/sequential-thinking/references/examples-api.md +88 -0
- package/templates/.claude/skills/sequential-thinking/references/examples-architecture.md +94 -0
- package/templates/.claude/skills/sequential-thinking/references/examples-debug.md +90 -0
- package/templates/.claude/skills/sequential-thinking/scripts/format-thought.js +159 -0
- package/templates/.claude/skills/sequential-thinking/scripts/process-thought.js +236 -0
- package/templates/.claude/skills/sequential-thinking/tests/format-thought.test.js +133 -0
- package/templates/.claude/skills/sequential-thinking/tests/process-thought.test.js +215 -0
- package/templates/.claude/skills/test-automation/SKILL.md +93 -0
- package/templates/.claude/skills/test-automation/examples/page-object.ts +44 -0
- package/templates/.claude/skills/test-automation/references/frameworks.md +96 -0
- package/templates/.claude/skills/test-data-management/SKILL.md +24 -0
- package/templates/.claude/skills/test-design/SKILL.md +25 -0
- package/templates/.claude/skills/typescript-pro/SKILL.md +84 -0
- package/templates/.claude/skills/typescript-pro/references/advanced-patterns.md +100 -0
- package/templates/.claude/skills/typescript-pro/references/best-practices.md +96 -0
- package/templates/.claude/skills/typescript-pro/references/conditional-types.md +85 -0
- package/templates/.claude/skills/typescript-pro/references/generics.md +97 -0
- package/templates/.claude/skills/typescript-pro/references/mapped-types.md +99 -0
- package/templates/.claude/skills/typescript-pro/references/template-literals.md +85 -0
- package/templates/.claude/skills/typescript-pro/references/type-inference.md +94 -0
- package/templates/.claude/skills/typescript-pro/references/utility-types.md +96 -0
- package/templates/.claude/skills/ui-testing/SKILL.md +24 -0
- package/templates/.claude/skills/ui-ux-pro-max/SKILL.md +229 -0
- package/templates/.claude/skills/ui-ux-pro-max/data/charts.csv +26 -0
- package/templates/.claude/skills/ui-ux-pro-max/data/colors.csv +97 -0
- package/templates/.claude/skills/ui-ux-pro-max/data/landing.csv +31 -0
- package/templates/.claude/skills/ui-ux-pro-max/data/products.csv +97 -0
- package/templates/.claude/skills/ui-ux-pro-max/data/prompts.csv +24 -0
- package/templates/.claude/skills/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
- package/templates/.claude/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
- package/templates/.claude/skills/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
- package/templates/.claude/skills/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
- package/templates/.claude/skills/ui-ux-pro-max/data/stacks/react.csv +54 -0
- package/templates/.claude/skills/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
- package/templates/.claude/skills/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
- package/templates/.claude/skills/ui-ux-pro-max/data/stacks/vue.csv +50 -0
- package/templates/.claude/skills/ui-ux-pro-max/data/styles.csv +59 -0
- package/templates/.claude/skills/ui-ux-pro-max/data/typography.csv +58 -0
- package/templates/.claude/skills/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
- package/templates/.claude/skills/ui-ux-pro-max/scripts/core.py +236 -0
- package/templates/.claude/skills/ui-ux-pro-max/scripts/search.py +61 -0
- package/templates/.claude/skills/webdriverio/SKILL.md +433 -0
- package/templates/.claude/skills/webdriverio/examples/mobile.page.ts +369 -0
- package/templates/.claude/skills/webdriverio/references/capabilities.md +377 -0
- package/templates/.claude/statusline.cjs +105 -0
- package/templates/.claude/statusline.ps1 +187 -0
- package/templates/.claude/statusline.sh +161 -0
- package/templates/.claude/workflows/api-testing-workflow.md +36 -0
- package/templates/.claude/workflows/bug-investigation-workflow.md +42 -0
- package/templates/.claude/workflows/development-rules.md +366 -0
- package/templates/.claude/workflows/documentation-management.md +128 -0
- package/templates/.claude/workflows/e2e-testing-workflow.md +36 -0
- package/templates/.claude/workflows/orchestration-protocol.md +16 -0
- package/templates/.claude/workflows/performance-testing-workflow.md +42 -0
- package/templates/.claude/workflows/primary-workflow.md +45 -0
- package/templates/.claude/workflows/qa-primary-workflow.md +48 -0
- package/templates/.claude/workflows/qa-rules.md +42 -0
- package/templates/.claude/workflows/regression-testing-workflow.md +36 -0
- package/templates/.claude/workflows/test-driven-qa-workflow.md +37 -0
- package/templates/.codex/config.toml.template +29 -0
- package/templates/.codex/prompts/qa-commands.md +32 -0
- package/templates/.codex/prompts/test-generation.md +29 -0
- package/templates/.cursor/CHANGELOG.md +540 -0
- package/templates/.cursor/README.md +261 -0
- package/templates/.cursor/commands/devkit/ask.md +71 -0
- package/templates/.cursor/commands/devkit/backend/create-api.md +207 -0
- package/templates/.cursor/commands/devkit/backend/create-migration.md +169 -0
- package/templates/.cursor/commands/devkit/backend/create-schema.md +183 -0
- package/templates/.cursor/commands/devkit/backend/design-graphql-api.md +287 -0
- package/templates/.cursor/commands/devkit/backend/design-rest-api.md +219 -0
- package/templates/.cursor/commands/devkit/config/init-backend.md +219 -0
- package/templates/.cursor/commands/devkit/config/init-frontend.md +114 -0
- package/templates/.cursor/commands/devkit/create-api-integration.md +196 -0
- package/templates/.cursor/commands/devkit/create-component.md +104 -0
- package/templates/.cursor/commands/devkit/create-form.md +189 -0
- package/templates/.cursor/commands/devkit/create-page.md +111 -0
- package/templates/.cursor/commands/devkit/create-storybook.md +235 -0
- package/templates/.cursor/commands/devkit/create-table.md +251 -0
- package/templates/.cursor/commands/devkit/create-test.md +174 -0
- package/templates/.cursor/commands/devkit/debug.md +192 -0
- package/templates/.cursor/commands/devkit/docs/capture-knowledge.md +252 -0
- package/templates/.cursor/commands/devkit/docs/init.md +153 -0
- package/templates/.cursor/commands/devkit/docs/summarize.md +82 -0
- package/templates/.cursor/commands/devkit/docs/update.md +174 -0
- package/templates/.cursor/commands/devkit/fix.md +24 -0
- package/templates/.cursor/commands/devkit/help.md +148 -0
- package/templates/.cursor/commands/devkit/refactor.md +476 -0
- package/templates/.cursor/commands/devkit/research.md +135 -0
- package/templates/.cursor/commands/devkit/review/code.md +297 -0
- package/templates/.cursor/commands/devkit/review/codebase.md +37 -0
- package/templates/.cursor/commands/devkit/scout.md +103 -0
- package/templates/.cursor/commands/devkit/solve.md +355 -0
- package/templates/.cursor/commands/devkit/spec/brainstorm.md +184 -0
- package/templates/.cursor/commands/devkit/spec/capture-requirement.md +164 -0
- package/templates/.cursor/commands/devkit/spec/cook.md +101 -0
- package/templates/.cursor/commands/devkit/spec/deep-capture-requirement.md +149 -0
- package/templates/.cursor/commands/devkit/spec/implement.md +354 -0
- package/templates/.cursor/commands/devkit/spec/plan.md +317 -0
- package/templates/.cursor/commands/devkit/spec/task.md +150 -0
- package/templates/.cursor/commands/devkit/spec/test.md +203 -0
- package/templates/.cursor/commands/devkit/spec/update-plan.md +234 -0
- package/templates/.cursor/commands/devkit/spec/update-requirement.md +222 -0
- package/templates/.cursor/commands/devkit/spec-lite/do.md +154 -0
- package/templates/.cursor/commands/devkit/spec-lite/plan.md +197 -0
- package/templates/.cursor/commands/devkit/spec-lite/task.md +138 -0
- package/templates/.cursor/commands/devkit/spec-lite/test.md +129 -0
- package/templates/.cursor/commands/devkit/spec-lite/update-plan.md +133 -0
- package/templates/.cursor/commands/devkit/ui-ux-pro-max.md +226 -0
- package/templates/.cursor/doc-templates/code-standards.md +486 -0
- package/templates/.cursor/doc-templates/codebase-summary.md +426 -0
- package/templates/.cursor/doc-templates/development-rules.md +553 -0
- package/templates/.cursor/doc-templates/project-overview-pdr.md +494 -0
- package/templates/.cursor/doc-templates/system-architecture.md +615 -0
- package/templates/.cursor/doc-templates/technical-documents.md +127 -0
- package/templates/.cursor/repomix.config.json +34 -0
- package/templates/.cursor/rules/backend-development/backend-development.mdc +94 -0
- package/templates/.cursor/rules/backend-development/references/backend-api-design.md +495 -0
- package/templates/.cursor/rules/backend-development/references/backend-architecture.md +454 -0
- package/templates/.cursor/rules/backend-development/references/backend-code-quality.md +659 -0
- package/templates/.cursor/rules/backend-development/references/backend-debugging.md +904 -0
- package/templates/.cursor/rules/backend-development/references/backend-devops.md +494 -0
- package/templates/.cursor/rules/backend-development/references/backend-mindset.md +387 -0
- package/templates/.cursor/rules/backend-development/references/backend-performance.md +397 -0
- package/templates/.cursor/rules/backend-development/references/backend-security.md +290 -0
- package/templates/.cursor/rules/backend-development/references/backend-technologies.md +256 -0
- package/templates/.cursor/rules/backend-development/references/backend-testing.md +429 -0
- package/templates/.cursor/rules/brainstormer.mdc +147 -0
- package/templates/.cursor/rules/code-optimizer.mdc +132 -0
- package/templates/.cursor/rules/code-review/code-revew.mdc +144 -0
- package/templates/.cursor/rules/code-review/references/code-review-reception.md +209 -0
- package/templates/.cursor/rules/code-review/references/requesting-code-review.md +105 -0
- package/templates/.cursor/rules/code-review/references/verification-before-completion.md +139 -0
- package/templates/.cursor/rules/code-reviewer.mdc +85 -0
- package/templates/.cursor/rules/code-simplifier.mdc +121 -0
- package/templates/.cursor/rules/coder.mdc +86 -0
- package/templates/.cursor/rules/community-rules.mdc +38 -0
- package/templates/.cursor/rules/cunningham.mdc +114 -0
- package/templates/.cursor/rules/debugger.mdc +108 -0
- package/templates/.cursor/rules/development-rules.mdc +208 -0
- package/templates/.cursor/rules/docs-manager.mdc +121 -0
- package/templates/.cursor/rules/docs-seeker/docs-seeker.mdc +57 -0
- package/templates/.cursor/rules/docs-seeker/references/advanced.md +80 -0
- package/templates/.cursor/rules/docs-seeker/references/context7-patterns.md +69 -0
- package/templates/.cursor/rules/docs-seeker/references/errors.md +69 -0
- package/templates/.cursor/rules/docs-seeker/scripts/analyze-llms-txt.js +211 -0
- package/templates/.cursor/rules/docs-seeker/scripts/detect-topic.js +172 -0
- package/templates/.cursor/rules/docs-seeker/scripts/fetch-docs.js +213 -0
- package/templates/.cursor/rules/docs-seeker/scripts/tests/run-tests.js +72 -0
- package/templates/.cursor/rules/docs-seeker/scripts/tests/test-analyze-llms.js +119 -0
- package/templates/.cursor/rules/docs-seeker/scripts/tests/test-detect-topic.js +112 -0
- package/templates/.cursor/rules/docs-seeker/scripts/tests/test-fetch-docs.js +84 -0
- package/templates/.cursor/rules/docs-seeker/scripts/utils/env-loader.js +94 -0
- package/templates/.cursor/rules/docs-seeker/workflows/library-search.md +88 -0
- package/templates/.cursor/rules/docs-seeker/workflows/repo-analysis.md +92 -0
- package/templates/.cursor/rules/docs-seeker/workflows/topic-search.md +78 -0
- package/templates/.cursor/rules/frontend-development/frontend-development.mdc +131 -0
- package/templates/.cursor/rules/frontend-development/references/accessibility.md +719 -0
- package/templates/.cursor/rules/frontend-development/references/data-fetching.md +412 -0
- package/templates/.cursor/rules/frontend-development/references/forms.md +808 -0
- package/templates/.cursor/rules/frontend-development/references/fsd-architecture.md +442 -0
- package/templates/.cursor/rules/frontend-development/references/graphql-apollo.md +730 -0
- package/templates/.cursor/rules/frontend-development/references/performance.md +417 -0
- package/templates/.cursor/rules/frontend-development/references/react-patterns.md +451 -0
- package/templates/.cursor/rules/frontend-development/references/routing.md +436 -0
- package/templates/.cursor/rules/frontend-development/references/state-management.md +511 -0
- package/templates/.cursor/rules/frontend-development/references/tailwind-css.md +398 -0
- package/templates/.cursor/rules/frontend-development/references/testing.md +629 -0
- package/templates/.cursor/rules/frontend-development/references/typescript-standards.md +364 -0
- package/templates/.cursor/rules/frontend-development/references/ui-libraries.md +587 -0
- package/templates/.cursor/rules/javascript-pro/javascript-pro.mdc +98 -0
- package/templates/.cursor/rules/javascript-pro/references/async-patterns.md +96 -0
- package/templates/.cursor/rules/javascript-pro/references/best-practices.md +98 -0
- package/templates/.cursor/rules/javascript-pro/references/design-patterns.md +100 -0
- package/templates/.cursor/rules/javascript-pro/references/error-handling.md +100 -0
- package/templates/.cursor/rules/javascript-pro/references/functional-patterns.md +93 -0
- package/templates/.cursor/rules/javascript-pro/references/modern-syntax.md +100 -0
- package/templates/.cursor/rules/javascript-pro/references/performance.md +98 -0
- package/templates/.cursor/rules/planner.mdc +87 -0
- package/templates/.cursor/rules/problem-solving/problem-solving.mdc +96 -0
- package/templates/.cursor/rules/problem-solving/references/attribution.md +69 -0
- package/templates/.cursor/rules/problem-solving/references/collision-zone-thinking.md +79 -0
- package/templates/.cursor/rules/problem-solving/references/inversion-exercise.md +91 -0
- package/templates/.cursor/rules/problem-solving/references/meta-pattern-recognition.md +87 -0
- package/templates/.cursor/rules/problem-solving/references/scale-game.md +95 -0
- package/templates/.cursor/rules/problem-solving/references/simplification-cascades.md +80 -0
- package/templates/.cursor/rules/problem-solving/references/when-stuck.md +72 -0
- package/templates/.cursor/rules/project-manager.mdc +116 -0
- package/templates/.cursor/rules/project-profile.mdc +54 -0
- package/templates/.cursor/rules/python-pro/python-pro.mdc +83 -0
- package/templates/.cursor/rules/python-pro/references/async-patterns.md +96 -0
- package/templates/.cursor/rules/python-pro/references/error-handling.md +84 -0
- package/templates/.cursor/rules/python-pro/references/performance.md +71 -0
- package/templates/.cursor/rules/python-pro/references/project-setup.md +78 -0
- package/templates/.cursor/rules/python-pro/references/security.md +73 -0
- package/templates/.cursor/rules/python-pro/references/testing.md +90 -0
- package/templates/.cursor/rules/python-pro/references/type-system.md +88 -0
- package/templates/.cursor/rules/qa-api-testing.mdc +25 -0
- package/templates/.cursor/rules/qa-automation.mdc +28 -0
- package/templates/.cursor/rules/qa-testing.mdc +28 -0
- package/templates/.cursor/rules/repomix/references/configuration.md +211 -0
- package/templates/.cursor/rules/repomix/references/usage-patterns.md +232 -0
- package/templates/.cursor/rules/repomix/repomix.mdc +248 -0
- package/templates/.cursor/rules/repomix/scripts/README.md +179 -0
- package/templates/.cursor/rules/repomix/scripts/repomix_batch.py +455 -0
- package/templates/.cursor/rules/repomix/scripts/repos.example.json +15 -0
- package/templates/.cursor/rules/repomix/scripts/requirements.txt +15 -0
- package/templates/.cursor/rules/repomix/scripts/tests/test_repomix_batch.py +531 -0
- package/templates/.cursor/rules/research/research.mdc +111 -0
- package/templates/.cursor/rules/researcher.mdc +54 -0
- package/templates/.cursor/rules/scout.mdc +105 -0
- package/templates/.cursor/rules/security-agent.mdc +122 -0
- package/templates/.cursor/rules/security.mdc +90 -0
- package/templates/.cursor/rules/sequential-thinking/references/advanced-strategies.md +80 -0
- package/templates/.cursor/rules/sequential-thinking/references/advanced-techniques.md +77 -0
- package/templates/.cursor/rules/sequential-thinking/references/core-patterns.md +96 -0
- package/templates/.cursor/rules/sequential-thinking/references/examples-api.md +89 -0
- package/templates/.cursor/rules/sequential-thinking/references/examples-architecture.md +95 -0
- package/templates/.cursor/rules/sequential-thinking/references/examples-debug.md +91 -0
- package/templates/.cursor/rules/sequential-thinking/scripts/format-thought.js +159 -0
- package/templates/.cursor/rules/sequential-thinking/scripts/process-thought.js +236 -0
- package/templates/.cursor/rules/sequential-thinking/sequential-thinking.mdc +86 -0
- package/templates/.cursor/rules/tattletale-reporter.mdc +64 -0
- package/templates/.cursor/rules/tester.mdc +221 -0
- package/templates/.cursor/rules/testing.mdc +215 -0
- package/templates/.cursor/rules/typescript-pro/references/advanced-patterns.md +100 -0
- package/templates/.cursor/rules/typescript-pro/references/best-practices.md +96 -0
- package/templates/.cursor/rules/typescript-pro/references/conditional-types.md +85 -0
- package/templates/.cursor/rules/typescript-pro/references/generics.md +97 -0
- package/templates/.cursor/rules/typescript-pro/references/mapped-types.md +99 -0
- package/templates/.cursor/rules/typescript-pro/references/template-literals.md +85 -0
- package/templates/.cursor/rules/typescript-pro/references/type-inference.md +94 -0
- package/templates/.cursor/rules/typescript-pro/references/utility-types.md +96 -0
- package/templates/.cursor/rules/typescript-pro/typescript-pro.mdc +101 -0
- package/templates/.cursor/rules/typescript-pro.mdc +129 -0
- package/templates/.cursor/rules/ui-ux-designer.mdc +117 -0
- package/templates/.cursor/scripts/helper.py +723 -0
- package/templates/.cursor/settings.json +5 -0
- package/templates/.kiro/steering/qa-standards.md +84 -0
- package/templates/.kiro/steering/test-patterns.md +62 -0
- package/templates/.kiro/steering/tool-integration.md +73 -0
|
@@ -0,0 +1,1089 @@
|
|
|
1
|
+
# Mobile Debugging Strategies
|
|
2
|
+
|
|
3
|
+
Comprehensive debugging techniques, tools, and best practices for mobile development (2024-2025).
|
|
4
|
+
|
|
5
|
+
## Mobile Debugging Mindset
|
|
6
|
+
|
|
7
|
+
### Unique Mobile Challenges
|
|
8
|
+
|
|
9
|
+
1. **Device Diversity** - Thousands of device/OS combinations
|
|
10
|
+
2. **Resource Constraints** - Limited CPU, memory, battery
|
|
11
|
+
3. **Network Variability** - From WiFi to 2G, offline scenarios
|
|
12
|
+
4. **Platform Differences** - iOS vs Android behavior
|
|
13
|
+
5. **Real Device Testing** - Simulators don't show real performance
|
|
14
|
+
6. **Limited Debugging Access** - Can't SSH into production devices
|
|
15
|
+
|
|
16
|
+
### Debugging Philosophy
|
|
17
|
+
|
|
18
|
+
**Golden Rules:**
|
|
19
|
+
1. **Test on real devices** - Simulators lie about performance
|
|
20
|
+
2. **Reproduce consistently** - Intermittent bugs need reproducible steps
|
|
21
|
+
3. **Check the obvious first** - Network, permissions, resources
|
|
22
|
+
4. **Isolate the platform** - Is it iOS-specific, Android-specific, or both?
|
|
23
|
+
5. **Monitor resources** - CPU, memory, battery, network
|
|
24
|
+
6. **Read the logs** - Device logs contain critical clues
|
|
25
|
+
|
|
26
|
+
## Platform-Specific Debugging Tools
|
|
27
|
+
|
|
28
|
+
### iOS Debugging
|
|
29
|
+
|
|
30
|
+
**1. Xcode Debugger**
|
|
31
|
+
|
|
32
|
+
```swift
|
|
33
|
+
// Breakpoint debugging
|
|
34
|
+
func fetchUserData(userId: String) {
|
|
35
|
+
// Set breakpoint here
|
|
36
|
+
let url = URL(string: "https://api.example.com/users/\(userId)")!
|
|
37
|
+
|
|
38
|
+
// LLDB commands:
|
|
39
|
+
// po userId - print object
|
|
40
|
+
// p url - print variable
|
|
41
|
+
// bt - backtrace
|
|
42
|
+
// c - continue
|
|
43
|
+
// step - step into
|
|
44
|
+
// next - step over
|
|
45
|
+
}
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
**LLDB Advanced Commands:**
|
|
49
|
+
```bash
|
|
50
|
+
# Conditional breakpoint
|
|
51
|
+
breakpoint set --name fetchUserData --condition userId == "123"
|
|
52
|
+
|
|
53
|
+
# Watchpoint (break on value change)
|
|
54
|
+
watchpoint set variable self.counter
|
|
55
|
+
|
|
56
|
+
# Print view hierarchy
|
|
57
|
+
po UIApplication.shared.keyWindow?.value(forKey: "recursiveDescription")
|
|
58
|
+
|
|
59
|
+
# Print all properties
|
|
60
|
+
po self.value(forKey: "description")
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
**2. Instruments (Performance Profiling)**
|
|
64
|
+
|
|
65
|
+
**Time Profiler** - CPU usage
|
|
66
|
+
```
|
|
67
|
+
1. Xcode → Product → Profile
|
|
68
|
+
2. Select "Time Profiler"
|
|
69
|
+
3. Record while using app
|
|
70
|
+
4. Identify hot methods (high self time)
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
**Allocations** - Memory usage
|
|
74
|
+
```
|
|
75
|
+
1. Select "Allocations" instrument
|
|
76
|
+
2. Look for memory growth
|
|
77
|
+
3. Filter by object type
|
|
78
|
+
4. Find allocation stack trace
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
**Leaks** - Memory leaks
|
|
82
|
+
```
|
|
83
|
+
1. Select "Leaks" instrument
|
|
84
|
+
2. Leaks shown in red
|
|
85
|
+
3. Click leak for stack trace
|
|
86
|
+
4. Fix retain cycles
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
**Network** - API debugging
|
|
90
|
+
```
|
|
91
|
+
1. Select "Network" instrument
|
|
92
|
+
2. See all HTTP requests
|
|
93
|
+
3. Response times, sizes
|
|
94
|
+
4. Failed requests highlighted
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
**3. View Debugging**
|
|
98
|
+
|
|
99
|
+
```swift
|
|
100
|
+
// View hierarchy in Xcode
|
|
101
|
+
// Debug → View Debugging → Capture View Hierarchy
|
|
102
|
+
|
|
103
|
+
// Runtime inspection
|
|
104
|
+
#if DEBUG
|
|
105
|
+
import SwiftUI
|
|
106
|
+
|
|
107
|
+
struct ContentView: View {
|
|
108
|
+
var body: some View {
|
|
109
|
+
VStack {
|
|
110
|
+
Text("Hello")
|
|
111
|
+
}
|
|
112
|
+
.onAppear {
|
|
113
|
+
// Print view tree for debugging
|
|
114
|
+
print(Mirror(reflecting: self.body))
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
#endif
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
**4. Console.app (System Logs)**
|
|
122
|
+
|
|
123
|
+
```bash
|
|
124
|
+
# Filter logs by process
|
|
125
|
+
log stream --predicate 'processImagePath contains "YourApp"' --level debug
|
|
126
|
+
|
|
127
|
+
# Filter by subsystem
|
|
128
|
+
log stream --predicate 'subsystem == "com.yourcompany.yourapp"'
|
|
129
|
+
|
|
130
|
+
# Show only errors
|
|
131
|
+
log stream --predicate 'processImagePath contains "YourApp"' --level error
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
**5. Network Link Conditioner**
|
|
135
|
+
|
|
136
|
+
```
|
|
137
|
+
Settings → Developer → Network Link Conditioner
|
|
138
|
+
|
|
139
|
+
Simulate:
|
|
140
|
+
- 3G, LTE, WiFi
|
|
141
|
+
- High latency
|
|
142
|
+
- Packet loss
|
|
143
|
+
- Bandwidth limits
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
### Android Debugging
|
|
147
|
+
|
|
148
|
+
**1. Android Studio Debugger**
|
|
149
|
+
|
|
150
|
+
```kotlin
|
|
151
|
+
// Breakpoint debugging
|
|
152
|
+
fun fetchUserData(userId: String) {
|
|
153
|
+
// Set breakpoint here
|
|
154
|
+
val url = "https://api.example.com/users/$userId"
|
|
155
|
+
|
|
156
|
+
// Debugger commands:
|
|
157
|
+
// Evaluate expression: Alt+F8 (Windows) / Cmd+F8 (Mac)
|
|
158
|
+
// Step over: F8
|
|
159
|
+
// Step into: F7
|
|
160
|
+
// Resume: F9
|
|
161
|
+
}
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
**Advanced Debugger Features:**
|
|
165
|
+
```kotlin
|
|
166
|
+
// Conditional breakpoint
|
|
167
|
+
// Right-click breakpoint → Condition: userId == "123"
|
|
168
|
+
|
|
169
|
+
// Logpoint (log without stopping)
|
|
170
|
+
// Right-click breakpoint → More → Check "Evaluate and log"
|
|
171
|
+
|
|
172
|
+
// Exception breakpoint
|
|
173
|
+
// Run → View Breakpoints → + → Java Exception Breakpoints
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
**2. Android Profiler**
|
|
177
|
+
|
|
178
|
+
**CPU Profiler:**
|
|
179
|
+
```
|
|
180
|
+
View → Tool Windows → Profiler → CPU
|
|
181
|
+
- Record trace
|
|
182
|
+
- Identify slow methods
|
|
183
|
+
- Flame chart shows call hierarchy
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
**Memory Profiler:**
|
|
187
|
+
```
|
|
188
|
+
View → Tool Windows → Profiler → Memory
|
|
189
|
+
- Track allocations
|
|
190
|
+
- Heap dump analysis
|
|
191
|
+
- Find memory leaks
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
**Network Profiler:**
|
|
195
|
+
```
|
|
196
|
+
View → Tool Windows → Profiler → Network
|
|
197
|
+
- All HTTP requests
|
|
198
|
+
- Request/response details
|
|
199
|
+
- Timeline view
|
|
200
|
+
```
|
|
201
|
+
|
|
202
|
+
**3. Layout Inspector**
|
|
203
|
+
|
|
204
|
+
```
|
|
205
|
+
Tools → Layout Inspector
|
|
206
|
+
|
|
207
|
+
Features:
|
|
208
|
+
- 3D view hierarchy
|
|
209
|
+
- Live layout updates
|
|
210
|
+
- View properties
|
|
211
|
+
- Constraints visualization
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
**4. ADB (Android Debug Bridge)**
|
|
215
|
+
|
|
216
|
+
```bash
|
|
217
|
+
# View device logs
|
|
218
|
+
adb logcat
|
|
219
|
+
|
|
220
|
+
# Filter by app
|
|
221
|
+
adb logcat | grep com.yourcompany.yourapp
|
|
222
|
+
|
|
223
|
+
# Filter by tag
|
|
224
|
+
adb logcat MyTag:D *:S
|
|
225
|
+
|
|
226
|
+
# Clear logs
|
|
227
|
+
adb logcat -c
|
|
228
|
+
|
|
229
|
+
# Install APK
|
|
230
|
+
adb install app-debug.apk
|
|
231
|
+
|
|
232
|
+
# Uninstall app
|
|
233
|
+
adb uninstall com.yourcompany.yourapp
|
|
234
|
+
|
|
235
|
+
# Take screenshot
|
|
236
|
+
adb shell screencap -p /sdcard/screenshot.png
|
|
237
|
+
adb pull /sdcard/screenshot.png
|
|
238
|
+
|
|
239
|
+
# Screen recording
|
|
240
|
+
adb shell screenrecord /sdcard/demo.mp4
|
|
241
|
+
adb pull /sdcard/demo.mp4
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
**5. Network Simulation**
|
|
245
|
+
|
|
246
|
+
```bash
|
|
247
|
+
# Emulator network throttling
|
|
248
|
+
# Settings → Network → Network Profile
|
|
249
|
+
|
|
250
|
+
# Or via ADB
|
|
251
|
+
adb shell setprop net.dns1 8.8.8.8
|
|
252
|
+
```
|
|
253
|
+
|
|
254
|
+
### React Native Debugging
|
|
255
|
+
|
|
256
|
+
**1. React DevTools**
|
|
257
|
+
|
|
258
|
+
```bash
|
|
259
|
+
# Install
|
|
260
|
+
npm install -g react-devtools
|
|
261
|
+
|
|
262
|
+
# Launch
|
|
263
|
+
react-devtools
|
|
264
|
+
|
|
265
|
+
# In app: Shake device → "Debug with React DevTools"
|
|
266
|
+
```
|
|
267
|
+
|
|
268
|
+
**2. Flipper (Recommended)**
|
|
269
|
+
|
|
270
|
+
```bash
|
|
271
|
+
# Install
|
|
272
|
+
npm install -g flipper
|
|
273
|
+
|
|
274
|
+
# Configure in app
|
|
275
|
+
# Add flipper packages to your app
|
|
276
|
+
npm install --save-dev react-native-flipper
|
|
277
|
+
|
|
278
|
+
# Features:
|
|
279
|
+
# - Layout inspector
|
|
280
|
+
# - Network inspector
|
|
281
|
+
# - Redux DevTools
|
|
282
|
+
# - Database viewer
|
|
283
|
+
# - Shared Preferences viewer
|
|
284
|
+
```
|
|
285
|
+
|
|
286
|
+
**3. Chrome DevTools**
|
|
287
|
+
|
|
288
|
+
```javascript
|
|
289
|
+
// In app: Shake device → "Debug"
|
|
290
|
+
// Opens Chrome DevTools
|
|
291
|
+
|
|
292
|
+
// Console.log appears in Chrome
|
|
293
|
+
console.log('User data:', userData);
|
|
294
|
+
|
|
295
|
+
// Set breakpoints in source code
|
|
296
|
+
debugger; // Pauses execution
|
|
297
|
+
|
|
298
|
+
// Network tab shows API calls
|
|
299
|
+
fetch('https://api.example.com/users')
|
|
300
|
+
.then(res => res.json())
|
|
301
|
+
.then(data => console.log(data));
|
|
302
|
+
```
|
|
303
|
+
|
|
304
|
+
**4. React Native Debugger (Standalone)**
|
|
305
|
+
|
|
306
|
+
```bash
|
|
307
|
+
# Install
|
|
308
|
+
brew install --cask react-native-debugger
|
|
309
|
+
|
|
310
|
+
# Launch
|
|
311
|
+
open "rndebugger://set-debugger-loc?host=localhost&port=8081"
|
|
312
|
+
|
|
313
|
+
# Features:
|
|
314
|
+
# - Redux DevTools
|
|
315
|
+
# - React DevTools
|
|
316
|
+
# - Network Inspector
|
|
317
|
+
# - Console
|
|
318
|
+
```
|
|
319
|
+
|
|
320
|
+
**5. Performance Monitor**
|
|
321
|
+
|
|
322
|
+
```javascript
|
|
323
|
+
// Show in-app performance overlay
|
|
324
|
+
// Shake device → "Show Perf Monitor"
|
|
325
|
+
|
|
326
|
+
// Shows:
|
|
327
|
+
// - RAM usage
|
|
328
|
+
// - JS frame rate
|
|
329
|
+
// - UI frame rate
|
|
330
|
+
// - Views count
|
|
331
|
+
```
|
|
332
|
+
|
|
333
|
+
**6. LogBox**
|
|
334
|
+
|
|
335
|
+
```javascript
|
|
336
|
+
// Ignore specific warnings
|
|
337
|
+
import { LogBox } from 'react-native';
|
|
338
|
+
|
|
339
|
+
LogBox.ignoreLogs([
|
|
340
|
+
'Warning: componentWillReceiveProps',
|
|
341
|
+
]);
|
|
342
|
+
|
|
343
|
+
// Ignore all logs (NOT recommended)
|
|
344
|
+
LogBox.ignoreAllLogs();
|
|
345
|
+
```
|
|
346
|
+
|
|
347
|
+
### Flutter Debugging
|
|
348
|
+
|
|
349
|
+
**1. DevTools**
|
|
350
|
+
|
|
351
|
+
```bash
|
|
352
|
+
# Launch from VS Code
|
|
353
|
+
# Debug → Open DevTools
|
|
354
|
+
|
|
355
|
+
# Or from command line
|
|
356
|
+
flutter pub global activate devtools
|
|
357
|
+
flutter pub global run devtools
|
|
358
|
+
|
|
359
|
+
# Features:
|
|
360
|
+
# - Widget inspector
|
|
361
|
+
# - Timeline view
|
|
362
|
+
# - Memory profiler
|
|
363
|
+
# - Network profiler
|
|
364
|
+
# - Logging view
|
|
365
|
+
```
|
|
366
|
+
|
|
367
|
+
**2. Widget Inspector**
|
|
368
|
+
|
|
369
|
+
```dart
|
|
370
|
+
// In DevTools: Inspector tab
|
|
371
|
+
|
|
372
|
+
// Debug paint (show layout borders)
|
|
373
|
+
// Ctrl+Shift+P → "Toggle Debug Painting"
|
|
374
|
+
|
|
375
|
+
// Print widget tree
|
|
376
|
+
debugDumpApp();
|
|
377
|
+
|
|
378
|
+
// Print render tree
|
|
379
|
+
debugDumpRenderTree();
|
|
380
|
+
|
|
381
|
+
// Print layer tree
|
|
382
|
+
debugDumpLayerTree();
|
|
383
|
+
```
|
|
384
|
+
|
|
385
|
+
**3. Performance Overlay**
|
|
386
|
+
|
|
387
|
+
```dart
|
|
388
|
+
void main() {
|
|
389
|
+
runApp(
|
|
390
|
+
MaterialApp(
|
|
391
|
+
showPerformanceOverlay: true, // FPS counter
|
|
392
|
+
debugShowCheckedModeBanner: false,
|
|
393
|
+
home: MyApp(),
|
|
394
|
+
),
|
|
395
|
+
);
|
|
396
|
+
}
|
|
397
|
+
```
|
|
398
|
+
|
|
399
|
+
**4. Logging**
|
|
400
|
+
|
|
401
|
+
```dart
|
|
402
|
+
import 'dart:developer' as developer;
|
|
403
|
+
|
|
404
|
+
// Simple print
|
|
405
|
+
print('User ID: $userId');
|
|
406
|
+
|
|
407
|
+
// Structured logging
|
|
408
|
+
developer.log(
|
|
409
|
+
'User logged in',
|
|
410
|
+
name: 'app.auth',
|
|
411
|
+
error: error,
|
|
412
|
+
stackTrace: stackTrace,
|
|
413
|
+
);
|
|
414
|
+
|
|
415
|
+
// Timeline events
|
|
416
|
+
developer.Timeline.startSync('fetchUsers');
|
|
417
|
+
await fetchUsers();
|
|
418
|
+
developer.Timeline.finishSync();
|
|
419
|
+
```
|
|
420
|
+
|
|
421
|
+
**5. Breakpoint Debugging**
|
|
422
|
+
|
|
423
|
+
```dart
|
|
424
|
+
// Set breakpoints in VS Code or Android Studio
|
|
425
|
+
Future<User> fetchUser(String id) async {
|
|
426
|
+
// Breakpoint here
|
|
427
|
+
final response = await http.get(Uri.parse('https://api.example.com/users/$id'));
|
|
428
|
+
|
|
429
|
+
// Debugger console commands:
|
|
430
|
+
// p variable - print variable
|
|
431
|
+
// Step over: F10
|
|
432
|
+
// Step into: F11
|
|
433
|
+
// Continue: F5
|
|
434
|
+
return User.fromJson(jsonDecode(response.body));
|
|
435
|
+
}
|
|
436
|
+
```
|
|
437
|
+
|
|
438
|
+
## UI Debugging
|
|
439
|
+
|
|
440
|
+
### Layout Issues
|
|
441
|
+
|
|
442
|
+
**iOS (SwiftUI):**
|
|
443
|
+
```swift
|
|
444
|
+
struct ContentView: View {
|
|
445
|
+
var body: some View {
|
|
446
|
+
VStack {
|
|
447
|
+
Text("Hello")
|
|
448
|
+
}
|
|
449
|
+
.border(Color.red) // Debug border
|
|
450
|
+
.background(Color.yellow.opacity(0.3)) // Debug background
|
|
451
|
+
}
|
|
452
|
+
}
|
|
453
|
+
|
|
454
|
+
// Print layout info
|
|
455
|
+
Text("Hello")
|
|
456
|
+
.onAppear {
|
|
457
|
+
print("Frame: \(UIScreen.main.bounds)")
|
|
458
|
+
}
|
|
459
|
+
```
|
|
460
|
+
|
|
461
|
+
**Android (Jetpack Compose):**
|
|
462
|
+
```kotlin
|
|
463
|
+
@Composable
|
|
464
|
+
fun DebugLayout() {
|
|
465
|
+
Column(
|
|
466
|
+
modifier = Modifier
|
|
467
|
+
.border(2.dp, Color.Red) // Debug border
|
|
468
|
+
.background(Color.Yellow.copy(alpha = 0.3f)) // Debug background
|
|
469
|
+
) {
|
|
470
|
+
Text("Hello")
|
|
471
|
+
}
|
|
472
|
+
}
|
|
473
|
+
|
|
474
|
+
// Show layout bounds in developer options
|
|
475
|
+
// Settings → Developer Options → Show layout bounds
|
|
476
|
+
```
|
|
477
|
+
|
|
478
|
+
**React Native:**
|
|
479
|
+
```javascript
|
|
480
|
+
// Debug borders
|
|
481
|
+
<View style={{ borderWidth: 1, borderColor: 'red' }}>
|
|
482
|
+
<Text>Hello</Text>
|
|
483
|
+
</View>
|
|
484
|
+
|
|
485
|
+
// Layout animation debugging
|
|
486
|
+
import { LayoutAnimation, UIManager } from 'react-native';
|
|
487
|
+
|
|
488
|
+
UIManager.setLayoutAnimationEnabledExperimental &&
|
|
489
|
+
UIManager.setLayoutAnimationEnabledExperimental(true);
|
|
490
|
+
|
|
491
|
+
// Inspector
|
|
492
|
+
// Shake device → "Toggle Inspector"
|
|
493
|
+
// Shows element hierarchy and styles
|
|
494
|
+
```
|
|
495
|
+
|
|
496
|
+
**Flutter:**
|
|
497
|
+
```dart
|
|
498
|
+
// Debug paint
|
|
499
|
+
void main() {
|
|
500
|
+
debugPaintSizeEnabled = true; // Show layout guides
|
|
501
|
+
debugPaintBaselinesEnabled = true; // Show text baselines
|
|
502
|
+
debugPaintLayerBordersEnabled = true; // Show layer borders
|
|
503
|
+
runApp(MyApp());
|
|
504
|
+
}
|
|
505
|
+
|
|
506
|
+
// Widget boundaries
|
|
507
|
+
Container(
|
|
508
|
+
decoration: BoxDecoration(
|
|
509
|
+
border: Border.all(color: Colors.red, width: 2),
|
|
510
|
+
),
|
|
511
|
+
child: Text('Hello'),
|
|
512
|
+
)
|
|
513
|
+
```
|
|
514
|
+
|
|
515
|
+
### Animation Debugging
|
|
516
|
+
|
|
517
|
+
**Slow Animations:**
|
|
518
|
+
```dart
|
|
519
|
+
// Flutter: Slow down animations
|
|
520
|
+
timeDilation = 5.0; // 5x slower
|
|
521
|
+
|
|
522
|
+
// React Native: Slow animations
|
|
523
|
+
import { Animated } from 'react-native';
|
|
524
|
+
Animated.timing(value, {
|
|
525
|
+
toValue: 1,
|
|
526
|
+
duration: 3000, // Increase duration
|
|
527
|
+
});
|
|
528
|
+
```
|
|
529
|
+
|
|
530
|
+
**Animation Performance:**
|
|
531
|
+
```swift
|
|
532
|
+
// iOS: Core Animation Instrument
|
|
533
|
+
// Instruments → Core Animation
|
|
534
|
+
// Check for:
|
|
535
|
+
// - Dropped frames
|
|
536
|
+
// - Off-screen rendering
|
|
537
|
+
// - Blending layers
|
|
538
|
+
```
|
|
539
|
+
|
|
540
|
+
## Performance Debugging
|
|
541
|
+
|
|
542
|
+
### Frame Rate Issues (< 60 FPS)
|
|
543
|
+
|
|
544
|
+
**Diagnosis:**
|
|
545
|
+
|
|
546
|
+
**React Native:**
|
|
547
|
+
```javascript
|
|
548
|
+
// Enable performance monitor
|
|
549
|
+
// Shows JS and UI thread FPS
|
|
550
|
+
|
|
551
|
+
// Common issues:
|
|
552
|
+
// 1. Heavy computations in render
|
|
553
|
+
// 2. Large lists without virtualization
|
|
554
|
+
// 3. Unnecessary re-renders
|
|
555
|
+
```
|
|
556
|
+
|
|
557
|
+
**Solutions:**
|
|
558
|
+
```javascript
|
|
559
|
+
// ❌ Bad: Heavy computation in render
|
|
560
|
+
function UserList({ users }) {
|
|
561
|
+
const sortedUsers = users.sort((a, b) => a.name.localeCompare(b.name));
|
|
562
|
+
return <FlatList data={sortedUsers} />;
|
|
563
|
+
}
|
|
564
|
+
|
|
565
|
+
// ✅ Good: Memoize expensive operations
|
|
566
|
+
function UserList({ users }) {
|
|
567
|
+
const sortedUsers = useMemo(
|
|
568
|
+
() => users.sort((a, b) => a.name.localeCompare(b.name)),
|
|
569
|
+
[users]
|
|
570
|
+
);
|
|
571
|
+
return <FlatList data={sortedUsers} />;
|
|
572
|
+
}
|
|
573
|
+
|
|
574
|
+
// ❌ Bad: ScrollView with large data
|
|
575
|
+
<ScrollView>
|
|
576
|
+
{users.map(user => <UserCard key={user.id} user={user} />)}
|
|
577
|
+
</ScrollView>
|
|
578
|
+
|
|
579
|
+
// ✅ Good: FlatList with virtualization
|
|
580
|
+
<FlatList
|
|
581
|
+
data={users}
|
|
582
|
+
renderItem={({ item }) => <UserCard user={item} />}
|
|
583
|
+
keyExtractor={item => item.id}
|
|
584
|
+
windowSize={5}
|
|
585
|
+
initialNumToRender={10}
|
|
586
|
+
/>
|
|
587
|
+
```
|
|
588
|
+
|
|
589
|
+
**Flutter:**
|
|
590
|
+
```dart
|
|
591
|
+
// Check for:
|
|
592
|
+
// - Build phase too long
|
|
593
|
+
// - Layout phase too long
|
|
594
|
+
// - Paint phase too long
|
|
595
|
+
|
|
596
|
+
// Use const constructors
|
|
597
|
+
// ❌ Bad
|
|
598
|
+
Widget build(BuildContext context) {
|
|
599
|
+
return Container(child: Text('Hello'));
|
|
600
|
+
}
|
|
601
|
+
|
|
602
|
+
// ✅ Good
|
|
603
|
+
Widget build(BuildContext context) {
|
|
604
|
+
return const Text('Hello');
|
|
605
|
+
}
|
|
606
|
+
|
|
607
|
+
// Avoid expensive builds
|
|
608
|
+
// Use keys for stateful widgets
|
|
609
|
+
ListView.builder(
|
|
610
|
+
itemBuilder: (context, index) {
|
|
611
|
+
return UserCard(
|
|
612
|
+
key: ValueKey(users[index].id), // Preserve state
|
|
613
|
+
user: users[index],
|
|
614
|
+
);
|
|
615
|
+
},
|
|
616
|
+
)
|
|
617
|
+
```
|
|
618
|
+
|
|
619
|
+
### Memory Issues
|
|
620
|
+
|
|
621
|
+
**Detection:**
|
|
622
|
+
|
|
623
|
+
**iOS:**
|
|
624
|
+
```
|
|
625
|
+
Xcode → Debug Navigator → Memory
|
|
626
|
+
- Watch memory graph
|
|
627
|
+
- Look for continuous growth
|
|
628
|
+
```
|
|
629
|
+
|
|
630
|
+
**Android:**
|
|
631
|
+
```
|
|
632
|
+
Android Studio → Profiler → Memory
|
|
633
|
+
- Take heap dump
|
|
634
|
+
- Analyze retained objects
|
|
635
|
+
```
|
|
636
|
+
|
|
637
|
+
**Common Causes:**
|
|
638
|
+
|
|
639
|
+
```javascript
|
|
640
|
+
// React Native: Memory leaks
|
|
641
|
+
|
|
642
|
+
// ❌ Bad: Event listener not removed
|
|
643
|
+
useEffect(() => {
|
|
644
|
+
EventEmitter.on('data', handleData);
|
|
645
|
+
// Missing cleanup
|
|
646
|
+
}, []);
|
|
647
|
+
|
|
648
|
+
// ✅ Good: Cleanup
|
|
649
|
+
useEffect(() => {
|
|
650
|
+
EventEmitter.on('data', handleData);
|
|
651
|
+
return () => {
|
|
652
|
+
EventEmitter.off('data', handleData);
|
|
653
|
+
};
|
|
654
|
+
}, []);
|
|
655
|
+
|
|
656
|
+
// ❌ Bad: Timer not cleared
|
|
657
|
+
useEffect(() => {
|
|
658
|
+
setInterval(() => {
|
|
659
|
+
console.log('tick');
|
|
660
|
+
}, 1000);
|
|
661
|
+
}, []);
|
|
662
|
+
|
|
663
|
+
// ✅ Good: Clear timer
|
|
664
|
+
useEffect(() => {
|
|
665
|
+
const timer = setInterval(() => {
|
|
666
|
+
console.log('tick');
|
|
667
|
+
}, 1000);
|
|
668
|
+
return () => clearInterval(timer);
|
|
669
|
+
}, []);
|
|
670
|
+
```
|
|
671
|
+
|
|
672
|
+
```dart
|
|
673
|
+
// Flutter: Dispose controllers
|
|
674
|
+
class MyWidget extends StatefulWidget {
|
|
675
|
+
@override
|
|
676
|
+
_MyWidgetState createState() => _MyWidgetState();
|
|
677
|
+
}
|
|
678
|
+
|
|
679
|
+
class _MyWidgetState extends State<MyWidget> {
|
|
680
|
+
late TextEditingController _controller;
|
|
681
|
+
|
|
682
|
+
@override
|
|
683
|
+
void initState() {
|
|
684
|
+
super.initState();
|
|
685
|
+
_controller = TextEditingController();
|
|
686
|
+
}
|
|
687
|
+
|
|
688
|
+
@override
|
|
689
|
+
void dispose() {
|
|
690
|
+
_controller.dispose(); // Must dispose
|
|
691
|
+
super.dispose();
|
|
692
|
+
}
|
|
693
|
+
|
|
694
|
+
@override
|
|
695
|
+
Widget build(BuildContext context) {
|
|
696
|
+
return TextField(controller: _controller);
|
|
697
|
+
}
|
|
698
|
+
}
|
|
699
|
+
```
|
|
700
|
+
|
|
701
|
+
## Network Debugging
|
|
702
|
+
|
|
703
|
+
### HTTP Debugging
|
|
704
|
+
|
|
705
|
+
**iOS (Proxyman / Charles)**
|
|
706
|
+
```
|
|
707
|
+
1. Install Proxyman (free) or Charles
|
|
708
|
+
2. Configure device proxy
|
|
709
|
+
3. Install SSL certificate
|
|
710
|
+
4. View all HTTP traffic
|
|
711
|
+
```
|
|
712
|
+
|
|
713
|
+
**Android (Charles / Flipper)**
|
|
714
|
+
```
|
|
715
|
+
1. Install Charles Proxy
|
|
716
|
+
2. Configure device proxy: Settings → WiFi → Modify → Proxy
|
|
717
|
+
3. Install Charles certificate
|
|
718
|
+
4. View all HTTP requests/responses
|
|
719
|
+
```
|
|
720
|
+
|
|
721
|
+
**React Native (Flipper Network Plugin)**
|
|
722
|
+
```javascript
|
|
723
|
+
// Automatically captures all fetch/axios requests
|
|
724
|
+
fetch('https://api.example.com/users')
|
|
725
|
+
.then(res => res.json())
|
|
726
|
+
.then(data => console.log(data));
|
|
727
|
+
|
|
728
|
+
// View in Flipper:
|
|
729
|
+
// - Request/response headers
|
|
730
|
+
// - Request/response body
|
|
731
|
+
// - Timing information
|
|
732
|
+
```
|
|
733
|
+
|
|
734
|
+
**Flutter (DevTools Network Tab)**
|
|
735
|
+
```dart
|
|
736
|
+
// Automatically captures HTTP requests
|
|
737
|
+
final response = await http.get(
|
|
738
|
+
Uri.parse('https://api.example.com/users')
|
|
739
|
+
);
|
|
740
|
+
|
|
741
|
+
// View in DevTools Network tab:
|
|
742
|
+
// - All HTTP requests
|
|
743
|
+
// - Headers and body
|
|
744
|
+
// - Response times
|
|
745
|
+
```
|
|
746
|
+
|
|
747
|
+
### Network Simulation
|
|
748
|
+
|
|
749
|
+
**Test scenarios:**
|
|
750
|
+
- Slow network (3G, 2G)
|
|
751
|
+
- High latency (500ms+)
|
|
752
|
+
- Packet loss (10%)
|
|
753
|
+
- Offline mode
|
|
754
|
+
|
|
755
|
+
**iOS:**
|
|
756
|
+
```
|
|
757
|
+
Settings → Developer → Network Link Conditioner
|
|
758
|
+
```
|
|
759
|
+
|
|
760
|
+
**Android:**
|
|
761
|
+
```
|
|
762
|
+
Emulator: Settings → Network → Network Profile
|
|
763
|
+
```
|
|
764
|
+
|
|
765
|
+
## Crash Debugging
|
|
766
|
+
|
|
767
|
+
### Crash Reporting Services
|
|
768
|
+
|
|
769
|
+
**Firebase Crashlytics (Recommended)**
|
|
770
|
+
|
|
771
|
+
**React Native:**
|
|
772
|
+
```javascript
|
|
773
|
+
import crashlytics from '@react-native-firebase/crashlytics';
|
|
774
|
+
|
|
775
|
+
// Log custom events
|
|
776
|
+
crashlytics().log('User pressed purchase button');
|
|
777
|
+
|
|
778
|
+
// Set user identifier
|
|
779
|
+
crashlytics().setUserId(userId);
|
|
780
|
+
|
|
781
|
+
// Record non-fatal error
|
|
782
|
+
try {
|
|
783
|
+
await fetchData();
|
|
784
|
+
} catch (error) {
|
|
785
|
+
crashlytics().recordError(error);
|
|
786
|
+
}
|
|
787
|
+
|
|
788
|
+
// Force crash for testing
|
|
789
|
+
crashlytics().crash();
|
|
790
|
+
```
|
|
791
|
+
|
|
792
|
+
**Flutter:**
|
|
793
|
+
```dart
|
|
794
|
+
import 'package:firebase_crashlytics/firebase_crashlytics.dart';
|
|
795
|
+
|
|
796
|
+
// Catch errors
|
|
797
|
+
FlutterError.onError = FirebaseCrashlytics.instance.recordFlutterError;
|
|
798
|
+
|
|
799
|
+
// Catch async errors
|
|
800
|
+
runZonedGuarded(() {
|
|
801
|
+
runApp(MyApp());
|
|
802
|
+
}, (error, stackTrace) {
|
|
803
|
+
FirebaseCrashlytics.instance.recordError(error, stackTrace);
|
|
804
|
+
});
|
|
805
|
+
|
|
806
|
+
// Log custom events
|
|
807
|
+
FirebaseCrashlytics.instance.log('User pressed purchase');
|
|
808
|
+
|
|
809
|
+
// Set user ID
|
|
810
|
+
FirebaseCrashlytics.instance.setUserIdentifier(userId);
|
|
811
|
+
```
|
|
812
|
+
|
|
813
|
+
**iOS Native:**
|
|
814
|
+
```swift
|
|
815
|
+
import FirebaseCrashlytics
|
|
816
|
+
|
|
817
|
+
// Log event
|
|
818
|
+
Crashlytics.crashlytics().log("User tapped button")
|
|
819
|
+
|
|
820
|
+
// Set user ID
|
|
821
|
+
Crashlytics.crashlytics().setUserID(userId)
|
|
822
|
+
|
|
823
|
+
// Record error
|
|
824
|
+
Crashlytics.crashlytics().record(error: error)
|
|
825
|
+
```
|
|
826
|
+
|
|
827
|
+
**Android Native:**
|
|
828
|
+
```kotlin
|
|
829
|
+
import com.google.firebase.crashlytics.FirebaseCrashlytics
|
|
830
|
+
|
|
831
|
+
// Log event
|
|
832
|
+
FirebaseCrashlytics.getInstance().log("User tapped button")
|
|
833
|
+
|
|
834
|
+
// Set user ID
|
|
835
|
+
FirebaseCrashlytics.getInstance().setUserId(userId)
|
|
836
|
+
|
|
837
|
+
// Record exception
|
|
838
|
+
FirebaseCrashlytics.getInstance().recordException(exception)
|
|
839
|
+
```
|
|
840
|
+
|
|
841
|
+
### Analyzing Crash Reports
|
|
842
|
+
|
|
843
|
+
**iOS (Xcode Organizer):**
|
|
844
|
+
```
|
|
845
|
+
Window → Organizer → Crashes
|
|
846
|
+
- Symbolicated crash logs
|
|
847
|
+
- Stack traces
|
|
848
|
+
- Crash counts
|
|
849
|
+
```
|
|
850
|
+
|
|
851
|
+
**Android (Play Console):**
|
|
852
|
+
```
|
|
853
|
+
Play Console → Quality → Crashes & ANRs
|
|
854
|
+
- Crash stack traces
|
|
855
|
+
- Affected devices
|
|
856
|
+
- OS versions
|
|
857
|
+
```
|
|
858
|
+
|
|
859
|
+
**Reading Stack Traces:**
|
|
860
|
+
```
|
|
861
|
+
Fatal Exception: java.lang.NullPointerException
|
|
862
|
+
Attempt to invoke virtual method 'java.lang.String User.getName()' on a null object reference
|
|
863
|
+
at com.example.app.UserService.displayUser(UserService.kt:42)
|
|
864
|
+
at com.example.app.MainActivity.onCreate(MainActivity.kt:23)
|
|
865
|
+
|
|
866
|
+
Fix:
|
|
867
|
+
1. Check line UserService.kt:42
|
|
868
|
+
2. User object is null
|
|
869
|
+
3. Add null check before accessing getName()
|
|
870
|
+
```
|
|
871
|
+
|
|
872
|
+
## Common Debugging Scenarios
|
|
873
|
+
|
|
874
|
+
### 1. App Crashes on Startup
|
|
875
|
+
|
|
876
|
+
**Steps:**
|
|
877
|
+
1. Check crash logs
|
|
878
|
+
2. Look for initialization errors
|
|
879
|
+
3. Verify dependencies loaded
|
|
880
|
+
4. Check permissions
|
|
881
|
+
|
|
882
|
+
**Example:**
|
|
883
|
+
```javascript
|
|
884
|
+
// React Native: Missing native dependency
|
|
885
|
+
// Error: Invariant Violation: Native module cannot be null
|
|
886
|
+
|
|
887
|
+
// Fix: Link native module
|
|
888
|
+
npx react-native link <module-name>
|
|
889
|
+
# or
|
|
890
|
+
cd ios && pod install
|
|
891
|
+
```
|
|
892
|
+
|
|
893
|
+
### 2. UI Not Updating
|
|
894
|
+
|
|
895
|
+
**React Native:**
|
|
896
|
+
```javascript
|
|
897
|
+
// ❌ Bad: Mutating state directly
|
|
898
|
+
this.state.users.push(newUser); // Won't trigger re-render
|
|
899
|
+
|
|
900
|
+
// ✅ Good: Create new state
|
|
901
|
+
this.setState({ users: [...this.state.users, newUser] });
|
|
902
|
+
```
|
|
903
|
+
|
|
904
|
+
**Flutter:**
|
|
905
|
+
```dart
|
|
906
|
+
// ❌ Bad: Not calling setState
|
|
907
|
+
void addUser(User user) {
|
|
908
|
+
users.add(user); // Won't rebuild
|
|
909
|
+
}
|
|
910
|
+
|
|
911
|
+
// ✅ Good: Call setState
|
|
912
|
+
void addUser(User user) {
|
|
913
|
+
setState(() {
|
|
914
|
+
users.add(user);
|
|
915
|
+
});
|
|
916
|
+
}
|
|
917
|
+
```
|
|
918
|
+
|
|
919
|
+
### 3. Image Not Loading
|
|
920
|
+
|
|
921
|
+
**Common causes:**
|
|
922
|
+
1. Wrong URL
|
|
923
|
+
2. CORS issues
|
|
924
|
+
3. SSL certificate issues
|
|
925
|
+
4. Network timeout
|
|
926
|
+
|
|
927
|
+
**Debugging:**
|
|
928
|
+
```javascript
|
|
929
|
+
// React Native
|
|
930
|
+
<Image
|
|
931
|
+
source={{ uri: imageUrl }}
|
|
932
|
+
onError={(error) => console.log('Image error:', error)}
|
|
933
|
+
onLoad={() => console.log('Image loaded')}
|
|
934
|
+
/>
|
|
935
|
+
|
|
936
|
+
// Check network tab for 404, 403, etc.
|
|
937
|
+
```
|
|
938
|
+
|
|
939
|
+
### 4. Keyboard Covering Input
|
|
940
|
+
|
|
941
|
+
**React Native:**
|
|
942
|
+
```javascript
|
|
943
|
+
import { KeyboardAvoidingView } from 'react-native';
|
|
944
|
+
|
|
945
|
+
<KeyboardAvoidingView
|
|
946
|
+
behavior={Platform.OS === 'ios' ? 'padding' : 'height'}
|
|
947
|
+
style={{ flex: 1 }}
|
|
948
|
+
>
|
|
949
|
+
<TextInput placeholder="Email" />
|
|
950
|
+
</KeyboardAvoidingView>
|
|
951
|
+
```
|
|
952
|
+
|
|
953
|
+
**Flutter:**
|
|
954
|
+
```dart
|
|
955
|
+
// Automatically handled by Scaffold
|
|
956
|
+
Scaffold(
|
|
957
|
+
resizeToAvoidBottomInset: true, // Default
|
|
958
|
+
body: TextField(),
|
|
959
|
+
)
|
|
960
|
+
```
|
|
961
|
+
|
|
962
|
+
### 5. Navigation Not Working
|
|
963
|
+
|
|
964
|
+
**React Navigation:**
|
|
965
|
+
```javascript
|
|
966
|
+
// ❌ Bad: Navigation prop not available
|
|
967
|
+
function MyComponent() {
|
|
968
|
+
navigation.navigate('Home'); // Error
|
|
969
|
+
}
|
|
970
|
+
|
|
971
|
+
// ✅ Good: Use hook or prop
|
|
972
|
+
function MyComponent({ navigation }) {
|
|
973
|
+
// or
|
|
974
|
+
// const navigation = useNavigation();
|
|
975
|
+
|
|
976
|
+
navigation.navigate('Home');
|
|
977
|
+
}
|
|
978
|
+
```
|
|
979
|
+
|
|
980
|
+
## Production Debugging
|
|
981
|
+
|
|
982
|
+
### Remote Logging
|
|
983
|
+
|
|
984
|
+
**LogRocket (Session Replay)**
|
|
985
|
+
```javascript
|
|
986
|
+
import LogRocket from '@logrocket/react-native';
|
|
987
|
+
|
|
988
|
+
LogRocket.init('your-app-id');
|
|
989
|
+
|
|
990
|
+
// Identify users
|
|
991
|
+
LogRocket.identify(userId, {
|
|
992
|
+
name: user.name,
|
|
993
|
+
email: user.email,
|
|
994
|
+
});
|
|
995
|
+
|
|
996
|
+
// Replays user sessions with:
|
|
997
|
+
// - Console logs
|
|
998
|
+
// - Network requests
|
|
999
|
+
// - UI interactions
|
|
1000
|
+
// - Redux actions
|
|
1001
|
+
```
|
|
1002
|
+
|
|
1003
|
+
### Feature Flags for Debugging
|
|
1004
|
+
|
|
1005
|
+
```javascript
|
|
1006
|
+
import { useFlags } from 'launchdarkly-react-native-client-sdk';
|
|
1007
|
+
|
|
1008
|
+
function MyComponent() {
|
|
1009
|
+
const { debugMode } = useFlags();
|
|
1010
|
+
|
|
1011
|
+
if (debugMode) {
|
|
1012
|
+
console.log('Debug info:', userData);
|
|
1013
|
+
}
|
|
1014
|
+
|
|
1015
|
+
return <View>...</View>;
|
|
1016
|
+
}
|
|
1017
|
+
|
|
1018
|
+
// Enable debug mode remotely for specific users
|
|
1019
|
+
```
|
|
1020
|
+
|
|
1021
|
+
### A/B Testing for Bug Investigation
|
|
1022
|
+
|
|
1023
|
+
```javascript
|
|
1024
|
+
// Gradually roll out fix
|
|
1025
|
+
if (abTest.variant === 'fixed') {
|
|
1026
|
+
return <FixedComponent />;
|
|
1027
|
+
} else {
|
|
1028
|
+
return <OriginalComponent />;
|
|
1029
|
+
}
|
|
1030
|
+
|
|
1031
|
+
// Monitor crash rates per variant
|
|
1032
|
+
```
|
|
1033
|
+
|
|
1034
|
+
## Debugging Checklist
|
|
1035
|
+
|
|
1036
|
+
**Before Filing Bug:**
|
|
1037
|
+
- [ ] Reproduce on real device
|
|
1038
|
+
- [ ] Check both iOS and Android
|
|
1039
|
+
- [ ] Test on multiple OS versions
|
|
1040
|
+
- [ ] Verify network connectivity
|
|
1041
|
+
- [ ] Check app permissions
|
|
1042
|
+
- [ ] Review recent code changes
|
|
1043
|
+
- [ ] Check crash logs
|
|
1044
|
+
|
|
1045
|
+
**Investigation:**
|
|
1046
|
+
- [ ] Enable debug logging
|
|
1047
|
+
- [ ] Use platform debugger
|
|
1048
|
+
- [ ] Profile performance if slow
|
|
1049
|
+
- [ ] Monitor memory usage
|
|
1050
|
+
- [ ] Check network requests
|
|
1051
|
+
- [ ] Inspect UI hierarchy
|
|
1052
|
+
|
|
1053
|
+
**Production Issues:**
|
|
1054
|
+
- [ ] Check crash reporting dashboard
|
|
1055
|
+
- [ ] Review user-reported issues
|
|
1056
|
+
- [ ] Analyze affected OS versions
|
|
1057
|
+
- [ ] Check affected devices
|
|
1058
|
+
- [ ] Review recent app releases
|
|
1059
|
+
- [ ] Compare crash-free rates
|
|
1060
|
+
|
|
1061
|
+
**After Fix:**
|
|
1062
|
+
- [ ] Test on real devices
|
|
1063
|
+
- [ ] Verify on affected OS versions
|
|
1064
|
+
- [ ] Add regression test
|
|
1065
|
+
- [ ] Staged rollout (10% → 100%)
|
|
1066
|
+
- [ ] Monitor crash rates
|
|
1067
|
+
|
|
1068
|
+
## Resources
|
|
1069
|
+
|
|
1070
|
+
**General:**
|
|
1071
|
+
- React Native Debugging: https://reactnative.dev/docs/debugging
|
|
1072
|
+
- Flutter DevTools: https://docs.flutter.dev/tools/devtools
|
|
1073
|
+
- iOS Debugging: https://developer.apple.com/documentation/xcode/debugging
|
|
1074
|
+
- Android Debugging: https://developer.android.com/studio/debug
|
|
1075
|
+
|
|
1076
|
+
**Crash Reporting:**
|
|
1077
|
+
- Firebase Crashlytics: https://firebase.google.com/docs/crashlytics
|
|
1078
|
+
- Sentry: https://docs.sentry.io/platforms/react-native/
|
|
1079
|
+
- Bugsnag: https://docs.bugsnag.com/
|
|
1080
|
+
|
|
1081
|
+
**Performance:**
|
|
1082
|
+
- iOS Instruments: https://developer.apple.com/instruments/
|
|
1083
|
+
- Android Profiler: https://developer.android.com/studio/profile
|
|
1084
|
+
- Flipper: https://fbflipper.com/
|
|
1085
|
+
|
|
1086
|
+
**Network:**
|
|
1087
|
+
- Proxyman: https://proxyman.io/
|
|
1088
|
+
- Charles Proxy: https://www.charlesproxy.com/
|
|
1089
|
+
- Flipper Network Plugin: https://fbflipper.com/docs/features/network-plugin/
|