Claude Code workflow

Signal Foundry は、Claude Code から CLI + JSON + 必要なときだけ HTTP API で使うのが最短です。このページでは、ユーザーが Claude Code に渡すときの実務フローを固定します。

基本ルール

• 最初に sf version --json --check-update と sf auth show --json で前提を見る
• 次に sf data capabilities --json で supported / weak / unsupported / needs_human を確認する
• 会社群や営業候補は sf list plan で実行可能条件へ落としてから sf list estimate に進む
• 取得は常に --json を付ける
• テーマ語だけの依頼は、保存前に sf observations search --source edinet または sf job sales-list で evidence を確認する
• materialize と enrich は estimate 後に --execute --max-credits を付ける
• candidate preview は export しない
• profile や filings の前に必ず companies search を使う
• 保存しない横断テーマ探索だけ sf observations search を使う
• 失敗時は error.code error.hint error.suggested_next_commands を次アクションに使う

Claude Code が 1 セッションでやること

1. sf version --json --check-update で CLI が古くないか確認する
2. sf auth show --json で接続前提を確認する
3. sf data capabilities --json で利用可能 source を確認する
4. 自然文の job を 会社リスト作成 1社調査 有報差分 保存済み見直し のどれかに分ける
5. 必要なら sf <surface> --help を読む
6. 会社群なら plan / estimate / candidates / materialize を進める
7. 1 社調査なら company_id や filing_id を解決する
8. JSON の要点だけを要約する
9. 必要なら website enrich / export まで進める

Claude Code に渡す最小 prompt

Signal Foundry を使って企業調査を進めてください。

進め方:
1. `sf version --json --check-update`
2. `sf auth show --json`
3. `sf data capabilities --json`
4. 会社群なら `sf list plan "<query>" --json`
5. `sf list estimate "<query>" --json`
6. `sf list candidates --from-estimate <estimateId> --json`
7. 保存するなら `sf list materialize --from-estimate <estimateId> --execute --max-credits <n> --json`
8. 追加情報なら `sf list enrich <listId> --source website --estimate --json`
9. 実行するなら `sf list enrich <listId> --source website --execute --max-credits <n> --json`
10. export するなら `sf list export <listId> --format csv --output ./exports/list.csv --json`

ルール:
- 出力は JSON の要点を短く要約する
- 失敗したら `error.hint` と `suggested_next_commands` に従って自己修復する
- Preview URL は使わない
- API キーは chat に貼り付けない。必要な接続設定は terminal 側で `sf auth setup --base-url https://signal-foundry.app` を済ませておく
- 1 社調査なら `sf job company-research <query> --execute --json` から始める

セッション開始時にやること

設定をジョブごとに分けると、Claude Code が混線しにくくなります。

export SIGNAL_FOUNDRY_CONFIG_PATH="$PWD/.signal-foundry/config.json"
sf auth setup --base-url https://signal-foundry.app
sf auth show --json

基本ループ

会社が分かっているとき:

sf companies search 7203 --json
sf company profile jpx_7203 --json
sf company observations jpx_7203 --limit 5 --json

テーマから入りたいとき:

sf observations search "生成AI" --source edinet --limit 10 --observations-per-company 3 --json
sf job sales-list "生成AI CRM に反応している上場SaaS" --execute --json

保存まで進める場合は、テーマ evidence を確認してから sf list plan "<criteria>" --json と sf list estimate "<criteria>" --json で件数と credit を固定します。今年上場した会社 のような上場日条件は、source_coverage に listing_events が入るか確認し、coverage gap があれば代替条件を提案してください。

確認する key

• version.current と version.updateAvailable
• auth.effectiveBaseUrl と auth.effectiveApiKeyPreview
• capabilities[].source_id と capabilities[].status
• plan.status と plan.unsupported_conditions
• estimate.estimate_id
• billing.materialize.estimated_credits
• list.list_id
• rows[]
• run.resolved_count
• run.review_required_count
• company_summary
• evidence_gaps
• run.run_id
• export.sha256

保存と見直しまで進めるとき

候補企業を見つけた後に あとで見返せる状態 まで作るなら、Claude Code には次を追加で実行させます。

sf list enrich <listId> --source website --estimate --json
sf list enrich <listId> --source website --execute --max-credits 100 --json
sf list export <listId> --format csv --output ./exports/list.csv --json

新しい会社リスト作成は estimate -> candidates -> materialize を優先します。list preview / publish / refresh / diff は saved List の current public surface です。delivery handoff は advanced API surface として扱い、approval workflow と full monitor はまだ deferred 側です。

Claude Code が止まりにくい運用

• コマンドに迷ったら sf <surface> --help
• company_not_found なら sf companies search <query> --json
• 401 や 429 なら sf auth show --json
• query が長すぎるなら、自然文をやめて短い token と filter に分解する