Update plugin creation agent guidance#10
Merged
eric-tramel merged 2 commits intomainfrom May 6, 2026
Merged
Conversation
johnnygreco
approved these changes
May 6, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Updates
.claude/commands/create-plugin.mdso the plugin creation command reflects the current repository structure,ddpscaffold output, Makefile target names, and Zensical documentation workflow.Adds
.codex/skills/data-designer-plugin-authoring/SKILL.mdas a Codex-native project skill for the same Data Designer plugin authoring flow.Why
The existing Claude command had drifted from the repo: it referenced stale paths and targets such as
docs/adding-a-plugin.mdandmake catalog, and it did not explain how to prepare per-plugin docs for the generated Zensical site.Usage
Claude command example:
Codex skill usage: ask Codex to create, update, or document a Data Designer plugin in this repo. The skill points Codex to the current repo guidance, scaffold flow, implementation conventions, validation targets, and per-plugin Zensical docs format.
Per-plugin docs should live under
plugins/data-designer-<slug>/docs/, typically withindex.mdand optionallyusage.md, then be regenerated and checked with:How
The Claude command was rewritten around the current
AGENTS.md,docs/authoring.md,docs/workflow.md,devtools/ddpscaffold,plugin_docs.py, and Makefile targets. The new Codex skill mirrors the same guidance in project-skill format under.codex/skills/.Validation
make syncmake formatmake lintmake testmake validatemake checkmake docsgit diff --cached --checkAdditional Codex skill smoke test:
codex execsession in/tmp/ddp-codex-skill-test.hgHHHM/DataDesignerPluginsagainst the current PR branch.vowel-countplugin with config, implementation, tests, and per-plugin docs.plugins/data-designer-vowel-count/, consistent withuv run ddp new vowel-count, then edited the generated files rather than hand-assembling the initial skeleton.make format,make test-plugin PLUGIN=data-designer-vowel-countwith 17 tests,make lint,make validate,make check,make docs, and fullmake testacross the template and new plugin.