Skip to content

Repository files navigation

VibeFlow

English

VibeFlow 把 AI 参与开发的程序组织成可执行、可检查、可生成架构视图的显式流程图。业务逻辑位于小型 Node 中,Config 声明控制流,端口契约声明数据流,Core 在运行或构建前验证结构。

terminal start → input I/O → process / nodeset → output I/O → terminal end

VibeFlow comprehensive flowchart

主要能力

  • Python Runtime 与 JavaScript/TypeScript AOT;
  • Node、Nodeset、Loop、Plugin、Capability 与显式副作用边界;
  • 确定性 Architecture、Mermaid、ASCII 和 SVG;
  • 配置、契约、可达性、控制流、质量、构建与执行证据检查;
  • collaborative 与 autonomous 两种开发协议,共享同一 Core 和机器规则。

VibeFlow 检查工程结构,不代替项目的业务测试、需求验收或外部接口语义验证。

开始使用

从 GitHub Release 下载所需发行包并解压:

  • vibeflow-distribution-0.13.2.zip:人机协同审核;
  • vibeflow-distribution-autonomous-0.13.2.zip:无人值守开发。

打开解压目录后,AI 从根 AGENTS.md 获得任务阅读路径;人类从 kernel/docs/README.md 进入使用者手册。两个包都包含最小的 python_project/ 和 javascript_project/。

Python 最短验证:

python run.py validate --config python_project/configs/main.jsonc
python run.py run --config python_project/configs/main.jsonc --input python_project/probe_input.json

JavaScript 最短验证:

npm ci --prefix javascript_project
python run.py build --config javascript_project/configs/main.jsonc --target node --profile esm-module --out-dir javascript_project/build/node
node javascript_project/scripts/workflow_execution_probe.mjs

文档

源码仓库完整门禁:

python tools/verify_project.py --full

当前包版本为 0.13.2,Workflow ABI 为 vibeflow.workflow.v4。

About

Executable flowchart guardrails for AI-assisted coding and vibe coding.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages