AsDecided

AsDecided

エージェントが従えるエンジニアリング上の決定。決定どおりに構築しましょう。

AsDecided は、要件、決定、設計、ロードマップ、プロンプトを、リポジトリ内の型付き Markdown として管理します。ネイティブの Rust エンジンがそのナレッジを検証し、関連する決定を決定論的に検索して、MCP 経由でエージェントに読み取り専用で提供します。

埋め込み、モデル呼び出し、ホスト型インデックス、Python ランタイムは不要です。同じリポジトリの状態からは、常に同じ回答が得られます。

製品サイト · ドキュメント · 正式なソース · 変更履歴

インストール

Homebrew でネイティブエンジンと MCP サーバーをインストールします。

brew install asdecided/tap/asdecided-core

Rust ユーザーは、crates.io から decided CLI を直接インストールできます。

cargo install decided
cargo install decided-mcp

cargo install はソースからコンパイルします。代わりにビルド済みのリリースバイナリをインストールするには、cargo binstall を使用してください。v0.31.0 以降に公開されたクレートは、GitHub のリリースアーカイブを参照します。

cargo binstall decided decided-mcp

Windows ユーザーは、Scoop で両方のネイティブ実行ファイルをインストールできます。

scoop bucket add asdecided https://github.com/asdecided/scoop-bucket
scoop install asdecided

ネイティブの decided および decided-mcp アーカイブも GitHub Releases で公開されています。 Linux アーカイブ（x86_64 および aarch64）には glibc 2.17 以降が必要なため、RHEL/CentOS 7 以降、Amazon Linux 2 および 2023、ならびに現行の Debian および Ubuntu リリースで動作します。

Python API を利用する場合は、クライアント SDK の asdecided/sdk を使用してください。これはネイティブエンジンと通信します。このリポジトリでは、別の Python エンジンや PyPI パッケージは提供していません。

リポジトリを開始する

decided quickstart
decided validate decisions/
decided gate decisions/
decided gate decisions/ --code --base origin/main

新しいリポジトリでは、次を使用します。

.decided/config.yaml
decisions/

RAC-ABC123DEF456 などの既存のアーティファクト ID は永続的な識別子であり、製品名が変わっても変更されません。

コーパスをフェデレーションする

マニフェストのバージョン 2 では、複数の固定済み・実体化済みの親コーパスを 1 つのソース対応 DAG にまとめ、すべてのソース、ダイヤモンド経路、オーバーライド、読み取り専用の境界を保持できます。

decided corpus status decisions/
decided corpus explain organization/standards::ADR-01K000000001 decisions/

フェデレーションは完全にオフラインで、特定のフォージに依存しません。エンジンが使用するのは検証済みのワーキングツリーのバイト列であり、GitHub API やホスト型インデックスではありません。フェデレーションガイドと実行可能な複数親の例を参照してください。

既存のリポジトリを移行する

移行は明示的に実行する必要があり、通常のコマンド実行中に行われることはありません。

decided migrate layout . --dry-run
decided migrate layout .

移行では .rac/ を .decided/ に、rac/ を decisions/ に移動します。どちらかの移行先に上書きすることはありません。

MCP

公式 MCP Registry の識別子は io.github.asdecided/core です。 Registry のパッケージは、バージョン指定されたローカル MCP イメージ ghcr.io/asdecided/core です。Homebrew と Cargo も、同じ Rust サーバーを直接ネイティブにインストールする方法として引き続き利用できます。

OCI サーバーを使用するには、リポジトリへの許可を明示的に指定する必要があります。

docker run --rm -i -v "$PWD:/work:ro" \
  ghcr.io/asdecided/core:mcp-latest --root /work

{
  "mcpServers": {
    "asdecided": {
      "command": "decided-mcp",
      "args": ["--root", "."]
    }
  }
}

アーキテクチャ

Rust は製品エンジンであり、このリポジトリにおける唯一の CLI/MCP ランタイムです。規範となる言語非依存の互換性フィクスチャは、 asdecided-spec にあります。ライブコーパスの検証では、妥当性、決定性、鮮度、キャッシュありとキャッシュなしの一致を基準とします。

ドキュメントの取り込みは、コアエンジンの一部ではなく、補助的な Python コネクターとして残されています。廃止された Python エンジンは、変更不能な python-engine-final タグで履歴確認用に保存されています。メンテナンスはされておらず、通常の CI で実行されることもありません。

ライセンス

Apache-2.0。LICENSE と NOTICE を参照してください。

ガバナンスと継続性

AsDecided core は単独のメンテナーが管理しており、サポートは可能な範囲で提供されます。このプロジェクトはホスト型サービスに依存していません。採用者は自身の git リポジトリで Markdown コーパスを管理し、Apache-2.0 の実装と言語非依存の仕様は公開されたままです。メンテナー、リリース、サポート、継続性に関する方針については、GOVERNANCE.md を参照してください。