Validation-as-Code

davidahmann/fde-guide

FDE Guide 是由 davidahmann 创建的一个面向 Forward Deployed Engineers (FDEs) 和内部应用 AI 团队的技术框架与工程套件。其核心目标是将模糊的操作性问题转化为受支持、可测量且持续运行的 AI 服务。该指南采用三层深度架构：指南层面向领导者、学习者和架构师，提供思维模型、原则和能力路线图；手册层面向一线 FDE，包含生命周期操作手册和人类可读库；工程套件层面向工程师和运维，提供 JSON Schema 模板和可执行参考系统。整个方法建立在“价值工程”哲学之上，强调以被接受的结果为产品，代币仅是输入，自主性仅为设计选择，并通过 12 Factors of AI Value Engineering 将价值契约工程化。仓库采用“Validation-as-Code”设计，内置 Node.js 测试套件，不仅校验代码正确性，还强制治理完整性，如确保每个发布清单关联有效的评估报告。核心工件包括 catalog.json 作为受治理工件注册表，llms.txt 作为文件索引，AGENTS.md 定义 AI 代理修改仓库的规则。环境要求 Node.js ≥ 22，通过 npm ci 和 npm test 验证本地环境。该仓库为 AI 部署工程师提供了一套从原则到自动化验证的端到端实践方法。