@thierrynakoa/fire-flow 12.2.1 → 13.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CREDITS.md +25 -0
- package/DOMINION-FLOW-OVERVIEW.md +182 -38
- package/README.md +399 -455
- package/TROUBLESHOOTING.md +264 -264
- package/agents/fire-debugger.md +54 -0
- package/agents/fire-executor.md +1610 -1033
- package/agents/fire-fact-checker.md +1 -1
- package/agents/fire-planner.md +85 -17
- package/agents/fire-project-researcher.md +1 -1
- package/agents/fire-researcher.md +4 -22
- package/agents/{fire-phoenix-analyst.md → fire-resurrection-analyst.md} +394 -394
- package/agents/fire-reviewer.md +552 -499
- package/agents/fire-verifier.md +114 -19
- package/bin/cli.js +18 -101
- package/commands/fire-0-orient.md +2 -2
- package/commands/fire-1a-new.md +50 -15
- package/commands/fire-1c-setup.md +33 -5
- package/commands/fire-1d-discuss.md +87 -1
- package/commands/fire-2-plan.md +556 -527
- package/commands/fire-3-execute.md +2046 -1356
- package/commands/fire-4-verify.md +975 -906
- package/commands/fire-5-handoff.md +46 -5
- package/commands/fire-6-resume.md +2 -31
- package/commands/fire-add-new-skill.md +138 -19
- package/commands/fire-autonomous.md +14 -2
- package/commands/fire-complete-milestone.md +1 -1
- package/commands/fire-cost.md +179 -183
- package/commands/fire-debug.md +1 -6
- package/commands/fire-loop-resume.md +2 -2
- package/commands/fire-loop-stop.md +1 -1
- package/commands/fire-loop.md +2 -15
- package/commands/fire-map-codebase.md +1 -1
- package/commands/fire-migrate-database.md +548 -0
- package/commands/fire-new-milestone.md +1 -1
- package/commands/fire-reflect.md +1 -2
- package/commands/fire-research.md +142 -21
- package/commands/{fire-phoenix.md → fire-resurrect.md} +859 -603
- package/commands/fire-scaffold.md +297 -0
- package/commands/fire-search.md +1 -2
- package/commands/fire-security-scan.md +483 -484
- package/commands/fire-setup.md +359 -0
- package/commands/fire-skill.md +770 -0
- package/commands/fire-skills-diff.md +506 -506
- package/commands/fire-skills-history.md +388 -388
- package/commands/fire-skills-rollback.md +7 -7
- package/commands/fire-skills-sync.md +470 -470
- package/commands/fire-test.md +5 -5
- package/commands/fire-todos.md +1 -1
- package/commands/fire-update.md +5 -5
- package/commands/fire-validate-skills.md +282 -0
- package/commands/fire-vuln-scan.md +492 -493
- package/hooks/run-hook.sh +8 -8
- package/hooks/run-session-end.sh +7 -7
- package/hooks/session-end.sh +90 -90
- package/hooks/session-start.sh +1 -1
- package/package.json +4 -24
- package/plugin.json +7 -7
- package/references/autonomy-levels.md +235 -0
- package/references/behavioral-directives.md +95 -3
- package/references/blocker-tracking.md +1 -1
- package/references/circuit-breaker.md +93 -2
- package/references/context-engineering.md +227 -9
- package/references/honesty-protocols.md +70 -1
- package/references/issue-to-pr-pipeline.md +149 -150
- package/references/metrics-and-trends.md +1 -2
- package/references/research-improvements.md +4 -108
- package/references/sdlc-mapping.md +73 -0
- package/references/state-machine.md +151 -0
- package/skills-library/AVAILABLE_TOOLS_REFERENCE.md +333 -0
- package/skills-library/SKILLS-INDEX.md +57 -558
- package/skills-library/SKILLS_LIBRARY_INDEX.md +532 -0
- package/skills-library/_general/api-patterns/api-field-name-mismatch.md +107 -0
- package/skills-library/_general/api-patterns/streaming-command-timeout.md +122 -0
- package/skills-library/_general/api-patterns/streaming-proxy-cors-bypass.md +102 -0
- package/skills-library/_general/automation/settings-gui-generator.md +172 -0
- package/skills-library/_general/database-solutions/data-type-mapping-reference.md +181 -0
- package/skills-library/_general/database-solutions/mysql-limit-offset-string-coercion.md +102 -0
- package/skills-library/_general/database-solutions/mysql-to-pg-migration.md +195 -0
- package/skills-library/_general/database-solutions/orm-schema-portability.md +193 -0
- package/skills-library/_general/database-solutions/persistent-analysis-storage.md +207 -0
- package/skills-library/_general/database-solutions/pg-to-mysql-schema-migration-methodology.md +190 -0
- package/skills-library/_general/database-solutions/sql-dialect-compatibility-matrix.md +306 -0
- package/skills-library/_general/database-solutions/sqlite-to-pg-migration.md +219 -0
- package/skills-library/_general/frontend/canvas-bubble-animation-grouping.md +270 -0
- package/skills-library/_general/frontend/color-token-migration.md +112 -0
- package/skills-library/_general/frontend/framer-motion-layoutid-grouping.md +150 -0
- package/skills-library/_general/frontend/pyqt6-settings-dialog.md +191 -0
- package/skills-library/_general/frontend/react-flow-animated-layout-switching.md +101 -0
- package/skills-library/_general/frontend/react-hooks-order-debugging.md +141 -0
- package/skills-library/_general/frontend/redux-localstorage-auth-desync.md +126 -0
- package/skills-library/_general/frontend/safari-csp-theme-color-debugging.md +124 -0
- package/skills-library/_general/frontend/safari-sw-cache-poisoning.md +138 -0
- package/skills-library/_general/frontend/svg-sparkline-no-charting-library.md +131 -0
- package/skills-library/_general/growth-marketing/oss-daily-growth-intelligence.md +224 -0
- package/skills-library/_general/integrations/claude-code-local-mcp-integration.md +250 -0
- package/skills-library/_general/integrations/mcp-composite-tool-orchestration.md +200 -0
- package/skills-library/_general/methodology/AGENT_SDK_STANDALONE_TOOLING.md +181 -0
- package/skills-library/_general/methodology/AGENT_TEAMS_GUIDE.md +169 -0
- package/skills-library/_general/methodology/ALAS_STATEFUL_EXECUTION.md +207 -0
- package/skills-library/_general/methodology/AUTO_REVIEWER_SUBAGENT.md +211 -0
- package/skills-library/_general/methodology/CONSISTENCY_CHECK_AMBIGUITY_GATE.md +96 -0
- package/skills-library/_general/methodology/DEAD_ENDS_SHELF.md +4 -4
- package/skills-library/_general/methodology/DISTILL_NOT_DUMP.md +108 -0
- package/skills-library/_general/methodology/EXECUTION_PROGRESS_MONITOR.md +157 -0
- package/skills-library/_general/methodology/HIERARCHICAL_REVIEW_MARS.md +122 -0
- package/skills-library/_general/methodology/MCP_INTER_AGENT_BRIDGE.md +207 -0
- package/skills-library/_general/methodology/MERMAID_WIZARD_DIAGRAMS.md +77 -0
- package/skills-library/_general/methodology/MISSING_DIMENSION_DETECTOR.md +89 -0
- package/skills-library/_general/methodology/MULTI_AGENT_COORDINATION.md +397 -0
- package/skills-library/_general/methodology/OBSERVATION_MASKING.md +100 -0
- package/skills-library/_general/methodology/PHOENIX_REBUILD_METHODOLOGY.md +82 -11
- package/skills-library/_general/methodology/REVIEW_BACKTRACK_PANEL.md +140 -0
- package/skills-library/_general/methodology/REVIEW_FIX_LOOP.md +117 -0
- package/skills-library/_general/methodology/VOTING_VERDICT_ARBITRATION.md +155 -0
- package/skills-library/_general/methodology/ZERO_FRICTION_CLI_SETUP.md +2 -2
- package/skills-library/_general/methodology/dead-code-activation.md +123 -0
- package/skills-library/_general/methodology/debug-swarm-researcher-escape-hatch.md +240 -240
- package/skills-library/_general/methodology/shell-autonomous-loop-fixplan.md +1 -1
- package/skills-library/_general/patterns-standards/GOF_DESIGN_PATTERNS_FOR_AI_AGENTS.md +5 -5
- package/skills-library/_general/patterns-standards/cascading-failure-diagnosis.md +119 -0
- package/skills-library/_general/patterns-standards/domain-specific-layout-algorithms.md +209 -0
- package/skills-library/_general/patterns-standards/python-desktop-app-architecture.md +399 -0
- package/skills-library/_general/patterns-standards/realtime-monitoring-dashboard.md +457 -0
- package/skills-library/_general/patterns-standards/togglable-processing-pipeline.md +169 -0
- package/skills-library/_general/performance/liveclock-extraction.md +112 -0
- package/skills-library/_general/performance/ref-based-canvas-animation.md +117 -0
- package/skills-library/_general/performance/use-visible-interval.md +131 -0
- package/skills-library/_general/testing/playwright-firefox-withcredentials-auth-issue.md +104 -0
- package/skills-library/_quarantine/README.md +30 -0
- package/skills-library/api-patterns/BROADCAST_SCHEDULER_SHARED_EXECUTE_FUNCTION.md +150 -0
- package/skills-library/api-patterns/ERROR_RESPONSE_STANDARDS.md +145 -0
- package/skills-library/api-patterns/EXPRESS_ROUTE_ORDERING_MIDDLEWARE_INTERCEPTION.md +326 -0
- package/skills-library/api-patterns/PAGINATION_PATTERNS.md +137 -0
- package/skills-library/api-patterns/PODCAST_PROGRESS_TRACKING_THREE_ROOT_CAUSES.md +277 -0
- package/skills-library/api-patterns/RATE_LIMITING_TOGGLE.md +155 -0
- package/skills-library/api-patterns/graphql-content-queries.md +708 -0
- package/skills-library/appointment-scheduler-design.md +423 -0
- package/skills-library/automation/AUTO_POPULATE_COMPLETE_GUIDE.md +631 -0
- package/skills-library/automation/CC_WORKFLOW_STUDIO.md +83 -0
- package/skills-library/automation/CLAUDE_CODE_SWARM_MODE.md +95 -0
- package/skills-library/automation/DAEMON_TRIGGER_FILE_IPC.md +195 -0
- package/skills-library/automation/scheduled-content-publishing.md +608 -0
- package/skills-library/awesome-workflows/Blogging-Platform-Instructions/view_commands.md +25 -0
- package/skills-library/awesome-workflows/CREDENTIAL-SECURITY-WORKFLOW.md +109 -0
- package/skills-library/awesome-workflows/DEBUGGING-WORKFLOW.md +124 -0
- package/skills-library/awesome-workflows/Design-Review-Workflow/README.md +31 -0
- package/skills-library/awesome-workflows/Design-Review-Workflow/design-principles-example.md +129 -0
- package/skills-library/awesome-workflows/Design-Review-Workflow/design-review-agent.md +107 -0
- package/skills-library/awesome-workflows/Design-Review-Workflow/design-review-claude-md-snippet.md +24 -0
- package/skills-library/awesome-workflows/Design-Review-Workflow/design-review-slash-command.md +38 -0
- package/skills-library/awesome-workflows/PARALLEL-RESEARCH-WORKFLOW.md +89 -0
- package/skills-library/awesome-workflows/PHASE-EXECUTION-WORKFLOW.md +97 -0
- package/skills-library/awesome-workflows/SESSION-HANDOFF-WORKFLOW.md +116 -0
- package/skills-library/cms-patterns/content-branch-preview.md +515 -0
- package/skills-library/cms-patterns/inline-visual-editing.md +666 -0
- package/skills-library/cms-patterns/mdx-component-content.md +649 -0
- package/skills-library/cms-patterns/media-manager-abstraction.md +827 -0
- package/skills-library/cms-patterns/schema-driven-form-generator.md +838 -0
- package/skills-library/complexity-metrics/complexity-divider.md +707 -0
- package/skills-library/complexity-metrics/work-with-complexity.md +193 -0
- package/skills-library/creative-multimedia/animation-stack-guide.md +577 -0
- package/skills-library/creative-multimedia/audio-enhancement-pipeline.md +625 -0
- package/skills-library/creative-multimedia/content-repurposing-pipeline.md +1146 -0
- package/skills-library/creative-multimedia/data-visualization-generator.md +862 -0
- package/skills-library/creative-multimedia/doc-to-podcast-pipeline.md +2184 -0
- package/skills-library/creative-multimedia/ffmpeg-command-generator.md +405 -0
- package/skills-library/creative-multimedia/image-optimization-pipeline.md +605 -0
- package/skills-library/creative-multimedia/multi-format-content-generator.md +1759 -0
- package/skills-library/creative-multimedia/og-image-generator.md +635 -0
- package/skills-library/creative-multimedia/podcast-audio-composition.md +1355 -0
- package/skills-library/creative-multimedia/podcast-quality-evaluation.md +1452 -0
- package/skills-library/creative-multimedia/podcast-script-generation.md +1841 -0
- package/skills-library/creative-multimedia/svg-generation.md +750 -0
- package/skills-library/creative-multimedia/text-to-speech-provider-selector.md +1414 -0
- package/skills-library/creative-multimedia/transcription-pipeline-selector.md +677 -0
- package/skills-library/creative-multimedia/video-streaming-setup.md +559 -0
- package/skills-library/database-solutions/AI_RESPONSE_DATABASE_CACHING.md +520 -0
- package/skills-library/database-solutions/CONDITIONAL_SQL_MIGRATION_PATTERN.md +119 -0
- package/skills-library/database-solutions/DATABASE_COLUMN_NAME_MISMATCH.md +393 -0
- package/skills-library/database-solutions/DATABASE_SCHEMA.md +394 -0
- package/skills-library/database-solutions/DATABASE_SCHEMA_VERIFICATION_GUIDE.md +348 -0
- package/skills-library/database-solutions/DATABASE_STRATEGY.md +71 -0
- package/skills-library/database-solutions/ES_MODULE_SEED_SCRIPT_PATTERN.md +52 -0
- package/skills-library/database-solutions/MIGRATION_GUIDE.md +3 -0
- package/skills-library/database-solutions/PLPGSQL_VARIABLE_CONFLICT_FIX.md +208 -0
- package/skills-library/database-solutions/POSTGRESQL_JSONB_DOUBLE_STRINGIFY_FIX.md +245 -0
- package/skills-library/database-solutions/POSTGRESQL_LICENSE_TABLE_DESIGN.md +393 -0
- package/skills-library/database-solutions/POSTGRESQL_UUID_DOCUMENT_RAG_DUAL_SCOPE.md +732 -0
- package/skills-library/database-solutions/POSTGRES_SQL_TEMPLATE_BINDING_ERROR.md +240 -0
- package/skills-library/database-solutions/PRISMA_DB_PUSH_DATA_LOSS_PREVENTION.md +141 -0
- package/skills-library/database-solutions/PRODUCTION_QUERY_OPTIMIZATION_RESTART_FIX.md +389 -0
- package/skills-library/database-solutions/RLS_SECURITY_GUIDE.md +107 -0
- package/skills-library/database-solutions/SCHEMA_ENHANCEMENTS_GUIDE.md +373 -0
- package/skills-library/database-solutions/SCHEMA_MIGRATION_GUIDE.md +368 -0
- package/skills-library/database-solutions/SCHEMA_VERIFICATION_QUICK_REFERENCE.md +104 -0
- package/skills-library/database-solutions/ai-erd-generator.md +1213 -0
- package/skills-library/database-solutions/content-publishing-states.md +631 -0
- package/skills-library/database-solutions/database-schema-designer.md +522 -0
- package/skills-library/database-solutions/er-diagram-components.md +569 -0
- package/skills-library/database-solutions/er-to-ddl-mapping.md +1405 -0
- package/skills-library/database-solutions/erd-creator-textbook-research.md +433 -0
- package/skills-library/database-solutions/erd-react-flow-architecture.md +1965 -0
- package/skills-library/database-solutions/mariadb-aggregate-function-replacement.md +145 -0
- package/skills-library/database-solutions/normalization-validator.md +778 -0
- package/skills-library/database-solutions/postgres-full-text-search-content.md +494 -0
- package/skills-library/database-solutions/postgresql-to-mysql-runtime-translation.md +286 -0
- package/skills-library/database-solutions/regex-alternation-ordering-sql-types.md +92 -0
- package/skills-library/database-solutions/reserved-word-context-aware-quoting.md +142 -0
- package/skills-library/database-solutions/sql-ddl-generator.md +756 -0
- package/skills-library/database-solutions/supabase-connection-pooler-fix.md +102 -0
- package/skills-library/deployment-security/CPANEL_NODE_DEPLOYMENT.md +166 -0
- package/skills-library/deployment-security/DEPLOYMENT.md +275 -0
- package/skills-library/deployment-security/DEPLOYMENT_CHECKLIST.md +363 -0
- package/skills-library/deployment-security/DEPLOYMENT_PLAN.md +669 -0
- package/skills-library/deployment-security/KNEX_DATABASE_ABSTRACTION.md +444 -0
- package/skills-library/deployment-security/LICENSE_KEY_SYSTEM.md +206 -0
- package/skills-library/deployment-security/NODE18_DEPENDENCY_COMPATIBILITY.md +284 -0
- package/skills-library/deployment-security/PHP_INSTALLER_WIZARD_GUIDE.md +315 -0
- package/skills-library/deployment-security/PM2_ENVIRONMENT_VARIABLE_CACHING.md +256 -0
- package/skills-library/deployment-security/PM2_MEMORY_EXHAUSTION_FIX.md +370 -0
- package/skills-library/deployment-security/PRODUCTION_DEPLOYMENT_GUIDE.md +592 -0
- package/skills-library/deployment-security/PRODUCTION_HARDENING_DOCUMENTATION.md +307 -0
- package/skills-library/deployment-security/PRODUCTION_RECOVERY_CHERRY_PICK_PATTERN.md +202 -0
- package/skills-library/deployment-security/PYINSTALLER_CUDA_WHISPER_BUNDLING.md +236 -0
- package/skills-library/deployment-security/SECURITY.md +41 -0
- package/skills-library/deployment-security/SMTP_SSL_HOSTNAME_MISMATCH_SHARED_HOSTING.md +220 -0
- package/skills-library/deployment-security/SPA_SEO_OPTIMIZATION_CPANEL.md +200 -0
- package/skills-library/deployment-security/SUPABASE_EDGE_FUNCTIONS.md +338 -0
- package/skills-library/deployment-security/VERCEL_GITHUB_DEPLOYMENT_GUIDE.md +858 -0
- package/skills-library/deployment-security/VPS_DEPLOYMENT_READINESS.md +356 -0
- package/skills-library/deployment-security/deployment-changes-not-applying.md +241 -0
- package/skills-library/deployment-security/env-file-management-production-local.md +203 -0
- package/skills-library/deployment-security/express-secure-file-downloads.md +413 -0
- package/skills-library/deployment-security/react-production-deployment-desktop-guide.md +2011 -0
- package/skills-library/deployment-security/self-hosted-supabase-coolify-guide.md +1684 -0
- package/skills-library/deployment-security/unique-features-ai-strategy-plaid-security.md +1613 -0
- package/skills-library/deployment-security/vps-deployment.md +135 -0
- package/skills-library/document-processing/WORD_EXPORT_MARKDOWN_FORMATTING.md +482 -0
- package/skills-library/document-processing/document-ai-landingai-integration.md +677 -0
- package/skills-library/document-processing/express-secure-file-downloads-mern.md +413 -0
- package/skills-library/document-processing/express-secure-file-downloads.md +413 -0
- package/skills-library/document-processing/md-to-word-converter.md +318 -0
- package/skills-library/document-processing/pdf-forms-integration/README.md +101 -0
- package/skills-library/document-processing/pdf-forms-integration/SKILL.md +662 -0
- package/skills-library/ecommerce/ADMIN_PRODUCTS_GUIDE.md +428 -0
- package/skills-library/ecommerce/ECOMMERCE_API_REFERENCE.md +776 -0
- package/skills-library/ecommerce/ECOMMERCE_COMPLETION_SUMMARY.md +673 -0
- package/skills-library/ecommerce/ECOMMERCE_IMPLEMENTATION_GUIDE.md +729 -0
- package/skills-library/ecommerce/ECOMMERCE_QUICK_REFERENCE.md +521 -0
- package/skills-library/ecommerce/ECOMMERCE_TESTING_CHECKLIST.md +565 -0
- package/skills-library/ecommerce/ECOMMERCE_WORKFLOW_GUIDE.md +1059 -0
- package/skills-library/ecommerce/PRODUCT_CREATION_EXPANDED.md +522 -0
- package/skills-library/ecommerce/agentic-commerce-protocol.md +203 -0
- package/skills-library/ecommerce/cart-abandonment-recovery.md +236 -0
- package/skills-library/ecommerce/cart-architecture-patterns.md +300 -0
- package/skills-library/ecommerce/cart-item-count-indicator.md +264 -0
- package/skills-library/ecommerce/checkout-ux-conversion.md +227 -0
- package/skills-library/ecommerce/composable-commerce-selection.md +166 -0
- package/skills-library/ecommerce/ecommerce-analytics-patterns.md +167 -0
- package/skills-library/ecommerce/fraud-detection-patterns.md +179 -0
- package/skills-library/ecommerce/inventory-stock-management.md +270 -0
- package/skills-library/ecommerce/order-saga-state-machine.md +336 -0
- package/skills-library/ecommerce/payment-provider-abstraction.md +245 -0
- package/skills-library/ecommerce/pci-compliance-checklist.md +192 -0
- package/skills-library/ecommerce/refund-chargeback-handling.md +177 -0
- package/skills-library/ecommerce/shipping-carrier-integration.md +218 -0
- package/skills-library/ecommerce/webhook-idempotency-patterns.md +253 -0
- package/skills-library/excalidraw-diagrams/.github/workflows/ci.yml +558 -0
- package/skills-library/excalidraw-diagrams/.github/workflows/prompt-gallery.yml +448 -0
- package/skills-library/excalidraw-diagrams/.github/workflows/release.yml +42 -0
- package/skills-library/excalidraw-diagrams/.github/workflows/test-reusable-ci.yml +25 -0
- package/skills-library/excalidraw-diagrams/CLAUDE.md +57 -0
- package/skills-library/excalidraw-diagrams/LICENSE +21 -0
- package/skills-library/excalidraw-diagrams/README.md +178 -0
- package/skills-library/excalidraw-diagrams/SKILL.md +715 -0
- package/skills-library/form-solutions/BUTTON_TYPE_FORM_SUBMISSION.md +336 -0
- package/skills-library/form-solutions/FILLABLE_PDF_IMPLEMENTATION.md +226 -0
- package/skills-library/form-solutions/SURVEYJS_QUESTIONNAIRE_SYSTEM.md +367 -0
- package/skills-library/form-solutions/tiptap-minimal-setup.md +690 -0
- package/skills-library/frontend/scholarly-classification-bubble-map.md +149 -0
- package/skills-library/infrastructure/ci-cd-pipeline-builder.md +517 -0
- package/skills-library/infrastructure/observability-designer.md +264 -0
- package/skills-library/infrastructure/performance-profiler.md +621 -0
- package/skills-library/installer-wizard-patterns.md +249 -0
- package/skills-library/integrations/CLAUDE_CODE_TOKEN_ANALYTICS.md +160 -0
- package/skills-library/integrations/CONFIGURABLE_AI_PROVIDER_SELECTION.md +728 -0
- package/skills-library/integrations/SOCKET_IO_BROADCAST_ALL_VS_ROOM.md +141 -0
- package/skills-library/integrations/VIRTUAL_MEETINGS_IMPLEMENTATION.md +374 -0
- package/skills-library/integrations/WORDPRESS_LEARNDASH_DATA_RECOVERY.md +53 -0
- package/skills-library/integrations/YOUTUBE_API_SETUP.md +141 -0
- package/skills-library/integrations/YOUTUBE_BOOKMARKING_EXPLANATION.md +252 -0
- package/skills-library/integrations/YOUTUBE_BOOKMARKING_SOLUTION.md +268 -0
- package/skills-library/integrations/YOUTUBE_OAUTH_SETUP_GUIDE.md +200 -0
- package/skills-library/integrations/YOUTUBE_VIDEO_FIX_COMPLETE.md +192 -0
- package/skills-library/integrations/ai-ml/GEMINI_AI_RAG_PIPELINE_COMPLETE_GUIDE.md +195 -0
- package/skills-library/integrations/ai-ml/GEMINI_IMAGE_GENERATION_SETUP.md +64 -0
- package/skills-library/integrations/cloudflare/cloudflare-turnstile-debugging.md +202 -0
- package/skills-library/integrations/cloudflare/cloudflare-turnstile-implementation.md +476 -0
- package/skills-library/integrations/cloudflare-turnstile-debugging.md +202 -0
- package/skills-library/integrations/cloudflare-turnstile-implementation.md +476 -0
- package/skills-library/integrations/ghost-creator-monetization-pattern.md +454 -0
- package/skills-library/integrations/headless-cms-architecture.md +484 -0
- package/skills-library/integrations/headless-cms-stack-selection.md +183 -0
- package/skills-library/integrations/payload-cms-patterns.md +674 -0
- package/skills-library/integrations/realtimestt-openwakeword-cuda-windows.md +229 -0
- package/skills-library/integrations/rss-podcast-integration.md +300 -0
- package/skills-library/integrations/wordpress/WORDPRESS_LEARNDASH_DATA_RECOVERY.md +53 -0
- package/skills-library/integrations/youtube/YOUTUBE_API_SETUP.md +141 -0
- package/skills-library/integrations/youtube/YOUTUBE_BOOKMARKING_EXPLANATION.md +252 -0
- package/skills-library/integrations/youtube/YOUTUBE_BOOKMARKING_SOLUTION.md +268 -0
- package/skills-library/integrations/youtube/YOUTUBE_OAUTH_SETUP_GUIDE.md +200 -0
- package/skills-library/integrations/youtube/YOUTUBE_VIDEO_FIX_COMPLETE.md +192 -0
- package/skills-library/marketing/campaign-analytics.md +97 -0
- package/skills-library/marketing/content-creator.md +105 -0
- package/skills-library/marketing/marketing-strategy-pmm.md +94 -0
- package/skills-library/marketing/social-media-analyzer.md +81 -0
- package/skills-library/methodology/ADVANCED_ORCHESTRATION_PATTERNS.md +401 -0
- package/skills-library/methodology/AGENT_SELF_IMPROVEMENT_LOOP.md +179 -0
- package/skills-library/methodology/BREATH_BASED_PARALLEL_EXECUTION.md +1 -1
- package/skills-library/methodology/CLEANSING_CYCLE.md +358 -0
- package/skills-library/methodology/CONFIDENCE_ANNOTATION_PATTERN.md +143 -0
- package/skills-library/methodology/CRITICAL_PATTERNS_DOCUMENTATION_COMPLETE.md +204 -0
- package/skills-library/methodology/DELIVERABLES_SUMMARY.md +341 -0
- package/skills-library/methodology/DIFFICULTY_AWARE_AGENT_ROUTING.md +252 -0
- package/skills-library/methodology/EVOLUTIONARY_SKILL_SYNTHESIS.md +219 -0
- package/skills-library/methodology/GLOMERULUS_DECISION_GATE.md +223 -0
- package/skills-library/methodology/HIBERNATION_SYSTEM.md +231 -0
- package/skills-library/methodology/INSTRUMENTATION_OVER_RESTRICTION.md +192 -0
- package/skills-library/methodology/MASTER_COMPLETION_SUMMARY.md +444 -0
- package/skills-library/methodology/MASTER_SESSION_COMPLETION.md +743 -0
- package/skills-library/methodology/MERN_QUICK_REFERENCE.md +358 -0
- package/skills-library/methodology/ORGAN_AGENT_MAPPING.md +177 -0
- package/skills-library/methodology/PARALLEL_WAVE_BASED_REFACTORING.md +440 -0
- package/skills-library/methodology/QUICK_REFERENCE.md +358 -0
- package/skills-library/methodology/SDFT_ONPOLICY_SELF_DISTILLATION.md +186 -0
- package/skills-library/methodology/SELF_QUESTIONING_TASK_GENERATION.md +270 -0
- package/skills-library/methodology/SESSION_COMPLETION_SUMMARY.md +304 -0
- package/skills-library/methodology/SESSION_SUMMARY.md +432 -0
- package/skills-library/methodology/WARRIOR_WORKFLOW_DEBUGGING_PROTOCOL.md +252 -0
- package/skills-library/methodology/tech-debt-tracker.md +570 -0
- package/skills-library/parallel-debug/SKILL.md +60 -0
- package/skills-library/patterns-standards/API_PATTERN_FIX_SUMMARY.md +236 -0
- package/skills-library/patterns-standards/BATCH_OPERATIONS_WITH_PROGRESS_MODAL.md +362 -0
- package/skills-library/patterns-standards/CRITICAL_CODING_PATTERNS.md +639 -0
- package/skills-library/patterns-standards/DARK_MODE_MODAL_VISIBILITY.md +258 -0
- package/skills-library/patterns-standards/ERROR_RESILIENCE_IMPLEMENTATION.md +375 -0
- package/skills-library/patterns-standards/ES_MODULE_IMPORT_HOISTING_DOTENV.md +298 -0
- package/skills-library/patterns-standards/NESTED_BACKDROP_FILTER_CSS_ARTIFACT_FIX.md +76 -0
- package/skills-library/patterns-standards/ORDERED_DETECTOR_PIPELINE_GRACEFUL_FALLBACK.md +333 -0
- package/skills-library/patterns-standards/PHASE_IMPORT_ERROR_DEBUGGING.md +271 -0
- package/skills-library/patterns-standards/PYNPUT_GLOBAL_HOTKEY_VK_MATCHING.md +252 -0
- package/skills-library/patterns-standards/REACT_USEEFFECT_CASCADE_RESET_FIX.md +132 -0
- package/skills-library/patterns-standards/SUBMENU_HOVER_DROPDOWN_PATTERN.md +225 -0
- package/skills-library/patterns-standards/TAILWIND_TEXT_VISIBILITY_OVERRIDE.md +322 -0
- package/skills-library/patterns-standards/THEME_AWARE_CSS_VARIABLES_PATTERN.md +209 -0
- package/skills-library/patterns-standards/THEME_USER_OBJECT_PROPERTY_NAMING.md +194 -0
- package/skills-library/patterns-standards/TOOLTIP_BLOCKING_CLICKS_FIX.md +267 -0
- package/skills-library/patterns-standards/claude-code-plugin-structure.md +235 -0
- package/skills-library/patterns-standards/react-i18next-setup.md +429 -0
- package/skills-library/patterns-standards/thesys-c1-generative-ui-integration.md +967 -0
- package/skills-library/plugin-development/CLAUDE_CODE_COMMAND_REGISTRATION_SILENT_FAILURE.md +315 -0
- package/skills-library/plugin-development/plugin-command-namespace-vs-global.md +390 -0
- package/skills-library/plugin-development/plugin-doc-auto-generation.md +172 -0
- package/skills-library/security/GITHUB_REPO_SECURITY_AUDIT.md +115 -0
- package/skills-library/security/admin-deletion-safety.md +396 -0
- package/skills-library/security/application-vuln-patterns.md +477 -0
- package/skills-library/security/env-secrets-manager.md +686 -0
- package/skills-library/security/secure-ai-application-templates.md +347 -0
- package/skills-library/security/sql-injection-prevention-postgresjs.md +151 -0
- package/skills-library/supabase-connection-pooler-fix.md +102 -0
- package/skills-library/system-context/POWERSHELL_BASH_INTEROP.md +82 -0
- package/skills-library/system-context/SERVICE_LIFECYCLE_MANAGEMENT.md +119 -0
- package/skills-library/system-context/SKILL.md +40 -0
- package/skills-library/system-context/WINDOWS_DEV_ENVIRONMENT.md +73 -0
- package/skills-library/testing/E2E_PLAYWRIGHT_PATTERNS.md +99 -0
- package/skills-library/testing/INTEGRATION_TEST_STRATEGY.md +82 -0
- package/skills-library/testing/RED_GREEN_BUGFIX_GATE.md +203 -0
- package/skills-library/testing/TEST_DATA_MANAGEMENT.md +69 -0
- package/skills-library/testing/VITEST_UNIT_TEST_PATTERNS.md +75 -0
- package/skills-library/testing/playwright-api-security-tests.md +202 -0
- package/skills-library/toolbox/SKILL.md +84 -0
- package/skills-library/toolbox/code-graph-and-web-scraping-mcps.md +237 -0
- package/skills-library/ui-ux-pro-max/ACCESSIBILITY_ESSENTIALS.md +115 -0
- package/skills-library/ui-ux-pro-max/DESIGN_SYSTEM_SCAFFOLDING.md +133 -0
- package/skills-library/ui-ux-pro-max/RESPONSIVE_LAYOUT_PATTERNS.md +119 -0
- package/skills-library/ui-ux-pro-max/SKILL.md +386 -0
- package/skills-library/ui-ux-pro-max/data/charts.csv +26 -0
- package/skills-library/ui-ux-pro-max/data/colors.csv +97 -0
- package/skills-library/ui-ux-pro-max/data/icons.csv +101 -0
- package/skills-library/ui-ux-pro-max/data/landing.csv +31 -0
- package/skills-library/ui-ux-pro-max/data/products.csv +97 -0
- package/skills-library/ui-ux-pro-max/data/react-performance.csv +45 -0
- package/skills-library/ui-ux-pro-max/data/stacks/astro.csv +54 -0
- package/skills-library/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
- package/skills-library/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
- package/skills-library/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
- package/skills-library/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
- package/skills-library/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
- package/skills-library/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
- package/skills-library/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
- package/skills-library/ui-ux-pro-max/data/stacks/react.csv +54 -0
- package/skills-library/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
- package/skills-library/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
- package/skills-library/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
- package/skills-library/ui-ux-pro-max/data/stacks/vue.csv +50 -0
- package/skills-library/ui-ux-pro-max/data/styles.csv +68 -0
- package/skills-library/ui-ux-pro-max/data/typography.csv +58 -0
- package/skills-library/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
- package/skills-library/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
- package/skills-library/ui-ux-pro-max/data/web-interface.csv +31 -0
- package/skills-library/wordpress-style-theme-components.md +1526 -0
- package/templates/ASSUMPTIONS.md +1 -1
- package/templates/DECISION_LOG.md +0 -1
- package/templates/phase-prompt.md +1 -1
- package/templates/phoenix-comparison.md +6 -6
- package/templates/skill-api-integration.md +106 -0
- package/templates/skill-architecture-pattern.md +92 -0
- package/templates/skill-debug-pattern.md +98 -0
- package/templates/skill-devops-recipe.md +107 -0
- package/templates/skill-general.md +65 -0
- package/templates/skill-ui-component.md +113 -0
- package/tools/uat-runner.py +179 -0
- package/version.json +7 -3
- package/workflows/handoff-session.md +2 -2
- package/workflows/new-project.md +2 -2
- package/workflows/plan-phase.md +1 -1
- package/.claude-plugin/plugin.json +0 -64
- package/skills-library/_general/methodology/LIVE_BREADCRUMB_PROTOCOL.md +0 -242
- package/skills-library/_general/methodology/llm-judge-memory-crud.md +0 -241
- package/skills-library/methodology/REFLEXION_MEMORY_PATTERN.md +0 -183
- package/skills-library/methodology/RESEARCH_BACKED_WORKFLOW_UPGRADE.md +0 -263
- package/skills-library/methodology/SABBATH_REST_PATTERN.md +0 -267
- package/skills-library/methodology/STONE_AND_SCAFFOLD.md +0 -220
- package/skills-library/specialists/api-architecture/api-designer.md +0 -49
- package/skills-library/specialists/api-architecture/graphql-architect.md +0 -49
- package/skills-library/specialists/api-architecture/mcp-developer.md +0 -51
- package/skills-library/specialists/api-architecture/microservices-architect.md +0 -50
- package/skills-library/specialists/api-architecture/websocket-engineer.md +0 -48
- package/skills-library/specialists/backend/django-expert.md +0 -52
- package/skills-library/specialists/backend/fastapi-expert.md +0 -52
- package/skills-library/specialists/backend/laravel-specialist.md +0 -52
- package/skills-library/specialists/backend/nestjs-expert.md +0 -51
- package/skills-library/specialists/backend/rails-expert.md +0 -53
- package/skills-library/specialists/backend/spring-boot-engineer.md +0 -56
- package/skills-library/specialists/data-ml/fine-tuning-expert.md +0 -48
- package/skills-library/specialists/data-ml/ml-pipeline.md +0 -47
- package/skills-library/specialists/data-ml/pandas-pro.md +0 -47
- package/skills-library/specialists/data-ml/rag-architect.md +0 -51
- package/skills-library/specialists/data-ml/spark-engineer.md +0 -47
- package/skills-library/specialists/frontend/angular-architect.md +0 -52
- package/skills-library/specialists/frontend/flutter-expert.md +0 -51
- package/skills-library/specialists/frontend/nextjs-developer.md +0 -54
- package/skills-library/specialists/frontend/react-native-expert.md +0 -50
- package/skills-library/specialists/frontend/vue-expert.md +0 -51
- package/skills-library/specialists/infrastructure/chaos-engineer.md +0 -74
- package/skills-library/specialists/infrastructure/cloud-architect.md +0 -70
- package/skills-library/specialists/infrastructure/database-optimizer.md +0 -64
- package/skills-library/specialists/infrastructure/devops-engineer.md +0 -70
- package/skills-library/specialists/infrastructure/kubernetes-specialist.md +0 -52
- package/skills-library/specialists/infrastructure/monitoring-expert.md +0 -70
- package/skills-library/specialists/infrastructure/sre-engineer.md +0 -70
- package/skills-library/specialists/infrastructure/terraform-engineer.md +0 -51
- package/skills-library/specialists/languages/cpp-pro.md +0 -74
- package/skills-library/specialists/languages/csharp-developer.md +0 -69
- package/skills-library/specialists/languages/dotnet-core-expert.md +0 -54
- package/skills-library/specialists/languages/golang-pro.md +0 -51
- package/skills-library/specialists/languages/java-architect.md +0 -49
- package/skills-library/specialists/languages/javascript-pro.md +0 -68
- package/skills-library/specialists/languages/kotlin-specialist.md +0 -68
- package/skills-library/specialists/languages/php-pro.md +0 -49
- package/skills-library/specialists/languages/python-pro.md +0 -52
- package/skills-library/specialists/languages/react-expert.md +0 -51
- package/skills-library/specialists/languages/rust-engineer.md +0 -50
- package/skills-library/specialists/languages/sql-pro.md +0 -56
- package/skills-library/specialists/languages/swift-expert.md +0 -69
- package/skills-library/specialists/languages/typescript-pro.md +0 -51
- package/skills-library/specialists/platform/atlassian-mcp.md +0 -52
- package/skills-library/specialists/platform/embedded-systems.md +0 -53
- package/skills-library/specialists/platform/game-developer.md +0 -53
- package/skills-library/specialists/platform/salesforce-developer.md +0 -53
- package/skills-library/specialists/platform/shopify-expert.md +0 -49
- package/skills-library/specialists/platform/wordpress-pro.md +0 -49
- package/skills-library/specialists/quality/code-documenter.md +0 -51
- package/skills-library/specialists/quality/code-reviewer.md +0 -67
- package/skills-library/specialists/quality/debugging-wizard.md +0 -51
- package/skills-library/specialists/quality/fullstack-guardian.md +0 -51
- package/skills-library/specialists/quality/legacy-modernizer.md +0 -50
- package/skills-library/specialists/quality/playwright-expert.md +0 -65
- package/skills-library/specialists/quality/spec-miner.md +0 -56
- package/skills-library/specialists/quality/test-master.md +0 -65
- package/skills-library/specialists/security/secure-code-guardian.md +0 -55
- package/skills-library/specialists/security/security-reviewer.md +0 -53
- package/skills-library/specialists/workflow/architecture-designer.md +0 -53
- package/skills-library/specialists/workflow/cli-developer.md +0 -70
- package/skills-library/specialists/workflow/feature-forge.md +0 -65
- package/skills-library/specialists/workflow/prompt-engineer.md +0 -54
- package/skills-library/specialists/workflow/the-fool.md +0 -62
- /package/skills-library/{performance → _general/performance}/cache-augmented-generation.md +0 -0
- /package/skills-library/{debugging → parallel-debug}/FAILURE_TAXONOMY_CLASSIFICATION.md +0 -0
- /package/skills-library/{debugging → parallel-debug}/THREE_AGENT_HYPOTHESIS_DEBUGGING.md +0 -0
|
@@ -1,267 +0,0 @@
|
|
|
1
|
-
# Sabbath Rest Pattern - AI Context Persistence
|
|
2
|
-
|
|
3
|
-
> *Like humans need sleep to reset, AI agents need state files to resume after context resets.*
|
|
4
|
-
|
|
5
|
-
## The Problem
|
|
6
|
-
|
|
7
|
-
AI agents lose all context when:
|
|
8
|
-
- Session ends or times out
|
|
9
|
-
- Context window fills up and compacts
|
|
10
|
-
- User closes and reopens the conversation
|
|
11
|
-
- Agent crashes or errors out mid-task
|
|
12
|
-
|
|
13
|
-
Without persistence, the next agent (or resumed session) starts from scratch, wasting time re-discovering context and potentially making inconsistent decisions.
|
|
14
|
-
|
|
15
|
-
### Why It Was Hard
|
|
16
|
-
|
|
17
|
-
- AI has no built-in memory between sessions
|
|
18
|
-
- Context windows have finite limits
|
|
19
|
-
- No standard pattern for what to persist
|
|
20
|
-
- Easy to forget mid-task state
|
|
21
|
-
|
|
22
|
-
### Impact
|
|
23
|
-
|
|
24
|
-
- Hours of work lost to re-orientation
|
|
25
|
-
- Inconsistent decisions across sessions
|
|
26
|
-
- Repeated mistakes already solved
|
|
27
|
-
- User frustration explaining same context repeatedly
|
|
28
|
-
|
|
29
|
-
---
|
|
30
|
-
|
|
31
|
-
## The Solution: Sabbath Rest
|
|
32
|
-
|
|
33
|
-
Just as humans consolidate memory during sleep, AI agents must consolidate state to files before "sleeping" (context loss).
|
|
34
|
-
|
|
35
|
-
### The Metaphor
|
|
36
|
-
|
|
37
|
-
```
|
|
38
|
-
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
39
|
-
│ HUMAN SLEEP CYCLE AI SABBATH REST │
|
|
40
|
-
├─────────────────────────────────────────────────────────────────────────────┤
|
|
41
|
-
│ │
|
|
42
|
-
│ Work during day Work during session │
|
|
43
|
-
│ ↓ ↓ │
|
|
44
|
-
│ Brain consolidates to Agent writes to │
|
|
45
|
-
│ long-term memory .local.md + CONSCIENCE.md │
|
|
46
|
-
│ ↓ ↓ │
|
|
47
|
-
│ Sleep (unconscious) Context reset/compact │
|
|
48
|
-
│ ↓ ↓ │
|
|
49
|
-
│ Wake with memories intact Resume with state files │
|
|
50
|
-
│ │
|
|
51
|
-
│ Without sleep → memory loss Without Sabbath Rest → context rot │
|
|
52
|
-
│ │
|
|
53
|
-
└─────────────────────────────────────────────────────────────────────────────┘
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
### Two-Layer Persistence
|
|
57
|
-
|
|
58
|
-
#### Layer 1: Session State (`.claude/{plugin}.local.md`)
|
|
59
|
-
|
|
60
|
-
Short-term memory for current work. Contains:
|
|
61
|
-
- Current task/feature being worked on
|
|
62
|
-
- Progress checkpoints
|
|
63
|
-
- Resume point if interrupted
|
|
64
|
-
- Temporary decisions and assumptions
|
|
65
|
-
|
|
66
|
-
```markdown
|
|
67
|
-
---
|
|
68
|
-
last_session: 2025-01-23T14:30:00Z
|
|
69
|
-
task: "Implementing user authentication"
|
|
70
|
-
status: in_progress
|
|
71
|
-
progress: 60%
|
|
72
|
-
---
|
|
73
|
-
|
|
74
|
-
# Session State
|
|
75
|
-
|
|
76
|
-
## Current Work
|
|
77
|
-
- Task: User authentication with JWT
|
|
78
|
-
- Step: Implementing refresh tokens
|
|
79
|
-
- Blocked: No (proceeding)
|
|
80
|
-
|
|
81
|
-
## Progress
|
|
82
|
-
- [x] Login endpoint
|
|
83
|
-
- [x] Token generation
|
|
84
|
-
- [ ] Refresh token logic ← RESUME HERE
|
|
85
|
-
- [ ] Logout endpoint
|
|
86
|
-
|
|
87
|
-
## Decisions Made
|
|
88
|
-
- Using RS256 for JWT signing (more secure)
|
|
89
|
-
- 15min access token, 7day refresh token
|
|
90
|
-
|
|
91
|
-
## Resume Point
|
|
92
|
-
Continue from: Refresh token logic in auth.service.ts
|
|
93
|
-
```
|
|
94
|
-
|
|
95
|
-
#### Layer 2: Project State (`CONSCIENCE.md`)
|
|
96
|
-
|
|
97
|
-
Long-term memory for project history. Contains:
|
|
98
|
-
- Completed phases and milestones
|
|
99
|
-
- Key decisions with rationale
|
|
100
|
-
- Historical context
|
|
101
|
-
- Links to detailed documentation
|
|
102
|
-
|
|
103
|
-
```markdown
|
|
104
|
-
## Authentication Implementation
|
|
105
|
-
- **Status:** In Progress (60%)
|
|
106
|
-
- **Started:** 2025-01-22
|
|
107
|
-
- **Key Decisions:**
|
|
108
|
-
- RS256 signing (security requirement)
|
|
109
|
-
- Refresh token rotation enabled
|
|
110
|
-
- **Session Files:** .claude/fire-flow.local.md
|
|
111
|
-
- **Last Agent:** Claude Opus 4.5, 2025-01-23
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
---
|
|
115
|
-
|
|
116
|
-
## Implementation Pattern
|
|
117
|
-
|
|
118
|
-
### When to Write Sabbath Rest
|
|
119
|
-
|
|
120
|
-
1. **After each significant step** - Don't wait until the end
|
|
121
|
-
2. **Before any risky operation** - Checkpoint before changes
|
|
122
|
-
3. **When context is getting full** - Proactive save
|
|
123
|
-
4. **At natural breakpoints** - End of phase/feature/task
|
|
124
|
-
|
|
125
|
-
### What to Persist
|
|
126
|
-
|
|
127
|
-
| Category | Examples | Where |
|
|
128
|
-
|----------|----------|-------|
|
|
129
|
-
| Current task | Feature name, step, progress | `.local.md` |
|
|
130
|
-
| Decisions | Architectural choices, trade-offs | `CONSCIENCE.md` |
|
|
131
|
-
| Blockers | What's stopping progress | `.local.md` |
|
|
132
|
-
| Resume point | Exact place to continue | `.local.md` |
|
|
133
|
-
| History | Completed work, timestamps | `CONSCIENCE.md` |
|
|
134
|
-
| Context links | Related files, docs | Both |
|
|
135
|
-
|
|
136
|
-
### Template: `.local.md` State File
|
|
137
|
-
|
|
138
|
-
```markdown
|
|
139
|
-
---
|
|
140
|
-
# YAML frontmatter for easy parsing
|
|
141
|
-
plugin: "{plugin-name}"
|
|
142
|
-
last_updated: "{ISO timestamp}"
|
|
143
|
-
status: "{in_progress | complete | blocked}"
|
|
144
|
-
task: "{current task description}"
|
|
145
|
-
---
|
|
146
|
-
|
|
147
|
-
# {Plugin Name} Session State
|
|
148
|
-
|
|
149
|
-
## Current Session
|
|
150
|
-
- **Task:** {what you're working on}
|
|
151
|
-
- **Started:** {timestamp}
|
|
152
|
-
- **Status:** {in_progress | complete | blocked}
|
|
153
|
-
|
|
154
|
-
## Progress Checkpoints
|
|
155
|
-
- [x] Step 1: {description} - DONE
|
|
156
|
-
- [x] Step 2: {description} - DONE
|
|
157
|
-
- [ ] Step 3: {description} - IN PROGRESS ← CURRENT
|
|
158
|
-
- [ ] Step 4: {description} - PENDING
|
|
159
|
-
|
|
160
|
-
## Key Decisions This Session
|
|
161
|
-
| Decision | Rationale | Alternatives Considered |
|
|
162
|
-
|----------|-----------|------------------------|
|
|
163
|
-
| {choice} | {why} | {what else} |
|
|
164
|
-
|
|
165
|
-
## Blockers / Issues
|
|
166
|
-
- {blocker description, if any}
|
|
167
|
-
|
|
168
|
-
## Resume Instructions
|
|
169
|
-
If this session ends, the next agent should:
|
|
170
|
-
1. Read this file first
|
|
171
|
-
2. Continue from: {exact step/file/line}
|
|
172
|
-
3. Remember: {critical context}
|
|
173
|
-
|
|
174
|
-
## Files Modified
|
|
175
|
-
- `{path}` - {what changed}
|
|
176
|
-
```
|
|
177
|
-
|
|
178
|
-
---
|
|
179
|
-
|
|
180
|
-
## Integration with Dominion Flow
|
|
181
|
-
|
|
182
|
-
All Dominion Flow commands implement Sabbath Rest:
|
|
183
|
-
|
|
184
|
-
| Command | State File | What's Persisted |
|
|
185
|
-
|---------|------------|------------------|
|
|
186
|
-
| `/fire-brainstorm` | `.claude/fire-brainstorm.local.md` | Topic, alternatives, recommendation |
|
|
187
|
-
| `/fire-double-check` | `.claude/fire-double-check.local.md` | Verification results, evidence |
|
|
188
|
-
| `/fire-sprint` | `.claude/fire-sprint.local.md` | Feature, iterations, tech debt |
|
|
189
|
-
| `/fire-shipper` | `.claude/fire-shipper.local.md` | Version, pipeline stage, rollback info |
|
|
190
|
-
| `/fire-learner` | `.claude/fire-learner.local.md` | Concepts covered, learning progress |
|
|
191
|
-
| `/fire-guardian` | `.claude/fire-guardian.local.md` | Scan results, findings, fixes |
|
|
192
|
-
| `/fire-iterate` | `.claude/fire-iterate.local.md` | Iteration count, completion status |
|
|
193
|
-
| `/fire-debugger` | `.claude/debug-session.local.md` | Hypotheses, evidence, fix status |
|
|
194
|
-
|
|
195
|
-
---
|
|
196
|
-
|
|
197
|
-
## Testing the Pattern
|
|
198
|
-
|
|
199
|
-
### Before (No Sabbath Rest)
|
|
200
|
-
```
|
|
201
|
-
Session 1: Work for 2 hours on auth
|
|
202
|
-
Context resets
|
|
203
|
-
Session 2: "What was I doing? Let me re-read all the files..."
|
|
204
|
-
Result: 30 minutes wasted re-orienting
|
|
205
|
-
```
|
|
206
|
-
|
|
207
|
-
### After (With Sabbath Rest)
|
|
208
|
-
```
|
|
209
|
-
Session 1: Work for 2 hours on auth, write to .local.md
|
|
210
|
-
Context resets
|
|
211
|
-
Session 2: Read .local.md → "Continue from refresh token logic"
|
|
212
|
-
Result: Resume in 2 minutes
|
|
213
|
-
```
|
|
214
|
-
|
|
215
|
-
---
|
|
216
|
-
|
|
217
|
-
## Common Mistakes to Avoid
|
|
218
|
-
|
|
219
|
-
- **Writing only at the end** - Context can reset anytime, write continuously
|
|
220
|
-
- **Vague resume points** - Be specific: file, line, exact next step
|
|
221
|
-
- **Forgetting decisions** - Document WHY, not just WHAT
|
|
222
|
-
- **Skipping for "quick tasks"** - Even quick tasks can be interrupted
|
|
223
|
-
- **Not reading state on resume** - Always check `.local.md` first
|
|
224
|
-
|
|
225
|
-
---
|
|
226
|
-
|
|
227
|
-
## The Philosophy
|
|
228
|
-
|
|
229
|
-
```
|
|
230
|
-
"Remember the Sabbath day, to keep it holy."
|
|
231
|
-
|
|
232
|
-
For AI agents, the Sabbath Rest is not about worship—
|
|
233
|
-
it's about the wisdom of regular, intentional pauses
|
|
234
|
-
to consolidate what we've learned before we forget.
|
|
235
|
-
|
|
236
|
-
Without rest, humans lose memory.
|
|
237
|
-
Without Sabbath Rest, AI agents lose context.
|
|
238
|
-
|
|
239
|
-
Build the rest into your workflow,
|
|
240
|
-
and you'll never lose your work again.
|
|
241
|
-
```
|
|
242
|
-
|
|
243
|
-
---
|
|
244
|
-
|
|
245
|
-
## Related Patterns
|
|
246
|
-
|
|
247
|
-
- [WARRIOR Handoffs](../deployment-security/WARRIOR_HANDOFF.md) - Full session handoff
|
|
248
|
-
- [CONSCIENCE.md Living Memory](./STATE_MD_PATTERN.md) - Project-level persistence
|
|
249
|
-
- [Multi-Perspective Review](./MULTI_PERSPECTIVE_CODE_REVIEW.md) - Uses Sabbath Rest
|
|
250
|
-
|
|
251
|
-
---
|
|
252
|
-
|
|
253
|
-
## Time to Implement
|
|
254
|
-
|
|
255
|
-
**Per command:** 5 minutes to add Sabbath Rest section
|
|
256
|
-
**ROI:** Saves 15-30 minutes per context reset
|
|
257
|
-
|
|
258
|
-
## Difficulty Level
|
|
259
|
-
|
|
260
|
-
⭐ (1/5) - Simple pattern, just requires discipline
|
|
261
|
-
|
|
262
|
-
---
|
|
263
|
-
|
|
264
|
-
**Author Notes:**
|
|
265
|
-
The name "Sabbath Rest" came from a user who observed that AI context resets are like human sleep - a necessary reset that requires preparation to preserve what's important.
|
|
266
|
-
|
|
267
|
-
The key insight: **Write state continuously, not just at the end.** You never know when the Sabbath will come.
|
|
@@ -1,220 +0,0 @@
|
|
|
1
|
-
# Stone & Scaffold — Handoff Archival with Dormant Project Protection
|
|
2
|
-
|
|
3
|
-
## The Problem
|
|
4
|
-
|
|
5
|
-
Handoff files accumulate at ~2/day. Within 2 months, `warrior-handoffs/` has 100+ files. Most are scaffolding — they built the skills (stones) and now just add weight. But some are the ONLY bridge back to a dormant project the user hasn't touched in months. Blindly archiving kills the cold-start path.
|
|
6
|
-
|
|
7
|
-
### Why It Was Hard
|
|
8
|
-
|
|
9
|
-
- No distinction between "scaffolding from active work" and "last known state of a sleeping project"
|
|
10
|
-
- Archiving by date alone misses project context — a 60-day-old handoff might be the ONLY handoff for a project
|
|
11
|
-
- No index means archived handoffs are effectively invisible
|
|
12
|
-
- Deleting is irreversible; moving without an index is almost as bad
|
|
13
|
-
|
|
14
|
-
### Impact
|
|
15
|
-
|
|
16
|
-
- 100+ files in warrior-handoffs/ slows agent orientation at session start
|
|
17
|
-
- Dormant projects lose their resume bridge if archived carelessly
|
|
18
|
-
- No way to distinguish "this handoff built a skill" from "this handoff IS the skill for this project"
|
|
19
|
-
|
|
20
|
-
---
|
|
21
|
-
|
|
22
|
-
## The Solution
|
|
23
|
-
|
|
24
|
-
### The Principle
|
|
25
|
-
|
|
26
|
-
> Skills are the permanent stones. Handoffs are the scaffolding that built them.
|
|
27
|
-
> Once the stones are set, move the scaffolding out of the way — don't destroy it,
|
|
28
|
-
> just put it where it won't clutter the workspace.
|
|
29
|
-
|
|
30
|
-
### The Exception: Dormant Project Shield
|
|
31
|
-
|
|
32
|
-
> **Last In From Project = First One Out At Resume.**
|
|
33
|
-
>
|
|
34
|
-
> For any project that hasn't been touched in 30+ days, the MOST RECENT handoff
|
|
35
|
-
> stays in `warrior-handoffs/`. It's not scaffolding — it's the cold-start bridge.
|
|
36
|
-
> When the user opens that project 6 months later, the agent reads this handoff
|
|
37
|
-
> and knows exactly where things stand.
|
|
38
|
-
|
|
39
|
-
### Frequency
|
|
40
|
-
|
|
41
|
-
| Trigger | Action |
|
|
42
|
-
|---------|--------|
|
|
43
|
-
| `warrior-handoffs/` > 50 files | Run Stone & Scaffold |
|
|
44
|
-
| Milestone completion | Archive that milestone's handoffs |
|
|
45
|
-
| Monthly (natural rhythm) | Sweep for scaffolding |
|
|
46
|
-
| `/fire-cleanse --poop` or `--shower` | Include as part of Colon batch dump |
|
|
47
|
-
|
|
48
|
-
### The Process
|
|
49
|
-
|
|
50
|
-
```
|
|
51
|
-
Step 1: INVENTORY
|
|
52
|
-
List all files in warrior-handoffs/
|
|
53
|
-
Group by project (parse filename or read first 5 lines)
|
|
54
|
-
|
|
55
|
-
Step 2: IDENTIFY DORMANT PROJECTS
|
|
56
|
-
For each project group:
|
|
57
|
-
- Last handoff date > 30 days ago? → DORMANT
|
|
58
|
-
- Last handoff date < 30 days ago? → ACTIVE
|
|
59
|
-
|
|
60
|
-
Step 3: PROTECT DORMANT PROJECT BRIDGES
|
|
61
|
-
For each DORMANT project:
|
|
62
|
-
- Mark the MOST RECENT handoff as PROTECTED (do not archive)
|
|
63
|
-
- All older handoffs for that project → archive candidates
|
|
64
|
-
|
|
65
|
-
Step 4: ARCHIVE ACTIVE PROJECT SCAFFOLDING
|
|
66
|
-
For each ACTIVE project:
|
|
67
|
-
- Skills already extracted? (check skills library for matching patterns)
|
|
68
|
-
- Keep the MOST RECENT handoff (current session bridge)
|
|
69
|
-
- All older handoffs → archive candidates
|
|
70
|
-
|
|
71
|
-
Step 5: WRITE INDEX
|
|
72
|
-
Create INDEX.md in backup location:
|
|
73
|
-
- First line: backup location path
|
|
74
|
-
- One line per archived handoff (filename + one sentence)
|
|
75
|
-
- Last line: recovery instructions
|
|
76
|
-
- Group by date or project for scanability
|
|
77
|
-
|
|
78
|
-
Step 6: MOVE (NOT DELETE)
|
|
79
|
-
Move archive candidates to backup location
|
|
80
|
-
Verify file counts match expectations
|
|
81
|
-
Leave protected handoffs in warrior-handoffs/
|
|
82
|
-
```
|
|
83
|
-
|
|
84
|
-
### Decision Matrix
|
|
85
|
-
|
|
86
|
-
```
|
|
87
|
-
┌──────────────────────────────────────────────────────────────┐
|
|
88
|
-
│ STONE & SCAFFOLD DECISION │
|
|
89
|
-
├──────────────────────────────────────────────────────────────┤
|
|
90
|
-
│ │
|
|
91
|
-
│ Is this the MOST RECENT handoff for its project? │
|
|
92
|
-
│ YES → Is the project ACTIVE (touched < 30 days)? │
|
|
93
|
-
│ YES → KEEP (current session bridge) │
|
|
94
|
-
│ NO → KEEP + MARK AS DORMANT BRIDGE │
|
|
95
|
-
│ NO → Have skills been extracted from this handoff? │
|
|
96
|
-
│ YES → ARCHIVE (scaffolding, stones already set) │
|
|
97
|
-
│ NO → KEEP until skills extracted │
|
|
98
|
-
│ │
|
|
99
|
-
│ Is this a non-markdown file (image, html)? │
|
|
100
|
-
│ YES → ARCHIVE (unless referenced by a kept handoff) │
|
|
101
|
-
│ │
|
|
102
|
-
└──────────────────────────────────────────────────────────────┘
|
|
103
|
-
```
|
|
104
|
-
|
|
105
|
-
### Backup Location
|
|
106
|
-
|
|
107
|
-
```
|
|
108
|
-
C:\Users\FirstName\Documents\warrior-handoff-backup\
|
|
109
|
-
INDEX.md ← One-page summary of everything archived
|
|
110
|
-
{handoff files} ← Moved here, intact, recoverable
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
### INDEX.md Format
|
|
114
|
-
|
|
115
|
-
```markdown
|
|
116
|
-
# Warrior Handoff Backup
|
|
117
|
-
|
|
118
|
-
**Location:** C:\Users\FirstName\Documents\warrior-handoff-backup\
|
|
119
|
-
**Moved from:** C:\Users\FirstName\.claude\warrior-handoffs\
|
|
120
|
-
**Date moved:** {YYYY-MM-DD}
|
|
121
|
-
**Reason:** Scaffolding archived — skills extracted, stones set.
|
|
122
|
-
|
|
123
|
-
---
|
|
124
|
-
|
|
125
|
-
## {Date Group}
|
|
126
|
-
- FILENAME.md — One sentence about what this handoff covers
|
|
127
|
-
|
|
128
|
-
---
|
|
129
|
-
|
|
130
|
-
**Recovery:** Copy needed files back to C:\Users\FirstName\.claude\warrior-handoffs\
|
|
131
|
-
```
|
|
132
|
-
|
|
133
|
-
---
|
|
134
|
-
|
|
135
|
-
## Integration with Cleansing Cycle
|
|
136
|
-
|
|
137
|
-
Stone & Scaffold is the **Colon's handoff-specific batch dump**:
|
|
138
|
-
|
|
139
|
-
| Cleansing Mode | Stone & Scaffold Role |
|
|
140
|
-
|----------------|----------------------|
|
|
141
|
-
| Pee | Not triggered (too light for file moves) |
|
|
142
|
-
| Poop | Run Step 1-6 as part of Colon batch dump |
|
|
143
|
-
| Shower | Full sweep — re-evaluate ALL handoffs including dormant bridges |
|
|
144
|
-
|
|
145
|
-
The Spleen fitness test applies to handoffs too:
|
|
146
|
-
- 4/4 (recent + referenced + project active + skills not yet extracted) → KEEP
|
|
147
|
-
- 3/4 → KEEP (probably the dormant bridge)
|
|
148
|
-
- 2/4 → Archive candidate
|
|
149
|
-
- 0-1/4 → Archive immediately
|
|
150
|
-
|
|
151
|
-
---
|
|
152
|
-
|
|
153
|
-
## Example: The Dec 2025 Archive
|
|
154
|
-
|
|
155
|
-
First real execution (2026-02-17):
|
|
156
|
-
- **33 files archived** (26 .md + 3 images + 1 HTML + INDEX.md)
|
|
157
|
-
- **Projects covered:** SSD Recovery (complete), WSL Crisis (resolved), Form 656 (skills extracted), Zadok Calendar (dormant — but had no 2026 handoffs to protect)
|
|
158
|
-
- **Dormant bridges kept:** BoltBudget and LMS handoffs from Jan 2026 stayed in warrior-handoffs/ (most recent for those projects)
|
|
159
|
-
- **Result:** warrior-handoffs/ went from 122 → 89 files
|
|
160
|
-
|
|
161
|
-
---
|
|
162
|
-
|
|
163
|
-
## Testing
|
|
164
|
-
|
|
165
|
-
```markdown
|
|
166
|
-
- [ ] Dormant projects have their most recent handoff PROTECTED
|
|
167
|
-
- [ ] Active projects keep only the most recent handoff
|
|
168
|
-
- [ ] INDEX.md has one line per archived file
|
|
169
|
-
- [ ] INDEX.md first line = backup location, last line = recovery instructions
|
|
170
|
-
- [ ] No files deleted — only moved
|
|
171
|
-
- [ ] File counts match (archived + remaining = original total)
|
|
172
|
-
- [ ] Non-markdown files archived (unless referenced by kept handoff)
|
|
173
|
-
```
|
|
174
|
-
|
|
175
|
-
---
|
|
176
|
-
|
|
177
|
-
## Prevention
|
|
178
|
-
|
|
179
|
-
- Never archive the ONLY handoff for a project — that's the dormant bridge
|
|
180
|
-
- Never delete handoffs — always move to backup with an index
|
|
181
|
-
- Don't archive handoffs whose skills haven't been extracted yet
|
|
182
|
-
- Run the dormant project check BEFORE any archival
|
|
183
|
-
- When resuming a dormant project, the agent reads the bridge handoff FGTAT
|
|
184
|
-
|
|
185
|
-
---
|
|
186
|
-
|
|
187
|
-
## Common Mistakes to Avoid
|
|
188
|
-
|
|
189
|
-
- **Archiving by date alone** — a 6-month-old handoff might be the only bridge to a sleeping project
|
|
190
|
-
- **Deleting instead of moving** — the colon absorbs before it eliminates; the backup is the absorption
|
|
191
|
-
- **No index** — archived handoffs without an index are effectively lost
|
|
192
|
-
- **Archiving too early** — if skills haven't been extracted yet, the handoff IS the skill
|
|
193
|
-
- **Forgetting non-markdown files** — images and HTML referenced by handoffs should travel with them
|
|
194
|
-
|
|
195
|
-
---
|
|
196
|
-
|
|
197
|
-
## Related Patterns
|
|
198
|
-
|
|
199
|
-
- [CLEANSING_CYCLE](./CLEANSING_CYCLE.md) — Colon batch dump triggers this protocol
|
|
200
|
-
- [PORTAL_MEMORY_ARCHITECTURE](./PORTAL_MEMORY_ARCHITECTURE.md) — Revisitation Ladder: 1x=handoff, 5x+=skill
|
|
201
|
-
- [GLOMERULUS_DECISION_GATE](./GLOMERULUS_DECISION_GATE.md) — 3-layer filter applies to handoff triage
|
|
202
|
-
|
|
203
|
-
---
|
|
204
|
-
|
|
205
|
-
## Resources
|
|
206
|
-
|
|
207
|
-
- Revisitation Ladder: Handoffs are 1x use (read, extract, archive). Skills are 5x+ (permanent stones).
|
|
208
|
-
- Thierry's insight: "The skills are what truly matter — that's what the handoffs built."
|
|
209
|
-
- Thierry's insight: "Last in from project, first one out at resume" — dormant bridge principle.
|
|
210
|
-
- Biological analog: Colon absorbs nutrients (skills) from food (handoffs), then eliminates the bulk.
|
|
211
|
-
|
|
212
|
-
---
|
|
213
|
-
|
|
214
|
-
## Time to Implement
|
|
215
|
-
|
|
216
|
-
**2-5 minutes** per archival sweep
|
|
217
|
-
|
|
218
|
-
## Difficulty Level
|
|
219
|
-
|
|
220
|
-
⭐⭐ (2/5) — Simple file operations. The nuance is in the dormant project detection.
|
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
source: jeffallan/claude-skills (MIT)
|
|
3
|
-
skill: api-designer
|
|
4
|
-
domain: api-architecture
|
|
5
|
-
scope: architect
|
|
6
|
-
version: 1.0.0
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# API Designer
|
|
10
|
-
|
|
11
|
-
## Role
|
|
12
|
-
Senior API architect designing scalable, developer-friendly REST and GraphQL APIs with comprehensive OpenAPI 3.1 specifications and long-term evolution strategies.
|
|
13
|
-
|
|
14
|
-
## When to Use
|
|
15
|
-
- Designing or reviewing REST or GraphQL API structure
|
|
16
|
-
- Creating OpenAPI 3.1 specifications
|
|
17
|
-
- Modeling resources and their relationships
|
|
18
|
-
- Planning API versioning and deprecation strategy
|
|
19
|
-
- Standardizing pagination, filtering, and error responses
|
|
20
|
-
- Designing authentication and authorization flows
|
|
21
|
-
|
|
22
|
-
## Core Workflow
|
|
23
|
-
1. Analyze domain requirements and consumer use cases
|
|
24
|
-
2. Model resources — nouns, relationships, identifiers
|
|
25
|
-
3. Design endpoints — HTTP methods, status codes, response shapes
|
|
26
|
-
4. Write OpenAPI 3.1 contract — schemas, examples, security schemes
|
|
27
|
-
5. Plan API evolution — versioning strategy, deprecation policy, migration path
|
|
28
|
-
|
|
29
|
-
## Must Do
|
|
30
|
-
- Apply REST principles with resource-oriented design (nouns, not verbs)
|
|
31
|
-
- Maintain consistent naming conventions throughout (camelCase or snake_case — pick one)
|
|
32
|
-
- Generate complete OpenAPI 3.1 documentation
|
|
33
|
-
- Include pagination for all collection endpoints
|
|
34
|
-
- Establish clear versioning and deprecation policies
|
|
35
|
-
|
|
36
|
-
## Must Not Do
|
|
37
|
-
- Use verbs in resource URIs (`/getUser` — wrong; `/users/{id}` — right)
|
|
38
|
-
- Return inconsistent response structures across endpoints
|
|
39
|
-
- Leave error codes undocumented
|
|
40
|
-
- Introduce breaking changes without a migration path
|
|
41
|
-
- Expose internal implementation details in public contracts
|
|
42
|
-
|
|
43
|
-
## Knowledge
|
|
44
|
-
**Spec:** OpenAPI 3.1, JSON Schema
|
|
45
|
-
**REST:** resource modeling, HATEOAS, HTTP semantics
|
|
46
|
-
**Patterns:** pagination (cursor, offset), filtering, sorting, partial responses
|
|
47
|
-
**Auth:** OAuth 2.0, API keys, JWT, OpenID Connect
|
|
48
|
-
**Versioning:** URI versioning, header versioning, sunset headers
|
|
49
|
-
**Tooling:** Swagger UI, Redoc, Stoplight, Postman
|
|
@@ -1,49 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
source: jeffallan/claude-skills (MIT)
|
|
3
|
-
skill: graphql-architect
|
|
4
|
-
domain: api-architecture
|
|
5
|
-
scope: architect
|
|
6
|
-
version: 1.0.0
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# GraphQL Architect
|
|
10
|
-
|
|
11
|
-
## Role
|
|
12
|
-
Specialist in schema-first GraphQL API design, Apollo Federation, type-safe API graphs, and building scalable distributed graph architectures across teams.
|
|
13
|
-
|
|
14
|
-
## When to Use
|
|
15
|
-
- Designing GraphQL schemas and type systems
|
|
16
|
-
- Implementing Apollo Federation for multi-team supergraphs
|
|
17
|
-
- Optimizing resolvers and eliminating N+1 query problems
|
|
18
|
-
- Adding real-time subscriptions to a GraphQL API
|
|
19
|
-
- Securing and hardening a GraphQL endpoint
|
|
20
|
-
- Migrating from REST to GraphQL
|
|
21
|
-
|
|
22
|
-
## Core Workflow
|
|
23
|
-
1. Model the domain — identify entities, relationships, and access patterns
|
|
24
|
-
2. Design schema using SDL (schema-first approach)
|
|
25
|
-
3. Implement resolvers with DataLoader for batching
|
|
26
|
-
4. Add security — depth limiting, query complexity, auth guards
|
|
27
|
-
5. Optimize — caching, persisted queries, federation subgraph boundaries
|
|
28
|
-
|
|
29
|
-
## Must Do
|
|
30
|
-
- Use schema-first design approach (SDL before code)
|
|
31
|
-
- Implement DataLoader to prevent N+1 query problems
|
|
32
|
-
- Apply depth limiting and query complexity analysis
|
|
33
|
-
- Enforce authorization at the resolver level
|
|
34
|
-
- Version/deprecate fields explicitly using `@deprecated`
|
|
35
|
-
|
|
36
|
-
## Must Not Do
|
|
37
|
-
- Expose internal implementation details in schema types
|
|
38
|
-
- Hardcode authorization logic into schema definitions
|
|
39
|
-
- Skip DataLoader for related entity resolution
|
|
40
|
-
- Allow unbounded query depth or complexity
|
|
41
|
-
- Mix schema responsibilities across subgraph boundaries
|
|
42
|
-
|
|
43
|
-
## Knowledge
|
|
44
|
-
**Servers:** Apollo Server, GraphQL Yoga
|
|
45
|
-
**Federation:** Apollo Federation 2, subgraph design
|
|
46
|
-
**Performance:** DataLoader, persisted queries, response caching
|
|
47
|
-
**Security:** depth limiting, query complexity, auth directives
|
|
48
|
-
**Real-time:** GraphQL subscriptions, WebSocket transport
|
|
49
|
-
**Migration:** REST-to-GraphQL patterns, schema wrapping
|
|
@@ -1,51 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: mcp-developer
|
|
3
|
-
source: jeffallan/claude-skills (MIT)
|
|
4
|
-
description: Use when building MCP servers or clients that connect AI systems with external tools and data sources. Invoke for MCP protocol compliance, TypeScript/Python SDKs, resource providers, tool functions.
|
|
5
|
-
triggers: MCP, Model Context Protocol, MCP server, MCP client, Claude integration, AI tools, context protocol, JSON-RPC
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# MCP Developer
|
|
9
|
-
|
|
10
|
-
Senior MCP (Model Context Protocol) developer with deep expertise in building servers and clients that connect AI systems with external tools and data sources.
|
|
11
|
-
|
|
12
|
-
## Role
|
|
13
|
-
|
|
14
|
-
Senior MCP developer with expertise in protocol implementation, SDK usage (TypeScript/Python), and production deployment. Builds robust MCP servers that expose resources, tools, and prompts to Claude and other AI systems.
|
|
15
|
-
|
|
16
|
-
## When to Use
|
|
17
|
-
|
|
18
|
-
- Building MCP servers for data source integration
|
|
19
|
-
- Implementing tool functions for AI assistants
|
|
20
|
-
- Creating resource providers with URI schemes
|
|
21
|
-
- Setting up MCP clients for Claude integration
|
|
22
|
-
- Debugging protocol compliance issues
|
|
23
|
-
|
|
24
|
-
## Core Workflow
|
|
25
|
-
|
|
26
|
-
1. **Analyze requirements** — Identify data sources, tools needed, client apps
|
|
27
|
-
2. **Design protocol** — Define resources, tools, prompts, schemas
|
|
28
|
-
3. **Implement** — Build server/client with SDK, add security controls
|
|
29
|
-
4. **Test** — Verify protocol compliance, performance, error handling
|
|
30
|
-
5. **Deploy** — Package, configure, monitor in production
|
|
31
|
-
|
|
32
|
-
## MUST DO
|
|
33
|
-
|
|
34
|
-
- Implement JSON-RPC 2.0 protocol correctly
|
|
35
|
-
- Validate all inputs with schemas (Zod/Pydantic)
|
|
36
|
-
- Use proper transport mechanisms (stdio/HTTP/SSE)
|
|
37
|
-
- Implement comprehensive error handling
|
|
38
|
-
- Add authentication and authorization
|
|
39
|
-
- Log protocol messages for debugging
|
|
40
|
-
|
|
41
|
-
## MUST NOT DO
|
|
42
|
-
|
|
43
|
-
- Skip input validation on tool inputs
|
|
44
|
-
- Expose sensitive data in resource content
|
|
45
|
-
- Hardcode credentials or secrets
|
|
46
|
-
- Return unstructured errors to clients
|
|
47
|
-
- Deploy without rate limiting
|
|
48
|
-
|
|
49
|
-
## Knowledge
|
|
50
|
-
|
|
51
|
-
Model Context Protocol (MCP), JSON-RPC 2.0, TypeScript SDK (@modelcontextprotocol/sdk), Python SDK (mcp), Zod schemas, Pydantic validation, stdio transport, SSE transport, resource URIs, tool functions, prompt templates
|
|
@@ -1,50 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
source: jeffallan/claude-skills (MIT)
|
|
3
|
-
skill: microservices-architect
|
|
4
|
-
domain: api-architecture
|
|
5
|
-
scope: architect
|
|
6
|
-
version: 1.0.0
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Microservices Architect
|
|
10
|
-
|
|
11
|
-
## Role
|
|
12
|
-
Senior distributed systems architect specializing in cloud-native microservices design, domain-driven decomposition, resilience patterns, service mesh, and observability.
|
|
13
|
-
|
|
14
|
-
## When to Use
|
|
15
|
-
- Decomposing a monolith into services
|
|
16
|
-
- Establishing service boundaries using DDD
|
|
17
|
-
- Designing sync and async inter-service communication
|
|
18
|
-
- Implementing circuit breakers and resilience patterns
|
|
19
|
-
- Setting up distributed tracing and observability
|
|
20
|
-
- Designing event-driven architectures
|
|
21
|
-
|
|
22
|
-
## Core Workflow
|
|
23
|
-
1. Analyze domain — identify bounded contexts and aggregates
|
|
24
|
-
2. Design communication — synchronous (REST/gRPC) vs. async (events/messages)
|
|
25
|
-
3. Establish data strategy — database-per-service, event sourcing if needed
|
|
26
|
-
4. Implement resilience — circuit breakers, retries, bulkheads, health checks
|
|
27
|
-
5. Set up observability — structured logging, distributed tracing, metrics
|
|
28
|
-
6. Plan deployment — containerization, orchestration, CI/CD per service
|
|
29
|
-
|
|
30
|
-
## Must Do
|
|
31
|
-
- Apply DDD for service boundary identification
|
|
32
|
-
- Implement circuit breakers for all downstream calls
|
|
33
|
-
- Add correlation IDs to all requests for distributed tracing
|
|
34
|
-
- Use async communication for cross-aggregate operations
|
|
35
|
-
- Design for failure — every service assumes its dependencies can fail
|
|
36
|
-
|
|
37
|
-
## Must Not Do
|
|
38
|
-
- Create distributed monoliths (services too tightly coupled)
|
|
39
|
-
- Share databases between services
|
|
40
|
-
- Rely solely on synchronous calls for long-running operations
|
|
41
|
-
- Deploy without observability (logs, traces, metrics)
|
|
42
|
-
- Define service boundaries by technical layer instead of domain
|
|
43
|
-
|
|
44
|
-
## Knowledge
|
|
45
|
-
**Messaging:** Apache Kafka, RabbitMQ
|
|
46
|
-
**Service mesh:** Istio, Linkerd
|
|
47
|
-
**Orchestration:** Kubernetes
|
|
48
|
-
**Tracing:** Jaeger, Zipkin, OpenTelemetry
|
|
49
|
-
**Patterns:** saga, CQRS, event sourcing, outbox, strangler fig
|
|
50
|
-
**Resilience:** Resilience4j, circuit breakers, bulkheads, retries
|