Skip to content

docs: add the write-your-first-plugin walkthrough - #260

Merged
jouwdan merged 1 commit into
mainfrom
claude/mei-115-xt6308-docs
Aug 26, 2026
Merged

docs: add the write-your-first-plugin walkthrough#260
jouwdan merged 1 commit into
mainfrom
claude/mei-115-xt6308-docs

Conversation

@jouwdan

@jouwdan jouwdan commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

Part of MEI-115 (deliverable 3 of 4: the authoring journey). Follows #258 (scaffolds) and #259 (smoke).

What this adds

docs/customization/first-plugin.md — the tutorial-shaped page the ticket asks for, taking an author from an empty directory to a listed plugin:

scaffold → change a hook → test it → install it into a board → publish → submit to the marketplace.

The existing customization pages are policy and reference: plugins.md says what a plugin may and may not do, and plugin-hooks.md lists every hook. Neither shows the path through them, which is the blank page a third-party author actually faces. This page assumes both exist and links out rather than restating them.

Registered in apps/web/content/docs.manifest.json and linked from docs/README.md (both the task table and the customization list); pnpm site:docs regenerated the root README table.

Two details worth flagging for review:

Validated

pnpm site:docs:check, pnpm docs:index:check and pnpm docs:links:check all pass (43 documents, 733 headings, every internal link and anchor resolves).

🤖 Generated with Claude Code

https://claude.ai/code/session_01G22SRRgkUV7doefmw9NMNf


Generated by Claude Code

The policy pages say what a plugin may do and the generated reference
lists every hook, but nothing walked an author from an empty directory to
a plugin running inside a board. This is that path: scaffold, change a
hook, test it, install it into a board, publish it, and submit it to the
marketplace.

Registered in the docs manifest and linked from the index, so the site
publishes it alongside the policy pages.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01G22SRRgkUV7doefmw9NMNf
@jouwdan
jouwdan merged commit c675908 into main Aug 26, 2026
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants