Skip to content
Back to search

core

Native deterministic engine and read-only MCP server for engineering decisions.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/asdecided--core/badge.svg)](/listings/asdecided--core)

HTML

<a href="/listings/asdecided--core"><img src="/api/listings/asdecided--core/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install the native engine and MCP server through Homebrew:

brew install asdecided/tap/asdecided-core

Rust users can install the `decided` CLI directly from crates.io:

cargo install decided
cargo install decided-mcp

`cargo install` compiles from source. To install the prebuilt release binaries instead, use [`cargo binstall`](https://github.com/cargo-bins/cargo-binstall). Crates published after v0.31.0 point it at the GitHub release archives:

cargo binstall decided decided-mcp

Windows users can install both native executables through Scoop:

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

Native `decided` and `decided-mcp` archives are also published on [GitHub Releases](https://github.com/asdecided/core/releases). The Linux archives (x86_64 and aarch64) need glibc 2.17 or newer, so they run on RHEL/CentOS 7 and later, Amazon Linux 2 and 2023, and current Debian and Ubuntu releases.

Python API consumers should use the [`asdecided/sdk`](https://github.com/asdecided/sdk) client SDK. It talks to the native engine; this repository does not ship a second Python engine or a PyPI package.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 151 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # AsDecided
  2. **Engineering decisions your agents can follow. Build, as decided.**
  3. AsDecided keeps requirements, decisions, designs, roadmaps, and prompts as
  4. typed Markdown in your repository. Its native Rust engine validates that
  5. knowledge, retrieves relevant decisions deterministically, and serves it
  6. read-only to agents over MCP.
  7. No embeddings, model call, hosted index, or Python runtime is required. The
  8. same repository state produces the same answer.
  9. [Product site](https://asdecided.com/) · [Documentation](https://asdecided.com/docs/start-here/) · [Canonical sources](https://asdecided.com/sources) · [Changelog](https://asdecided.com/changelog)
  10. ## Install
  11. Install the native engine and MCP server through Homebrew:
  12. ```sh
  13. brew install asdecided/tap/asdecided-core
  14. ```
  15. Rust users can install the `decided` CLI directly from crates.io:
  16. ```sh
  17. cargo install decided
  18. cargo install decided-mcp
  19. ```
  20. `cargo install` compiles from source. To install the prebuilt release binaries
  21. instead, use [`cargo binstall`](https://github.com/cargo-bins/cargo-binstall).
  22. Crates published after v0.31.0 point it at the GitHub release archives:
  23. ```sh
  24. cargo binstall decided decided-mcp
  25. ```
  26. Windows users can install both native executables through Scoop:
  27. ```powershell
  28. scoop bucket add asdecided https://github.com/asdecided/scoop-bucket
  29. scoop install asdecided
  30. ```
  31. Native `decided` and `decided-mcp` archives are also published on
  32. [GitHub Releases](https://github.com/asdecided/core/releases).
  33. The Linux archives (x86_64 and aarch64) need glibc 2.17 or newer, so they run
  34. on RHEL/CentOS 7 and later, Amazon Linux 2 and 2023, and current Debian and
  35. Ubuntu releases.
  36. Python API consumers should use the
  37. [`asdecided/sdk`](https://github.com/asdecided/sdk) client SDK. It talks to the
  38. native engine; this repository does not ship a second Python engine or a PyPI
  39. package.
  40. ## Start a repository
  41. ```sh
  42. decided quickstart
  43. decided validate decisions/
  44. decided gate decisions/
  45. decided gate decisions/ --code --base origin/main
  46. ```
  47. New repositories use:
  48. ```text
  49. .decided/config.yaml
  50. decisions/
  51. ```
  52. Existing artifact IDs such as `RAC-ABC123DEF456` are durable identities and do
  53. not change with the product name.
  54. ## Federate corpora
  55. Manifest version 2 composes several pinned, materialised parent corpora into
  56. one source-aware DAG while preserving every source, diamond route, override,
  57. and read-only boundary:
  58. ```sh
  59. decided corpus status decisions/
  60. decided corpus explain organization/standards::ADR-01K000000001 decisions/
  61. ```
  62. Federation is fully offline and forge-neutral: the engine consumes verified
  63. working-tree bytes, not GitHub APIs or a hosted index. See the
  64. [federation guide](docs/federation.md) and
  65. [runnable multi-parent example](examples/federation/).
  66. ## Migrate an existing repository
  67. Migration is explicit and never runs during an ordinary command:
  68. ```sh
  69. decided migrate layout . --dry-run
  70. decided migrate layout .
  71. ```
  72. The migration moves `.rac/` to `.decided/` and `rac/` to `decisions/`. It
  73. refuses to overwrite either destination.
  74. ## MCP
  75. The official MCP Registry identity is `io.github.asdecided/core`.
  76. Its Registry package is the versioned local MCP image under
  77. `ghcr.io/asdecided/core`; Homebrew and Cargo remain direct native installation
  78. paths for the same Rust server.
  79. The OCI server still needs an explicit repository grant:
  80. ```sh
  81. docker run --rm -i -v "$PWD:/work:ro" \
  82. ghcr.io/asdecided/core:mcp-latest --root /work
  83. ```
  84. ```json
  85. {
  86. "mcpServers": {
  87. "asdecided": {
  88. "command": "decided-mcp",
  89. "args": ["--root", "."]
  90. }
  91. }
  92. }
  93. ```
  94. ## Architecture
  95. Rust is the product engine and the only CLI/MCP runtime in this repository.
  96. The authoritative language-neutral compatibility fixtures live in
  97. [`asdecided-spec`](https://github.com/asdecided/spec). Live-corpus validation is
  98. based on validity, determinism, freshness, and cache/no-cache equality.
  99. Document ingestion remains an ancillary Python connector rather than part of
  100. the core engine. The retired Python engine is preserved for historical review
  101. at the immutable
  102. [`python-engine-final`](https://github.com/asdecided/core/tree/python-engine-final)
  103. tag; it is not maintained or run in normal CI.
  104. ## License
  105. Apache-2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE).
  106. ## Governance and continuity
  107. AsDecided core is solo-maintained and supported on a best-effort basis. The
  108. project does not depend on a hosted service: adopters keep their Markdown
  109. corpus in their own git repository, while the Apache-2.0 implementation and
  110. language-neutral specification remain public. See [GOVERNANCE.md](GOVERNANCE.md)
  111. for the maintainer, release, support, and continuity posture.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.