内容
# AsDecided
**您的代理可以遵循的工程决策。 构建，如决定。**
AsDecided 将需求、决策、设计、路线图和提示以 Markdown 格式存储在您的仓库中。其本地 Rust 引擎验证该知识，确定性地检索相关决策，并通过 MCP 以只读方式提供给代理。
无需嵌入、模型调用、托管索引或 Python 运行时。相同的仓库状态产生相同的答案。
## 安装
通过 Homebrew 安装本地引擎和 MCP 服务器：
```sh
brew install asdecided/tap/asdecided-core
```
本地 `decided` 和 `decided-mcp` 存档也在 [GitHub Releases](https://github.com/asdecided/core/releases) 上发布。
`rac-core` 不再通过 PyPI 分发。Python API 使用者应使用 [`asdecided/sdk`](https://github.com/asdecided/sdk)，它是一个客户端 SDK，而不是第二个引擎实现。
## 启动仓库
```sh
decided quickstart
decided validate decisions/
decided gate decisions/
```
新仓库使用：
```text
.decided/config.yaml
decisions/
```
现有的工件 ID（如 `RAC-ABC123DEF456`）是持久标识符，不会随着产品名称的更改而改变。
## 迁移现有仓库
迁移是显式的，永远不会在普通命令期间运行：
```sh
decided migrate layout . --dry-run
decided migrate layout .
```
迁移将 `.rac/` 移动到 `.decided/`，将 `rac/` 移动到 `decisions/`。它拒绝覆盖任一目标。
## MCP
```json
{
"mcpServers": {
"asdecided": {
"command": "decided-mcp",
"args": ["--root", "."]
}
}
}
```
## 架构
Rust 是产品引擎，也是此仓库中唯一的 CLI/MCP 运行时。权威的语言中立兼容性装置位于 [`asdecided-spec`](https://github.com/asdecided/spec) 中。实时语料库验证基于有效性、确定性、 freshness 和缓存/非缓存相等性。
文档摄取仍然是一个辅助的 Python 连接器，而不是核心引擎的一部分。已弃用的 Python 引擎在不可变的 [`python-engine-final`](https://github.com/asdecided/core/tree/python-engine-final) 标签处保留，以供历史审查；它不维护或在正常 CI 中运行。
## License
Apache-2.0。参见 [LICENSE](LICENSE) 和 [NOTICE](NOTICE)。
