112 lines
4.7 KiB
Markdown
112 lines
4.7 KiB
Markdown
# Vertical Slice + Core ハイブリッド構成 マッピング案
|
||
|
||
## 目的
|
||
- CLI中心の機能（コマンド）を slice 化し、変更影響を局所化する。
|
||
- Workflow Engine などのコアは内向き依存（Clean）で保護する。
|
||
- Public API（`index.ts`）で境界を固定し、深い import を避ける。
|
||
|
||
## 依存ルール（簡易）
|
||
- `core` は外側に依存しない。
|
||
- `infra` は `core` に依存できる。
|
||
- `features` は `core` / `infra` / `shared` に依存できる。
|
||
- `app` は配線専用（入口）。
|
||
|
||
## 移行マップ
|
||
|
||
### 1) app/cli（CLI入口・配線）
|
||
```
|
||
src/cli/index.ts -> src/app/cli/index.ts
|
||
src/cli/program.ts -> src/app/cli/program.ts
|
||
src/cli/commands.ts -> src/app/cli/commands.ts
|
||
src/cli/routing.ts -> src/app/cli/routing.ts
|
||
src/cli/helpers.ts -> src/app/cli/helpers.ts
|
||
```
|
||
- `app/cli/index.ts` は CLI エントリのみ。
|
||
- ルーティングは `features` の Public API を呼ぶだけにする。
|
||
|
||
### 2) features（コマンド単位）
|
||
```
|
||
src/commands/index.ts -> src/features/tasks/index.ts
|
||
src/commands/runAllTasks.ts -> src/features/tasks/run/index.ts
|
||
src/commands/watchTasks.ts -> src/features/tasks/watch/index.ts
|
||
src/commands/addTask.ts -> src/features/tasks/add/index.ts
|
||
src/commands/listTasks.ts -> src/features/tasks/list/index.ts
|
||
src/commands/execution/selectAndExecute.ts -> src/features/tasks/execute/selectAndExecute.ts
|
||
src/commands/execution/types.ts -> src/features/tasks/execute/types.ts
|
||
|
||
src/commands/pipeline/executePipeline.ts -> src/features/pipeline/execute.ts
|
||
src/commands/pipeline/index.ts -> src/features/pipeline/index.ts
|
||
|
||
src/commands/switchWorkflow.ts -> src/features/config/switchWorkflow.ts
|
||
src/commands/switchConfig.ts -> src/features/config/switchConfig.ts
|
||
src/commands/ejectBuiltin.ts -> src/features/config/ejectBuiltin.ts
|
||
```
|
||
- `features/tasks` は run/watch/add/list の共通入口を持つ。
|
||
- `features/pipeline` は pipeline モードの専用 slice。
|
||
- `features/config` は設定系（switch/eject）を集約。
|
||
|
||
### 3) core/workflow（中核ロジック）
|
||
```
|
||
src/workflow/engine/* -> src/core/workflow/engine/*
|
||
src/workflow/instruction/* -> src/core/workflow/instruction/*
|
||
src/workflow/evaluation/* -> src/core/workflow/evaluation/*
|
||
src/workflow/types.ts -> src/core/workflow/types.ts
|
||
src/workflow/constants.ts -> src/core/workflow/constants.ts
|
||
src/workflow/index.ts -> src/core/workflow/index.ts
|
||
```
|
||
- `core/workflow/index.ts` だけを Public API として使用。
|
||
- `engine/`, `instruction/`, `evaluation/` 間の依存は内向き（core 内のみ）。
|
||
|
||
### 4) core/models（型・スキーマ）
|
||
```
|
||
src/models/schemas.ts -> src/core/models/schemas.ts
|
||
src/models/types.ts -> src/core/models/types.ts
|
||
src/models/workflow-types.ts -> src/core/models/workflow-types.ts
|
||
src/models/index.ts -> src/core/models/index.ts
|
||
```
|
||
- `core/models/index.ts` を Public API 化。
|
||
|
||
### 5) infra（外部I/O）
|
||
```
|
||
src/providers/* -> src/infra/providers/*
|
||
src/github/* -> src/infra/github/*
|
||
src/config/* -> src/infra/config/*
|
||
src/task/* -> src/infra/task/*
|
||
src/utils/session.ts -> src/infra/fs/session.ts
|
||
src/utils/git/* -> src/infra/git/*
|
||
```
|
||
- GitHub API / FS / Git / Provider など外部依存は `infra` に集約。
|
||
|
||
### 6) shared（横断ユーティリティ）
|
||
```
|
||
src/utils/error.ts -> src/shared/utils/error.ts
|
||
src/utils/debug.ts -> src/shared/utils/debug.ts
|
||
src/utils/ui.ts -> src/shared/ui/index.ts
|
||
src/utils/* -> src/shared/utils/* (外部I/O以外)
|
||
```
|
||
- 共有は `shared` に集めるが、肥大化は避ける。
|
||
|
||
### 7) docs（参照パス修正）
|
||
```
|
||
docs/data-flow.md -> パス参照を app/core/features に合わせて更新
|
||
`src/cli.ts` 参照 -> `src/app/cli/index.ts` に更新
|
||
`src/workflow/state-manager.ts` 参照 -> `src/core/workflow/engine/state-manager.ts`
|
||
`src/workflow/transitions.ts` 参照 -> `src/core/workflow/engine/transitions.ts`
|
||
```
|
||
|
||
## Public API ルール
|
||
- `core/*` と `features/*` は **必ず `index.ts` から import**。
|
||
- 深い import（`../engine/xxx` など）は禁止。
|
||
|
||
## 移行順序（推奨）
|
||
1. `core/` に workflow + models を集約
|
||
2. `infra/` に外部I/Oを移動
|
||
3. `features/` にコマンド単位で集約
|
||
4. `app/cli` にエントリを移す
|
||
5. Public API を整理し、深い import を排除
|
||
6. docs の参照を更新
|
||
|
||
## 備考
|
||
- `src/workflow/index.ts` は `core/workflow/index.ts` に移し、外部からはここだけを参照。
|
||
- `src/models/workflow.ts` のようなプレースホルダは廃止するか、`core/models/index.ts` へ統合する。
|