Carlos Florêncio
51 lines
2.0 KiB
Markdown
51 lines
2.0 KiB
Markdown
---
|
|
id: "03-agent-discoverability"
|
|
title: "Agent plugin discoverability"
|
|
status: completed
|
|
wave: 3
|
|
depends_on: ["02-contract-reconciliation"]
|
|
plan: "plan.md"
|
|
spec: "../../specs/plugins/requirements/authoring-experience.md"
|
|
---
|
|
|
|
# Task 03: Agent plugin discoverability
|
|
|
|
## Acceptance
|
|
|
|
1. Root, backend, and web `AGENTS.md` each link directly to the canonical guide
|
|
and identify the contract authorities relevant to their scope.
|
|
2. 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.
|
|
3. All focused documentation, harness, backend package, and frontend plugin-host
|
|
checks pass, with exact results recorded in the plan.
|
|
|
|
## Verification
|
|
|
|
```sh
|
|
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.
|