Plugin 2.2.0: troubleshoot skill, new-app emits AGENTS.md + CLAUDE.md - #269
Merged
Conversation
New troubleshoot skill covers the everyday failure loop: a symptom table keyed on the framework's real error messages (docstring enforcement, AgentConfig.client validation, per-provider role/mode errors, HTTP_STREAM, history misuse) with mechanical fixes and a mandatory re-run verification. The framework skill routes concrete errors to it; escalation map points into the reference files. new-app now scaffolds an AGENTS.md (framework conventions + provider quirk line) and a one-line CLAUDE.md @AGENTS.md shim into every generated project, so any coding assistant picks up the conventions from the first commit. Quickstart guide gains a "Set Up Your Project for AI Coding Assistants" section with the same drop-in pair for existing projects plus both skill install paths. Plugin README "What you get" was still describing the 2.0 layout (two skills); now lists all seven. plugin.json and marketplace.json bumped to 2.2.0, changelog folds the unreleased items into the release. Verified: claude plugin validate passes; npx skills local discovery shows exactly the 7 plugin skills with the maintainer release skill still hidden. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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.
What
Final slice of the AI DX upgrade (after #267, #268). New consumer-facing plugin content, shipped as plugin 2.2.0.
troubleshootskill. The everyday loop where generic assistants get the framework wrong is "my agent errors or returns garbage." The new skill carries a symptom table keyed on the framework's real error messages, pulled from source, not paraphrased: theBaseIOSchemadocstring enforcement string,AgentConfig.clientPydantic validation (raw SDK client), per-provider role/mode failures (Geminiassistant_role, Anthropicmax_tokens, Groq/Ollama JSON mode),HTTP_STREAMvs the nonexistentSTREAMABLE_HTTP, history misuse, unbounded context (fix:max_context_tokens), blockingget_info(). Every entry has a mechanical fix and the workflow mandates a re-run before declaring victory.frameworkroutes concrete errors here; an escalation map points into the reference files for unmatched cases.new-appscaffolds agent instructions. Every generated project now gets anAGENTS.md(framework conventions + a provider-specific quirk line) and a one-lineCLAUDE.mdcontaining@AGENTS.md— the documented, Windows-safe pattern (Claude Code doesn't read AGENTS.md natively, verified against current docs). Quickstart guide gets the same drop-in pair for existing projects, plus both skill install paths.Housekeeping. Plugin README's "What you get" still described the 2.0 layout (two skills); it now lists all seven.
plugin.json/marketplace.json→ 2.2.0, changelog folds the unreleased items (rebrand, MiniMax M3, Copilot CLI fix, release-skill hiding) into the release.Verified
claude plugin validatepassesnpx skills add <local-path> --list: exactly the 7 plugin skills, maintainerreleaseskill still hiddenbase_io_schema.py,mcp_definition_service.py,atomic_agent.py,chat_history.py)../framework/references/*.md)🤖 Generated with Claude Code