Scopecraft Command

Scopecraft コマンド

Markdown 駆動のタスク管理（MDTM）ファイルを管理するための、強力なコマンドラインツールおよび MCP サーバーです。Scopecraft を使うと、構造化された方法でタスク、機能、開発ワークフローを整理できます。

バージョン 2.0：2 状態のワークフロー（current/archive）とフェーズベースの整理、複雑な機能に対応する親タスク、高度なサブタスクの順序設定機能を備えました！

主な機能：

• 柔軟なプロジェクトルート設定により、あらゆる AI IDE（Cursor、Claude Desktop など）で利用できます
• フェーズベースのタスク整理を備えた 2 状態のワークフロー（current/archive ＋ フェーズメタデータ）
• サブタスクの順序設定と並列実行に対応した親タスク
• TOML/YAML フロントマターを含む MDTM 形式に対応
• CLI と MCP サーバーの両方のインターフェースを提供
• 機能開発に特化した Claude コマンドを搭載
• プロジェクトの種類を自動検出
• 簡単に切り替えられる複数プロジェクトのサポート

インストール

NPM からインストール

グローバルインストール（推奨）

# Install globally with npm
npm install -g @scopecraft/cmd

# Or with yarn
yarn global add @scopecraft/cmd

# Or with bun
bun install -g @scopecraft/cmd

インストール後、次のコマンドを利用できます：

• scopecraft / sc - タスク管理用 CLI
• scopecraft-mcp / sc-mcp - MCP サーバー（HTTP/SSE）
• scopecraft-stdio / sc-stdio - MCP サーバー（STDIO トランスポート）

npx で使用（インストール不要）

# Run CLI commands directly
npx @scopecraft/cmd sc task list
npx @scopecraft/cmd sc feature create "New Feature"

# Run MCP STDIO server
npx --package=@scopecraft/cmd scopecraft-stdio --root-dir /path/to/your/project

ソースからインストール

# Clone repository
git clone https://github.com/scopecraft-ai/scopecraft-command.git
cd scopecraft-command

# Install dependencies
bun install

# Build project
bun run build

# Install globally
bun run install:global

プロジェクトルートの設定

Scopecraft は、あらゆる AI IDE で利用できるようになりました！次のいずれかの方法でプロジェクトルートを設定してください。

AI IDE のクイックセットアップ

Cursor / Claude Desktop

# Start MCP server with your project
scopecraft-mcp --root-dir /path/to/your/project

または、IDE の MCP 設定に追加します：

{
  "scopecraft": {
    "command": "scopecraft-mcp",
    "args": ["--root-dir", "/path/to/your/project"]
  }
}

複数のプロジェクト

~/.scopecraft/config.json を作成します：

{
  "projects": {
    "frontend": { "path": "/projects/myapp/frontend" },
    "backend": { "path": "/projects/myapp/backend" }
  }
}

実行時にプロジェクトを切り替えます：

init_root /projects/myapp/backend

設定方法

1. CLI パラメーター：--root-dir /path/to/project
2. MCP コマンド：init_root /path/to/project
3. 設定ファイル：~/.scopecraft/config.json
4. 環境変数：SCOPECRAFT_ROOT=/path/to/project

詳しい設定方法については、プロジェクトルート設定ガイドを参照してください。

はじめに

# Initialize Scopecraft in your project
sc init

# Create your first task
sc task create --title "My first feature" --type feature

# List your tasks
sc task list

クイックスタート

基本的なタスク管理

# List all tasks
sc task list
sc task list --current    # Show only active tasks  
sc task list --phase backlog  # Show backlog items by phase

# Create a new task (goes to current with phase=backlog by default)
sc task create --title "Implement user authentication" --type feature

# Update task status
sc task update TASK-123 --status "In Progress"
sc task start TASK-123    # Shortcut for marking as "In Progress"
sc task complete TASK-123 # Shortcut for marking as "Done"

# View task details
sc task get TASK-123

親タスク（複雑な機能）

# Create a parent task with subtasks
sc parent create --title "User Authentication" --type feature

# Add subtasks to a parent
sc parent add-subtask auth-05K --title "Design login UI"
sc parent add-subtask auth-05K --title "Implement API" --after 01-design

# View parent task with tree visualization
sc parent show auth-05K --tree

# Work with subtasks (use full path or --parent option)
sc task update current/auth-05K/02-impl-api --status "In Progress"
sc task complete 02-impl-api --parent auth-05K

タスクの順序設定

# Make subtasks run in parallel
sc task parallelize 02-api 03-ui --parent auth-05K

# Reorder subtasks
sc task resequence auth-05K --from 1,2,3 --to 3,1,2

# Convert simple task to parent with subtasks
sc task promote simple-auth-05M --subtasks "Design,Build,Test"

ワークフロー管理

# Two-state workflow: current (with phases) → archive
sc task create --title "New feature"          # Creates in current/ with phase=backlog
sc task update new-feature-05A --status "In Progress"  # Status changes, stays in current/
sc task update new-feature-05A --phase active          # Change phase to active
sc task complete new-feature-05A              # Moves to archive/ when done

# Move parent tasks to archive when complete
sc parent move auth-05K archive

環境とセッションの管理

Scopecraft は、統合開発環境と Claude セッション管理を提供します。

環境コマンド

# Create or switch to task environment
sc env auth-feature-05A

# List active environments
sc env list

# Get environment path for shell integration
cd "$(sc env path auth-feature-05A)"

# Close environment when done
sc env close auth-feature-05A --force

対話型開発（Work コマンド）

# Interactive task selection
sc work

# Work on specific task
sc work auth-feature-05A

# Work with additional context
sc work auth-feature-05A "Focus on security requirements"

# Resume previous session
sc work --session session-abc123

自律型開発（Dispatch コマンド）

# Autonomous execution in Docker
sc dispatch auth-feature-05A

# Execute in tmux session
sc dispatch auth-feature-05A --exec tmux

# Execute in specific mode
sc dispatch auth-feature-05A --mode implementation

# Resume autonomous session
sc dispatch --session session-xyz789

組み合わせ可能なワークフロー

# Complete development workflow
sc task create --title "New feature" --type feature --phase backlog
sc env new-feature-05A
sc work new-feature-05A

# Or autonomous processing
sc dispatch new-feature-05A --exec tmux

従来の Worktree 管理

既存のワークフローとの互換性のため、次を利用できます：

# Start a task worktree
tw-start TASK-123

# Start a feature worktree
tw-feat-start FEATURE_auth

# List active worktrees
tw-list

# Finish and merge work
tw-finish TASK-123

エンティティ・コマンドのパターン

コマンドは直感的なパターンに従います：

<entity> <command> [options]

エンティティ：

• task - タスク管理（単純なタスクとサブタスク）
• parent - 親タスク管理（サブタスクを含むフォルダー）
• env - 開発環境管理（worktree）
• work - 対話型 Claude 開発セッション
• dispatch - 自律型 Claude 実行
• area - エリアディレクトリー（組織単位）
• workflow - タスクの順序とステータス
• template - タスクテンプレート

例：

# Task management
sc task list
sc task create --title "Feature X" --type feature

# Environment management
sc env feature-x-05A
sc env list

# Interactive development
sc work feature-x-05A

# Autonomous execution
sc dispatch feature-x-05A --exec tmux

# Legacy format (still supported)
sc list

Claude コマンド

Scopecraft には、構造化された開発に特化した Claude コマンドが含まれています。

利用可能なコマンド

• /project:01_brainstorm-feature - 対話型のアイデア出し（ステップ 1）
• /project:02_feature-proposal - 正式な提案を作成（ステップ 2）
• /project:03_feature-to-prd - 詳細な PRD に展開（ステップ 3）
• /project:04_feature-planning - タスクに分割（ステップ 4）
• /project:05_implement {mode} {task-id} - ガイダンスに沿って実行
  • モード：typescript、ui、mcp、cli、devops
• /project:review - プロジェクトの状態を確認

ワークフローの例

# Step 1: Start with an idea
/project:01_brainstorm-feature "better task filtering"

# Step 2: Create proposal
/project:02_feature-proposal

# Step 3: Expand to PRD
/project:03_feature-to-prd TASK-20250517-123456

# Step 4: Plan implementation
/project:04_feature-planning FEATURE-20250517-123456

# Execute tasks
/project:05_implement ui TASK-20250517-234567

# Automatically find and implement next task in feature
/project:implement-next FEATURE_auth
/project:implement-next  # Auto-detect from current worktree

MCP サーバーの使用方法

サーバーの起動

# HTTP/SSE Server (default port 3000)
scopecraft-mcp

# With custom port
MCP_PORT=8080 scopecraft-mcp

# STDIO transport
scopecraft-stdio

Roo Commander との統合

LLM エージェントが MCP プロトコルを介してタスクを直接管理できるよう、Roo Commander の設定を行います。

リクエストの例

{
  "method": "task.list", 
  "params": {
    "status": "in_progress",
    "phase": "active",
    "format": "json"
  }
}

ドキュメント

CLI リファレンスとガイド

• CLI リファレンス - コマンドの完全なリファレンス
• CLI ワークフローガイド - ワークフローのパターンとベストプラクティス

開発と統合

• 機能開発ワークフロー
• Claude コマンドガイド
• 組織構成ガイド
• 開発ガイド

統合オプション

単独での使用

Scopecraft を直接使用して、任意のプロジェクトで MDTM ファイルを管理できます。TOML または YAML のフロントマターを含む標準 MDTM 形式に対応しています。

Roo Commander との併用

直接的な CRUD 操作を提供することで、Roo Commander の LLM ベースの管理を補完します。MCP サーバーを使用すると、Markdown を解析せずに効率よくタスクを操作できます。

プロジェクトタイプの検出

プロジェクトタイプを自動的に検出し、それに応じて動作を調整します。特別な設定は必要ありません。

クレジット

Scopecraft は、Roo Commander が作成した Markdown-Driven Task Management（MDTM）形式を実装しています。Markdown ファイルでのタスク管理に標準化されたこの形式に感謝します。

ライセンス

MIT