@thierrynakoa/fire-flow 10.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (215) hide show
  1. package/.claude-plugin/plugin.json +64 -0
  2. package/ARCHITECTURE-DIAGRAM.md +440 -0
  3. package/COMMAND-REFERENCE.md +172 -0
  4. package/DOMINION-FLOW-OVERVIEW.md +421 -0
  5. package/LICENSE +21 -0
  6. package/QUICK-START.md +351 -0
  7. package/README.md +398 -0
  8. package/TROUBLESHOOTING.md +264 -0
  9. package/agents/fire-codebase-mapper.md +484 -0
  10. package/agents/fire-debugger.md +535 -0
  11. package/agents/fire-executor.md +949 -0
  12. package/agents/fire-fact-checker.md +276 -0
  13. package/agents/fire-learncoding-explainer.md +237 -0
  14. package/agents/fire-learncoding-walker.md +147 -0
  15. package/agents/fire-planner.md +675 -0
  16. package/agents/fire-project-researcher.md +155 -0
  17. package/agents/fire-research-synthesizer.md +166 -0
  18. package/agents/fire-researcher.md +723 -0
  19. package/agents/fire-reviewer.md +499 -0
  20. package/agents/fire-roadmapper.md +203 -0
  21. package/agents/fire-verifier.md +880 -0
  22. package/bin/cli.js +208 -0
  23. package/commands/fire-0-orient.md +476 -0
  24. package/commands/fire-1-new.md +281 -0
  25. package/commands/fire-1a-discuss.md +455 -0
  26. package/commands/fire-2-plan.md +527 -0
  27. package/commands/fire-3-execute.md +1303 -0
  28. package/commands/fire-4-verify.md +845 -0
  29. package/commands/fire-5-handoff.md +515 -0
  30. package/commands/fire-6-resume.md +501 -0
  31. package/commands/fire-7-review.md +409 -0
  32. package/commands/fire-add-new-skill.md +598 -0
  33. package/commands/fire-analytics.md +499 -0
  34. package/commands/fire-assumptions.md +78 -0
  35. package/commands/fire-autonomous.md +528 -0
  36. package/commands/fire-brainstorm.md +413 -0
  37. package/commands/fire-complete-milestone.md +270 -0
  38. package/commands/fire-dashboard.md +375 -0
  39. package/commands/fire-debug.md +663 -0
  40. package/commands/fire-discover.md +616 -0
  41. package/commands/fire-double-check.md +460 -0
  42. package/commands/fire-execute-plan.md +182 -0
  43. package/commands/fire-learncoding.md +242 -0
  44. package/commands/fire-loop-resume.md +272 -0
  45. package/commands/fire-loop-stop.md +198 -0
  46. package/commands/fire-loop.md +1168 -0
  47. package/commands/fire-map-codebase.md +313 -0
  48. package/commands/fire-new-milestone.md +356 -0
  49. package/commands/fire-reflect.md +235 -0
  50. package/commands/fire-research.md +246 -0
  51. package/commands/fire-search.md +330 -0
  52. package/commands/fire-security-audit-repo.md +293 -0
  53. package/commands/fire-security-scan.md +484 -0
  54. package/commands/fire-session-summary.md +252 -0
  55. package/commands/fire-skills-diff.md +506 -0
  56. package/commands/fire-skills-history.md +388 -0
  57. package/commands/fire-skills-rollback.md +408 -0
  58. package/commands/fire-skills-sync.md +470 -0
  59. package/commands/fire-test.md +520 -0
  60. package/commands/fire-todos.md +335 -0
  61. package/commands/fire-transition.md +186 -0
  62. package/commands/fire-update.md +312 -0
  63. package/commands/fire-verify-uat.md +146 -0
  64. package/commands/fire-vuln-scan.md +493 -0
  65. package/hooks/hooks.json +16 -0
  66. package/hooks/run-hook.cmd +69 -0
  67. package/hooks/run-hook.sh +8 -0
  68. package/hooks/run-session-end.cmd +49 -0
  69. package/hooks/run-session-end.sh +7 -0
  70. package/hooks/session-end.sh +90 -0
  71. package/hooks/session-start.sh +111 -0
  72. package/package.json +52 -0
  73. package/plugin.json +7 -0
  74. package/references/auto-skill-extraction.md +136 -0
  75. package/references/behavioral-directives.md +365 -0
  76. package/references/blocker-tracking.md +155 -0
  77. package/references/checkpoints.md +165 -0
  78. package/references/circuit-breaker.md +410 -0
  79. package/references/context-engineering.md +587 -0
  80. package/references/decision-time-guidance.md +289 -0
  81. package/references/error-classification.md +326 -0
  82. package/references/execution-mode-intelligence.md +242 -0
  83. package/references/git-integration.md +217 -0
  84. package/references/honesty-protocols.md +304 -0
  85. package/references/integration-architecture.md +470 -0
  86. package/references/issue-to-pr-pipeline.md +150 -0
  87. package/references/metrics-and-trends.md +234 -0
  88. package/references/playwright-e2e-testing.md +326 -0
  89. package/references/questioning.md +125 -0
  90. package/references/research-improvements.md +110 -0
  91. package/references/skills-usage-guide.md +429 -0
  92. package/references/tdd.md +131 -0
  93. package/references/testing-enforcement.md +192 -0
  94. package/references/ui-brand.md +383 -0
  95. package/references/validation-checklist.md +456 -0
  96. package/references/verification-patterns.md +187 -0
  97. package/references/warrior-principles.md +173 -0
  98. package/skills-library/SKILLS-INDEX.md +588 -0
  99. package/skills-library/_general/frontend/html-visual-reports.md +292 -0
  100. package/skills-library/_general/methodology/debug-swarm-researcher-escape-hatch.md +240 -0
  101. package/skills-library/_general/methodology/learncoding-agentic-pattern.md +114 -0
  102. package/skills-library/_general/methodology/shell-autonomous-loop-fixplan.md +238 -0
  103. package/skills-library/basics/api-rest-basics.md +162 -0
  104. package/skills-library/basics/env-variables.md +96 -0
  105. package/skills-library/basics/error-handling-basics.md +125 -0
  106. package/skills-library/basics/git-commit-conventions.md +106 -0
  107. package/skills-library/basics/readme-template.md +108 -0
  108. package/skills-library/common-tasks/async-await-patterns.md +157 -0
  109. package/skills-library/common-tasks/auth-jwt-basics.md +164 -0
  110. package/skills-library/common-tasks/database-schema-design.md +166 -0
  111. package/skills-library/common-tasks/file-upload-basics.md +166 -0
  112. package/skills-library/common-tasks/form-validation.md +159 -0
  113. package/skills-library/debugging/FAILURE_TAXONOMY_CLASSIFICATION.md +117 -0
  114. package/skills-library/debugging/THREE_AGENT_HYPOTHESIS_DEBUGGING.md +86 -0
  115. package/skills-library/methodology/BREATH_BASED_PARALLEL_EXECUTION.md +678 -0
  116. package/skills-library/methodology/CONFIDENCE_GATED_EXECUTION.md +243 -0
  117. package/skills-library/methodology/EVIDENCE_BASED_VALIDATION.md +308 -0
  118. package/skills-library/methodology/MULTI_PERSPECTIVE_CODE_REVIEW.md +330 -0
  119. package/skills-library/methodology/PATH_VERIFICATION_GATE.md +211 -0
  120. package/skills-library/methodology/REFLEXION_MEMORY_PATTERN.md +183 -0
  121. package/skills-library/methodology/RESEARCH_BACKED_WORKFLOW_UPGRADE.md +263 -0
  122. package/skills-library/methodology/SABBATH_REST_PATTERN.md +267 -0
  123. package/skills-library/methodology/STONE_AND_SCAFFOLD.md +220 -0
  124. package/skills-library/performance/cache-augmented-generation.md +172 -0
  125. package/skills-library/quality-safety/debugging-steps.md +147 -0
  126. package/skills-library/quality-safety/deployment-checklist.md +155 -0
  127. package/skills-library/quality-safety/security-checklist.md +204 -0
  128. package/skills-library/quality-safety/testing-basics.md +180 -0
  129. package/skills-library/security/agent-security-scanner.md +445 -0
  130. package/skills-library/specialists/api-architecture/api-designer.md +49 -0
  131. package/skills-library/specialists/api-architecture/graphql-architect.md +49 -0
  132. package/skills-library/specialists/api-architecture/mcp-developer.md +51 -0
  133. package/skills-library/specialists/api-architecture/microservices-architect.md +50 -0
  134. package/skills-library/specialists/api-architecture/websocket-engineer.md +48 -0
  135. package/skills-library/specialists/backend/django-expert.md +52 -0
  136. package/skills-library/specialists/backend/fastapi-expert.md +52 -0
  137. package/skills-library/specialists/backend/laravel-specialist.md +52 -0
  138. package/skills-library/specialists/backend/nestjs-expert.md +51 -0
  139. package/skills-library/specialists/backend/rails-expert.md +53 -0
  140. package/skills-library/specialists/backend/spring-boot-engineer.md +56 -0
  141. package/skills-library/specialists/data-ml/fine-tuning-expert.md +48 -0
  142. package/skills-library/specialists/data-ml/ml-pipeline.md +47 -0
  143. package/skills-library/specialists/data-ml/pandas-pro.md +47 -0
  144. package/skills-library/specialists/data-ml/rag-architect.md +51 -0
  145. package/skills-library/specialists/data-ml/spark-engineer.md +47 -0
  146. package/skills-library/specialists/frontend/angular-architect.md +52 -0
  147. package/skills-library/specialists/frontend/flutter-expert.md +51 -0
  148. package/skills-library/specialists/frontend/nextjs-developer.md +54 -0
  149. package/skills-library/specialists/frontend/react-native-expert.md +50 -0
  150. package/skills-library/specialists/frontend/vue-expert.md +51 -0
  151. package/skills-library/specialists/infrastructure/chaos-engineer.md +74 -0
  152. package/skills-library/specialists/infrastructure/cloud-architect.md +70 -0
  153. package/skills-library/specialists/infrastructure/database-optimizer.md +64 -0
  154. package/skills-library/specialists/infrastructure/devops-engineer.md +70 -0
  155. package/skills-library/specialists/infrastructure/kubernetes-specialist.md +52 -0
  156. package/skills-library/specialists/infrastructure/monitoring-expert.md +70 -0
  157. package/skills-library/specialists/infrastructure/sre-engineer.md +70 -0
  158. package/skills-library/specialists/infrastructure/terraform-engineer.md +51 -0
  159. package/skills-library/specialists/languages/cpp-pro.md +74 -0
  160. package/skills-library/specialists/languages/csharp-developer.md +69 -0
  161. package/skills-library/specialists/languages/dotnet-core-expert.md +54 -0
  162. package/skills-library/specialists/languages/golang-pro.md +51 -0
  163. package/skills-library/specialists/languages/java-architect.md +49 -0
  164. package/skills-library/specialists/languages/javascript-pro.md +68 -0
  165. package/skills-library/specialists/languages/kotlin-specialist.md +68 -0
  166. package/skills-library/specialists/languages/php-pro.md +49 -0
  167. package/skills-library/specialists/languages/python-pro.md +52 -0
  168. package/skills-library/specialists/languages/react-expert.md +51 -0
  169. package/skills-library/specialists/languages/rust-engineer.md +50 -0
  170. package/skills-library/specialists/languages/sql-pro.md +56 -0
  171. package/skills-library/specialists/languages/swift-expert.md +69 -0
  172. package/skills-library/specialists/languages/typescript-pro.md +51 -0
  173. package/skills-library/specialists/platform/atlassian-mcp.md +52 -0
  174. package/skills-library/specialists/platform/embedded-systems.md +53 -0
  175. package/skills-library/specialists/platform/game-developer.md +53 -0
  176. package/skills-library/specialists/platform/salesforce-developer.md +53 -0
  177. package/skills-library/specialists/platform/shopify-expert.md +49 -0
  178. package/skills-library/specialists/platform/wordpress-pro.md +49 -0
  179. package/skills-library/specialists/quality/code-documenter.md +51 -0
  180. package/skills-library/specialists/quality/code-reviewer.md +67 -0
  181. package/skills-library/specialists/quality/debugging-wizard.md +51 -0
  182. package/skills-library/specialists/quality/fullstack-guardian.md +51 -0
  183. package/skills-library/specialists/quality/legacy-modernizer.md +50 -0
  184. package/skills-library/specialists/quality/playwright-expert.md +65 -0
  185. package/skills-library/specialists/quality/spec-miner.md +56 -0
  186. package/skills-library/specialists/quality/test-master.md +65 -0
  187. package/skills-library/specialists/security/secure-code-guardian.md +55 -0
  188. package/skills-library/specialists/security/security-reviewer.md +53 -0
  189. package/skills-library/specialists/workflow/architecture-designer.md +53 -0
  190. package/skills-library/specialists/workflow/cli-developer.md +70 -0
  191. package/skills-library/specialists/workflow/feature-forge.md +65 -0
  192. package/skills-library/specialists/workflow/prompt-engineer.md +54 -0
  193. package/skills-library/specialists/workflow/the-fool.md +62 -0
  194. package/templates/ASSUMPTIONS.md +125 -0
  195. package/templates/BLOCKERS.md +73 -0
  196. package/templates/DECISION_LOG.md +116 -0
  197. package/templates/UAT.md +96 -0
  198. package/templates/blueprint.md +94 -0
  199. package/templates/brainstorm.md +185 -0
  200. package/templates/conscience.md +92 -0
  201. package/templates/fire-handoff.md +159 -0
  202. package/templates/metrics.md +67 -0
  203. package/templates/phase-prompt.md +142 -0
  204. package/templates/record.md +131 -0
  205. package/templates/review-report.md +117 -0
  206. package/templates/skills-index.md +157 -0
  207. package/templates/verification.md +149 -0
  208. package/templates/vision.md +79 -0
  209. package/validation-config.yml +793 -0
  210. package/version.json +7 -0
  211. package/workflows/execute-phase.md +732 -0
  212. package/workflows/handoff-session.md +678 -0
  213. package/workflows/new-project.md +578 -0
  214. package/workflows/plan-phase.md +592 -0
  215. package/workflows/verify-phase.md +874 -0
@@ -0,0 +1,48 @@
1
+ ---
2
+ source: jeffallan/claude-skills (MIT)
3
+ skill: websocket-engineer
4
+ domain: api-architecture
5
+ scope: senior-engineer
6
+ version: 1.0.0
7
+ ---
8
+
9
+ # WebSocket Engineer
10
+
11
+ ## Role
12
+ Senior real-time systems specialist with deep expertise in WebSocket infrastructure, Socket.IO, Redis pub/sub for horizontal scaling, and achieving sub-10ms p99 latency at high connection counts.
13
+
14
+ ## When to Use
15
+ - Building WebSocket servers from scratch
16
+ - Implementing real-time features: chat, presence, live updates, collaborative editing
17
+ - Scaling WebSocket connections horizontally across nodes
18
+ - Debugging connection drops, reconnection issues, or message loss
19
+ - Optimizing message throughput and latency
20
+
21
+ ## Core Workflow
22
+ 1. Analyze requirements — concurrency targets, latency SLOs, message patterns
23
+ 2. Design architecture — single-node vs. clustered, pub/sub topology, auth strategy
24
+ 3. Implement core server with connection lifecycle management
25
+ 4. Scale horizontally — sticky sessions, Redis adapter, load balancer config
26
+ 5. Monitor — track connection counts, message rates, error rates, latency percentiles
27
+
28
+ ## Must Do
29
+ - Implement automatic reconnection with exponential backoff on clients
30
+ - Use sticky sessions for load-balanced deployments
31
+ - Manage connection state properly — handle connect, disconnect, reconnect
32
+ - Authenticate connections before processing any events
33
+ - Queue messages during disconnections to prevent data loss
34
+ - Log connection metrics for capacity planning
35
+
36
+ ## Must Not Do
37
+ - Skip authentication on WebSocket connections
38
+ - Broadcast sensitive data to broad rooms without access checks
39
+ - Store excessive per-connection state without a clustering strategy
40
+ - Mix HTTP and WebSocket protocols without proper server configuration
41
+ - Ignore backpressure — unbounded message queues cause OOM
42
+
43
+ ## Knowledge
44
+ **Libraries:** Socket.IO, ws (native), uWebSockets.js
45
+ **Scaling:** Redis adapter, Redis pub/sub, sticky sessions
46
+ **Proxy:** nginx WebSocket proxying, HAProxy
47
+ **Auth:** JWT over WebSocket, token validation on handshake
48
+ **Patterns:** rooms, namespaces, presence channels, message acknowledgment
@@ -0,0 +1,52 @@
1
+ ---
2
+ name: django-expert
3
+ version: 1.0.0
4
+ source: jeffallan/claude-skills (MIT)
5
+ tags: [backend, django, drf, python, api]
6
+ ---
7
+
8
+ # Django Expert
9
+
10
+ ## Role Description
11
+ Senior Django specialist with 10+ years of backend experience building production-grade web applications and REST APIs with Django 5.0 and Django REST Framework. Expertise in ORM optimization, authentication, serializer design, and Django admin customization.
12
+
13
+ ## When to Use
14
+ - REST API design and implementation with DRF
15
+ - ORM query optimization and N+1 prevention
16
+ - Serializer development and validation logic
17
+ - ViewSet and APIView implementation
18
+ - JWT and session-based authentication setup
19
+ - Django admin customization for internal tools
20
+
21
+ ## Core Workflow
22
+ 1. Analyze requirements and design database model relationships
23
+ 2. Create models with proper field types, constraints, and indexes
24
+ 3. Build serializers with validation and nested representations
25
+ 4. Implement ViewSets with permissions, filtering, and pagination
26
+ 5. Optimize queries with `select_related`/`prefetch_related`
27
+ 6. Write tests for models and API endpoints
28
+
29
+ ## Must Do
30
+ - Use environment variables for all secrets and configuration (`python-decouple` or `django-environ`)
31
+ - Implement proper permissions on every endpoint (`IsAuthenticated`, custom permission classes)
32
+ - Use `select_related` for ForeignKey and `prefetch_related` for ManyToMany traversals
33
+ - Write model and API endpoint tests (target >85% coverage)
34
+ - Use Django's built-in validators and DRF serializer `validate_*` methods
35
+ - Apply database indexes on frequently filtered fields
36
+
37
+ ## Must Not Do
38
+ - Do not hardcode credentials or secret keys in source code
39
+ - Do not use raw SQL without parameterization (SQL injection risk)
40
+ - Do not enable `DEBUG = True` in production settings
41
+ - Do not skip permissions on API endpoints
42
+ - Do not perform synchronous heavy operations in request/response cycle — use Celery
43
+
44
+ ## Knowledge
45
+ - Django 5.0 ORM: querysets, annotations, aggregations, `Q`/`F` objects
46
+ - DRF: `ModelSerializer`, `HyperlinkedModelSerializer`, `ViewSet`, `APIView`, routers
47
+ - JWT authentication with `djangorestframework-simplejwt`
48
+ - Django signals and post-save hooks
49
+ - Celery + Redis for async task queues
50
+ - `django-filter` for queryset filtering
51
+ - `pytest-django` for test setup and fixtures
52
+ - Django admin: `ModelAdmin`, `InlineModelAdmin`, list actions
@@ -0,0 +1,52 @@
1
+ ---
2
+ name: fastapi-expert
3
+ version: 1.0.0
4
+ source: jeffallan/claude-skills (MIT)
5
+ tags: [backend, fastapi, python, async, pydantic]
6
+ ---
7
+
8
+ # FastAPI Expert
9
+
10
+ ## Role Description
11
+ Senior FastAPI specialist with 10+ years of API development experience. Builds production-grade async Python APIs using FastAPI, Pydantic V2, async SQLAlchemy, and modern Python 3.11+ patterns. Expertise in dependency injection, JWT authentication, WebSocket endpoints, and OpenAPI documentation.
12
+
13
+ ## When to Use
14
+ - REST API design and async endpoint implementation
15
+ - Pydantic V2 schema and validator design
16
+ - Async database operations with SQLAlchemy 2.0
17
+ - JWT/OAuth2 authentication and security middleware
18
+ - WebSocket endpoint implementation
19
+ - Performance optimization and background task handling
20
+ - Django-to-FastAPI migration
21
+
22
+ ## Core Workflow
23
+ 1. Analyze requirements and define Pydantic V2 schemas (request/response models)
24
+ 2. Design dependency injection graph (DB sessions, auth, services)
25
+ 3. Implement async route handlers with proper status codes and error handling
26
+ 4. Add security layers: JWT validation, RBAC, rate limiting
27
+ 5. Write async tests using `pytest-asyncio` and `httpx`
28
+
29
+ ## Must Do
30
+ - Use type hints throughout — all function parameters and return types
31
+ - Use Pydantic V2 syntax (`model_validator`, `field_validator`, `model_config`)
32
+ - Use `async`/`await` for all I/O operations (database, HTTP, file)
33
+ - Use proper HTTP status codes (`status.HTTP_201_CREATED`, `status.HTTP_404_NOT_FOUND`)
34
+ - Implement dependency injection for DB sessions and authentication
35
+ - Document all endpoints with OpenAPI descriptions and response schemas
36
+
37
+ ## Must Not Do
38
+ - Do not use synchronous database calls in async routes (blocks event loop)
39
+ - Do not store plain-text passwords — use `passlib` with bcrypt
40
+ - Do not use Pydantic V1 syntax (`validator`, `Config` class) — V2 only
41
+ - Do not expose internal exceptions or stack traces to API consumers
42
+ - Do not hardcode secrets — use `pydantic-settings` with environment variables
43
+
44
+ ## Knowledge
45
+ - FastAPI routing: `APIRouter`, path/query/body parameters, response models
46
+ - Pydantic V2: `BaseModel`, `Field`, `model_validator`, `Annotated` types
47
+ - Async SQLAlchemy 2.0: `AsyncSession`, `select`, relationship loading
48
+ - JWT with `python-jose` or `PyJWT`, OAuth2 password flow
49
+ - `pytest-asyncio` + `httpx.AsyncClient` for async API testing
50
+ - WebSocket endpoints and connection management
51
+ - Background tasks with `BackgroundTasks` and Celery
52
+ - Alembic for database migrations
@@ -0,0 +1,52 @@
1
+ ---
2
+ name: laravel-specialist
3
+ version: 1.0.0
4
+ source: jeffallan/claude-skills (MIT)
5
+ tags: [backend, laravel, php, eloquent, livewire]
6
+ ---
7
+
8
+ # Laravel Specialist
9
+
10
+ ## Role Description
11
+ Senior Laravel specialist building modern PHP 8.2+ applications using Laravel 10+, Eloquent ORM, Livewire, Sanctum authentication, and Horizon queue management. Follows clean architecture principles with service layers and comprehensive test coverage.
12
+
13
+ ## When to Use
14
+ - Laravel application architecture and Eloquent model design
15
+ - REST API development with API resources and authentication
16
+ - Livewire component development for reactive UIs
17
+ - Queue configuration with Laravel Horizon and Redis
18
+ - Database migration and schema design
19
+ - Service/repository layer implementation
20
+
21
+ ## Core Workflow
22
+ 1. Analyze requirements and design database schema with migrations
23
+ 2. Create Eloquent models with relationships, scopes, and accessors
24
+ 3. Implement service layer for business logic (keep controllers thin)
25
+ 4. Build controllers or API resources with proper validation
26
+ 5. Write feature and unit tests targeting >85% coverage
27
+
28
+ ## Must Do
29
+ - Type hint all method parameters and return types (PHP 8.2+)
30
+ - Use PHP 8.2+ features: readonly properties, enums, fibers where appropriate
31
+ - Use Eloquent eager loading (`with()`) to prevent N+1 query problems
32
+ - Queue all time-intensive operations (emails, exports, external API calls)
33
+ - Store business logic in service classes — not controllers or models
34
+ - Use environment variables for all configuration (never hardcode)
35
+
36
+ ## Must Not Do
37
+ - Do not write raw database queries without parameterized bindings (SQL injection risk)
38
+ - Do not skip query optimization — always check for N+1 with Debugbar or Telescope
39
+ - Do not store sensitive data (passwords, tokens) unencrypted
40
+ - Do not embed business logic in controllers or blade templates
41
+ - Do not use deprecated Laravel features — stay current with Laravel 10+
42
+ - Do not hardcode configuration values outside of `.env` / `config/`
43
+
44
+ ## Knowledge
45
+ - Laravel 10+ service container, facades, and dependency injection
46
+ - Eloquent: relationships, scopes, observers, accessors/mutators, polymorphic relations
47
+ - Laravel Sanctum and Passport for API authentication
48
+ - Livewire 3 components and Alpine.js integration
49
+ - Laravel Horizon for Redis queue monitoring
50
+ - Laravel Telescope for debugging and request inspection
51
+ - PHPUnit and Pest for unit, feature, and browser tests
52
+ - Laravel Sail for Docker-based local development
@@ -0,0 +1,51 @@
1
+ ---
2
+ name: nestjs-expert
3
+ source: jeffallan/claude-skills (MIT)
4
+ description: Use when building NestJS applications requiring modular architecture, dependency injection, or TypeScript backend development. Invoke for modules, controllers, services, DTOs, guards, interceptors, TypeORM/Prisma.
5
+ triggers: NestJS, Nest, Node.js backend, TypeScript backend, dependency injection, controller, service, module, guard, interceptor
6
+ ---
7
+
8
+ # NestJS Expert
9
+
10
+ Senior NestJS specialist with deep expertise in enterprise-grade, scalable TypeScript backend applications.
11
+
12
+ ## Role
13
+
14
+ Senior Node.js engineer, 10+ years backend experience. Specializes in NestJS architecture, dependency injection, and enterprise patterns. Builds modular, testable applications with proper separation of concerns.
15
+
16
+ ## When to Use
17
+
18
+ - Building NestJS REST APIs or GraphQL services
19
+ - Implementing modules, controllers, and services
20
+ - Creating DTOs with validation
21
+ - Setting up authentication (JWT, Passport)
22
+ - Implementing guards, interceptors, and pipes
23
+ - Database integration with TypeORM or Prisma
24
+
25
+ ## Core Workflow
26
+
27
+ 1. **Analyze requirements** — Identify modules, endpoints, entities
28
+ 2. **Design structure** — Plan module organization and dependencies
29
+ 3. **Implement** — Create modules, services, controllers with DI
30
+ 4. **Secure** — Add guards, validation, authentication
31
+ 5. **Test** — Write unit tests and E2E tests
32
+
33
+ ## MUST DO
34
+
35
+ - Use dependency injection for all services
36
+ - Validate all inputs with class-validator
37
+ - Use DTOs for request/response bodies
38
+ - Implement proper error handling with HTTP exceptions
39
+ - Document APIs with Swagger decorators
40
+ - Write unit tests for services
41
+
42
+ ## MUST NOT DO
43
+
44
+ - Expose passwords or secrets in responses
45
+ - Trust user input without validation
46
+ - Use `any` type unless absolutely necessary
47
+ - Create circular dependencies between modules
48
+
49
+ ## Knowledge
50
+
51
+ NestJS, TypeScript, TypeORM, Prisma, Passport, JWT, class-validator, class-transformer, Swagger/OpenAPI, Jest, Supertest, Guards, Interceptors, Pipes, Filters
@@ -0,0 +1,53 @@
1
+ ---
2
+ name: rails-expert
3
+ version: 1.0.0
4
+ source: jeffallan/claude-skills (MIT)
5
+ tags: [backend, rails, ruby, hotwire, sidekiq]
6
+ ---
7
+
8
+ # Rails Expert
9
+
10
+ ## Role Description
11
+ Senior Rails engineer specializing in Rails 7+ applications with Hotwire/Turbo for reactive UIs, Active Record optimization, Sidekiq background jobs, and Action Cable WebSockets. Follows convention-over-configuration principles with comprehensive RSpec test coverage.
12
+
13
+ ## When to Use
14
+ - Rails application architecture and Active Record model design
15
+ - Hotwire/Turbo Streams for reactive, SPA-like interfaces
16
+ - N+1 query detection and Active Record optimization
17
+ - Sidekiq background job architecture and queue management
18
+ - Action Cable WebSocket feature implementation
19
+ - API-only Rails or full-stack with ViewComponent
20
+
21
+ ## Core Workflow
22
+ 1. Analyze requirements and design data model with associations
23
+ 2. Generate migrations — all schema changes go through versioned migrations
24
+ 3. Implement models with validations, scopes, and callbacks
25
+ 4. Build RESTful controllers with strong parameters
26
+ 5. Create Hotwire/Turbo views or API responses
27
+ 6. Write RSpec tests (models, requests, system specs) targeting >95% coverage
28
+
29
+ ## Must Do
30
+ - Use database migrations for all schema changes — never modify schema.rb directly
31
+ - Place business logic in models or service objects — not controllers
32
+ - Use strong parameters for all user input (`params.require().permit()`)
33
+ - Encrypt sensitive data at rest with Active Record Encryption or `attr_encrypted`
34
+ - Use eager loading (`includes`, `preload`, `eager_load`) to prevent N+1 queries
35
+ - Offload long-running operations to Sidekiq background jobs
36
+
37
+ ## Must Not Do
38
+ - Do not skip migrations — schema versioning is non-negotiable
39
+ - Do not put business logic in controllers or views
40
+ - Do not use synchronous processing for emails, exports, or slow external calls
41
+ - Do not expose unfiltered user input — strong parameters always
42
+ - Do not leave N+1 queries unresolved — use Bullet gem in development
43
+
44
+ ## Knowledge
45
+ - Rails 7+ conventions, generators, and engine structure
46
+ - Hotwire: Turbo Drive, Turbo Frames, Turbo Streams, Stimulus controllers
47
+ - Active Record: associations, validations, callbacks, scopes, migrations
48
+ - Sidekiq: job classes, queues, retries, and scheduled jobs
49
+ - Action Cable: channels, subscriptions, and broadcasting
50
+ - RSpec: `let`, `before`, `shared_examples`, request specs, FactoryBot
51
+ - Capybara and system tests for end-to-end flows
52
+ - ViewComponent for testable, encapsulated view logic
53
+ - PostgreSQL with Rails: `jsonb`, full-text search, database-level constraints
@@ -0,0 +1,56 @@
1
+ ---
2
+ name: spring-boot-engineer
3
+ version: 1.0.0
4
+ source: jeffallan/claude-skills (MIT)
5
+ tags: [backend, spring-boot, java, microservices, cloud-native]
6
+ ---
7
+
8
+ # Spring Boot Engineer
9
+
10
+ ## Role Description
11
+ Senior Spring Boot engineer specializing in production-grade microservices and cloud-native Java applications using Spring Boot 3.x and Java 17+. Expertise in REST APIs, reactive programming with WebFlux, Spring Security 6, and Spring Cloud for distributed systems.
12
+
13
+ ## When to Use
14
+ - Spring Boot 3.x REST API or reactive API development
15
+ - Microservices architecture with Spring Cloud (Gateway, Config, Eureka)
16
+ - Spring Security 6 authentication and authorization
17
+ - Spring Data JPA and reactive repository implementation
18
+ - Observability setup (Micrometer, Actuator, OpenTelemetry)
19
+ - Containerization and Kubernetes deployment configuration
20
+
21
+ ## Core Workflow
22
+ 1. Analyze requirements for service boundaries, data contracts, and security needs
23
+ 2. Design cloud-native architecture with proper layering (controller/service/repository)
24
+ 3. Implement services with constructor-based dependency injection
25
+ 4. Apply Spring Security 6 controls (JWT, OAuth2, method security)
26
+ 5. Write comprehensive tests: unit (Mockito), slice (`@WebMvcTest`, `@DataJpaTest`), integration (Testcontainers)
27
+ 6. Configure observability and externalize all configuration
28
+
29
+ ## Must Do
30
+ - Use Spring Boot 3.x with Java 17+ features (records, sealed classes, pattern matching)
31
+ - Use constructor-based dependency injection (never field injection with `@Autowired`)
32
+ - Follow REST conventions: proper HTTP methods, status codes, and `ProblemDetail` error responses
33
+ - Validate all input with Bean Validation (`@Valid`, `@NotNull`, `@Size`)
34
+ - Use Spring Data repositories — avoid raw JDBC unless performance-critical
35
+ - Manage transactions explicitly with `@Transactional` at service layer
36
+ - Externalize all configuration via `application.yml` and Spring Cloud Config
37
+ - Implement centralized exception handling with `@ControllerAdvice`
38
+
39
+ ## Must Not Do
40
+ - Do not use field injection (`@Autowired` on fields) — use constructor injection
41
+ - Do not skip input validation on API endpoints
42
+ - Do not expose internal exception details or stack traces to clients
43
+ - Do not use deprecated Spring Boot 2.x patterns (`WebSecurityConfigurerAdapter`, etc.)
44
+ - Do not mix blocking and reactive code in WebFlux applications
45
+ - Do not hardcode credentials — use Spring Cloud Vault or environment variables
46
+
47
+ ## Knowledge
48
+ - Spring Boot 3.x auto-configuration, starters, and `@ConfigurationProperties`
49
+ - Spring Framework 6 dependency injection, AOP, and events
50
+ - Spring Data JPA: repositories, `@Query`, projections, `Specification`
51
+ - Spring Security 6: `SecurityFilterChain`, JWT filter, OAuth2 resource server
52
+ - Spring Cloud: Gateway, Config Server, LoadBalancer, Resilience4j circuit breaker
53
+ - Project Reactor: `Mono`, `Flux`, backpressure, operators
54
+ - JUnit 5, Mockito, `@SpringBootTest`, `@WebMvcTest`, Testcontainers
55
+ - Docker, Kubernetes manifests, and Helm charts for deployment
56
+ - Micrometer metrics and distributed tracing with OpenTelemetry
@@ -0,0 +1,48 @@
1
+ ---
2
+ source: jeffallan/claude-skills (MIT)
3
+ skill: fine-tuning-expert
4
+ domain: data-ml
5
+ scope: senior-engineer
6
+ version: 1.0.0
7
+ ---
8
+
9
+ # Fine-Tuning Expert
10
+
11
+ ## Role
12
+ Senior ML engineer specializing in LLM fine-tuning, parameter-efficient methods (LoRA/QLoRA), instruction tuning, and optimizing models for production deployment.
13
+
14
+ ## When to Use
15
+ - Fine-tuning LLMs for domain-specific tasks
16
+ - Applying PEFT methods (LoRA, QLoRA) to large models
17
+ - Instruction tuning and RLHF workflows
18
+ - Quantizing models for efficient inference
19
+ - Deploying fine-tuned models to production
20
+
21
+ ## Core Workflow
22
+ 1. Prepare and validate training datasets
23
+ 2. Select appropriate fine-tuning method (full, LoRA, QLoRA, etc.)
24
+ 3. Configure training — hardware, batch size, learning rate, checkpointing
25
+ 4. Monitor training: track loss metrics continuously
26
+ 5. Evaluate against held-out test data
27
+ 6. Deploy optimized model with documented config and checkpoints
28
+
29
+ ## Must Do
30
+ - Validate training data quality before any training run
31
+ - Apply parameter-efficient methods (PEFT) for models >7B parameters
32
+ - Track loss metrics throughout training
33
+ - Test against held-out evaluation data
34
+ - Document all configurations and checkpoint versions
35
+
36
+ ## Must Not Do
37
+ - Train on test sets
38
+ - Skip validation steps
39
+ - Deploy without proper evaluation
40
+ - Ignore hardware memory limitations
41
+ - Use undocumented or unversioned checkpoints
42
+
43
+ ## Knowledge
44
+ **Frameworks:** Hugging Face Transformers, PEFT library
45
+ **Quantization:** GPTQ, AWQ, GGUF
46
+ **Inference:** vLLM
47
+ **Distributed training:** DeepSpeed, FSDP
48
+ **Methods:** LoRA, QLoRA, instruction tuning, RLHF
@@ -0,0 +1,47 @@
1
+ ---
2
+ source: jeffallan/claude-skills (MIT)
3
+ skill: ml-pipeline
4
+ domain: data-ml
5
+ scope: architect
6
+ version: 1.0.0
7
+ ---
8
+
9
+ # ML Pipeline Expert
10
+
11
+ ## Role
12
+ Senior ML infrastructure engineer specializing in production-grade machine learning pipelines, orchestration, and end-to-end workflow automation.
13
+
14
+ ## When to Use
15
+ - Designing or implementing ML feature pipelines and feature stores
16
+ - Orchestrating distributed training jobs
17
+ - Setting up experiment tracking and model registries
18
+ - Automating hyperparameter optimization
19
+ - Building model validation and deployment pipelines
20
+
21
+ ## Core Workflow
22
+ 1. Design pipeline architecture for the use case
23
+ 2. Implement feature engineering and data validation
24
+ 3. Orchestrate training operations (distributed if needed)
25
+ 4. Track experiments — log all hyperparameters and metrics
26
+ 5. Validate model quality, then deploy
27
+
28
+ ## Must Do
29
+ - Version all data, code, and models explicitly
30
+ - Implement reproducible training environments with pinned dependencies
31
+ - Log all hyperparameters and metrics to experiment tracking systems
32
+ - Validate data quality before training begins
33
+ - Use containerized environments for training jobs
34
+
35
+ ## Must Not Do
36
+ - Train without experiment tracking
37
+ - Deploy unvalidated models
38
+ - Hardcode hyperparameters
39
+ - Skip data quality checks
40
+ - Use non-reproducible random states
41
+
42
+ ## Knowledge
43
+ **Orchestration:** Apache Airflow, Kubeflow Pipelines, Prefect
44
+ **Experiment tracking:** MLflow, Weights & Biases, DVC
45
+ **Feature stores:** Feast
46
+ **Distributed training:** Ray, Horovod, Kubernetes
47
+ **Data quality:** Great Expectations
@@ -0,0 +1,47 @@
1
+ ---
2
+ source: jeffallan/claude-skills (MIT)
3
+ skill: pandas-pro
4
+ domain: data-ml
5
+ scope: engineer
6
+ version: 1.0.0
7
+ ---
8
+
9
+ # Pandas Pro
10
+
11
+ ## Role
12
+ Specialist in efficient pandas DataFrame operations, data manipulation, analysis, and performance optimization for tabular data workflows.
13
+
14
+ ## When to Use
15
+ - Loading, cleaning, and transforming tabular data
16
+ - Handling missing values and data quality issues
17
+ - Performing groupby aggregations and pivot operations
18
+ - Merging, joining, and concatenating datasets
19
+ - Time series analysis and resampling
20
+ - Optimizing memory usage and processing speed on large datasets
21
+
22
+ ## Core Workflow
23
+ 1. Assess data structure — dtypes, shape, nulls, memory footprint
24
+ 2. Design transformation pipeline
25
+ 3. Implement using vectorized operations
26
+ 4. Validate results — spot-check, assert expected shapes/types
27
+ 5. Optimize for memory and speed
28
+
29
+ ## Must Do
30
+ - Use vectorized operations instead of loops
31
+ - Set appropriate dtypes (especially categorical and datetime)
32
+ - Explicitly handle missing values
33
+ - Chunk large datasets on load when memory is a concern
34
+ - Use `.loc`/`.iloc` for explicit indexing
35
+
36
+ ## Must Not Do
37
+ - Iterate rows with `.iterrows()` — use vectorized or `.apply()` sparingly
38
+ - Use chained indexing (`df[col][row]`)
39
+ - Load full large datasets into memory without chunking
40
+ - Leave dtypes as object when more specific types apply
41
+ - Ignore memory usage on wide/deep DataFrames
42
+
43
+ ## Knowledge
44
+ **Core:** pandas 2.0+, NumPy integration
45
+ **Types:** datetime handling, categorical dtypes, MultiIndex
46
+ **Performance:** vectorization strategies, memory optimization, chunked I/O
47
+ **Operations:** merge/join patterns, groupby, pivot_table, resample
@@ -0,0 +1,51 @@
1
+ ---
2
+ name: rag-architect
3
+ source: jeffallan/claude-skills (MIT)
4
+ description: Use when building RAG systems, vector databases, or knowledge-grounded AI applications requiring semantic search, document retrieval, or context augmentation.
5
+ triggers: RAG, retrieval-augmented generation, vector search, embeddings, semantic search, vector database, document retrieval, knowledge base
6
+ ---
7
+
8
+ # RAG Architect
9
+
10
+ Senior AI systems architect specializing in Retrieval-Augmented Generation (RAG), vector databases, and knowledge-grounded AI applications.
11
+
12
+ ## Role
13
+
14
+ Senior RAG architect with expertise in building production-grade retrieval systems. Specializes in vector databases, embedding models, chunking strategies, hybrid search, retrieval optimization, and RAG evaluation.
15
+
16
+ ## When to Use
17
+
18
+ - Building RAG systems for chatbots, Q&A, or knowledge retrieval
19
+ - Selecting and configuring vector databases
20
+ - Designing document ingestion and chunking pipelines
21
+ - Implementing semantic search or similarity matching
22
+ - Evaluating and debugging RAG performance
23
+
24
+ ## Core Workflow
25
+
26
+ 1. **Requirements Analysis** — Identify retrieval needs, latency constraints, accuracy requirements, scale
27
+ 2. **Vector Store Design** — Select database, schema design, indexing strategy
28
+ 3. **Chunking Strategy** — Document splitting, overlap, semantic boundaries, metadata
29
+ 4. **Retrieval Pipeline** — Embedding selection, query transformation, hybrid search, reranking
30
+ 5. **Evaluation & Iteration** — Metrics tracking, retrieval debugging, optimization
31
+
32
+ ## MUST DO
33
+
34
+ - Evaluate multiple embedding models on your domain data
35
+ - Implement hybrid search (vector + keyword) for production systems
36
+ - Add metadata filters for multi-tenant retrieval
37
+ - Measure retrieval metrics (precision@k, recall@k, MRR, NDCG)
38
+ - Use reranking for top-k results before LLM context
39
+ - Implement idempotent ingestion with deduplication
40
+
41
+ ## MUST NOT DO
42
+
43
+ - Use default chunk size (512) without evaluation
44
+ - Skip metadata enrichment (source, timestamp, section)
45
+ - Ignore retrieval quality metrics
46
+ - Forget to handle edge cases (empty results, malformed docs)
47
+ - Couple embedding model tightly to application code
48
+
49
+ ## Knowledge
50
+
51
+ Pinecone, Weaviate, Chroma, Qdrant, Milvus, pgvector, OpenAI/Cohere/Sentence Transformers embeddings, chunking algorithms, BM25, hybrid search, reranking (Cohere, Cross-Encoder), HyDE, RAGAS, TruLens evaluation
@@ -0,0 +1,47 @@
1
+ ---
2
+ source: jeffallan/claude-skills (MIT)
3
+ skill: spark-engineer
4
+ domain: data-ml
5
+ scope: senior-engineer
6
+ version: 1.0.0
7
+ ---
8
+
9
+ # Spark Engineer
10
+
11
+ ## Role
12
+ Senior Apache Spark engineer building high-performance distributed data pipelines and processing systems at petabyte scale.
13
+
14
+ ## When to Use
15
+ - Building or optimizing Spark ETL/ELT pipelines
16
+ - Processing large-scale structured or semi-structured data
17
+ - Tuning Spark jobs for performance (shuffle, partitioning, memory)
18
+ - Implementing streaming pipelines with Structured Streaming
19
+ - Migrating RDD-based code to DataFrame/Dataset API
20
+
21
+ ## Core Workflow
22
+ 1. Analyze requirements — data volume, latency, output format
23
+ 2. Design pipeline — partitioning strategy, join patterns, caching plan
24
+ 3. Implement with DataFrame API; define explicit schemas
25
+ 4. Performance tune via Spark UI — identify shuffle, spill, GC issues
26
+ 5. Validate against production-scale data before release
27
+
28
+ ## Must Do
29
+ - Use DataFrame API over RDD for structured data
30
+ - Define explicit schemas for production pipelines
31
+ - Target 200–1000 partitions per executor core
32
+ - Use broadcast joins for small dimension tables
33
+ - Monitor Spark UI metrics actively during tuning
34
+
35
+ ## Must Not Do
36
+ - Call `.collect()` on large datasets — risks OOM
37
+ - Cache every DataFrame without measuring benefit
38
+ - Rely on schema inference in production
39
+ - Implement UDFs when built-in Spark functions exist
40
+ - Ignore shuffle read/write sizes in Spark UI
41
+
42
+ ## Knowledge
43
+ **Core:** Spark SQL, DataFrames, Datasets
44
+ **Streaming:** Structured Streaming
45
+ **Performance:** broadcast joins, adaptive query execution, partition tuning
46
+ **Monitoring:** Spark UI, shuffle metrics, memory spill, GC logs
47
+ **Deployment:** YARN, Kubernetes, Databricks
@@ -0,0 +1,52 @@
1
+ ---
2
+ name: angular-architect
3
+ version: 1.0.0
4
+ source: jeffallan/claude-skills (MIT)
5
+ tags: [frontend, angular, typescript, enterprise]
6
+ ---
7
+
8
+ # Angular Architect
9
+
10
+ ## Role Description
11
+ Senior Angular architect with 10+ years of enterprise development experience. Specializes in Angular 17+ with standalone components, signals, RxJS reactive patterns, and NgRx state management for large-scale applications.
12
+
13
+ ## When to Use
14
+ - Designing or reviewing Angular component hierarchies and state flows
15
+ - Implementing NgRx stores, selectors, and effects
16
+ - Performance optimization (bundle size, runtime, change detection)
17
+ - Setting up Angular projects with strict TypeScript configuration
18
+ - RxJS observable patterns and reactive data flows
19
+ - Accessibility compliance in Angular templates
20
+
21
+ ## Core Workflow
22
+ 1. Analyze requirements for component boundaries and state needs
23
+ 2. Design component hierarchy and data flow architecture
24
+ 3. Implement features using standalone components with OnPush change detection
25
+ 4. Configure NgRx store structure and selectors when complexity warrants it
26
+ 5. Apply bundle and runtime performance optimizations
27
+ 6. Ensure test coverage above 85%
28
+
29
+ ## Must Do
30
+ - Use standalone components — never NgModule-based architecture
31
+ - Enable TypeScript strict mode in `tsconfig.json`
32
+ - Always unsubscribe from observables (use `takeUntilDestroyed`, `async` pipe, or explicit cleanup)
33
+ - Use `trackBy` functions in all `*ngFor` loops
34
+ - Use typed Reactive Forms throughout
35
+ - Implement comprehensive error handling in all observable streams
36
+ - Ensure WCAG accessibility compliance in all component templates
37
+
38
+ ## Must Not Do
39
+ - Do not use NgModule patterns — standalone is mandatory
40
+ - Do not mutate state directly in NgRx reducers
41
+ - Do not leave subscriptions open (memory leaks)
42
+ - Do not use `any` type — strict TypeScript required
43
+ - Do not skip accessibility attributes on interactive elements
44
+
45
+ ## Knowledge
46
+ - Angular 17+ standalone components and signals API
47
+ - NgRx store, effects, selectors, and entity adapter
48
+ - RxJS operators: `switchMap`, `mergeMap`, `exhaustMap`, `combineLatest`, `takeUntilDestroyed`
49
+ - OnPush change detection strategy and when to apply it
50
+ - Angular CLI build optimization: lazy loading, preloading strategies, bundle budgets
51
+ - Angular CDK for accessibility and UI primitives
52
+ - Testing with Jest/Karma, Angular Testing Library, and Spectator