core/AGENTS.md

Core SDK

Go module git.dev.alexdunmow.com/block/core. Defines plugin interfaces, template engine, block registry, and shared types for the BlockNinja CMS.

Critical Rules

• NEVER use replace directives in go.mod — not in this repo, not in any consumer. All module resolution goes through the Gitea module proxy. If you need to test local changes, tag and push a version.
• Plugins import from core only — never from the CMS (blockninja/backend) or orchestrator.
• All consumers are in-house — no backwards compatibility shims needed. Just change the API and update consumers.