{
  "markdown": "# AsDecided\n\n**Engineering decisions your agents can follow. Build, as decided.**\n\nAsDecided keeps requirements, decisions, designs, roadmaps, and prompts as\ntyped Markdown in your repository. Its native Rust engine validates that\nknowledge, retrieves relevant decisions deterministically, and serves it\nread-only to agents over MCP.\n\nNo embeddings, model call, hosted index, or Python runtime is required. The\nsame repository state produces the same answer.\n\n[Product site](https://asdecided.com/) · [Documentation](https://asdecided.com/docs/start-here/) · [Canonical sources](https://asdecided.com/sources) · [Changelog](https://asdecided.com/changelog)\n\n## Install\n\nInstall the native engine and MCP server through Homebrew:\n\n```sh\nbrew install asdecided/tap/asdecided-core\n```\n\nRust users can install the `decided` CLI directly from crates.io:\n\n```sh\ncargo install decided\ncargo install decided-mcp\n```\n\nWindows users can install both native executables through Scoop:\n\n```powershell\nscoop bucket add asdecided https://github.com/asdecided/scoop-bucket\nscoop install asdecided\n```\n\nNative `decided` and `decided-mcp` archives are also published on\n[GitHub Releases](https://github.com/asdecided/core/releases).\n\nPython API consumers should use the\n[`asdecided/sdk`](https://github.com/asdecided/sdk) client SDK. It talks to the\nnative engine; this repository does not ship a second Python engine or a PyPI\npackage.\n\n## Start a repository\n\n```sh\ndecided quickstart\ndecided validate decisions/\ndecided gate decisions/\ndecided gate decisions/ --code --base origin/main\n```\n\nNew repositories use:\n\n```text\n.decided/config.yaml\ndecisions/\n```\n\nExisting artifact IDs such as `RAC-ABC123DEF456` are durable identities and do\nnot change with the product name.\n\n## Federate corpora\n\nManifest version 2 composes several pinned, materialised parent corpora into\none source-aware DAG while preserving every source, diamond route, override,\nand read-only boundary:\n\n```sh\ndecided corpus status decisions/\ndecided corpus explain organization/standards::ADR-01K000000001 decisions/\n```\n\nFederation is fully offline and forge-neutral: the engine consumes verified\nworking-tree bytes, not GitHub APIs or a hosted index. See the\n[federation guide](docs/federation.md) and\n[runnable multi-parent example](examples/federation/).\n\n## Migrate an existing repository\n\nMigration is explicit and never runs during an ordinary command:\n\n```sh\ndecided migrate layout . --dry-run\ndecided migrate layout .\n```\n\nThe migration moves `.rac/` to `.decided/` and `rac/` to `decisions/`. It\nrefuses to overwrite either destination.\n\n## MCP\n\nThe official MCP Registry identity is `io.github.asdecided/core`.\nIts Registry package is the versioned local MCP image under\n`ghcr.io/asdecided/core`; Homebrew and Cargo remain direct native installation\npaths for the same Rust server.\n\nThe OCI server still needs an explicit repository grant:\n\n```sh\ndocker run --rm -i -v \"$PWD:/work:ro\" \\\n  ghcr.io/asdecided/core:mcp-latest --root /work\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"asdecided\": {\n      \"command\": \"decided-mcp\",\n      \"args\": [\"--root\", \".\"]\n    }\n  }\n}\n```\n\n## Architecture\n\nRust is the product engine and the only CLI/MCP runtime in this repository.\nThe authoritative language-neutral compatibility fixtures live in\n[`asdecided-spec`](https://github.com/asdecided/spec). Live-corpus validation is\nbased on validity, determinism, freshness, and cache/no-cache equality.\n\nDocument ingestion remains an ancillary Python connector rather than part of\nthe core engine. The retired Python engine is preserved for historical review\nat the immutable\n[`python-engine-final`](https://github.com/asdecided/core/tree/python-engine-final)\ntag; it is not maintained or run in normal CI.\n\n## License\n\nApache-2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE).\n\n## Governance and continuity\n\nAsDecided core is solo-maintained and supported on a best-effort basis. The\nproject does not depend on a hosted service: adopters keep their Markdown\ncorpus in their own git repository, while the Apache-2.0 implementation and\nlanguage-neutral specification remain public. See [GOVERNANCE.md](GOVERNANCE.md)\nfor the maintainer, release, support, and continuity posture.\n",
  "bytes": 4219,
  "sha": "0904c2953c33a99b187e31cb57abcf9e22c559a96b05763c61a4207784104554",
  "repo_slug": "asdecided/core",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_asdecided_core_162b0f68/readme"
}