feat: complete the nddev-builder toolkit and teach ZCode's real loading model#26
Merged
Merged
Conversation
…ading model
The authoring skills taught the pre-fix loading model: they told developers to
place components in ~/.zcode/marketplaces/<mp>/plugins/, which ZCode 3.3.6 never
loads. A developer following them reproduced the exact bug the installer's
user-scope flatten fixed. This corrects the toolkit to teach the real model and
fills its gaps.
- Add nddev-builder-orientation: the single map of the toolkit and how ZCode
discovers/loads skills/commands/agents at user scope, what the installer
flattens (and what it does not), the install/remove/switch lifecycle, and the
fail-closed cross-plugin basename collision rule.
- Add add-instructions (AGENTS.md user/workspace scopes and merge order) and
validate-components (static pre-install checks incl. the cross-plugin
collision that aborts a build), each with a /nddev-* command.
- Correct add-skill, add-plugin, add-tool, add-mcp-server, add-hook, add-command,
add-agent, the README, and the zcode-native-format reference to state the
user-scope flatten reality, the collision rule, absolute installed paths for
tools/hooks (not flattened, no ${CLAUDE_PLUGIN_ROOT}), the correct strict hook
output schema (allow/ask/deny/additionalContext), and disable-noninteractive.
Claude-Session: https://claude.ai/code/session_01Y29c9sJRhChvxDcUjab5Xo
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
1 participant
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.
Why
The
nddev-builderauthoring skills taught the pre-fix loading model — they told developers to place components in~/.zcode/marketplaces/<mp>/plugins/, which ZCode 3.3.6 never loads. A developer following them reproduced the exact bug the installer's user-scope flatten just fixed. This makes the toolkit complete, self-orienting, and correct against ZCode 3.3.6.What
nddev-builder-orientationskill (/nddev-orient): the single map — toolkit layout, how ZCode discovers/loads skills/commands/agents at user scope, what the installer flattens (and what it doesn't: references, tools, MCP, hooks), the install/remove/switch lifecycle, and the fail-closed cross-plugin basename collision rule.add-instructions(AGENTS.md scopes + merge order) andvalidate-components(static pre-install checks incl. the collision that aborts a build), each with a/nddev-*command.add-skill,add-plugin,add-tool,add-mcp-server,add-hook,add-command,add-agent, the README, and thezcode-native-formatreference: user-scope flatten reality, collision rule, absolute installed paths for tools/hooks (not flattened, no${CLAUDE_PLUGIN_ROOT}), the strict hook output schema (allow/ask/deny/additionalContext), anddisable-noninteractive.Verification
Marketplace validators pass (
validate_public_contracts,validate_zcode_components, markdown fences); the private harness marketplace-structure/lifecycle/list/runtime tests pass (the exact-surface set was updated for the 3 new components).https://claude.ai/code/session_01Y29c9sJRhChvxDcUjab5Xo