@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.
Files changed (500) hide show
  1. package/CREDITS.md +25 -0
  2. package/DOMINION-FLOW-OVERVIEW.md +182 -38
  3. package/README.md +399 -455
  4. package/TROUBLESHOOTING.md +264 -264
  5. package/agents/fire-debugger.md +54 -0
  6. package/agents/fire-executor.md +1610 -1033
  7. package/agents/fire-fact-checker.md +1 -1
  8. package/agents/fire-planner.md +85 -17
  9. package/agents/fire-project-researcher.md +1 -1
  10. package/agents/fire-researcher.md +4 -22
  11. package/agents/{fire-phoenix-analyst.md → fire-resurrection-analyst.md} +394 -394
  12. package/agents/fire-reviewer.md +552 -499
  13. package/agents/fire-verifier.md +114 -19
  14. package/bin/cli.js +18 -101
  15. package/commands/fire-0-orient.md +2 -2
  16. package/commands/fire-1a-new.md +50 -15
  17. package/commands/fire-1c-setup.md +33 -5
  18. package/commands/fire-1d-discuss.md +87 -1
  19. package/commands/fire-2-plan.md +556 -527
  20. package/commands/fire-3-execute.md +2046 -1356
  21. package/commands/fire-4-verify.md +975 -906
  22. package/commands/fire-5-handoff.md +46 -5
  23. package/commands/fire-6-resume.md +2 -31
  24. package/commands/fire-add-new-skill.md +138 -19
  25. package/commands/fire-autonomous.md +14 -2
  26. package/commands/fire-complete-milestone.md +1 -1
  27. package/commands/fire-cost.md +179 -183
  28. package/commands/fire-debug.md +1 -6
  29. package/commands/fire-loop-resume.md +2 -2
  30. package/commands/fire-loop-stop.md +1 -1
  31. package/commands/fire-loop.md +2 -15
  32. package/commands/fire-map-codebase.md +1 -1
  33. package/commands/fire-migrate-database.md +548 -0
  34. package/commands/fire-new-milestone.md +1 -1
  35. package/commands/fire-reflect.md +1 -2
  36. package/commands/fire-research.md +142 -21
  37. package/commands/{fire-phoenix.md → fire-resurrect.md} +859 -603
  38. package/commands/fire-scaffold.md +297 -0
  39. package/commands/fire-search.md +1 -2
  40. package/commands/fire-security-scan.md +483 -484
  41. package/commands/fire-setup.md +359 -0
  42. package/commands/fire-skill.md +770 -0
  43. package/commands/fire-skills-diff.md +506 -506
  44. package/commands/fire-skills-history.md +388 -388
  45. package/commands/fire-skills-rollback.md +7 -7
  46. package/commands/fire-skills-sync.md +470 -470
  47. package/commands/fire-test.md +5 -5
  48. package/commands/fire-todos.md +1 -1
  49. package/commands/fire-update.md +5 -5
  50. package/commands/fire-validate-skills.md +282 -0
  51. package/commands/fire-vuln-scan.md +492 -493
  52. package/hooks/run-hook.sh +8 -8
  53. package/hooks/run-session-end.sh +7 -7
  54. package/hooks/session-end.sh +90 -90
  55. package/hooks/session-start.sh +1 -1
  56. package/package.json +4 -24
  57. package/plugin.json +7 -7
  58. package/references/autonomy-levels.md +235 -0
  59. package/references/behavioral-directives.md +95 -3
  60. package/references/blocker-tracking.md +1 -1
  61. package/references/circuit-breaker.md +93 -2
  62. package/references/context-engineering.md +227 -9
  63. package/references/honesty-protocols.md +70 -1
  64. package/references/issue-to-pr-pipeline.md +149 -150
  65. package/references/metrics-and-trends.md +1 -2
  66. package/references/research-improvements.md +4 -108
  67. package/references/sdlc-mapping.md +73 -0
  68. package/references/state-machine.md +151 -0
  69. package/skills-library/AVAILABLE_TOOLS_REFERENCE.md +333 -0
  70. package/skills-library/SKILLS-INDEX.md +57 -558
  71. package/skills-library/SKILLS_LIBRARY_INDEX.md +532 -0
  72. package/skills-library/_general/api-patterns/api-field-name-mismatch.md +107 -0
  73. package/skills-library/_general/api-patterns/streaming-command-timeout.md +122 -0
  74. package/skills-library/_general/api-patterns/streaming-proxy-cors-bypass.md +102 -0
  75. package/skills-library/_general/automation/settings-gui-generator.md +172 -0
  76. package/skills-library/_general/database-solutions/data-type-mapping-reference.md +181 -0
  77. package/skills-library/_general/database-solutions/mysql-limit-offset-string-coercion.md +102 -0
  78. package/skills-library/_general/database-solutions/mysql-to-pg-migration.md +195 -0
  79. package/skills-library/_general/database-solutions/orm-schema-portability.md +193 -0
  80. package/skills-library/_general/database-solutions/persistent-analysis-storage.md +207 -0
  81. package/skills-library/_general/database-solutions/pg-to-mysql-schema-migration-methodology.md +190 -0
  82. package/skills-library/_general/database-solutions/sql-dialect-compatibility-matrix.md +306 -0
  83. package/skills-library/_general/database-solutions/sqlite-to-pg-migration.md +219 -0
  84. package/skills-library/_general/frontend/canvas-bubble-animation-grouping.md +270 -0
  85. package/skills-library/_general/frontend/color-token-migration.md +112 -0
  86. package/skills-library/_general/frontend/framer-motion-layoutid-grouping.md +150 -0
  87. package/skills-library/_general/frontend/pyqt6-settings-dialog.md +191 -0
  88. package/skills-library/_general/frontend/react-flow-animated-layout-switching.md +101 -0
  89. package/skills-library/_general/frontend/react-hooks-order-debugging.md +141 -0
  90. package/skills-library/_general/frontend/redux-localstorage-auth-desync.md +126 -0
  91. package/skills-library/_general/frontend/safari-csp-theme-color-debugging.md +124 -0
  92. package/skills-library/_general/frontend/safari-sw-cache-poisoning.md +138 -0
  93. package/skills-library/_general/frontend/svg-sparkline-no-charting-library.md +131 -0
  94. package/skills-library/_general/growth-marketing/oss-daily-growth-intelligence.md +224 -0
  95. package/skills-library/_general/integrations/claude-code-local-mcp-integration.md +250 -0
  96. package/skills-library/_general/integrations/mcp-composite-tool-orchestration.md +200 -0
  97. package/skills-library/_general/methodology/AGENT_SDK_STANDALONE_TOOLING.md +181 -0
  98. package/skills-library/_general/methodology/AGENT_TEAMS_GUIDE.md +169 -0
  99. package/skills-library/_general/methodology/ALAS_STATEFUL_EXECUTION.md +207 -0
  100. package/skills-library/_general/methodology/AUTO_REVIEWER_SUBAGENT.md +211 -0
  101. package/skills-library/_general/methodology/CONSISTENCY_CHECK_AMBIGUITY_GATE.md +96 -0
  102. package/skills-library/_general/methodology/DEAD_ENDS_SHELF.md +4 -4
  103. package/skills-library/_general/methodology/DISTILL_NOT_DUMP.md +108 -0
  104. package/skills-library/_general/methodology/EXECUTION_PROGRESS_MONITOR.md +157 -0
  105. package/skills-library/_general/methodology/HIERARCHICAL_REVIEW_MARS.md +122 -0
  106. package/skills-library/_general/methodology/MCP_INTER_AGENT_BRIDGE.md +207 -0
  107. package/skills-library/_general/methodology/MERMAID_WIZARD_DIAGRAMS.md +77 -0
  108. package/skills-library/_general/methodology/MISSING_DIMENSION_DETECTOR.md +89 -0
  109. package/skills-library/_general/methodology/MULTI_AGENT_COORDINATION.md +397 -0
  110. package/skills-library/_general/methodology/OBSERVATION_MASKING.md +100 -0
  111. package/skills-library/_general/methodology/PHOENIX_REBUILD_METHODOLOGY.md +82 -11
  112. package/skills-library/_general/methodology/REVIEW_BACKTRACK_PANEL.md +140 -0
  113. package/skills-library/_general/methodology/REVIEW_FIX_LOOP.md +117 -0
  114. package/skills-library/_general/methodology/VOTING_VERDICT_ARBITRATION.md +155 -0
  115. package/skills-library/_general/methodology/ZERO_FRICTION_CLI_SETUP.md +2 -2
  116. package/skills-library/_general/methodology/dead-code-activation.md +123 -0
  117. package/skills-library/_general/methodology/debug-swarm-researcher-escape-hatch.md +240 -240
  118. package/skills-library/_general/methodology/shell-autonomous-loop-fixplan.md +1 -1
  119. package/skills-library/_general/patterns-standards/GOF_DESIGN_PATTERNS_FOR_AI_AGENTS.md +5 -5
  120. package/skills-library/_general/patterns-standards/cascading-failure-diagnosis.md +119 -0
  121. package/skills-library/_general/patterns-standards/domain-specific-layout-algorithms.md +209 -0
  122. package/skills-library/_general/patterns-standards/python-desktop-app-architecture.md +399 -0
  123. package/skills-library/_general/patterns-standards/realtime-monitoring-dashboard.md +457 -0
  124. package/skills-library/_general/patterns-standards/togglable-processing-pipeline.md +169 -0
  125. package/skills-library/_general/performance/liveclock-extraction.md +112 -0
  126. package/skills-library/_general/performance/ref-based-canvas-animation.md +117 -0
  127. package/skills-library/_general/performance/use-visible-interval.md +131 -0
  128. package/skills-library/_general/testing/playwright-firefox-withcredentials-auth-issue.md +104 -0
  129. package/skills-library/_quarantine/README.md +30 -0
  130. package/skills-library/api-patterns/BROADCAST_SCHEDULER_SHARED_EXECUTE_FUNCTION.md +150 -0
  131. package/skills-library/api-patterns/ERROR_RESPONSE_STANDARDS.md +145 -0
  132. package/skills-library/api-patterns/EXPRESS_ROUTE_ORDERING_MIDDLEWARE_INTERCEPTION.md +326 -0
  133. package/skills-library/api-patterns/PAGINATION_PATTERNS.md +137 -0
  134. package/skills-library/api-patterns/PODCAST_PROGRESS_TRACKING_THREE_ROOT_CAUSES.md +277 -0
  135. package/skills-library/api-patterns/RATE_LIMITING_TOGGLE.md +155 -0
  136. package/skills-library/api-patterns/graphql-content-queries.md +708 -0
  137. package/skills-library/appointment-scheduler-design.md +423 -0
  138. package/skills-library/automation/AUTO_POPULATE_COMPLETE_GUIDE.md +631 -0
  139. package/skills-library/automation/CC_WORKFLOW_STUDIO.md +83 -0
  140. package/skills-library/automation/CLAUDE_CODE_SWARM_MODE.md +95 -0
  141. package/skills-library/automation/DAEMON_TRIGGER_FILE_IPC.md +195 -0
  142. package/skills-library/automation/scheduled-content-publishing.md +608 -0
  143. package/skills-library/awesome-workflows/Blogging-Platform-Instructions/view_commands.md +25 -0
  144. package/skills-library/awesome-workflows/CREDENTIAL-SECURITY-WORKFLOW.md +109 -0
  145. package/skills-library/awesome-workflows/DEBUGGING-WORKFLOW.md +124 -0
  146. package/skills-library/awesome-workflows/Design-Review-Workflow/README.md +31 -0
  147. package/skills-library/awesome-workflows/Design-Review-Workflow/design-principles-example.md +129 -0
  148. package/skills-library/awesome-workflows/Design-Review-Workflow/design-review-agent.md +107 -0
  149. package/skills-library/awesome-workflows/Design-Review-Workflow/design-review-claude-md-snippet.md +24 -0
  150. package/skills-library/awesome-workflows/Design-Review-Workflow/design-review-slash-command.md +38 -0
  151. package/skills-library/awesome-workflows/PARALLEL-RESEARCH-WORKFLOW.md +89 -0
  152. package/skills-library/awesome-workflows/PHASE-EXECUTION-WORKFLOW.md +97 -0
  153. package/skills-library/awesome-workflows/SESSION-HANDOFF-WORKFLOW.md +116 -0
  154. package/skills-library/cms-patterns/content-branch-preview.md +515 -0
  155. package/skills-library/cms-patterns/inline-visual-editing.md +666 -0
  156. package/skills-library/cms-patterns/mdx-component-content.md +649 -0
  157. package/skills-library/cms-patterns/media-manager-abstraction.md +827 -0
  158. package/skills-library/cms-patterns/schema-driven-form-generator.md +838 -0
  159. package/skills-library/complexity-metrics/complexity-divider.md +707 -0
  160. package/skills-library/complexity-metrics/work-with-complexity.md +193 -0
  161. package/skills-library/creative-multimedia/animation-stack-guide.md +577 -0
  162. package/skills-library/creative-multimedia/audio-enhancement-pipeline.md +625 -0
  163. package/skills-library/creative-multimedia/content-repurposing-pipeline.md +1146 -0
  164. package/skills-library/creative-multimedia/data-visualization-generator.md +862 -0
  165. package/skills-library/creative-multimedia/doc-to-podcast-pipeline.md +2184 -0
  166. package/skills-library/creative-multimedia/ffmpeg-command-generator.md +405 -0
  167. package/skills-library/creative-multimedia/image-optimization-pipeline.md +605 -0
  168. package/skills-library/creative-multimedia/multi-format-content-generator.md +1759 -0
  169. package/skills-library/creative-multimedia/og-image-generator.md +635 -0
  170. package/skills-library/creative-multimedia/podcast-audio-composition.md +1355 -0
  171. package/skills-library/creative-multimedia/podcast-quality-evaluation.md +1452 -0
  172. package/skills-library/creative-multimedia/podcast-script-generation.md +1841 -0
  173. package/skills-library/creative-multimedia/svg-generation.md +750 -0
  174. package/skills-library/creative-multimedia/text-to-speech-provider-selector.md +1414 -0
  175. package/skills-library/creative-multimedia/transcription-pipeline-selector.md +677 -0
  176. package/skills-library/creative-multimedia/video-streaming-setup.md +559 -0
  177. package/skills-library/database-solutions/AI_RESPONSE_DATABASE_CACHING.md +520 -0
  178. package/skills-library/database-solutions/CONDITIONAL_SQL_MIGRATION_PATTERN.md +119 -0
  179. package/skills-library/database-solutions/DATABASE_COLUMN_NAME_MISMATCH.md +393 -0
  180. package/skills-library/database-solutions/DATABASE_SCHEMA.md +394 -0
  181. package/skills-library/database-solutions/DATABASE_SCHEMA_VERIFICATION_GUIDE.md +348 -0
  182. package/skills-library/database-solutions/DATABASE_STRATEGY.md +71 -0
  183. package/skills-library/database-solutions/ES_MODULE_SEED_SCRIPT_PATTERN.md +52 -0
  184. package/skills-library/database-solutions/MIGRATION_GUIDE.md +3 -0
  185. package/skills-library/database-solutions/PLPGSQL_VARIABLE_CONFLICT_FIX.md +208 -0
  186. package/skills-library/database-solutions/POSTGRESQL_JSONB_DOUBLE_STRINGIFY_FIX.md +245 -0
  187. package/skills-library/database-solutions/POSTGRESQL_LICENSE_TABLE_DESIGN.md +393 -0
  188. package/skills-library/database-solutions/POSTGRESQL_UUID_DOCUMENT_RAG_DUAL_SCOPE.md +732 -0
  189. package/skills-library/database-solutions/POSTGRES_SQL_TEMPLATE_BINDING_ERROR.md +240 -0
  190. package/skills-library/database-solutions/PRISMA_DB_PUSH_DATA_LOSS_PREVENTION.md +141 -0
  191. package/skills-library/database-solutions/PRODUCTION_QUERY_OPTIMIZATION_RESTART_FIX.md +389 -0
  192. package/skills-library/database-solutions/RLS_SECURITY_GUIDE.md +107 -0
  193. package/skills-library/database-solutions/SCHEMA_ENHANCEMENTS_GUIDE.md +373 -0
  194. package/skills-library/database-solutions/SCHEMA_MIGRATION_GUIDE.md +368 -0
  195. package/skills-library/database-solutions/SCHEMA_VERIFICATION_QUICK_REFERENCE.md +104 -0
  196. package/skills-library/database-solutions/ai-erd-generator.md +1213 -0
  197. package/skills-library/database-solutions/content-publishing-states.md +631 -0
  198. package/skills-library/database-solutions/database-schema-designer.md +522 -0
  199. package/skills-library/database-solutions/er-diagram-components.md +569 -0
  200. package/skills-library/database-solutions/er-to-ddl-mapping.md +1405 -0
  201. package/skills-library/database-solutions/erd-creator-textbook-research.md +433 -0
  202. package/skills-library/database-solutions/erd-react-flow-architecture.md +1965 -0
  203. package/skills-library/database-solutions/mariadb-aggregate-function-replacement.md +145 -0
  204. package/skills-library/database-solutions/normalization-validator.md +778 -0
  205. package/skills-library/database-solutions/postgres-full-text-search-content.md +494 -0
  206. package/skills-library/database-solutions/postgresql-to-mysql-runtime-translation.md +286 -0
  207. package/skills-library/database-solutions/regex-alternation-ordering-sql-types.md +92 -0
  208. package/skills-library/database-solutions/reserved-word-context-aware-quoting.md +142 -0
  209. package/skills-library/database-solutions/sql-ddl-generator.md +756 -0
  210. package/skills-library/database-solutions/supabase-connection-pooler-fix.md +102 -0
  211. package/skills-library/deployment-security/CPANEL_NODE_DEPLOYMENT.md +166 -0
  212. package/skills-library/deployment-security/DEPLOYMENT.md +275 -0
  213. package/skills-library/deployment-security/DEPLOYMENT_CHECKLIST.md +363 -0
  214. package/skills-library/deployment-security/DEPLOYMENT_PLAN.md +669 -0
  215. package/skills-library/deployment-security/KNEX_DATABASE_ABSTRACTION.md +444 -0
  216. package/skills-library/deployment-security/LICENSE_KEY_SYSTEM.md +206 -0
  217. package/skills-library/deployment-security/NODE18_DEPENDENCY_COMPATIBILITY.md +284 -0
  218. package/skills-library/deployment-security/PHP_INSTALLER_WIZARD_GUIDE.md +315 -0
  219. package/skills-library/deployment-security/PM2_ENVIRONMENT_VARIABLE_CACHING.md +256 -0
  220. package/skills-library/deployment-security/PM2_MEMORY_EXHAUSTION_FIX.md +370 -0
  221. package/skills-library/deployment-security/PRODUCTION_DEPLOYMENT_GUIDE.md +592 -0
  222. package/skills-library/deployment-security/PRODUCTION_HARDENING_DOCUMENTATION.md +307 -0
  223. package/skills-library/deployment-security/PRODUCTION_RECOVERY_CHERRY_PICK_PATTERN.md +202 -0
  224. package/skills-library/deployment-security/PYINSTALLER_CUDA_WHISPER_BUNDLING.md +236 -0
  225. package/skills-library/deployment-security/SECURITY.md +41 -0
  226. package/skills-library/deployment-security/SMTP_SSL_HOSTNAME_MISMATCH_SHARED_HOSTING.md +220 -0
  227. package/skills-library/deployment-security/SPA_SEO_OPTIMIZATION_CPANEL.md +200 -0
  228. package/skills-library/deployment-security/SUPABASE_EDGE_FUNCTIONS.md +338 -0
  229. package/skills-library/deployment-security/VERCEL_GITHUB_DEPLOYMENT_GUIDE.md +858 -0
  230. package/skills-library/deployment-security/VPS_DEPLOYMENT_READINESS.md +356 -0
  231. package/skills-library/deployment-security/deployment-changes-not-applying.md +241 -0
  232. package/skills-library/deployment-security/env-file-management-production-local.md +203 -0
  233. package/skills-library/deployment-security/express-secure-file-downloads.md +413 -0
  234. package/skills-library/deployment-security/react-production-deployment-desktop-guide.md +2011 -0
  235. package/skills-library/deployment-security/self-hosted-supabase-coolify-guide.md +1684 -0
  236. package/skills-library/deployment-security/unique-features-ai-strategy-plaid-security.md +1613 -0
  237. package/skills-library/deployment-security/vps-deployment.md +135 -0
  238. package/skills-library/document-processing/WORD_EXPORT_MARKDOWN_FORMATTING.md +482 -0
  239. package/skills-library/document-processing/document-ai-landingai-integration.md +677 -0
  240. package/skills-library/document-processing/express-secure-file-downloads-mern.md +413 -0
  241. package/skills-library/document-processing/express-secure-file-downloads.md +413 -0
  242. package/skills-library/document-processing/md-to-word-converter.md +318 -0
  243. package/skills-library/document-processing/pdf-forms-integration/README.md +101 -0
  244. package/skills-library/document-processing/pdf-forms-integration/SKILL.md +662 -0
  245. package/skills-library/ecommerce/ADMIN_PRODUCTS_GUIDE.md +428 -0
  246. package/skills-library/ecommerce/ECOMMERCE_API_REFERENCE.md +776 -0
  247. package/skills-library/ecommerce/ECOMMERCE_COMPLETION_SUMMARY.md +673 -0
  248. package/skills-library/ecommerce/ECOMMERCE_IMPLEMENTATION_GUIDE.md +729 -0
  249. package/skills-library/ecommerce/ECOMMERCE_QUICK_REFERENCE.md +521 -0
  250. package/skills-library/ecommerce/ECOMMERCE_TESTING_CHECKLIST.md +565 -0
  251. package/skills-library/ecommerce/ECOMMERCE_WORKFLOW_GUIDE.md +1059 -0
  252. package/skills-library/ecommerce/PRODUCT_CREATION_EXPANDED.md +522 -0
  253. package/skills-library/ecommerce/agentic-commerce-protocol.md +203 -0
  254. package/skills-library/ecommerce/cart-abandonment-recovery.md +236 -0
  255. package/skills-library/ecommerce/cart-architecture-patterns.md +300 -0
  256. package/skills-library/ecommerce/cart-item-count-indicator.md +264 -0
  257. package/skills-library/ecommerce/checkout-ux-conversion.md +227 -0
  258. package/skills-library/ecommerce/composable-commerce-selection.md +166 -0
  259. package/skills-library/ecommerce/ecommerce-analytics-patterns.md +167 -0
  260. package/skills-library/ecommerce/fraud-detection-patterns.md +179 -0
  261. package/skills-library/ecommerce/inventory-stock-management.md +270 -0
  262. package/skills-library/ecommerce/order-saga-state-machine.md +336 -0
  263. package/skills-library/ecommerce/payment-provider-abstraction.md +245 -0
  264. package/skills-library/ecommerce/pci-compliance-checklist.md +192 -0
  265. package/skills-library/ecommerce/refund-chargeback-handling.md +177 -0
  266. package/skills-library/ecommerce/shipping-carrier-integration.md +218 -0
  267. package/skills-library/ecommerce/webhook-idempotency-patterns.md +253 -0
  268. package/skills-library/excalidraw-diagrams/.github/workflows/ci.yml +558 -0
  269. package/skills-library/excalidraw-diagrams/.github/workflows/prompt-gallery.yml +448 -0
  270. package/skills-library/excalidraw-diagrams/.github/workflows/release.yml +42 -0
  271. package/skills-library/excalidraw-diagrams/.github/workflows/test-reusable-ci.yml +25 -0
  272. package/skills-library/excalidraw-diagrams/CLAUDE.md +57 -0
  273. package/skills-library/excalidraw-diagrams/LICENSE +21 -0
  274. package/skills-library/excalidraw-diagrams/README.md +178 -0
  275. package/skills-library/excalidraw-diagrams/SKILL.md +715 -0
  276. package/skills-library/form-solutions/BUTTON_TYPE_FORM_SUBMISSION.md +336 -0
  277. package/skills-library/form-solutions/FILLABLE_PDF_IMPLEMENTATION.md +226 -0
  278. package/skills-library/form-solutions/SURVEYJS_QUESTIONNAIRE_SYSTEM.md +367 -0
  279. package/skills-library/form-solutions/tiptap-minimal-setup.md +690 -0
  280. package/skills-library/frontend/scholarly-classification-bubble-map.md +149 -0
  281. package/skills-library/infrastructure/ci-cd-pipeline-builder.md +517 -0
  282. package/skills-library/infrastructure/observability-designer.md +264 -0
  283. package/skills-library/infrastructure/performance-profiler.md +621 -0
  284. package/skills-library/installer-wizard-patterns.md +249 -0
  285. package/skills-library/integrations/CLAUDE_CODE_TOKEN_ANALYTICS.md +160 -0
  286. package/skills-library/integrations/CONFIGURABLE_AI_PROVIDER_SELECTION.md +728 -0
  287. package/skills-library/integrations/SOCKET_IO_BROADCAST_ALL_VS_ROOM.md +141 -0
  288. package/skills-library/integrations/VIRTUAL_MEETINGS_IMPLEMENTATION.md +374 -0
  289. package/skills-library/integrations/WORDPRESS_LEARNDASH_DATA_RECOVERY.md +53 -0
  290. package/skills-library/integrations/YOUTUBE_API_SETUP.md +141 -0
  291. package/skills-library/integrations/YOUTUBE_BOOKMARKING_EXPLANATION.md +252 -0
  292. package/skills-library/integrations/YOUTUBE_BOOKMARKING_SOLUTION.md +268 -0
  293. package/skills-library/integrations/YOUTUBE_OAUTH_SETUP_GUIDE.md +200 -0
  294. package/skills-library/integrations/YOUTUBE_VIDEO_FIX_COMPLETE.md +192 -0
  295. package/skills-library/integrations/ai-ml/GEMINI_AI_RAG_PIPELINE_COMPLETE_GUIDE.md +195 -0
  296. package/skills-library/integrations/ai-ml/GEMINI_IMAGE_GENERATION_SETUP.md +64 -0
  297. package/skills-library/integrations/cloudflare/cloudflare-turnstile-debugging.md +202 -0
  298. package/skills-library/integrations/cloudflare/cloudflare-turnstile-implementation.md +476 -0
  299. package/skills-library/integrations/cloudflare-turnstile-debugging.md +202 -0
  300. package/skills-library/integrations/cloudflare-turnstile-implementation.md +476 -0
  301. package/skills-library/integrations/ghost-creator-monetization-pattern.md +454 -0
  302. package/skills-library/integrations/headless-cms-architecture.md +484 -0
  303. package/skills-library/integrations/headless-cms-stack-selection.md +183 -0
  304. package/skills-library/integrations/payload-cms-patterns.md +674 -0
  305. package/skills-library/integrations/realtimestt-openwakeword-cuda-windows.md +229 -0
  306. package/skills-library/integrations/rss-podcast-integration.md +300 -0
  307. package/skills-library/integrations/wordpress/WORDPRESS_LEARNDASH_DATA_RECOVERY.md +53 -0
  308. package/skills-library/integrations/youtube/YOUTUBE_API_SETUP.md +141 -0
  309. package/skills-library/integrations/youtube/YOUTUBE_BOOKMARKING_EXPLANATION.md +252 -0
  310. package/skills-library/integrations/youtube/YOUTUBE_BOOKMARKING_SOLUTION.md +268 -0
  311. package/skills-library/integrations/youtube/YOUTUBE_OAUTH_SETUP_GUIDE.md +200 -0
  312. package/skills-library/integrations/youtube/YOUTUBE_VIDEO_FIX_COMPLETE.md +192 -0
  313. package/skills-library/marketing/campaign-analytics.md +97 -0
  314. package/skills-library/marketing/content-creator.md +105 -0
  315. package/skills-library/marketing/marketing-strategy-pmm.md +94 -0
  316. package/skills-library/marketing/social-media-analyzer.md +81 -0
  317. package/skills-library/methodology/ADVANCED_ORCHESTRATION_PATTERNS.md +401 -0
  318. package/skills-library/methodology/AGENT_SELF_IMPROVEMENT_LOOP.md +179 -0
  319. package/skills-library/methodology/BREATH_BASED_PARALLEL_EXECUTION.md +1 -1
  320. package/skills-library/methodology/CLEANSING_CYCLE.md +358 -0
  321. package/skills-library/methodology/CONFIDENCE_ANNOTATION_PATTERN.md +143 -0
  322. package/skills-library/methodology/CRITICAL_PATTERNS_DOCUMENTATION_COMPLETE.md +204 -0
  323. package/skills-library/methodology/DELIVERABLES_SUMMARY.md +341 -0
  324. package/skills-library/methodology/DIFFICULTY_AWARE_AGENT_ROUTING.md +252 -0
  325. package/skills-library/methodology/EVOLUTIONARY_SKILL_SYNTHESIS.md +219 -0
  326. package/skills-library/methodology/GLOMERULUS_DECISION_GATE.md +223 -0
  327. package/skills-library/methodology/HIBERNATION_SYSTEM.md +231 -0
  328. package/skills-library/methodology/INSTRUMENTATION_OVER_RESTRICTION.md +192 -0
  329. package/skills-library/methodology/MASTER_COMPLETION_SUMMARY.md +444 -0
  330. package/skills-library/methodology/MASTER_SESSION_COMPLETION.md +743 -0
  331. package/skills-library/methodology/MERN_QUICK_REFERENCE.md +358 -0
  332. package/skills-library/methodology/ORGAN_AGENT_MAPPING.md +177 -0
  333. package/skills-library/methodology/PARALLEL_WAVE_BASED_REFACTORING.md +440 -0
  334. package/skills-library/methodology/QUICK_REFERENCE.md +358 -0
  335. package/skills-library/methodology/SDFT_ONPOLICY_SELF_DISTILLATION.md +186 -0
  336. package/skills-library/methodology/SELF_QUESTIONING_TASK_GENERATION.md +270 -0
  337. package/skills-library/methodology/SESSION_COMPLETION_SUMMARY.md +304 -0
  338. package/skills-library/methodology/SESSION_SUMMARY.md +432 -0
  339. package/skills-library/methodology/WARRIOR_WORKFLOW_DEBUGGING_PROTOCOL.md +252 -0
  340. package/skills-library/methodology/tech-debt-tracker.md +570 -0
  341. package/skills-library/parallel-debug/SKILL.md +60 -0
  342. package/skills-library/patterns-standards/API_PATTERN_FIX_SUMMARY.md +236 -0
  343. package/skills-library/patterns-standards/BATCH_OPERATIONS_WITH_PROGRESS_MODAL.md +362 -0
  344. package/skills-library/patterns-standards/CRITICAL_CODING_PATTERNS.md +639 -0
  345. package/skills-library/patterns-standards/DARK_MODE_MODAL_VISIBILITY.md +258 -0
  346. package/skills-library/patterns-standards/ERROR_RESILIENCE_IMPLEMENTATION.md +375 -0
  347. package/skills-library/patterns-standards/ES_MODULE_IMPORT_HOISTING_DOTENV.md +298 -0
  348. package/skills-library/patterns-standards/NESTED_BACKDROP_FILTER_CSS_ARTIFACT_FIX.md +76 -0
  349. package/skills-library/patterns-standards/ORDERED_DETECTOR_PIPELINE_GRACEFUL_FALLBACK.md +333 -0
  350. package/skills-library/patterns-standards/PHASE_IMPORT_ERROR_DEBUGGING.md +271 -0
  351. package/skills-library/patterns-standards/PYNPUT_GLOBAL_HOTKEY_VK_MATCHING.md +252 -0
  352. package/skills-library/patterns-standards/REACT_USEEFFECT_CASCADE_RESET_FIX.md +132 -0
  353. package/skills-library/patterns-standards/SUBMENU_HOVER_DROPDOWN_PATTERN.md +225 -0
  354. package/skills-library/patterns-standards/TAILWIND_TEXT_VISIBILITY_OVERRIDE.md +322 -0
  355. package/skills-library/patterns-standards/THEME_AWARE_CSS_VARIABLES_PATTERN.md +209 -0
  356. package/skills-library/patterns-standards/THEME_USER_OBJECT_PROPERTY_NAMING.md +194 -0
  357. package/skills-library/patterns-standards/TOOLTIP_BLOCKING_CLICKS_FIX.md +267 -0
  358. package/skills-library/patterns-standards/claude-code-plugin-structure.md +235 -0
  359. package/skills-library/patterns-standards/react-i18next-setup.md +429 -0
  360. package/skills-library/patterns-standards/thesys-c1-generative-ui-integration.md +967 -0
  361. package/skills-library/plugin-development/CLAUDE_CODE_COMMAND_REGISTRATION_SILENT_FAILURE.md +315 -0
  362. package/skills-library/plugin-development/plugin-command-namespace-vs-global.md +390 -0
  363. package/skills-library/plugin-development/plugin-doc-auto-generation.md +172 -0
  364. package/skills-library/security/GITHUB_REPO_SECURITY_AUDIT.md +115 -0
  365. package/skills-library/security/admin-deletion-safety.md +396 -0
  366. package/skills-library/security/application-vuln-patterns.md +477 -0
  367. package/skills-library/security/env-secrets-manager.md +686 -0
  368. package/skills-library/security/secure-ai-application-templates.md +347 -0
  369. package/skills-library/security/sql-injection-prevention-postgresjs.md +151 -0
  370. package/skills-library/supabase-connection-pooler-fix.md +102 -0
  371. package/skills-library/system-context/POWERSHELL_BASH_INTEROP.md +82 -0
  372. package/skills-library/system-context/SERVICE_LIFECYCLE_MANAGEMENT.md +119 -0
  373. package/skills-library/system-context/SKILL.md +40 -0
  374. package/skills-library/system-context/WINDOWS_DEV_ENVIRONMENT.md +73 -0
  375. package/skills-library/testing/E2E_PLAYWRIGHT_PATTERNS.md +99 -0
  376. package/skills-library/testing/INTEGRATION_TEST_STRATEGY.md +82 -0
  377. package/skills-library/testing/RED_GREEN_BUGFIX_GATE.md +203 -0
  378. package/skills-library/testing/TEST_DATA_MANAGEMENT.md +69 -0
  379. package/skills-library/testing/VITEST_UNIT_TEST_PATTERNS.md +75 -0
  380. package/skills-library/testing/playwright-api-security-tests.md +202 -0
  381. package/skills-library/toolbox/SKILL.md +84 -0
  382. package/skills-library/toolbox/code-graph-and-web-scraping-mcps.md +237 -0
  383. package/skills-library/ui-ux-pro-max/ACCESSIBILITY_ESSENTIALS.md +115 -0
  384. package/skills-library/ui-ux-pro-max/DESIGN_SYSTEM_SCAFFOLDING.md +133 -0
  385. package/skills-library/ui-ux-pro-max/RESPONSIVE_LAYOUT_PATTERNS.md +119 -0
  386. package/skills-library/ui-ux-pro-max/SKILL.md +386 -0
  387. package/skills-library/ui-ux-pro-max/data/charts.csv +26 -0
  388. package/skills-library/ui-ux-pro-max/data/colors.csv +97 -0
  389. package/skills-library/ui-ux-pro-max/data/icons.csv +101 -0
  390. package/skills-library/ui-ux-pro-max/data/landing.csv +31 -0
  391. package/skills-library/ui-ux-pro-max/data/products.csv +97 -0
  392. package/skills-library/ui-ux-pro-max/data/react-performance.csv +45 -0
  393. package/skills-library/ui-ux-pro-max/data/stacks/astro.csv +54 -0
  394. package/skills-library/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  395. package/skills-library/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
  396. package/skills-library/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
  397. package/skills-library/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
  398. package/skills-library/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
  399. package/skills-library/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
  400. package/skills-library/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  401. package/skills-library/ui-ux-pro-max/data/stacks/react.csv +54 -0
  402. package/skills-library/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
  403. package/skills-library/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
  404. package/skills-library/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  405. package/skills-library/ui-ux-pro-max/data/stacks/vue.csv +50 -0
  406. package/skills-library/ui-ux-pro-max/data/styles.csv +68 -0
  407. package/skills-library/ui-ux-pro-max/data/typography.csv +58 -0
  408. package/skills-library/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
  409. package/skills-library/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
  410. package/skills-library/ui-ux-pro-max/data/web-interface.csv +31 -0
  411. package/skills-library/wordpress-style-theme-components.md +1526 -0
  412. package/templates/ASSUMPTIONS.md +1 -1
  413. package/templates/DECISION_LOG.md +0 -1
  414. package/templates/phase-prompt.md +1 -1
  415. package/templates/phoenix-comparison.md +6 -6
  416. package/templates/skill-api-integration.md +106 -0
  417. package/templates/skill-architecture-pattern.md +92 -0
  418. package/templates/skill-debug-pattern.md +98 -0
  419. package/templates/skill-devops-recipe.md +107 -0
  420. package/templates/skill-general.md +65 -0
  421. package/templates/skill-ui-component.md +113 -0
  422. package/tools/uat-runner.py +179 -0
  423. package/version.json +7 -3
  424. package/workflows/handoff-session.md +2 -2
  425. package/workflows/new-project.md +2 -2
  426. package/workflows/plan-phase.md +1 -1
  427. package/.claude-plugin/plugin.json +0 -64
  428. package/skills-library/_general/methodology/LIVE_BREADCRUMB_PROTOCOL.md +0 -242
  429. package/skills-library/_general/methodology/llm-judge-memory-crud.md +0 -241
  430. package/skills-library/methodology/REFLEXION_MEMORY_PATTERN.md +0 -183
  431. package/skills-library/methodology/RESEARCH_BACKED_WORKFLOW_UPGRADE.md +0 -263
  432. package/skills-library/methodology/SABBATH_REST_PATTERN.md +0 -267
  433. package/skills-library/methodology/STONE_AND_SCAFFOLD.md +0 -220
  434. package/skills-library/specialists/api-architecture/api-designer.md +0 -49
  435. package/skills-library/specialists/api-architecture/graphql-architect.md +0 -49
  436. package/skills-library/specialists/api-architecture/mcp-developer.md +0 -51
  437. package/skills-library/specialists/api-architecture/microservices-architect.md +0 -50
  438. package/skills-library/specialists/api-architecture/websocket-engineer.md +0 -48
  439. package/skills-library/specialists/backend/django-expert.md +0 -52
  440. package/skills-library/specialists/backend/fastapi-expert.md +0 -52
  441. package/skills-library/specialists/backend/laravel-specialist.md +0 -52
  442. package/skills-library/specialists/backend/nestjs-expert.md +0 -51
  443. package/skills-library/specialists/backend/rails-expert.md +0 -53
  444. package/skills-library/specialists/backend/spring-boot-engineer.md +0 -56
  445. package/skills-library/specialists/data-ml/fine-tuning-expert.md +0 -48
  446. package/skills-library/specialists/data-ml/ml-pipeline.md +0 -47
  447. package/skills-library/specialists/data-ml/pandas-pro.md +0 -47
  448. package/skills-library/specialists/data-ml/rag-architect.md +0 -51
  449. package/skills-library/specialists/data-ml/spark-engineer.md +0 -47
  450. package/skills-library/specialists/frontend/angular-architect.md +0 -52
  451. package/skills-library/specialists/frontend/flutter-expert.md +0 -51
  452. package/skills-library/specialists/frontend/nextjs-developer.md +0 -54
  453. package/skills-library/specialists/frontend/react-native-expert.md +0 -50
  454. package/skills-library/specialists/frontend/vue-expert.md +0 -51
  455. package/skills-library/specialists/infrastructure/chaos-engineer.md +0 -74
  456. package/skills-library/specialists/infrastructure/cloud-architect.md +0 -70
  457. package/skills-library/specialists/infrastructure/database-optimizer.md +0 -64
  458. package/skills-library/specialists/infrastructure/devops-engineer.md +0 -70
  459. package/skills-library/specialists/infrastructure/kubernetes-specialist.md +0 -52
  460. package/skills-library/specialists/infrastructure/monitoring-expert.md +0 -70
  461. package/skills-library/specialists/infrastructure/sre-engineer.md +0 -70
  462. package/skills-library/specialists/infrastructure/terraform-engineer.md +0 -51
  463. package/skills-library/specialists/languages/cpp-pro.md +0 -74
  464. package/skills-library/specialists/languages/csharp-developer.md +0 -69
  465. package/skills-library/specialists/languages/dotnet-core-expert.md +0 -54
  466. package/skills-library/specialists/languages/golang-pro.md +0 -51
  467. package/skills-library/specialists/languages/java-architect.md +0 -49
  468. package/skills-library/specialists/languages/javascript-pro.md +0 -68
  469. package/skills-library/specialists/languages/kotlin-specialist.md +0 -68
  470. package/skills-library/specialists/languages/php-pro.md +0 -49
  471. package/skills-library/specialists/languages/python-pro.md +0 -52
  472. package/skills-library/specialists/languages/react-expert.md +0 -51
  473. package/skills-library/specialists/languages/rust-engineer.md +0 -50
  474. package/skills-library/specialists/languages/sql-pro.md +0 -56
  475. package/skills-library/specialists/languages/swift-expert.md +0 -69
  476. package/skills-library/specialists/languages/typescript-pro.md +0 -51
  477. package/skills-library/specialists/platform/atlassian-mcp.md +0 -52
  478. package/skills-library/specialists/platform/embedded-systems.md +0 -53
  479. package/skills-library/specialists/platform/game-developer.md +0 -53
  480. package/skills-library/specialists/platform/salesforce-developer.md +0 -53
  481. package/skills-library/specialists/platform/shopify-expert.md +0 -49
  482. package/skills-library/specialists/platform/wordpress-pro.md +0 -49
  483. package/skills-library/specialists/quality/code-documenter.md +0 -51
  484. package/skills-library/specialists/quality/code-reviewer.md +0 -67
  485. package/skills-library/specialists/quality/debugging-wizard.md +0 -51
  486. package/skills-library/specialists/quality/fullstack-guardian.md +0 -51
  487. package/skills-library/specialists/quality/legacy-modernizer.md +0 -50
  488. package/skills-library/specialists/quality/playwright-expert.md +0 -65
  489. package/skills-library/specialists/quality/spec-miner.md +0 -56
  490. package/skills-library/specialists/quality/test-master.md +0 -65
  491. package/skills-library/specialists/security/secure-code-guardian.md +0 -55
  492. package/skills-library/specialists/security/security-reviewer.md +0 -53
  493. package/skills-library/specialists/workflow/architecture-designer.md +0 -53
  494. package/skills-library/specialists/workflow/cli-developer.md +0 -70
  495. package/skills-library/specialists/workflow/feature-forge.md +0 -65
  496. package/skills-library/specialists/workflow/prompt-engineer.md +0 -54
  497. package/skills-library/specialists/workflow/the-fool.md +0 -62
  498. /package/skills-library/{performance → _general/performance}/cache-augmented-generation.md +0 -0
  499. /package/skills-library/{debugging → parallel-debug}/FAILURE_TAXONOMY_CLASSIFICATION.md +0 -0
  500. /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