はじめかた

このセクションは、Astar Management のリポジトリに初めて触るところから、最初の変更を main に ship するところまでを一直線に案内します。3 ページで完結します。

全体の流れ

1. リポジトリ取得 + 環境構築
   git clone → bun / JDK 25 / Go / Docker を用意
        │
        ▼
2. 開発ループに入る
   /wt start <name> → worktree 作成（DB・ポートは自動割当）
   /wt serve <name>  → backend + frontend 起動
        │
        ▼
3. 実装する
   コード変更は worktree の中だけで行う
        │
        ▼
4. 検証する（L1〜L4）
   静的チェック → unit test → 見た目 → 結合
        │
        ▼
5. ship する
   /wt ship <name> → 検証 → main へ merge → worktree 片付け

このループは 1 回で終わりません。同じ手順を、変更のたびに何度も回します。慣れれば 2〜5 は数分で一周します。

このセクションの構成

• リポジトリ取得と環境構築 — git clone の後に何を入れるか。前提ツールのバージョンと、docker-compose.selfhost.yml が日々の開発では使わない理由。
• 日々の開発ループ — /wt worktree オーケストレーターと dev-lifecycle skill。このセクションで最も重要なページです。
• 検証の 4 層 — L1（静的）〜L4（結合）の検証ピラミッドと、backend テストの唯一の実行経路。

読む前提

このセクションは「手を動かして環境を作る」ことにフォーカスしています。Astar が何のプロダクトで、どういう戦略で作られているかは扱いません。それは Welcome と アーキテクチャ のセクションで扱います。先にそちらを読んでいなくてもこのセクションは進められますが、コードの意味を理解しながら進めたい場合は先に目を通しておくことをおすすめします。