Skip to content
Agent Memory
Skill

/plugin-thin

Adapter boundary rules for plugin integrations. Trigger: Changes in plugin scripts/hooks for Claude, OpenCode, Pi, Gemini, or Codex.

From plugin
engram
8.1k20 skills

Claude Code

$ npx -y skills add Gentleman-Programming/engram --skill plugin-thin --agent claude-code

SKILL.md

plugin-thin.SKILL.md
name: engram-plugin-thin
description: >
  Adapter boundary rules for plugin integrations.
  Trigger: Changes in plugin scripts/hooks for Claude, OpenCode, Pi, Gemini, or Codex.
license: Apache-2.0
metadata:
  author: gentleman-programming
  version: "1.0"

When to Use

Use this skill when:

  • Editing plugin hooks/scripts/adapters
  • Adding passive/active memory capture integrations
  • Wiring agent-specific setup behavior

---

Boundary Rules

1. Keep adapters thin: parse input, call API/tool, return. 2. Put complex logic in Go core (`store/server/mcp`). 3. Avoid extra runtime dependencies in plugin scripts. 4. Reuse a shared contract across all supported agents.

---

Narrow Pi Exception: Observation-Save Acknowledgement Recovery

`plugin/pi` native `mem_save` may resolve only an ambiguous acknowledgement because the Go server cannot observe that a client lost one. Go remains the sole authority for the durable ledger, canonical fingerprint, validation, conflicts, tombstones, retention, and mutation effects.

  • Generate one operation UUID before the initial dispatch and freeze the exact

redacted payload and both destinations.

  • On ambiguity, query only authoritative `GET /observations/save-result`.

A typed `404` with code `observation_save_result_not_found` permits one exact replay after the cancellable 250 ms backoff. A positive replay receipt succeeds immediately; only an ambiguous replay, including a replay `409` or `410`, gets one final GET.

  • Keep existing total-deadline and caller-cancellation bounds. A lookup confirms

success only with a positive ID and `status: "committed"`; a successful initial POST retains legacy positive `{id}` acknowledgement compatibility.

  • Initial received HTTP errors remain typed and never replay or self-heal.

Caller cancellation is propagated; unresolved write uncertainty remains unknown, never saved.

  • This exception grants no other route or tool retry authority, no general retry

framework, no local business ledger decision, and no telemetry exemption. Timing telemetry may not log the operation UUID; it grants no broader logging permission or change to existing user-facing unknown-outcome diagnostics that expose it for read-only lookup.

---

Compatibility Checklist

  • [ ] Claude Code flow still works
  • [ ] OpenCode flow still works
  • [ ] Gemini/Codex config paths remain valid
  • [ ] Docs reflect real integration behavior
Read more
@gentleman-programming
Ships withengram

Persistent memory system for AI coding agents. Agent-agnostic Go binary with SQLite + FTS5, MCP server, HTTP API, CLI, and TUI.

Stars on GitHub

Momentum

stars in total
8.1k
Star history of Gentleman-Programming/engram on GitHub, a chart by star-history.com

Other skills on engram.

memory

memory

ALWAYS ACTIVE — Selective persistent memory: preserve verified, durable knowledge worth reconstructing, with safe topic updates…

branch-pr

branch-pr

PR creation workflow for Engram following the issue-first enforcement system. Trigger: When creating a pull request, opening a…

More skills from other plugins.

agent-cost-report

agent-cost-report

Believable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude…

@thedotmack@thedotmackInstall Skill
bot-handoff

bot-handoff

Keep a durable record of work passed between Bots in the shared Hindsight memory bank. Use when handing work to another Bot, when…

@vectorize-io@vectorize-ioInstall Skill
mempalace

mempalace

Install, configure, and operate MemPalace, including a private local palace, a shared-brain hub, or a client joining an existing…

@mempalace@mempalaceInstall Skill
mempalace

mempalace

Install, configure, and operate MemPalace, including a private local palace, a shared-brain hub, or a client joining an existing…

@milla-jovovich@milla-jovovichInstall Skill

Questions about plugin-thin.

Which coding agents can use plugin-thin?
plugin-thin installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.