backend-patterns

バックエンドのパターン

バックエンド／データ処理に広く適用できるベストプラクティスです。以下のパターンをすべて読んでください。これから作成するものに当てはまるものがあれば、適用してください。 ここに明文化されている内容について許可を求める必要はありません。ルールに従い、その旨を一行で伝えてください。

このスキルを参照するタイミング

次のいずれかに該当するコードを作成または編集するときは、いつでも参照してください。

• URL／リンクをデータベースに保存、挿入、または永続化する
• ユーザー、エージェント、Webhook、インポート、または貼り付け処理からリンクを受け取る
• リンクを別のシステムに転送する
• ナレッジを保管するあらゆる場所（例：カンバン、タスクコンソール、ナレッジベース、ブックマーク、メモ）にリンクを追加する
• リンクを含むレコードを作成するエージェントツールを構築する
• データベースに対してクエリまたは書き込みを行う（読み取り、挿入、更新、削除）
• データベーススキーマを変更する、またはマイグレーション／生成／プッシュのコマンドを実行する

以下のパターンがどれも状況に当てはまらない場合は、コメントせず元のタスクに戻ってください。

パターン

• ソーシャルメディアのリンクを保存するときは、必ず自動アーカイバーを経由させてください（このミニアプリは今後追加される予定です）。
  • 自動アーカイバーがまだコードベースに存在しない場合、生のリンクをそのまま黙って保存してはいけません。すべてのリンク書き込みを、明確にマークした TODO: route through auto-archiver once available を含む単一のヘルパー（例：saveLink(url, context)）に集約してください。これにより、今後の接続作業を一か所の変更で済ませられます。
• データベース操作ではORMを優先し、可能な限り生のSQLを避けてください。ORMで表現できないなど、本当に必要な場合に限り生のSQLを使用し、その理由を一行で説明してください。
• 変更処理やフォーム処理では、APIルートよりサーバーアクションを優先してください。本当に必要な場合（例：Webhookの受信、公開のHTTPエンドポイントやサードパーティ向けHTTPエンドポイント、REST／JSONのインターフェースが必要なフォーム以外のクライアント）に限り、APIルートを使用してください。ガイダンスについては next-best-practices スキルを参照してください。
• ユーザーからの明示的な確認なしに、接続先データベースへスキーマ変更を適用してはいけません。スキーマのソースファイル（例：Prisma／Drizzleスキーマ）の編集は問題ありませんが、接続先DBのスキーマを変更する操作（pnpm db:generate、pnpm db:migrate、pnpm db:push、またはスキーマを直接変更するSQL）を実行する前に、停止してユーザーに確認してください。このスキルで、実行するのではなく事前に確認を求める必要があるのはここだけです。

このスキルが適用される場合の動作

1. 該当するパターンを特定します。
2. 適用します。パターンが適合しない具体的な理由がない限り、代替案を提案しないでください。
3. 必要に応じて上書きできるよう、どのパターンを適用したかを短い一行でユーザーに伝えます。
4. パターンが必要とするインフラ（例：アーカイバー自体）が存在しない場合は、そのことを明示し、代わりに何をしたかを説明します。

今後のパターン

このスキルは今後拡充されます。新しいパターンは、エージェントが機械的に適用できるルールとして、上記のパターンセクションに箇条書きで追加してください。