v3 ロードマップ

[konokenj]

目的

AI駆動開発に適したテンプレートとして使いやすい構成にアップグレードします。

前提

• 本リポジトリはスターターキットであり、ユーザーは forkでなくcopy して自分のアプリとして育てていくことを想定しています。このためアップストリームの破壊的変更が既存ユーザーに与える影響は軽微です
• 時代のニーズに合わせて背景技術を変更していくことを想定します
• Conventional Commitsを導入します。ただし上記背景により、カジュアルにメジャーバージョンを上げる予定です

変更しない点

• Lambda Web Adapter + Next.js
• Lambda Function URL + CloudFront
• AppSync Events
• CDK

変更点

アーキテクチャ変更

• Aurora Serverless v2 → DSQL
• VPCレス化
• Prisma v6 → Drizzle ORM

リポジトリ管理と開発体験

• Semantic Versioning
• PNPM workspaces によるモノレポ化。ジョブと共通モジュールを独立させる。構成例:

+-- apps/
|   +-- cdk/
|   +-- webapp/
|   +-- async-job/
|   `-- migration-runner/
`-- packages/
    +-- db/
    `-- shared-types/

• 最小限のAGENTS.md
• Agent Hooksで利用可能な軽量なlinter, formatter
• メンテナンスポリシーの記述

[konokenj]

提案1: NodejsFunction

軽量な処理を書く例として、またesbuildの認知負荷を軽減するためにasync-jobをNodejsFunction化してもよいかも。現状では prisma generate を行う都合上Dockerのマルチステージビルドを使っているが、Drizzleに移行すれば現実的になりそう

提案2: DSQL Migrator の CDK Construct 公開

Drizzle ORM + 独自のmigratorを作成する場合、CDKデプロイプロセス内でマイグレーションを行う構成はCDK Constructとして再利用可能にできるかもしれません。要検証。

v2時点ですぐやること

• CDKでのスタック全体へのタグ付け cdk.Tags.of(app).add('Application', 'ServerlessWebappStarterKit');
• Lambdaのデフォルトメモリサイズ増加
• useEventBus の再接続: AppSync Events の WebSocket 接続が切断された場合、自動再接続されない

要検証

• 認証処理の改善
  • getSession の React cache 対応
  • middleware でのAPI Route保護の統一

[konokenj]

#66 こちらも検討

[tmokmss]

単体テスト周りのひな型も整備されてると良い

[konokenj]

提案3: Starter Kit 自体の固有アセット分離とマイグレーションガイド

ユーザーがStarter Kit由来で自分のアプリに影響しないファイルを簡単に識別して削除できるようにするために .serverless-full-stack-webapp-starter-kit/ ディレクトリを作成して、以下を格納する

• .upstream-version ... Starter Kitのバージョン追跡
• docs/GETTING_STARTED.md ... Starter Kitの利用方法詳細
• docs/imgs ... ルートのimgsを移動
• docs/migration/v3.0.0/migration-prompt.md ... 既存アプリをマイグレーションするための簡易なプロンプト。
• docs/migration/v3.0.0/adr-xxx.md ... ADR
• docs/migration/migration-meta.md ... migration-prompt.md を生成させるためのメタプロンプト。メンテナ用

GETTING_STARTED.md

README.mdから分離するかどうかは分量次第。いくつか固有の手順があるため:

• forkではなくclone
• cdk.context.json を .gitignore から削除してトラック
• prisma db push から prisma migrate への変更
• release-please, CODE_OF_CONDUCTなどのリポジトリルートにあるファイルの位置づけの明記 (削除可能かどうかなど)
• .serverless-full-stack-webapp-starter-kit/.upstream-version へのhash or tag保存

マイグレーションの位置づけ

本リポジトリはスターターキットであり、ユーザーは forkでなくcopy して自分のアプリとして育てていくことを想定しています。

この前提で基本的にマイグレーションは正式サポートしないが、ユーザーがコピーした自分のアプリに任意のアップデートを取り込めるように、 参考情報として migration-prompt を提供する。マイグレーションはコーディングエージェントに任せる想定。Starter Kit提供のプロンプトを使用してユーザーが自分のアプリ用のマイグレーション計画を生成するためのもの。

[konokenj]

GitHubのテンプレートリポジトリ機能がこのユースケースに合っているか確認する https://docs.github.com/ja/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template