Decouple example templates from the plugin install - #18
Open
houfu wants to merge 3 commits into
Open
Conversation
Cowork no longer loads skills from a project's bundled .claude/skills/, which broke the folder-download install path the docs were built around. Rewrite install/positioning to lead with the plugin marketplace in both Cowork and Claude Code, and polish the plugin manifests for marketplace listing quality (semver placeholder, homepage, repository, license, keywords, tags). Refs #17.
The plugin install was shipping templates alongside the engine, which coupled template release cycles to engine releases and bloated every marketplace install. Stop bundling all three example templates (Bonterms_Mutual_NDA, invoice, meeting_notes); the plugin now ships skills + scripts only. Example templates are released as a new coquill-examples-v*.zip artifact (plus a coquill-examples-latest.zip alias) so users can grab them in one click and unzip into their project's templates/ folder. The orchestrator's template discovery collapses to a single tier (templates/) since there is no longer a bundled fallback to merge with. Install docs and the quickstart gain a "get a starter template" step pointing at the new download. Reference and guide pages drop "bundled" framing. The unversioned coquill-latest.zip alias for the Cowork fork-starter zip is removed (versioned coquill-v*.zip stays).
When a user installs CoQuill into a project with no templates, the previous flow dead-ended at "no templates found, here is a download URL" and forced them to leave the chat to grab the zip. Push that work back into the conversation: when discovery hits an empty templates/, the orchestrator now asks permission, probes for curl and unzip on PATH, and runs the fetch-and-unzip in one step before resuming template matching. Manual download stays documented as a fallback for sandboxed environments. Install docs and the quickstart are reframed around the conversational flow. The standalone "Get a starter template" step is gone; the manual download lives in a sandboxed/offline Aside. The quickstart's "Prepare the NDA" gains a step showing Claude's offer-and-confirm exchange and the existing steps are renumbered.
Owner
Author
|
Closes #17 |
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
2 participants
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.
Summary
Three connected changes that reshape how a new user gets from "install CoQuill" to "render a document":
73b531e). Updated install docs, README, and feature-tour pages to lead with/plugin marketplace add houfu/coquillrather than the old "open folder as Cowork project" flow. The Cowork zip remains as a fork-starter on releases but is demoted in the docs.a7e1815). The build script copies skills + scripts only;plugin/templates/is removed from the working tree and from every release artifact. Example templates ship instead as a newcoquill-examples-v*.zip(with acoquill-examples-latest.zipalias) attached to each release. The unversionedcoquill-latest.zipCowork-zip alias is dropped. Discovery in the orchestrator collapses to a single tier (templates/) since there is no longer a bundled fallback.c1276ad). When discovery finds an emptytemplates/, the orchestrator asks permission, probes forcurl/unzip, and runs the fetch-and-unzip in one step before resuming template matching. Manual download stays documented as a fallback Aside for sandboxed/offline environments.Reference and guide pages drop "bundled" framing throughout. The quickstart's "Prepare the NDA" gains a step showing Claude's offer-and-confirm exchange.
Test plan
bash scripts/build-plugin.shproduces aplugin/tree with notemplates/subdircd docs && npm run build— 22 pages build clean( cd templates/_examples && zip -r /tmp/x.zip . )producesBonterms_Mutual_NDA/,invoice/,meeting_notes/at archive root (matches the workflow'scoquill-examples-v*.zipstep)/plugin marketplace add houfu/coquill+/plugin install coquill@coquilltemplates/folder yet — confirm orchestrator asks permission, runscurl+unzip, lands the three example dirs intemplates/, then resumes template matchingunzip, confirm orchestrator detects this up front and falls back to the manual download Asidecoquill-plugin-v*.zip,coquill-v*.zip,coquill-examples-v*.zip, plus the-latestaliases for plugin and examples (Cowork zip's unversioned alias intentionally gone)https://claude.ai/code/session_01PC9t7uCA4VFjXhjHBAqx4s
Generated by Claude Code