初回セットアップ（例）:
git clone https://github.com/yug1224/dotfiles.git
cd dotfiles
make install # Homebrew インストール・Prezto clone（install.sh）
make mise # mise bootstrap（packages / dotfiles / tools / bootstrap task）
make node # pnpm install（lefthook の pre-commit で oxfmt / secretlint に必要。TypeScript はエディタの言語サービス用）
make check # oxfmt check + lint + typecheck + AI sync 検証（allowlist / wrapper / deny-guard / always-on）+ script 最小テスト + check-bootstrap（macOS）make install（install.sh）は初回 seed として Homebrew・Prezto・mise 導入に加え、mise.tomlがある場合はmise bootstrap --yesまで実行する（重い・GUI reconcile の可能性あり）。日常の再適用はmake mise。- パッケージマネージャは pnpm（
packageManager/pnpm-lock.yaml）。npm installは使わない。 - lefthook pre-commit は oxfmt + secretlint のみ。AI sync は
make check/ CI で担保する。 - bootstrap には mise ≥ 2026.7.7 が必要（ルート
mise.tomlのmin_version。不足時はmake miseの gate がbrew upgrade mise）。 install.shは/usr/bin/curlで Homebrew を入れます。Intel Mac では/opt/homebrewではなく/usr/local側になる場合があります。- AI 設定（Cursor / Claude Code）は RTK 前提。
make miseの後、rtk --version && rtk gainで smoke test すること。詳細はpackages/shared/ai/docs/RTK.md。 - Cursor / AI 用のルールは
packages/cursor/README.mdを参照。 - Raycast 拡張は
packages/raycast/README.mdを参照。 - oxfmt の構成は
packages/oxfmt/README.mdを参照。 - 依存の所有権（oxfmt の二重管理・Node 正本は
.node-version）はpackages/oxfmt/README.mdを参照。 - エディタの oxfmt パスは
$HOME/.dotfiles/...（make miseでリポジトリが~/.dotfilesに symlink される前提）。 - bootstrap の dry-run:
mise bootstrap -n。macOS のmake check-bootstrapは[bootstrap.packages]のbrew:/brew-cask:のみ不足を検出する（[tasks.bootstrap]の cask は対象外。CI は ubuntu のみで no-op）。 make install/make miseの前に、対象 GUI アプリ（Chrome / Slack 等）を終了すること。既存マシンでは mise が cask を reconcile 再インストールすることがある。- Tap 由来 formula を brew で触る場合:
brew trust --formula cloudflare/cloudflare/curl dotenvx/brew/dotenvx
| 層 | 正本 | 対象 |
|---|---|---|
mise [dotfiles] |
ルート mise.toml |
zsh / shared / rtk / git（config・ignore）/ pnpm / tig / code（双ターゲット）/ cursor / claude / ssh（config のみ）/ mise（config.toml） |
mise [tools] |
packages/mise/config.toml |
runtimes（node / pnpm / …）+ CLI（gh jq bat delta difftastic fd lefthook peco ripgrep（バイナリ rg）rtk tlrc 等） |
mise [bootstrap.*] |
ルート mise.toml |
formulae + 一部 cask（brew: / brew-cask:）。pkg/特殊配布 cask・VS Code 拡張・rtmpdump は [tasks.bootstrap] |
所有権ルール
- 設定の正本はルート
mise.tomlの[dotfiles]。展開はmake mise（bootstrap の dotfiles フェーズ）。 *.local.*/ 秘密ファイルは[dotfiles]に取り込まない（.zshrc.local/settings.local.json/ SSH 鍵含む）。- 通常ファイル（symlink でない）で conflict になる場合は、バックアップのうえ
mise -C . dotfiles apply --force --yes。
[tools]の正本はpackages/mise/config.toml→~/.config/mise/config.toml（symlink）。- マシン固有の
[tools]はpackages/mise/config.local.toml（.gitignore済み。コミットしない）。config.tomlの symlink 解決先の隣として読み込まれる。 trusted_config_paths等の trust 系 settings はグローバル専用（~/.config/mise/config.local.tomlのみ）。packages/mise/config.local.tomlに書くとnon-global config ... is ignored警告になる。- 例（パスは自分の作業ルートに置換。
~/.config/mise/config.local.tomlに書く）:
[settings]
trusted_config_paths = ["/PATH/TO/Workspaces"]