atlan-fact-verification-gate

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Atlan Fact Verification Gate

Atlan事实验证门

Create a lightweight verification checkpoint before behavior-changing decisions.
在做出变更行为的决策前创建一个轻量级验证检查点。

Workflow

工作流程

  1. Classify task as
    build
    ,
    modify
    ,
    test
    ,
    review
    , or
    release
    .
  2. Read source guide:
    ../_shared/references/verification-sources.md
    .
  3. Verify only what is required for the current decision:
    • SDK behavior for runtime/data-path decisions.
    • CLI behavior for scaffold/run/test/release commands.
  4. Resolve SDK evidence using portable fallback order:
    • local checkout (if present)
    • installed package source
    • remote source/docs
  5. For build tasks, classify app quality tier (
    quickstart-utility
    or
    connector-standard
    ) using
    ../_shared/references/app-quality-bar.md
    .
  6. Create
    verification_manifest.json
    using
    ../_shared/assets/verification_manifest.json
    as template.
  7. Validate manifest:
    python ../_shared/scripts/validate_verification_manifest.py verification_manifest.json
  8. Continue if status is
    ready
    ; otherwise resolve unknowns or ask user.
  9. If CLI mismatch is found, append proposal entry to
    ../_shared/references/cli-change-proposals.md
    .
  1. 将任务分类为
    build
    modify
    test
    review
    release
  2. 读取源指南:
    ../_shared/references/verification-sources.md
  3. 仅验证当前决策所需的内容:
    • 运行时/数据路径决策验证SDK行为。
    • 脚手架/运行/测试/发布命令验证CLI行为。
  4. 按照以下可移植的优先级顺序获取SDK证据:
    • 本地检出的代码(如果存在)
    • 已安装包的源代码
    • 远程源/文档
  5. 对于构建任务,使用
    ../_shared/references/app-quality-bar.md
    将应用质量等级分类为
    quickstart-utility
    connector-standard
  6. ../_shared/assets/verification_manifest.json
    为模板创建
    verification_manifest.json
  7. 验证清单:
    python ../_shared/scripts/validate_verification_manifest.py verification_manifest.json
  8. 如果状态为
    ready
    则继续,否则解决未知问题或询问用户。
  9. 如果发现CLI不匹配,将提案条目追加到
    ../_shared/references/cli-change-proposals.md

Output Contract

输出约定

  • Produce
    verification_manifest.json
    for non-trivial behavior changes.
  • Record what was inspected, including exact command/flag facts when command behavior matters.
  • Never edit SDK or CLI repositories.
  • 涉及重大行为变更时需生成
    verification_manifest.json
  • 记录所有检查内容,涉及命令行为时需包含准确的命令/参数事实。
  • 禁止编辑SDK或CLI仓库。

References

参考资料

  • Checklist:
    references/checklist.md
  • Artifact schema:
    ../_shared/references/artifact-templates.md
  • Quality bar:
    ../_shared/references/app-quality-bar.md
  • Multi-agent compatibility:
    ../_shared/references/agent-surface-compatibility.md
  • 检查清单:
    references/checklist.md
  • 制品Schema:
    ../_shared/references/artifact-templates.md
  • 质量标准:
    ../_shared/references/app-quality-bar.md
  • 多Agent兼容性:
    ../_shared/references/agent-surface-compatibility.md