Agentic Forge

The Forge That Designs Before It Builds

Complete project architecture -- entities, operations, dependencies, file layout, skeletons, and tests -- before any code is generated.

Quickstart · Problems Solved · How It Works · Capabilities · MCP Tools · Benchmarks · Install · API · Concepts · Paper

______________________________________________________________________

Agentra生态系统中的姐妹| .forge 格式| 32功能| 15 MCP工具| 41 CLI命令

为什么选择AgenticForge

每个AI代理都从空白页编写代码。在开始键入之前，它不知道项目结构。它猜测实体关系。它创造了依赖关系。它以先出现的任何顺序生成文件。由此产生的架构是不一致的、未经测试的、脆弱的——因为它从未被设计过。

当前的修复程序不起作用。快速工程会给你提示——永远不会有一个完整的架构。模板生成器生成刚性脚手架，打破了力矩要求的变化。手动架构文档在生成第一个文件的那一刻就过时了。

当前AI： 生成代码时不了解它正在构建的项目。 AgenticForge： 首先设计完整的蓝图——每个实体、每个操作、每个依赖关系、每个文件、每个测试——然后生成在严格的约束下填补空白。

AgenticForge 从自然语言意图创建完整的项目蓝图。不是“生成项目”。您的代理有 建筑师 --实体推理、依赖解析、文件结构规划、代码骨架生成和测试架构——在任何实现开始之前都已解决。

已解决的问题（请先阅读）

• 问题： AI代理在不理解项目结构的情况下生成代码。

解决了的： 蓝图引擎在编写任何代码之前将意图分解为层、实体、操作和依赖关系——代理总是知道架构。

• 问题： 实体关系被猜测，导致数据模型不一致。

解决了的： 通过关系映射和字段推导的实体推理从自然语言描述中生成一致的数据模型。

• 问题： 依赖关系是临时的，发现版本冲突的时间较晚。

解决了的： 通过版本解析和冲突检测进行依赖推理，可以在第一行代码之前发现问题。

• 问题： 生成的文件结构混乱且不稳定。

解决了的： 通过导入图分析和模块层次结构生成文件结构，可以生成干净、可测试的项目布局。

• 问题： 测试覆盖率是一种事后的想法，在一代人之后才加上。

解决了的： 测试架构是蓝图的一部分——测试用例、夹具、集成计划和模拟规范与它们测试的代码一起设计。

• 问题： 每次都从头开始重新构建相同的项目类型。

解决了的： 蓝图捕获了可重用的架构决策 .forge 可以调整而不是重新创建的文件。

# Design your architecture, then build with confidence -- four commands
aforge blueprint create my-api --domain api --description "REST API for task management"
aforge entity infer  "Users create tasks assigned to teams with deadlines"
aforge structure generate 
aforge test generate 

四个命令。一个完整的架构。一 .forge 文件包含所有内容。适用于Claude、GPT、Ollama或您接下来切换到的任何LLM。

______________________________________________________________________

运作原理

建筑

v0.1.0 --蓝图引擎基础设施。

AgentForge是一个Rust原生蓝图引擎，它将项目架构视为一级数据。实体之间存在关系。操作有签名。依赖项有版本。测试有目标。

核心能力

• 层分解 --将意图分解为架构层（表示、应用程序、域、基础设施），层之间有依赖规则。
• 实体推断 --从自然语言项目描述中提取实体、字段、关系和验证规则。
• 操作设计 --推断每个实体的CRUD操作、查询模式、异步边界和错误流。
• 结构生成 --为目标语言生成文件结构、导入图形、模块层次结构和配置布局。
• 依赖解析 --从域和实体分析中推断依赖关系，解析版本，提取API规范，并检测冲突。
• 骨架生成 --生成具有函数签名、契约和生成顺序规划的类型优先代码骨架。
• 部件接线 --映射组件依赖关系、数据流、初始化序列和关闭序列。
• 测试体系结构 --生成测试用例、夹具、集成测试计划和模拟规范以及他们测试的代码。

架构概述

+-------------------------------------------------------------+
|                     YOUR AI AGENT                           |
|           (Claude, Cursor, Windsurf, Cody)                  |
+----------------------------+--------------------------------+
                             |
                  +----------v----------+
                  |      MCP LAYER      |
                  |   15 Tools + stdio  |
                  +----------+----------+
                             |
+----------------------------v--------------------------------+
|                    FORGE ENGINE                              |
+-----------+-----------+------------+-----------+------------+
| Write     | Query     | 32         | Blueprint | Token      |
| Engine    | Engine    | Capabilities| Validator | Conservation|
+-----------+-----------+------------+-----------+------------+
                             |
                  +----------v----------+
                  |     .forge FILE     |
                  | (your architecture) |
                  +---------------------+

蓝图生命周期

Intent -> Decompose -> Infer Entities -> Design Operations -> Resolve Deps
  |                                                                    |
  +-- Structure -> Skeleton -> Wire Components -> Generate Tests ------+
                                                                       |
                                                              .forge file

发动机启动时 意图，解析自然语言项目描述。 分解 将关注点分层。 推断实体 提取数据模型。 设计操作 创建函数签名。 解决Deps问题 决定图书馆。 结构 规划文件布局。 骨架 生成类型优先的代码。 电线 映射组件依赖关系。 生成测试 设计测试架构。结果是便携式 .forge 包含完整蓝图的文件。

______________________________________________________________________

32功能

AgenticForge提供32种能力，分为八个层次，具体程度越来越高：

完整功能文档->

______________________________________________________________________

MCP工具

AgenticForge曝光 15个MCP工具 对于AI代理：

蓝图工具

实体工具

依赖工具

生成工具

完整的MCP文档->

______________________________________________________________________

基准测试

Resolve dependencies

aforge dependency resolve

Generate file structure and skeletons

aforge structure generate aforge skeleton create

Generate test architecture

aforge test generate

Validate the blueprint

aforge blueprint validate

Export

aforge export json

______________________________________________________________________

## MCP服务器

aforge serve --mode stdio

兼容Claude Desktop、Cursor、Windsurf、VS Code、Cody和任何MCP客户端。

______________________________________________________________________

## 安装

### 源自源头

git clone https://github.com/agentralabs/agentic-forge.git cd agentic-forge cargo install --path crates/agentic-forge-cli

### 快速安装

curl -fsSL https://agentralabs.tech/install/forge | bash

配置文件变体：

curl -fsSL https://agentralabs.tech/install/forge/desktop | bash # Claude Desktop + Cursor curl -fsSL https://agentralabs.tech/install/forge/terminal | bash # CLI only curl -fsSL https://agentralabs.tech/install/forge/server | bash # Server mode with auth npm install @agenticamem/forge

**独立担保：** AgentForge完全独立运行。不需要其他姐妹、外部服务或协调器。

______________________________________________________________________

## 构建和测试

cargo build --workspace cargo test --workspace # 519 tests

______________________________________________________________________

## 文档

- [快速启动](docs/public/quickstart.md)
- [概念](docs/public/concepts.md)
- [CLI参考](docs/public/cli-reference.md)
- [MCP工具](docs/public/mcp-tools.md)
- [API 参考](docs/public/api-reference.md)
- [建筑](docs/public/architecture.md)
- [配置](docs/public/configuration.md)
- [FFI参考](docs/public/ffi-reference.md)
- [集成指南](docs/public/integration-guide.md)
- [基准测试](docs/public/benchmarks.md)
- [常见问题解答](docs/public/faq.md)
- [故障排除](docs/public/troubleshooting.md)

______________________________________________________________________

## 许可证

麻省理工学院——见 [许可证](LICENSE).