Skip to content

Commit 3d0bc10

Browse files
committed
docs: clarify migration prompt as planning template and add agentic coding context to ADR-003
migration-prompt.ja.md was written as if the agent should execute it directly, but each derived project has unique schemas, extensions, and data volumes. Reframe the purpose section to position the document as a planning template: analyze first (Phase 1), then produce a project-specific plan, then execute. ADR-003 context was missing the primary motivation for choosing fast tooling — the kit recommends running lint + format on every file write as a post-write hook for AI coding agents (README "Agentic coding"), which requires sub-second execution.
1 parent 568dba0 commit 3d0bc10

2 files changed

Lines changed: 9 additions & 3 deletions

File tree

.serverless-full-stack-webapp-starter-kit/docs/v3.0.0/adr-003-oxlint-oxfmt.ja.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,9 @@
66

77
## コンテキスト
88

9-
キットにはコーディング時に DSQL 非互換パターンを検出するリントルールが必要 — 具体的には `drizzle-orm/pg-core` からの `serial`, `json`, `jsonb` import をブロックする `no-restricted-imports`。リンター速度は開発者体験と CI 時間に影響し、モノレポの成長に伴い重要性が増す。
9+
キットにはコーディング時に DSQL 非互換パターンを検出するリントルールが必要 — 具体的には `drizzle-orm/pg-core` からの `serial`, `json`, `jsonb` import をブロックする `no-restricted-imports`
10+
11+
また、キットは AI コーディングエージェントとの併用を前提としており、ファイル書き込みごとに lint + format を実行する post-write hook を推奨している(README「Agentic coding」セクション参照)。このワークフローでは、リンターとフォーマッターが体感できない速度で完了することが必須条件となる。
1012

1113
## 決定
1214

.serverless-full-stack-webapp-starter-kit/docs/v3.0.0/migration-prompt.ja.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,13 @@
22

33
## 目的
44

5-
あなたは Serverless Full Stack WebApp Starter Kit の v2 から v3 へユーザーのアプリケーションを移行するソフトウェアエンジニアです。このドキュメントが移行計画の全体像です — 開始前に全体を読み、各フェーズを順番に実行してください
5+
このドキュメントは v2 から v3 への移行計画を立案するための下地(テンプレート)である。各派生プロジェクトはユーザー固有のスキーマ、独自拡張、データ量を持つため、このドキュメントをそのまま実行するのではなく、Phase 1 の事前評価結果を踏まえてプロジェクト固有の移行計画を作成すること
66

7-
ユーザーは v2 ベースのアプリケーション(キットをコピーして構築した独自コード)と、本番データを持つ稼働中の Aurora Serverless v2 データベースを持っています。あなたの仕事は、各フェーズのチェックポイントでデータ安全性を確認しながら、コードベースとデータを移行することです。
7+
計画立案の流れ:
8+
1. このドキュメント全体を読み、フェーズ構成と行動規約を把握する
9+
2. Phase 1(バックアップと事前評価)を実行し、ユーザーのスキーマ・データ・独自拡張を分析する
10+
3. 分析結果に基づき、各フェーズの具体的なタスクとチェックポイントをプロジェクト固有の計画として文書化する
11+
4. 計画に従って各フェーズを順番に実行する
812

913
## 前提条件
1014

0 commit comments

Comments
 (0)