task-composer CLAUDE.md

Task Composer

DAGベースのタスク管理ライブラリ（Rust学習プロジェクト）

Claudeへの指示

このプロジェクトはRust学習を目的としています。以下の点を意識してサポートしてください：

• コードを直接書かない: ヒントやシグネチャを提示し、ユーザーが自分で実装できるようガイドする
• 概念を説明する: 新しいRustの概念が出てきたら、図や例を使って分かりやすく説明する
• エラーを学習機会に: コンパイルエラーが出たら、なぜそのエラーが起きるのかを丁寧に解説する
• 段階的に進める: 一度に大量のコードを提示せず、小さなステップで進める
• 質問を促す: ユーザーが理解を深められるよう、適宜質問を投げかける
• テストを重視: 実装後は必ずテストを書くよう促す

プロジェクト概要

有向非巡回グラフ(DAG)を使ってタスクの依存関係を管理するRustライブラリ。

構造

task-composer/
├── Cargo.toml                   # ワークスペース定義
├── LICENSE                      # Apache 2.0
├── README.md
├── CLAUDE.md                    # このファイル
├── task-composer-core/          # コアライブラリ
│   ├── Cargo.toml
│   └── src/
│       ├── lib.rs
│       ├── types.rs             # 型定義（Task, Role, Config等）
│       ├── path_resolver.rs     # パス参照・埋め込み参照の解決
│       ├── dag/                 # DAG実装
│       │   ├── mod.rs
│       │   └── tests.rs
│       ├── checkpoint/          # チェックポイント機能
│       │   ├── mod.rs
│       │   └── writer.rs
│       ├── task_executor/       # Executor実装
│       │   ├── mod.rs
│       │   ├── log_executor.rs
│       │   ├── mcp_executor.rs
│       │   ├── dag_executor.rs
│       │   ├── bash_executor.rs
│       │   ├── data_executor.rs
│       │   ├── git_executor.rs
│       │   ├── github_executor.rs
│       │   ├── map_executor.rs
│       │   ├── filter_executor.rs
│       │   └── reduce_executor.rs
│       └── analysis/            # 静的解析
│           ├── mod.rs
│           ├── dag_analysis.rs
│           ├── task_validation.rs
│           └── conflict/
├── task-composer-cli/           # CLIツール
│   ├── Cargo.toml
│   └── src/
│       ├── main.rs
│       └── signal.rs            # シグナルハンドリング
├── task-composer-ui/            # Dioxus UI（Desktop/Web/TUI）
│   ├── Cargo.toml
│   ├── Dioxus.toml
│   └── src/
│       ├── main.rs
│       ├── tui_main.rs
│       ├── components/          # UIコンポーネント
│       ├── hooks/               # カスタムフック
│       └── state/               # 状態管理
├── mcp_servers/
│   └── claude_code_mcp/
│       ├── main.py              # FastMCPサーバー
│       └── pyproject.toml
└── samples/                     # サンプルDAGファイル
    ├── basics/                  # 基本サンプル
    │   ├── minimal.json
    │   ├── simple_dag.json
    │   ├── auto_dependency.json
    │   └── embedded_reference.json
    ├── executors/               # Executor別サンプル
    │   ├── bash.json
    │   ├── data.json
    │   ├── git/
    │   ├── github/
    │   └── mcp/
    ├── features/                # 機能別サンプル
    │   ├── condition/           # if/else条件
    │   ├── loop/                # ループ実行
    │   └── subgraph/            # サブグラフ
    └── workflows/               # ワークフローサンプル