tech-details
Database schema (users, messages, photos tables), environment variables, ImageKit storage structure, authentication flow, and service integrations. Use when working on database operations, API logic, authentication, or infrastructure.
Database schema (users, messages, photos tables), environment variables, ImageKit storage structure, authentication flow, and service integrations. Use when working on database operations, API logic, authentication, or infrastructure.
楽観的更新(Optimistic Updates)パターンの実装スキル。サーバーレスポンス前にUIを即座更新し、失敗時のロールバック機構を提供することで、レスポンシブなユーザー体験を実現します。 Anchors: • Designing Data-Intensive Applications (Martin Kleppmann) / 適用: 分散システムにおける楽観的並行制御 / 目的: 競合検出とロールバック戦略の設計 • React Query (TanStack) / 適用: onMutate/onError/onSettledフック / 目的: 楽観的更新とロールバックの自動化 • SWR Documentation (Vercel) / 適用: optimisticDataとrollbackOnError / 目的: 宣言的な楽観的更新の実装 Trigger: Use when implementing instant UI feedback before server response, hiding CRUD latency, implementing optimistic updates with React Query/SWR, designing rollback strategies, or handling conflict states. optimistic update, UI feedback, rollback, React Query, SWR, mutation, conflict resolution
機能フラグ(Feature Flag/Feature Toggle)による段階的リリースとA/Bテスト実装スキル。 リスク管理とカナリアリリースを可能にし、本番環境での安全な機能展開を実現します。 Anchors: • Feature Toggles (Pete Hodgson - Martin Fowler blog) / 適用: フラグ設計パターン / 目的: Release/Experiment/Ops/Permission Togglesの適切な使い分け • Continuous Delivery (Jez Humble) / 適用: デプロイ戦略 / 目的: デプロイと機能リリースの分離による安全性向上 Trigger: Use when implementing feature flags, feature toggles, A/B testing, gradual rollouts, canary releases, or managing feature lifecycles. feature flag, feature toggle, A/B testing, canary release, gradual rollout, dark launch, percentage rollout, kill switch
MCPサーバー設計パターンとアーキテクチャベストプラクティス。ツール組織化、エラーハンドリング、状態管理、サーバーライフサイクル管理の実証済みパターンを提供。 Anchors: • Clean Architecture / 適用: サーバー構造と依存関係管理 / 目的: テスト可能で保守性の高いコード • Domain-Driven Design / 適用: ツールドメインモデリングと境界付きコンテキスト / 目的: 機能別ツール組織化 • Pragmatic Programmer / 適用: エラーハンドリングと回復性パターン / 目的: 堅牢なサーバー構築 Trigger: Use when designing MCP server architecture, organizing tool definitions, implementing error handling patterns, managing server state, structuring MCP server projects, or refactoring existing MCP servers.
Explains the 'Context Bridge' pattern where Middleware resolves the tenant (domain/store), stores it in the Request object, and an Interceptor unifies it with user authentication into AsyncLocalStorage.
Expert Django and Celery guidance for asynchronous task processing. Use when designing background tasks, configuring workers, handling retries and errors, optimizing task performance, implementing periodic tasks, or setting up production monitoring. Follows Celery best practices with Django integration patterns.
GoFの行動パターンを用いて、オブジェクト間の責務分散と通信設計を支援するスキル。 パターン選定、実装方針、検証手順を体系化する。 Anchors: • Design Patterns / 適用: 行動パターンの設計理論 / 目的: 相互作用の整理 • Command Pattern / 適用: 操作の実行・取り消し / 目的: 実行制御の柔軟化 • Strategy Pattern / 適用: アルゴリズム切替 / 目的: 変更容易性の確保 Trigger: Use when designing flexible object collaboration, selecting behavioral patterns, or validating pattern usage in implementations. behavioral design patterns, strategy, command, observer, state, template method
Specialist skill for agent templates and design patterns. Provides 4 types of agent templates (Analysis, Implementation, Orchestrator, Deploy), {{variable}} format abstraction, abstraction balance, and conceptual element design principles. Anchors: • The Pragmatic Programmer (Andrew Hunt, David Thomas) / 適用: テンプレート設計 / 目的: 手順設計と実践的改善の原則 Trigger: Use when creating new agent templates, generalizing existing agents into reusable patterns, designing standard templates for agent mass production, implementing {{variable}} format abstraction, or optimizing conceptual element design and abstraction balance. agent template, template design, orchestrator pattern, variable abstraction, template standardization
クリーンアーキテクチャを採用しているプロジェクト向けの設計・レビュー支援。4層構造(ドメイン層、 ユースケース層、インターフェースアダプタ層、インフラストラクチャ層)に基づく。特にインフラ層は 横断的関心事(ロギング、設定管理)のみ、永続化やRPCはインターフェースアダプタ層に配置すべき という原則を適用する。トリガー:「クリーンアーキテクチャで」「クリーンアーキテクチャに従って」 「クリーンアーキテクチャのレビュー」など、クリーンアーキテクチャを明示的に指定した場合のみ起動。 一般的な「設計レビュー」「アーキテクチャ相談」では起動しない。
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes - four-phase framework (root cause investigation, pattern analysis, hypothesis testing, implementation) that ensures understanding before attempting solutions
オープン・クローズド原則(OCP)の専門スキル。 拡張に対して開き、修正に対して閉じた設計を提供します。 Anchors: • 『Clean Architecture』(Robert C. Martin) / 適用: SOLID原則 / 目的: 保守性向上 • 『アジャイルソフトウェア開発の奥義』(Robert C. Martin) / 適用: 設計パターン / 目的: 拡張性確保 Trigger: OCP適用時、拡張可能設計時、SOLID原則実装時に使用
ドメインモデル中心の開発手順ガイド。テストファーストでドメインモデルを設計・実装し、 インメモリリポジトリ→ユースケース→インフラの順で開発を進める手法を解説。 トリガー:「ドメインモデルから始めたい」「TDDでDDD」「インメモリリポジトリの作り方」 「ユースケースのテスト方法」「DDD開発の進め方」等の開発プロセス関連リクエストで起動。
Build FastAPI applications using Clean Architecture principles with proper layer separation (Domain, Infrastructure, API), dependency injection, repository pattern, and comprehensive testing. Use this skill when designing or implementing Python backend services that require maintainability, testability, and scalability.
イベント駆動アーキテクチャの設計・実装スキル。メッセージングパターン、Event Sourcing、CQRS、Sagaを活用し、 スケーラブルで疎結合なシステムを構築する。 Anchors: • Enterprise Integration Patterns (Gregor Hohpe) / 適用: メッセージングパターン / 目的: 疎結合な統合設計 • Designing Event-Driven Systems (Ben Stopford) / 適用: EDAアーキテクチャ / 目的: スケーラブルな非同期処理 • Domain-Driven Design (Eric Evans) / 適用: ドメインイベント / 目的: ビジネスイベントの表現 Trigger: Use when designing event-driven systems, implementing event sourcing, CQRS, message brokers, saga patterns, or asynchronous service integration. event-driven, messaging, pub/sub, event sourcing, cqrs, saga, kafka, rabbitmq, async
Data architecture - models, relationships. Use when designing data structures.
GoFのFactory系パターン(Factory Method、Abstract Factory、Builder等)の設計・実装を支援するスキル。 Erich Gammaの『Design Patterns』に基づき、オブジェクト生成の柔軟性と拡張性を実現する戦略を提供します。 Anchors: • Design Patterns / 適用: 全Factory系パターン共通の基本原則 / 目的: Gang of Fourの標準的設計思想に準拠 • Factory Method / 適用: サブクラスによるオブジェクト生成 / 目的: 生成ロジックをサブクラスへ委譲 • Abstract Factory / 適用: 関連オブジェクトの族単位の生成 / 目的: プロダクトファミリ間の一貫性確保 • Builder / 適用: 複雑なオブジェクトの段階的構築 / 目的: 構築ロジックと表現の分離 Trigger: 以下の場合に使用してください:オブジェクト生成ロジックが複雑化している時、複数のオブジェクト族を扱う時、 生成戦略を動的に切り替える必要がある時、フレームワークやライブラリのファクトリパターン実装が必要な時。
アーキテクチャパターン(Hexagonal、Onion、Vertical Sliceなど)の選定・比較・適用と、依存関係の準拠評価を支援するスキル。 境界設計、レイヤー責務、移行計画を整理し、設計判断の根拠と実装の一貫性を保ちます。 Anchors: • Patterns of Enterprise Application Architecture / 適用: パターン比較と選定 / 目的: トレードオフを整理する • Domain-Driven Design / 適用: ドメイン中心設計 / 目的: 境界と責務の明確化 • Clean Architecture / 適用: 依存関係ルール / 目的: レイヤーの一方向性を維持 Trigger: Use when selecting architecture patterns, designing system boundaries, comparing Hexagonal/Onion/Vertical Slice approaches, or evaluating dependency compliance in a codebase.
AIWorkflowOrchestratorプロジェクトの仕様管理スキル。 仕様書を検索・参照するためのインターフェース。 references/配下に全仕様を格納し、キーワード検索で必要な情報に素早くアクセス。 Anchors: • Specification-Driven Development / 適用: 仕様書正本 / 目的: 実装との一貫性 • Progressive Disclosure / 適用: 検索→詳細参照 / 目的: コンテキスト効率化 • MECE原則 / 適用: トピック分類 / 目的: 漏れなく重複なく Trigger: プロジェクト仕様の検索、アーキテクチャ確認、API設計参照、セキュリティ要件確認、テスト戦略参照を行う場合に使用。 仕様, 要件, アーキテクチャ, API, データベース, セキュリティ, UI/UX, デプロイ, Claude Code, テスト, MSW, カバレッジ
React and Next.js implementation patterns for performance and maintainability. Use when building frontend components, pages, and applications with React ecosystem.
一貫性と拡張性を両立するデザインシステムの基盤設計を支援するスキル。 デザイントークン、コンポーネント規約、Figma/コード同期を体系化する。 Anchors: • Atomic Design / 適用: コンポーネント階層設計 / 目的: 構造の一貫性確保 • Design Tokens / 適用: トークン管理 / 目的: 再利用性の向上 • Clean Architecture / 適用: 依存関係設計 / 目的: 責務分離 Trigger: Use when designing a design system, defining design tokens, or establishing component and Figma-code synchronization rules. design system architecture, design tokens, figma sync, component guidelines