mcpField
E
engram-architecture-guardrails

engram-architecture-guardrails

github.com/gentleman-programming开发7.7k73 次安装今天更新
代码仓库

关于 engram-architecture-guardrails

供新增子系统或调整 Engram 存储、云端、仪表板、插件及同步边界的开发者使用。它明确组件职责,并要求通过回归测试验证本地、远程和仪表板行为。

主要功能

  1. 01以本地 SQLite 为事实来源
  2. 02明确存储与云端边界
  3. 03保持插件和适配层精简
  4. 04指导职责划分
  5. 05为边界变更添加回归测试

适用场景

  1. 01新增子系统或主要软件包
  2. 02调整持久化或事实来源规则
  3. 03修改本地与云端之间的同步流程

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/gentleman-programming/engram --skill engram-architecture-guardrails

安装后在 Claude Code 中输入/engram-architecture-guardrails确认已加载。

详细介绍

适用场景

在以下情况下使用此技能:

  • 添加新的子系统或主要软件包
  • 在本地存储、云端、仪表板或插件之间转移职责
  • 更改同步流程、事实来源规则或持久化边界

核心准则

  1. 本地 SQLite 是事实来源;云端用于复制和共享访问。
  2. 保持插件/适配器层精简;实际行为应放在 Go 软件包中。
  3. 明确划分边界:store、cloudstore、server、dashboard、autosync。
  4. 新功能必须先符合现有的本地优先理念,再适配 UI。
  5. 不要将跨系统耦合隐藏在辅助程序或模板中。

决策规则

  • 仅限本地的事项 -> internal/store
  • 云端物化或组织级控制 -> internal/cloud/cloudstore
  • HTTP 合约或强制执行 -> internal/cloud/cloudserver
  • 浏览器渲染和 UX -> internal/cloud/dashboard
  • 后台编排 -> internal/cloud/autosync

验证

  • 每次边界变更都要添加回归测试。
  • 确认本地、远程和仪表板的行为仍传达一致的产品理念。
  • 如果变更涉及同步,请测试推送和拉取流程。

评论

支持 Markdown