关于 engram-architecture-guardrails
供新增子系统或调整 Engram 存储、云端、仪表板、插件及同步边界的开发者使用。它明确组件职责,并要求通过回归测试验证本地、远程和仪表板行为。
主要功能
- 01以本地 SQLite 为事实来源
- 02明确存储与云端边界
- 03保持插件和适配层精简
- 04指导职责划分
- 05为边界变更添加回归测试
适用场景
- 01新增子系统或主要软件包
- 02调整持久化或事实来源规则
- 03修改本地与云端之间的同步流程
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ gentleman-programming/ engram --skill engram-architecture-guardrails安装后在 Claude Code 中输入/engram-architecture-guardrails确认已加载。
详细介绍
适用场景
在以下情况下使用此技能:
- 添加新的子系统或主要软件包
- 在本地存储、云端、仪表板或插件之间转移职责
- 更改同步流程、事实来源规则或持久化边界
核心准则
- 本地 SQLite 是事实来源;云端用于复制和共享访问。
- 保持插件/适配器层精简;实际行为应放在 Go 软件包中。
- 明确划分边界:store、cloudstore、server、dashboard、autosync。
- 新功能必须先符合现有的本地优先理念,再适配 UI。
- 不要将跨系统耦合隐藏在辅助程序或模板中。
决策规则
- 仅限本地的事项 ->
internal/store - 云端物化或组织级控制 ->
internal/cloud/cloudstore - HTTP 合约或强制执行 ->
internal/cloud/cloudserver - 浏览器渲染和 UX ->
internal/cloud/dashboard - 后台编排 ->
internal/cloud/autosync
验证
- 每次边界变更都要添加回归测试。
- 确认本地、远程和仪表板的行为仍传达一致的产品理念。
- 如果变更涉及同步,请测试推送和拉取流程。
评论
支持 Markdown