Root, backend, and web AGENTS.md each link directly to the canonical guide
and identify the contract authorities relevant to their scope.
The existing create-kandev-plugin skill follows the canonical guide,
reflects implemented Host writes, and sends agents through choose recipe →
edit manifest → implement → validate → package → smoke test.
All focused documentation, harness, backend package, and frontend plugin-host
checks pass, with exact results recorded in the plan.
Verification
rg -n "docs/public/plugins-authoring.md|PLUGIN-API.md|apps/web/lib/plugins/types.ts|pkg/pluginsdk|plugin.proto|internal/plugins/manifest" AGENTS.md apps/backend/AGENTS.md apps/web/AGENTS.md .agents/skills/create-kandev-plugin/SKILL.md
node --test scripts/validate-public-docs.test.mjs
node scripts/validate-public-docs.mjs
make -C apps/backend e2e-plugin-package
(cd apps/backend && go test ./cmd/plugin-pack ./cmd/plugin-fixture ./internal/plugins/manifest ./internal/plugins/pkgtar ./pkg/pluginsdk)(cd apps && pnpm --filter @kandev/web test -- lib/plugins/host-api.test.ts lib/plugins/host.test.ts lib/plugins/registry.test.ts lib/ws/plugin-bridge.test.ts)
git diff --check
Files likely touched
AGENTS.md
apps/backend/AGENTS.md
apps/web/AGENTS.md
.agents/skills/create-kandev-plugin/SKILL.md
this plan and its task files
Results
Root, backend, and web AGENTS now link directly to the canonical guide and
identify the frontend pair, backend SDK, proto, manifest, and package
authorities.
create-kandev-plugin now routes through the same guide, current Host write
behavior, unavailable-API notes, and layered validation scope.
Stale-reference audit and git diff --check passed.
Carlos Florêncio