codespring

CodeSpring CLI

ワークスペース、プロジェクト、タスク、PRD、マインドマップなど、プロジェクト計画を管理します。

前提条件

• CLI のインストール：npm i -g @codespring-app/cli を実行するか、npx @codespring-app/cli を使用します
• 認証済みであること：codespring auth status を実行して確認します。codespring auth login でログインします
• プロジェクトがリンク済みであること：.codespring/config.json があるか確認するか、codespring init を実行します

クイックスタート

# 1. Check auth
codespring auth status

# 2. Link project (interactive — picks workspace → project → writes config)
codespring init

# 3. Start working
codespring tasks --status todo

主なコマンド

コマンド	目的
codespring workspaces	利用可能なワークスペースを一覧表示
codespring projects [--org ID]	プロジェクトを一覧表示
codespring project create --name <n>	新しいプロジェクトを作成
codespring features	リンク済みプロジェクトの機能を一覧表示
codespring feature create --title <t>	機能を作成
codespring tasks [--status S] [--feature ID]	フィルターを指定してタスクを一覧表示
codespring task create --title <t> [--priority P]	タスクを作成
codespring task start <id>	タスクを in_progress に設定
codespring task done <id>	タスクを done に設定
codespring task update <id> --status <s>	タスクのフィールドを更新
codespring prds	機能別に PRD を一覧表示
codespring prd <id>	PRD の全内容を取得
codespring prd sync <id> --file <path>	ファイルから PRD を更新
codespring mindmap	マインドマップの構造を取得
codespring mindmap set-info --title <t>	プロジェクト情報ノードを更新
codespring mindmap tech-stack --add '<json>'	技術スタックを同期
codespring mindmap features --add '<json>'	機能を同期
codespring mindmap note <featureId> --text '...'	機能のメモを追加
codespring schema	データスキーマのリファレンス
codespring node-types	マインドマップのノードタイプのリファレンス

**注：**タスク ID には UUID または行番号を指定できます（例：task start 1 は、一覧の最初のタスクを選択します）。

出力

すべてのコマンドは、ターミナルではデフォルトで Markdown を、パイプで渡された場合は JSON を出力します。 --json を追加すると JSON を強制し、--pretty を追加すると整形済み JSON を、--md を追加すると Markdown を出力します。

エージェント型タスクのワークフロー

# 1. Find available work
codespring tasks --status todo

# 2. Claim a task (UUID or row number)
codespring task start 1

# 3. Do the work using your coding tools

# 4. Mark done
codespring task done 1

# Or create a new task
codespring task create --title "Fix login bug" --priority high

コードベース分析の同期

コードベースの分析後、分析結果を同期します。

# Sync detected technologies
codespring mindmap tech-stack --add '[{"id":"tech-react","title":"React","description":"Frontend"}]'

# Sync discovered features
codespring mindmap features --add '[{"title":"Authentication","description":"User login/signup"}]'

# Add analysis notes to a feature
codespring mindmap note feature-auth --text "Uses OAuth2 with PKCE flow..."

PRD の生成

CLI は PRD の読み取りと同期を行いますが、まだ生成には対応していません。PRD を生成し、PRD ノードをキャンバスに追加する処理は、CodeSpring アプリが使用する直接の API 呼び出しです。prd-management.md と mindmap-structure.md を参照してください。cs-build-create-prd スキルを使うと、この一連の処理を実行できます。

スクリプト — 目視で判断せず、チェックを実行する

チェックはスクリプトで、判断は文章で行います。 実行のたびに同じ結果になる必要がある処理は、scripts/ に配置し、読み取り専用で、プロジェクトにもリポジトリにも何も書き込みません。

bash scripts/fetch-project.sh --out /tmp/cs-state   # snapshot the linked project's JSON; prints the projectId
node scripts/state.mjs        /tmp/cs-state         # the one-line state summary + booleans and counts
node scripts/check-map.mjs    /tmp/cs-state [--expect-core N]   # map quality + post-write verification

check-map.mjs は、主要機能の数、タイトルの重複、トップレベルにフラット化されたサブ機能、メモの欠落、PRD の重複、未リンクのタスクを判定します。終了コード 1 は実際の失敗、2 は警告のみを示します。マップが 適切かどうか — サイドバー階層の機能、動詞を使ったサブ機能、1 文で記述されたカードの説明 — は判断事項であり、文章で扱います。cs-build-audit-codebase/scripts/check-repo.sh は、Git とデリバリーの実態について同じ役割を果たします。

詳細なリファレンス

• project-state.md — まずここから始めてください。 どのスキルでもどの状態からでも開始できるようにする状態判定、コードを基に開発する価値があるかを決める5つの質問、Understand → Plan → Build の各段階とその境界、マップ品質に関する注意点と2プロジェクトのケース、簡単な健全性チェック
• auditing-and-fixing.md — audit → verdict → map → tasks のパイプライン、監査エラーの実際の原因（オーケストレーター自身による要約）、変化し続ける対象とGitの実情、マップに目標を示す理由、再構築か修正かを決める判断表とユーザー有無の条件、調査する価値のある不具合カテゴリ、スコープの規律（problems / could-add-later / not-worth-adding）と将来のアイデアの保存場所、平易な言葉のルール、冪等性と検証、FERBのエッジケース
• commands.md — すべてのフラグを含むCLIリファレンス
• task-workflow.md — エージェントによるタスク実行パターン
• analyze-codebase.md — コードベース分析チェックリスト（スタックの検出と、機能・バックエンド・フロントエンドの詳細な分析、および最小限のコア機能セットの選定）
• mindmap-structure.md — マインドマップのデータ形式とノードタイプ（PRDブリッジノードを含む）
• prd-management.md — PRDの読み取り・同期、および生成・添付・重複排除
• pitfalls.md — 失敗パターンとガードレール（既存のものを確認しない、プロジェクトの取り違え、平坦化、PRDの重複、features --replaceによる追記、プロジェクトの削除・移動ができない）

関連スキル

このcodespringスキルは、共有ナレッジベース（CodeSpringの仕組みとCLI）です。タスク固有のスキルはこれを基盤とします。どのスキルも、開始時にプロジェクトの実際の状態を判定します（project-state.md）。そのため、ユーザーがどのスキルを呼び出しても問題ありません。

• cs-build-getting-started — 接続し、プロジェクトの実際の状況を報告して、次に行うべき唯一の手順を提示します。2つの質問で振り分けます。コードがあるか、そしてそのコードが目的を果たしているか（project-state.mdの5つの質問。「信頼できるか」は問いません）。
• cs-build-plan-app — まだコードがない状態で、アイデアや通話録音だけがある場合に使用します。情報を聞き取るかソースを分析し、機能に基づいてプラットフォームを選び、難所となる1点を検証し、販売可能なv1に絞り込んでから、マップとメモを作成します。
• cs-build-audit-codebase — 目的を果たしていないコードベースを診断します（実行、専門エージェントによる並列調査、Git/CI監査）。平易な英語でFINDINGS.mdを作成し、再構築するか、現在のコードベースを修正するかの判断を提示します。
• cs-build-import-codebase — リポジトリをCodeSpringにマッピングします。監査がある場合は、修正済みの目標マップと、調査結果に基づくタスクを作成します。監査がない場合は、現状を記録します。マップ品質の段階とノードモデルを管理します。
• cs-build-ui-mockup — メモを基に、使い捨てのクリック可能なモックアップとスタイルガイドを作成します。クライアントと確認し、修正内容をプランに反映します。ユーザーインターフェースがあるものでは、PRDの作成前に使用します。
• cs-build-create-prd — 選択した機能のFrontend/Backend PRDを生成します（PRD作成における唯一の信頼できる情報源）。
• cs-build-create-tasks — 機能のPRDを、番号付きで並列実行に対応したタスクリストに変換します。
• cs-build-handoff — 完成したプランを、料金を支払うクライアントに実際に渡すパッケージにまとめます。
• cs-build-feature — 対話型のビルドオーケストレーター（準備状況の確認 → 最大5つのサブエージェント → 失敗リスクのガード）。
• cs-build-resync-codebase — CodeSpringを構築済みコードと同期させます（コードは読み取り専用）。タスク完了後に、目標マップを再び実際の状態と一致させるために使います。

Webアプリのみで必要となる手順をユーザーに案内する方法についてはreferences/codespring-docs.mdを、プラットフォームごとのCLAUDE.mdスターターについては（リポジトリのルートにある）claude-templates/を参照してください。