Accordo

あなたの営業プロセスをコーディングエージェントに説明し、それが構築するCRMを所有する。

Claude Code、Codex、Gemini CLIが、あなたが所有するコードとしてCRMアプリケーションを生成するために使用するオープンソースフレームワーク — 決定論的ワークフロー、ポリシーゲート付きの人間による承認、監査とトレースが組み込まれている。

名前は選定され、ドメインは登録されている。npm create accordoは、公開されたcreate-accordo@0.1.0から動作するプロジェクトをスキャフォールドする。accordoパッケージ自体は、空の0.0.1の名前予約のままである — フレームワークをライブラリとしてインストールするものはない — そして@accordoスコープは主張されているが、意図的に空である。商標スクリーニングは実行されておらず、プロジェクトは本番環境にデプロイできない。それが正確に何を意味するかは停止する場所にあり、残りを読む前に読む価値がある。

Business request
      ↓  "Renewals of €50,000 or more need a manager's sign-off."
Claude Code / Codex
      ↓  reads AGENTS.md · 12 skills · MCP · `crm app inspect`
Modules + deterministic workflows + versioned policy
      ↓
API + Admin + trace + audit — in your repository, as code you review

Accordoを使うべき場合

• カスタムCRM: 営業プロセスが製品であり、結果が他の誰かのランタイム内の設定ではなくレビュー可能なコードであるべき場合。

• Customer Hub: 「ハブ」が管理されたアクションを持つ1つのローカルな営業記録チェーンを意味する場合。AccordoはCDPのようにソースを取り込んだり、顧客IDを解決したりしない。

• Smart CRM: コーディングエージェントがアプリケーションを構成し、バージョン付きポリシーと指名された人間がビジネス上の決定を保持する場合。エージェントが構築したソフトウェアであり、自律的な意思決定者ではない。

• CDP + CRM: 外部のCDPが取り込み、ID解決、オーディエンスを所有し、Accordoがその隣で決定論的なCRMプロセスレイヤーを所有する場合。AccordoはCDP、コネクタ、インポーター、同期ランタイムを一切提供しない。

これらの隣接用語は検索パスであり、追加の能力の主張ではない。チェックされた推奨マップは、それぞれをフレームワークが証明するものと停止する場所に結び付けている。

Related MCP server: Pathmode

なぜこれが存在するのか

すべてのCRMは、最終的にあなたのプロセスをそのモデルに合わせて曲げるよう求める。通常の2つの逃げ道はどちらも何かを犠牲にする:

• プラットフォームを設定する — 開始は速く、カスタマイズは誰か他のランタイム内のメタデータとして存在する。天井に達すると、モノレポをフォークすることになる。

• ゼロから構築する — 完全な自由だが、すべてのチームが検証、パイプラインセマンティクス、承認、監査を再導出する。通常は遅く、通常はプレッシャーの下で。

このフレームワークは3つ目の選択肢だ: エージェントがアプリケーションを生成し、フレームワークがチームが締め切り下で常に間違える部分を提供する。どの開発者でも適用できるテストは「このプロジェクトが明日消えたら、私は何を残されるのか」という問いだ。ここでの答えは: サードパーティのランタイム依存関係がなく、どのクライアントでも開けるSQLiteファイルを持つ、あなたのリポジトリ内のNodeアプリケーションである。

何が証明されているか

以下の各行はマージ済みのテストに結び付けられている。完全な台帳 — 主張、証拠、そしてそれに伴う限界 — はsite/claims.jsonにあり、その背後にあるレビュー規律はdocs/QUALITY_GATES.mdにある。

スイート全体は、スモークテストとともに、すべてのプッシュで実行される。それが何件のテストだったか、そして測定されたコミットは、site/claims.jsonのmeasuredAgainstの下にある — このリポジトリでテスト件数が書き留められている唯一の場所であり、npm run gtm:checkが数値の出現を許可する唯一の場所である。

実行方法

Node.js 22.16以降。サードパーティのランタイム依存関係はなく、ビルドステップもない。

npm run tour     # compose the whole application and inspect it
npm run verify   # source checks, then the whole test suite
npm run falsify  # break five rules on purpose and watch the suite catch them
npm run demo     # the approval slice, end to end
npm run dev      # http://localhost:4000

npm run tourは、これが実際に何であるかを確認する最も速い方法だ。リポジトリのデフォルト構成は意図的に空である — プロジェクトは自分が望む構成を書く — したがって、新しいクローンでのcrm app inspectは何も報告しない。ツアーはスターターインストーラー(CIが毎回のプッシュで実行するものと同じ)を保持するディレクトリに実行し、その後、結果を検査する:

  modules       76        resources     71        policies       7
  packages       9        actions       64        providers      1

  production posture — local development only: no authentication, tenancy or RBAC
                       exists, and actor headers are not identity

これは、検査官が見ることができない11の項目で締めくくられる。なぜなら、良い半分だけを見せるツアーは、実行する価値がないからだ。npm run tour -- --keep ./demo は探索するプロジェクトを残し、--json は機械可読なレシートを出力する。

npm run falsify は逆の方向だ。テスト数はどれだけ書かれたかを示すが、テストがグリーンのままでいるために何が間違っていなければならないかは示さない。そこで、これは一度に1つのルールを削除する——承認に対する人間アクターのガード、承認閾値の境界、webhook署名検証、ポリシーバージョンの不変性、完全管理モジュールが公開書き込みを生成しないというルール——それを防御すべきスイートを実行し、それを捕捉したテストを指名する。未コミットの変更に対しては実行を拒否し、触れたすべてのファイルを復元する。生き残ったものはすべてギャップとして出力される。それが有用な出力だからだ (docs/FALSIFY.md、tests/falsify.test.js)。

npm run demo は2つの更新を作成し、プッシュのたびに scripts/smoke.js によって検証される:

• €20,000 → 直接 Proposal に移動する。

• €80,000 → マネージャーが決定するまで Approval Pending で停止する。

コーディングエージェントから使う

Claude Code は CLAUDE.md、.mcp.json、.claude/skills/ を読み取る。Codex は AGENTS.md と .codex/config.toml を読み取る。両方ともチェックインされ、相互に結線されている。

Read AGENTS.md, PRODUCT.md and docs/PROJECT_STATUS.md.
Run npm run crm -- app inspect --json.
Tell me which parts of my commercial process this already supports, and which it does not.

ハーネスに必要なのは: コマンドの実行、stdout の読み取り、終了コードの読み取り、JSON の解析、ファイルの読み書きだけだ。MCP サーバーも、ネットワークも、認証情報も、データベースも、長時間稼働するプロセスも不要だ — docs/AGENT_HARNESS_COMPATIBILITY.md。

npm run crm -- app inspect --json          # what this application contains
npm run crm -- solution check plan.json    # is this plan still valid against it

終了コードが契約だ: 0 有効 · 1 問題あり、レポートは出力される · 2 読み取り不能。

MCP サーバーは stdio 上で動作し（node --no-warnings packages/mcp/bin/server.js）、プロジェクト検査、機会一覧、ステージ変更リクエスト、承認決定、実行トレース、モジュールスキャフォールディングを公開する。コード生成ツールと破壊的ツールは、明示的な apply フラグを渡さない限りドライランだ（tests/mcp.test.js、tests/scaffold.test.js — docs/MCP.md）。 これは stdio のみ、ローカルのみだ: ホスト型や認証付きの MCP エンドポイントは存在せず、サーバーはそれを起動したプロセスの権限を継承する。

どこで止まるか

上記の何かを評価する前にこれを読むこと。docs/benchmarks/CRM_JTBD_MATRIX.md は、未サポートがデフォルトであり、そこから離れるには証拠が必要という保守的なステータス語彙で、すべての CRM ジョブを追跡する。

• 認証、テナント、RBAC はなし。 サーバーはローカル開発専用だ。アクターヘッダーはアサーションであり、アイデンティティではない。ネットワークに公開してはならない。

• SQLite のみ。 PostgreSQL は Production Spine トラックにあり、実装されていない。

• ビルドベンチマークは実行されていない。 Successful Agent Build Rate は存在しない。このプロジェクトに帰属するパーセンテージはすべて捏造だ — docs/strategy/CRM_BUILD_BENCHMARK.md はプロトコルであり、結果ではない。

• スケジューラーなし、リマインダーなし、タイマー上のものはなし。 フォローアップタスクとアクティビティタイムラインは1つの共有モデルとして存在し（docs/WORK_TASKS.md）、人がそれらのすべてを動かす: 期日は状態を変更せず、繰り返し発生するものは存在せず、割り当てや通知もなく、更新通知期間は記録されるだけで発火することはない。

• メール、カレンダー、マーケティング統合はなし。 通知プロバイダー契約は存在するが、誰かに何かを送信するアダプターはない。

• インポート、エクスポート、重複排除、マージ、一括編集、保存ビュー、グローバル検索はなし。 すべての商用 CRM で必須の基本機能であり、どれにもまだマイルストーンがない。

• まだ実際の顧客データを入れることはできない。 認証も、テナントも、エクスポートも、消去パスもない — したがって、データ主体のアクセス要求や削除要求にはこれで対応できない。 docs/strategy/DATA_GOVERNANCE.md は設計のみだ。唯一保持されていること: リードスコアリングは決定的で、バージョン管理され、説明可能であり、人物に対するモデルの判断ではない。

• これはフレームワークであり、サインアップする製品ではない。 ホスト型 CRM も、無料ティアも、アカウントもない。出力は、あなたが実行するアプリケーションだ。

• 所有とはベンダーソースを意味する: 依存関係として bump するフレームワークはない。 npm create accordo — 公開されている create-accordo@0.1.0 — は、起動し、app inspect から valid を報告し、project doctor から 0 で終了するプロジェクトを、フレームワークソースをコピーしてスキャフォールドする。同じブートストラップはチェックアウトからも実行される （node packages/create-accordo/bin/create-accordo.js <dir> --apply、インストール不要、ネットワーク不要 — tests/project-bootstrap.test.js）。レジストリが渡すのはスキャフォルダーであり、フレームワークではない: accordo パッケージは意図的に空の 0.0.1 名前予約だ。フレームワークはプロジェクトにベンダーソースされるため、結果を完全に所有できる — そしてアップグレードはバージョンの bump ではなくマージを意味する。

5つのフォルダで見るアーキテクチャ

packages/core/        the runtime platform: registry, services, workflow engine, audit
packages/modules/     CRM domain primitives
packages/domains/     optional domain packages (contracts, delivery) on a public contract
packages/mcp/         tools and context exposed to coding agents
apps/                 API server and generated Admin

エージェントはデータベーステーブルに書き込むことはない。検証、アクターアイデンティティ、ポリシー、トレース、監査を保持するサービスメソッドと名前付きワークフローを呼び出す — ARCHITECTURE.md。

ドキュメント

ライセンス

MIT、ADR-023 によって確認済み。