agentsclimarketplace

Architecture guardrails

Skill Gentleman-Programming/engram/skills/architecture-guardrails

Architecture guardrails for Engram across local store, cloud sync, dashboard, and plugins. Trigger: Any change that affects system boundaries, ownership, state flow, or cross-package responsibilities.From its SKILL.md

Install
npx -y skills add Gentleman-Programming/engram --skill architecture-guardrails

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its file declares

Copied from the file, not written here

The file declares its own license as Apache-2.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

1.5 KB, as published. Nobody here has run it

When to Use

Use this skill when:

  • Adding a new subsystem or major package
  • Moving responsibilities between local store, cloud, dashboard, or plugins
  • Changing sync flow, source-of-truth rules, or persistence boundaries

Core Guardrails

  1. Local SQLite is the source of truth; cloud is replication and shared access.
  2. Keep plugin/adaptor layers thin; real behavior belongs in Go packages.
  3. Prefer explicit boundaries: store, cloudstore, server, dashboard, autosync.
  4. New features must fit the existing local-first mental model before they fit the UI.
  5. Do not hide cross-system coupling inside helpers or templates.

Decision Rules

  • Local-only concern -> internal/store
  • Cloud materialization or org-wide control -> internal/cloud/cloudstore
  • HTTP contract or enforcement -> internal/cloud/cloudserver
  • Browser rendering and UX -> internal/cloud/dashboard
  • Background orchestration -> internal/cloud/autosync

Validation

  • Add regression tests for every boundary change.
  • Verify local, remote, and dashboard behavior still tell the same product story.
  • If the change touches sync, test both push and pull paths.

Keep looking

Skills are one crate of 613,373. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.