ようこそ

このサイトは Astar Management の内部エンジニア向けオンボーディングドキュメントです。

読者として想定しているのは、チームに入って 1〜2 週間の新しいエンジニアです。プロダクトを触ったことがない前提で、「何を作っている会社か」から「実際に手を動かして最初の PR を出すまで」を一直線に読めるように構成しています。

このサイトは社内エンジニア向けです。お客様向けの操作マニュアルは別サイト（docs/user-guide/。アプリ内の「使い方ガイド」からも同じ内容を見られます）にあります。混同しないでください。

読む順番

上から順に読んでください。所要時間は「初見でざっと読む」場合の目安です。

このセクション（Welcome） — Astar が何を解決するプロダクトか、事業文脈へのポインタ（10 分）
Getting Started — 環境構築、リポジトリ構成、最初の一歩（30 分〜1 時間、実際に手を動かす）
Architecture — システム全体構成、モジュール設計、AI アーキテクチャ、データモデル（30 分）
自分の担当層のガイド — Backend / Frontend / Go Agent & CLI のうち、自分が実際に触る層を読む（30 分〜1 時間）
Modules — 実装時に随時参照するモジュール索引。通読するものではなく、辞書として使う
docs-map — docs/ 配下の地図。このサイトで足りない一次情報を探すときに使う

ガイド部分（1〜4）はトータルで 2〜3 時間程度です。5・6 は最初から通読する必要はなく、実装しながら都度参照してください。

このサイトはオンボーディング用に再構成した二次資料です。プロダクト戦略・設計判断のような一次資料はリポジトリの docs/ 配下に直接あり、CLAUDE.md（ルート/backend//frontend//agent/ 各所）は特に正確度が高い一次資料です。ただし AI エージェント向けの文体（テンポが速く、専門用語や社内略語がそのまま出てくる）で書かれているため、人間の初読には向きません。docs/ のどこに何があり、どれが読む価値があるかは docs-map にまとめています。