ahtserhsuddav/project-setup

Project setup

各ステップは、対象ツールの公式 CLI またはドキュメント（スキル official-docs）を使用します。リモート操作を行う前には必ず確認を取ってください。

作成直後（CLI がすでにスキャフォールディング、インストール、チェックをすべて完了している場合）

1. PROJECT.md を読み、What（名前、ドメイン、タイプ、目的）を人間の言葉で埋めます。 {{#dotenv}}
2. 人間が .env.example を .env にコピーして内容を埋めます{{#auth}}（{{dlx}} auth@latest secret で認証シークレットを生成）{{/auth}}。 エージェントは決して .env を作成・読み取り・書き込みしません。.env が存在するまでは、そのコマンドにだけ使い捨てのテスト値を設定してテストします。 {{/dotenv}} {{#postgres}}
3. ローカルデータベース：docker compose up -d を実行し、次に {{run}} db:migrate を実行します（事前に確認）。 {{/postgres}} {{#d1}}
4. ローカルデータベース：{{run}} db:migrate を実行します（事前に確認）。 {{/d1}}
5. {{run}} docs:sync を実行し、docs/DEPLOYMENT.md を埋めます（URL、シークレットの設定場所）。 {{#cloudflare}} リソースが作成されたら（DEPLOYMENT.md → First-time setup）、wrangler.jsonc のプレースホルダーIDを置き換えます。 {{/cloudflare}}
6. design/DESIGN.md は website-design スキルに任せます。このスキルは最初のページの前にデザイン入力を順に収集します。ホームページはプレースホルダーです。
7. リポジトリが GitHub に上がったら、人間が Settings → Actions → General → "Allow GitHub Actions to create and approve pull requests" を有効にします。これにより、週次のエージェントスキル更新がプルリクエストを開けるようになります。Dependabot とワークフローの変更については、スキル dependabot と github-actions-hardening を参照してください。
8. {{run}} log "Project set up" --by <agent> を実行します。

既存プロジェクト（キットの導入）

1. {{dlx}} create-agent-ready-app@latest install . を実行すると、エージェント設定（AGENTS.md、スキル、スクリプト、ガードレール）のみが追加されます。package.json からアドオンを検出します。古い AGENTS.md、CLAUDE.md、.cursorrules などのファイルは docs/legacy-agents.md に移動されます。まだ有効なルールは PROJECT.md → Rules for agents にまとめ、その後そのファイルを削除します（事前に確認）。
2. 存在する情報（package.json、ルート、簡単なフォルダ一覧）から PROJECT.md を埋めます。深く探索しないでください。
3. 再構築は行いません。ギャップ（構造、チェック、SEO、セキュリティ）を 1 つの大きなタスクとして提案し、確認を取ります。

後からアドオンを追加（ガード付き）

1. 1 つの yes/no 質問をします：アドオン、追加するパッケージ、作成されるファイルについて。
2. {{dlx}} create-agent-ready-app@latest add <add-on> . を実行すると、まだ存在しないアドオンファイルが作成され、AGENTS.md とスキルが更新され、スキルパックがインストールされ、追加するパッケージが表示されます。
3. それらのパッケージを {{add}} します。次に、プロジェクトがすでに所有しているファイルにアドオンを配線します。create-agent-ready-app リポジトリ内のアドオンファイル（template/frameworks/）と公式ドキュメントに従います：
   • query: {{#tanstack-start}}src/router.tsx（QueryClient + SSR 統合）と src/routes/__root.tsx（devtools パネル）{{/tanstack-start}}{{#next}}src/shared/lib/tanstack/query-provider.tsx を src/app/layout.tsx で{{/next}}；
   • shadcn: {{dlx}} shadcn@latest apply --preset nova を実行し、次に必要なコンポーネントを add します；
   • auth: {{#tanstack-start}}src/routes/_private/{{/tanstack-start}}{{#next}}src/app/(private)/{{/next}} 以下のガードと {{run}} auth:generate、次に {{run}} db:generate を実行します。
4. {{run}} docs:sync、{{run}} check を実行し、PROJECT.md → Stack and Decisions を更新し、ログ行を追加します。

アドオンの削除（ガード付き）

{{dlx}} create-agent-ready-app@latest remove <add-on> . を実行すると、キットのファイル、スキル、スクリプト、権限が削除されます。 コードとパッケージの削除は大きなタスクです：rg ですべての使用箇所を検索し、削除してから {{run}} check を実行します。

エージェントスキル

• .agents/skills/ 内のコミュニティスキルは、その作成者から提供されたものです（skills-lock.json に各ソースとハッシュが記録されています）。{{run}} skills:update で更新します。他のコード変更と同様、コミット前に差分を確認してください。
• その他のスキル：ツールの作成者が提供する公式スキル（https://www.skills.sh/official）を推奨します。スキル find-skills、または {{dlx}} skills@latest add <owner/repo> --skill <name> -a universal -a claude-code（事前に確認）を使用します。オプションのキットパック：{{dlx}} create-agent-ready-app@latest add <pack> .（マーケティング、セキュリティレビューなど）。

キットの更新

{{run}} kit:update を実行すると、AGENTS.md、スキル、スクリプトが更新されます。このプロジェクトで変更されたキットファイルは保持され、報告されます。プロジェクト固有のルールは、キットファイルを編集する代わりに PROJECT.md に記述してください。