UZUMAKI 社 の OSS。経営者・少人数のエンジニアが ほぼ一人ユニコーン になるのを助ける Claude Code スキル集です。

uzustack は garrytan/gstack を subtree として _upstream/gstack/ に取り込んで構築した Claude Code スキルツールキットです。Y Combinator 会長 Garry Tan 氏が公開した gstack は、CEO レビュー・エンジニアレビュー・QA など開発チームのロールを Claude Code に演じさせる構造化スキル群を提供します。英語前提なので、日本人が実用的に使えるよう、日本語化と経営者コンテキストへの翻案を加えて uzustack としてカスタマイズしました。

uzustack の特徴：

• gstack を 日本語化 して、日本人が違和感なく使える
• gstack でカバーされていない領域は 独自スキル として追加
• gstack 由来のスキルを使いつつ、自分の文脈に合わせて 独自スキルに昇華できる 設計（守破離 参照）

このプロジェクトは以下のような方を対象にしています：

• 一人で会社を回している経営者
• 少人数のスタートアップチーム / 受託開発会社
• 新規ビジネスを立ち上げる人
• 日本語ファーストで Claude Code を使いたい人
• 経営判断・プロダクト開発・ナレッジ運用を AI でブーストしたい人
• （任意）Obsidian × claude code 運用を実践している人

ゼロから Claude Code のスキルを設計するより、Garry Tan 氏という巨人の肩に乗り、その思考の延長で磨くほうが学びが深く、実用的です。gstack は YC スケール志向の開発チーム向けに設計されていますが、その本質的な型（ロール別スキル + 構造化ハンドオフ + freshness CI）は経営者・少人数の会社にも応用できます。

メンテナーである @ToraDady が 株式会社UZUMAKI のCEOとして、個人実践として始めましたが、同じような課題感を持つ日本の経営者・開発者にも役立つよう、UZUMAKI 社の OSS 活動として公開しています。

• Claude Code インストール済み
• bun インストール済み

git clone --depth 1 https://github.com/uzumaki-inc/uzustack.git ~/.claude/skills/uzustack
cd ~/.claude/skills/uzustack && bun install

任意のプロジェクトディレクトリで：

cd ~/path/to/your-project
~/.claude/skills/uzustack/setup

これで <your-project>/.claude/skills/<skill>/SKILL.md 配下に uzustack の各スキルが symlink として配置され、Claude Code から呼び出せるようになります。

📝 現在のスコープ：./setup は .claude/skills/ への symlink 配備に focus します。.claude/settings.json / .claude/CLAUDE.md への自動追記は行いません（既存ファイルを破壊しないため、ユーザー判断に委ねる設計）。

/investigate  # 根本原因調査

💡 uzustack 自体を開発したい方 は CONTRIBUTING.md を参照してください。

uzustack は garrytan/gstack を subtree として取り込んで 構築されています。

gstack の優れた仕組みを継承しつつ、Claude Codeに特化し、日本語経営者コンテキストで一次設計しています。 また、著者自身がObsidianの愛好家なので、Obsidianとの親和性を意識して作成しています。

uzustack の構築哲学・原則は ETHOS.md に集約しています：「一晩でやり切る（Boil the Lake）」「作る前に探す（Search Before Building）」「ユーザー主権（User Sovereignty）」「自分のために作れ（Build for Yourself）」（gstack の ETHOS を翻訳・経営者文脈に翻案）。

uzustack は 3 つの場所 に分散して動作します： ※Typeについては後述

<your-project>/                       ← Claude Code を起動する場所
├── CLAUDE.md                          ← プロジェクト固有の文脈
├── .claude/
│   ├── settings.json                  ← （あれば既存のまま。setup では触らない）
│   ├── CLAUDE.md                      ← （あれば既存のまま。setup では触らない）
│   └── skills/                        ← ./setup が管理（フラット配置で skill を symlink）
│       ├── investigate/               ← Type 1: uzustack 由来の翻訳スキル
│       │   └── SKILL.md
│       ├── obsidian-audit-tac/        ← Type 2: 個人固有スキル（OSS 非公開、各ユーザー固有）
│       │   └── SKILL.md
│       └── ...                        ← skill ごとに 1 ディレクトリ（frontmatter で type 区別）
└── ...（プロジェクトのファイル）

~/.claude/skills/uzustack/             ← uzustack のグローバル install（repo がそのまま入る）
├── investigate/                       ← skill 1 個 = 1 ディレクトリ
│   ├── SKILL.md.tmpl                  ← 一次ソース（メンテナーが編集）
│   └── SKILL.md                       ← 生成物（gen:skill-docs で再生成）
├── <other-skills>/
├── _upstream/
│   └── gstack/                        ← gstack を subtree で保持（git subtree pull で最新化）
└── setup                              ← end user 向けセットアップスクリプト

~/.uzustack/                           ← 生成物・状態保存
└── projects/
    └── {SLUG}/                        ← プロジェクト別 namespace
        ├── checkpoints/
        ├── timeline.jsonl
        └── ...

• A. skill 本体（~/.claude/skills/uzustack/）：uzustack のスキル群を install する場所。各 skill は repo top に直接配置（<skill>/SKILL.md）。Type 1/2/3 の区別は SKILL.md frontmatter の type: フィールドで表現。_upstream/gstack/ に gstack の subtree を保持
• B. skill 本体への接続点（<your-project>/.claude/skills/）：./setup が各 skill を <your-project>/.claude/skills/<skill>/ に展開（real dir + SKILL.md symlink）。Claude Code は .claude/skills/<skill>/SKILL.md を skill discovery する仕様のため、フラット配置が必須
• C. 生成物・状態保存（~/.uzustack/projects/{SLUG}/）：スキル実行の中間成果物（checkpoint, timeline 等）を、プロジェクト別 namespace で保存

📝 C の補足：スキルが checkpoint・タイムラインログ・学習履歴などの中間成果物を ~/.uzustack/projects/{SLUG}/ に書き出します。Claude Code セッションを跨いだ状態の永続化が目的で、プロジェクト本体（コードリポジトリやドキュメント）を汚しません。この設計は gstack のパターンを踏襲しています。

💡 開発者向けの Architecture（メンテナー / Contributor の場合）は CONTRIBUTING.md を参照してください。

uzustack のスキルは 3 タイプに分かれます：

OSS 公開対象は Type 1 と Type 3 のみ。Type 2 は各ユーザーが自由に試行錯誤する個人領域。これにより「個人依存スキルが OSS を侵さない」構造的な分離を実現しています。

📝 type: の意義：Claude Code は .claude/skills/<skill>/SKILL.md をフラットに探索する仕様のため、Type 1 と Type 3 を別フォルダに分けても、配布時には同じディレクトリに混在します。区別はメタデータ（frontmatter）で表現します。

Phase 3.5 完遂時点（2026-05-02）で実翻訳完了 + browser 機構を必要とせず単独で動作するスキル：

これらのスキルは uzustack の browse 機構 (永続的 browser daemon) を必要とし、 Phase 6 で実装検討の対象です（着手時に Type 1 維持 / Type 3 化準備 / 取り入れない決断 の 3 選択肢を判断）。 翻訳された SKILL.md は配置済みですが、 動作する bin が未配置のため現時点では動作しません。 browse 機構が必要な場合は upstream gstack を直接利用してください。 詳細は docs/uzustack/phase6-pending-skills.md を参照。

翻訳履歴と各 skill の PR # 内訳は docs/uzustack/phase-history.md を参照してください。

uzustack は uzustack プロジェクト全体 として、守破離の段階で進化します：

Phase 3 + Phase 3.5 で型の取り込み完了（2026-05-02）: runtime（bin 約 50 個 + テンプレート機構 + voice 翻案ガイドライン v1/v2 + ETHOS.md）と動作する Type 1 実翻訳 26 skill + browse 機構必須 14 skill (翻訳済 stub) = 翻訳完了 40 skill が揃った。Phase 4「絆を結ぶ」 完遂（v0.4.0.0、2026-05-24、PR #192 / Closes #183）：preamble core resolver port + hook 機構の発動経路検証 + skill 連鎖検証 + close path 規律補強の 4 軸完備。 続く Phase 5（橋を架ける = upstream 統合準備）/ Phase 6（守の完成 = browse 機構実装 + 14 skill の動作実装）で 守の完成 を達成予定。 learnings 機構実装 (元 Phase 5「記憶が編まれる」 framing) は v0.4.0.0 で Phase 5「橋を架ける」 採用に伴い、 Phase 5 と並走または Phase 5 後の別 epic として再位置づけ。 Phase 0c〜現在（Phase 4 完遂、 Phase 5 着手準備）の詳細は docs/uzustack/phase-history.md を参照。

uzustack には gbrain（クロスマシン記憶同期機構）の Supabase 連携 binary (uzustack-gbrain-supabase-provision / uzustack-gbrain-supabase-verify) が配置されています。これは upstream gstack に揃えるための完璧複製で、Supabase アカウントを契約したユーザが使う時点で動く 状態を保つことを目的としています。

ただし、uzustack 単独では 実機 Supabase 接続による検証は行っていません。配置のみ済み、bash -n syntax check と --help 出力の確認のみ完了しています。Supabase アカウントを実際に持つ uzustack ユーザが利用する場合、gstack 側の動作確認エビデンスを参照しながら使用してください。

uzustack の開発・改善に貢献していただける方は CONTRIBUTING.md を参照してください：

• 開発用 clone と bin/dev-setup のセットアップ
• ブランチ運用・PR の流れ
• Type 2 → Type 3 への昇華プロセス
• 翻訳ガイド

Issue / 機能要望：

• 個人メンテナーによる OSS です。PR は歓迎しますが、対応の保証はありません
• バグ報告・機能要望は Issue へ

uzustack は garrytan/gstack（MIT License）を subtree として取り込んで 構築されています。Garry Tan 氏 の革新的なスキルツールキット設計に深く感謝します。

• CONTRIBUTING.md ― 開発者・コントリビューター向けガイド
• ARCHITECTURE.md ― 3 場所 layout / skill typology / Phase progression / runtime / state 層の設計詳細
• CHANGELOG.md ― release notes（Keep a Changelog 形式）
• docs/uzustack/phase-history.md ― Phase 0c〜現在（Phase 4 完遂、 Phase 5 着手準備）の進捗履歴と主要 PR # 内訳
• docs/uzustack/translation-voice-guide.md ― 翻訳 voice ガイド + 訳語表（メンテナー向け）
• docs/uzustack/translation-rebase-fixes.md ― rebase 時に保持すべき uzustack 独自 fix