devbasex · takemi-ohama · Jun 3, 2026 · May 30, 2026 · Jun 2, 2026 · Jun 2, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,12 @@
 ## [Unreleased]
 
 ### Added
+- **`devbase project` サブコマンド群を新設**しました (PLAN06)。CWD に依存せずプロジェクト名でコンテナ操作ができます。
+ - `devbase project up/down/ps/logs/scale [name]` で、任意のディレクトリから `$DEVBASE_ROOT/projects/<name>` を対象に操作できます。名前解決はラッパー (`bin/devbase`) が対象ディレクトリへ `cd` してから実行するため、シェル実装の `build` を含む全操作が名前指定で成立します（呼び出し元シェルの作業ディレクトリは変わりません）。存在しない名前はエラーになり候補が提示されます。
+ - `devbase project list [--interactive|-i]` で `$DEVBASE_ROOT/projects/` 配下を `NAME` / `PLUGIN` / `STATUS` の一覧表示します。`PLUGIN` 列はシンボリックリンク先から解決するため、PLAN04 の同名衝突 suffix（例 `carmo.takemi`）が付いていても正しいプラグイン名を表示します。`--interactive` では一覧から番号で選択して起動でき、非対話環境では番号入力にフォールバックします。
+ - トップレベルシノニム `devbase up/down/ps/scale [name]` / `devbase build [image]` / `devbase login [index]` / `devbase list` を整備しました（`logs` はシノニムを持たず `devbase project logs` のみ）。
+ - bash / zsh のシェル補完に `project` グループとプロジェクト名補完（`$DEVBASE_ROOT/projects/` 配下を列挙）を追加しました。
+ - 利用者向けドキュメント [`docs/user/cli-reference.md`](docs/user/cli-reference.md) / [`docs/user/container-operations.md`](docs/user/container-operations.md) を `project` 体系に更新しました。
 - `devbase env export` / `devbase env import` で **S3 URI (`s3://bucket/key`) を入出力先として指定**できるようになりました (PLAN03-1 PR3)。
  - 既定でオブジェクト単位の SSE (`aws:kms` または `AES256`) を強制し、export 時はバケット側のデフォルト暗号化も `GetBucketEncryption` で事前確認します。
  - 暗号化が未設定のバケットへ export する場合は `--unsafe-allow-unencrypted-bucket` の明示が必要です (オブジェクト単位の SSE はこのフラグに関係なく常に付与されます)。
@@ -15,6 +21,7 @@
  - README と環境変数ガイドからのリンクも追加しました。
 
 ### Changed
+- **`devbase container` グループを非推奨化**しました (PLAN06)。`devbase container <sub>` は `devbase project <sub>` のエイリアスとして当面動作しますが、実行時に非推奨警告を表示します（移行期間後のリリースで削除予定）。`[name]` 指定や `list` などの新機能は `project` 側のみで提供されます。トップレベルショートカット (`devbase up` 等) の転送先も `container` から `project` へ変更しました。
 - `gs://` (GCS) スキームは **PLAN03-1 PR4 廃案** により対応しません。指定すると明示的なエラーメッセージで失敗します (旧: "未実装")。
 - `lib/devbase/env/` 配下の export / import モジュールをリファクタリングしました (PLAN03-1 PR5)。公開 API (`ExportOptions`, `ImportOptions`, `export`, `import_bundle`) に互換性のない変更はありません。
  - export / import で重複していた passphrase 読み取り / 既定鍵 fallback / セキュアな bytes 書き込みを `io_common.py` に集約。

diff --git a/README.md b/README.md
@@ -11,7 +11,7 @@ devbaseは、Docker Composeを使った再現性の高い開発環境を提供
 - **Pluginベースのプロジェクト管理**: 外部リポジトリからプロジェクト設定をインストール・更新
 - **コンテナ化された開発環境**: Docker Composeベースで再現性の高い環境を提供
 - **豊富なツールセット**: Docker CLI、AWS CLI、gcloud SDK、Terraform、Node.js、AI CLIツールがプリインストール
-- **複数コンテナの並行開発**: `devbase container scale`で既存コンテナを再起動せずにスケール可能
+- **複数コンテナの並行開発**: `devbase project scale`で既存コンテナを再起動せずにスケール可能
 - **データ永続化**: 名前付きボリュームでコンテナ再起動後もデータを保持
 - **スナップショット管理**: `/home/ubuntu` 共通ボリュームの増分バックアップ・復元・世代管理
 - **環境変数の自動収集**: `devbase env init`でAWS/Git/GCP認証情報を対話的に設定
@@ -75,12 +75,14 @@ devbaseのコマンドは4つのグループにまとめられています。
 
 | グループ | 略記 | 説明 |
 |---------|------|------|
-| `container` | `ct` | コンテナ管理（up / down / login / ps / logs / scale / build） |
+| `project` | — | プロジェクト管理（up / down / login / ps / logs / scale / build / list） |
 | `env` | — | 環境変数管理（init / sync / list / set / get / delete / edit / project / export / import） |
 | `plugin` | `pl` | プラグイン管理（list / install / uninstall / update / info / sync / repo） |
 | `snapshot` | `ss` | スナップショット管理（create / list / restore / copy / delete / rotate） |
 
-- **ショートカット**: `up`, `down`, `login`, `build`, `ps` はトップレベルから直接使用可能
+> **`container`（略記 `ct`）グループは非推奨です。** `devbase project <sub>` のエイリアスとして当面動作しますが、非推奨警告を表示します。新しいコマンドは `project` を使用してください。
+
+- **ショートカット**: `up [name]`, `down [name]`, `login [index]`, `build [image]`, `ps [name]`, `scale [name] <num>`, `list` はトップレベルから直接使用可能（`project` グループへ自動転送。`logs` はシノニムを持ちません）。ただし `build` のみ例外で、`project` グループ（Python 実装）ではなく `bin/devbase` のシェル実装 `cmd_build` へ直接委譲されます（詳細は [CLI リファレンス](docs/user/cli-reference.md#ショートカットコマンド)）
 - **プレフィックス略記**: `devbase p l` → `devbase plugin list`
 - **トップレベルコマンド**: `init`, `status`, `shell-rc`
 

diff --git a/docs/user/cli-reference.md b/docs/user/cli-reference.md
@@ -11,38 +11,54 @@ graph TD
  A[devbase] --> B[init]
  A --> C[status]
  A --> H[shell-rc]
- A --> D[container / ct]
+ A --> D[project]
  A --> E[env]
  A --> F[plugin / pl]
  A --> G[snapshot / ss]
- D --> D1[up / down / login / ps / logs / scale / build]
+ D --> D1["up / down / ps / logs / scale [name]"]
+ D --> D3["login [index]"]
+ D --> D4["build [image]"]
+ D --> D2["list [--interactive]"]
  E --> E1[init / sync / list / set / get / delete / edit / project]
  F --> F1[list / install / uninstall / update / info / sync]
  F --> F2[repo add / repo remove / repo list / repo refresh]
  G --> G1[create / list / restore / copy / delete / rotate]
 ```
 
+> **`container` グループは非推奨になりました。** 旧 `devbase container <sub>` は
+> `devbase project <sub>` のエイリアスとして当面動作しますが、実行時に非推奨警告を
+> 表示します（移行期間後のリリースで削除予定）。新しいコマンドは `project` を使用してください。
+
 ### グループエイリアス
 
 各グループには短縮形が用意されています。
 
-| グループ名 | エイリアス |
-|-----------|-----------|
-| `container` | `ct` |
-| `plugin` | `pl` |
-| `snapshot` | `ss` |
+| グループ名 | エイリアス | 備考 |
+|-----------|-----------|------|
+| `plugin` | `pl` | |
+| `snapshot` | `ss` | |
+| `container` | `ct` | **非推奨**（`project` へ移行してください） |
 
 ### ショートカットコマンド
 
-頻繁に使用するコンテナ操作はトップレベルから直接実行できます。これらは `container` グループに自動転送されます。
+頻繁に使用するプロジェクト操作はトップレベルから直接実行できます。これらは `project` グループに自動転送されます。
 
 | ショートカット | 転送先 |
 |--------------|--------|
-| `devbase up` | `devbase container up` |
-| `devbase down` | `devbase container down` |
-| `devbase login` | `devbase container login` |
-| `devbase build` | `devbase container build` |
-| `devbase ps` | `devbase container ps` |
+| `devbase up [name]` | `devbase project up [name]` |
+| `devbase down [name]` | `devbase project down [name]` |
+| `devbase login [index]` | `devbase project login [index]` |
+| `devbase build [image]` | `bin/devbase` の `cmd_build`（シェル実装）※ |
+| `devbase ps [name]` | `devbase project ps [name]` |
+| `devbase scale [name] <num>` | `devbase project scale [name] <num>` |
+| `devbase list` | `devbase project list` |
+
+> **Note:** `logs` はトップレベルシノニムを持ちません。`devbase project logs` を使用してください。
+>
+> **※ `build` の転送先について:** `devbase build` は他のショートカットのように `project` グループ
+> （Python 実装）へ転送されるのではなく、`bin/devbase` のシェル実装 `cmd_build` に直接委譲されます。
+> base イメージの段階ビルド等を CWD で行う必要があるためで、`devbase project build` とは実装経路が
+> 異なります（名前指定はラッパーの `cd` で解決）。挙動上の入出力は同等ですが、実装は別物です。
 
 ### ユニークプレフィックスマッチング
 
@@ -113,17 +129,44 @@ source "$(./bin/devbase shell-rc)"
 
 > **⚠ 引用符は必須**: `source $(devbase shell-rc)` のように引用符を省くと、ホームディレクトリ名に空白を含む環境（例: `/Users/foo bar/.zshrc`）で word splitting が起き `source` が失敗します。必ず `source "$(devbase shell-rc)"` の形で書いてください。
 
-## container (ct) グループ
+## project グループ
+
+プロジェクト（コンテナ）のライフサイクル管理と一覧表示を行うコマンド群です。
+
+### プロジェクト名指定（CWD 非依存）
+
+`up` / `down` / `ps` / `logs` / `scale` は省略可能な `[name]` 引数を取ります。`[name]`
+を指定すると、**現在のディレクトリに依存せず** `$DEVBASE_ROOT/projects/<name>` を対象に
+操作できます。
+
+```bash
+# 任意のディレクトリから adminer プロジェクトを起動
+devbase project up adminer
+
+# 省略時は従来どおりカレントディレクトリのプロジェクトを対象にする
+cd $DEVBASE_ROOT/projects/adminer && devbase project up
+```
+
+- `<name>` は `$DEVBASE_ROOT/projects/` 配下のプロジェクト名（`devbase project list` で確認可能）
+- 存在しない名前を指定するとエラーになり、利用可能なプロジェクト候補が表示されます
+- 名前解決はラッパー (`bin/devbase`) が対象ディレクトリへ `cd` してから実行します。
+ これにより `build`（シェル実装）を含む全操作が名前指定で成立します
+- `devbase` は PATH 上の実行ファイルとして子プロセスで起動されるため、この `cd` が
+ **呼び出し元シェルの作業ディレクトリを変えることはありません**
 
-コンテナのライフサイクル管理を行うコマンド群です。
+> **`project login` / `project build` は `[name]` を取りません。** これらの単一引数はそれぞれ
+> `index` / `image` であり、`[name]` を許すと `project login 2` / `project build web` が誤解釈される
+> ため除外しています。一方、トップレベルシノニム `devbase build <name>` / `devbase login <name>` は
+> ラッパー (`bin/devbase`) の存在性判定（`$DEVBASE_ROOT/projects/<name>` が実在すれば cd）で
+> 名前解決されます（実在しない場合は従来どおり `index` / `image` として下流へ渡されます）。
 
-### `devbase container up`
+### `devbase project up`
 
 コンテナを起動します。
 
 ```
-devbase container up
-devbase up
+devbase project up [name]
+devbase up [name]
 ```
 
 - 起動時にスナップショットを自動作成（新世代 or 差分追加）
@@ -136,23 +179,23 @@ devbase up
  （前回 pull 日時は `${DEVBASE_ROOT}/.cache/pulls/<image>` の touch-file mtime で判定）
  - 閾値は `DEVBASE_IMAGE_MAX_AGE_DAYS` 環境変数で上書き可能（既定 7、不正値は警告して既定値）
 
-### `devbase container down`
+### `devbase project down`
 
 コンテナを停止・削除します。
 
 ```
-devbase container down
-devbase down
+devbase project down [name]
+devbase down [name]
 ```
 
 - 停止時にスナップショットのローテーションを自動実行
 
-### `devbase container login`
+### `devbase project login`
 
 コンテナにログインします。
 
 ```
-devbase container login [index]
+devbase project login [index]
 devbase login [index]
 ```
 
@@ -168,25 +211,26 @@ devbase login
 devbase login 2
 ```
 
-### `devbase container ps`
+### `devbase project ps`
 
-コンテナの状態を表示します。
+対象プロジェクトのコンテナ状態を `docker compose ps` で表示します。複数プロジェクトの
+横断一覧は `devbase project list` を使用してください。
 
 ```
-devbase container ps [-a]
-devbase ps [-a]
+devbase project ps [name] [-a]
+devbase ps [name] [-a]
 ```
 
 | オプション | 説明 |
 |-----------|------|
 | `-a` | 停止中のコンテナも表示 |
 
-### `devbase container logs`
+### `devbase project logs`
 
-コンテナのログを表示します。
+コンテナのログを表示します（トップレベルシノニムはありません）。
 
 ```
-devbase container logs [-f] [--tail N]
+devbase project logs [name] [-f] [--tail N]
 ```
 
 | オプション | 説明 |
@@ -196,42 +240,96 @@ devbase container logs [-f] [--tail N]
 
 ```bash
 # 最新50行をリアルタイムで追跡
-devbase container logs -f --tail 50
+devbase project logs -f --tail 50
 ```
 
-### `devbase container scale`
+### `devbase project scale`
 
 既存のコンテナを再起動せずにスケールします。
 
 ```
-devbase container scale <num>
+devbase project scale [name] <num>
+devbase scale [name] <num>
 ```
 
 | パラメータ | 必須 | 説明 |
 |-----------|------|------|
+| `name` | いいえ | 対象プロジェクト名（省略時はカレント） |
 | `<num>` | はい | コンテナ数 |
 
 ```bash
 # コンテナを3台に増やす
-devbase container scale 3
+devbase project scale 3
 
-# コンテナを1台に減らす
-devbase container scale 1
+# 任意のディレクトリから adminer を3台に
+devbase project scale adminer 3
 ```
 
-### `devbase container build`
+### `devbase project build`
 
 コンテナイメージをビルドします。
 
 ```
-devbase container build [image]
+devbase project build [image]
 devbase build [image]
 ```
 
 | パラメータ | 必須 | 説明 |
 |-----------|------|------|
 | `image` | いいえ | ビルドするイメージ名（省略時は全イメージ） |
 
+### `devbase project list`
+
+`$DEVBASE_ROOT/projects/` 配下のプロジェクトを `NAME` / `PLUGIN` / `STATUS` の一覧で
+表示します。
+
+```
+devbase project list [--interactive|-i]
+devbase list [--interactive|-i]
+```
+
+| オプション | 説明 |
+|-----------|------|
+| `--interactive` / `-i` | 一覧から番号で選択し、そのプロジェクトを `project up` で起動 |
+
+```bash
+# 一覧表示
+devbase list
+
+# 一覧から選んで起動（非対話環境では番号入力にフォールバック）
+devbase list -i
+```
+
+出力例:
+
+```
+NAME PLUGIN STATUS
+adminer adminer running (2 containers)
+carmo carmo stopped
+carmo.takemi carmo-fork stopped
+```
+
+- `PLUGIN` 列はシンボリックリンク先から解決するため、PLAN04 の同名衝突 suffix
+ （例 `carmo.takemi`）が付いていても正しいプラグイン名を表示します
+- `STATUS` は `running (N containers)` / `stopped` / `unknown`（docker 未起動・
+ `compose.yml` 不在等で判定不能）のいずれか
+
+## container (ct) グループ（非推奨）
+
+> **非推奨:** `container` グループは `project` グループへ移行しました。`devbase container
+> <sub>` は当面 `devbase project <sub>` のエイリアスとして動作しますが、実行時に非推奨警告を
+> 表示します（移行期間後のリリースで削除予定）。`[name]` 指定や `list` などの新機能は
+> `project` 側のみで提供されます。
+
+```bash
+# 旧（非推奨・警告が出ます）
+devbase container up
+
+# 新（推奨）
+devbase project up
+devbase up
+```
+
 ## env グループ
 
 環境変数の管理を行うコマンド群です。詳細は [環境変数ガイド](environment-variables.md) を参照してください。

diff --git a/docs/user/container-operations.md b/docs/user/container-operations.md
@@ -2,6 +2,13 @@
 
 devbase のコンテナ管理機能について、ライフサイクル、並行開発、ボリューム構造、イメージ階層を解説します。
 
+> **コマンド体系について:** コンテナ操作は `devbase project <sub>` グループ（および
+> トップレベルショートカット `devbase up` 等）で行います。旧 `devbase container <sub>` は
+> 非推奨となり、`project` へのエイリアスとして警告付きで当面動作します。`project` では
+> `up` / `down` / `ps` / `logs` / `scale` に `[name]` を指定することで **任意のディレクトリ
+> から** 対象プロジェクトを操作できます。プロジェクト一覧は `devbase project list` を参照
+> してください。詳細は [CLI リファレンス](cli-reference.md#project-グループ) を参照。
+
 ## コンテナライフサイクル
 
 devbase のコンテナは以下のライフサイクルで管理されます。
@@ -75,10 +82,13 @@ CONTAINER_SCALE=2
 
 ```bash
 # コンテナを3台に増やす（既存コンテナは再起動しない）
-devbase container scale 3
+devbase project scale 3
 
 # コンテナを1台に減らす
-devbase container scale 1
+devbase project scale 1
+
+# 任意のディレクトリから adminer を3台に
+devbase project scale adminer 3
 ```
 
 ### 各コンテナへのログイン
@@ -216,15 +226,28 @@ devbase ps -a
 
 ```bash
 # 最新のログを表示
-devbase container logs
+devbase project logs
 
 # リアルタイムでログを追跡
-devbase container logs -f
+devbase project logs -f
 
 # 末尾100行のみ追跡
-devbase container logs -f --tail 100
+devbase project logs -f --tail 100
+```
+
+### プロジェクト一覧
+
+```bash
+# 全プロジェクトを NAME / PLUGIN / STATUS で一覧表示
+devbase list
+
+# 一覧から選択して起動（非対話環境では番号入力にフォールバック）
+devbase list -i
 ```
 
+`devbase project ps` が「対象プロジェクト 1 つのコンテナ状態」を表示するのに対し、
+`devbase list` は「全プロジェクトの横断一覧」を表示します。
+
 ### 環境の全体像
 
 ```bash