Skip to content

Restructure install/publish templates around user journeys#17

Merged
discreteds merged 13 commits intomainfrom
feature/install-publish-template-restructure
Apr 28, 2026
Merged

Restructure install/publish templates around user journeys#17
discreteds merged 13 commits intomainfrom
feature/install-publish-template-restructure

Conversation

@discreteds
Copy link
Copy Markdown
Member

Summary

  • Replaced 3 overlapping template sets (install, adding-platform, publishing — 19 files) with 2 audience-based sets (install/, publish/ — 14 files + 2 headers)
  • Install templates follow consistent user journeys: Registry → GitHub → Local clone → Verify
  • Publish templates are author-only: Prerequisites → Submit to registry → Team distribution — no install commands
  • Deleted adding-platform/ entirely — "install from local clone" covers that use case
  • Fixed factual errors in pattern reference file: Antigravity OpenVSX removal, Gemini CLI auto-discovery mechanism, fabricated Codex $skill-installer install commands, stale extension count
  • Regenerated INSTALL.md and PUBLISHING.md from corrected templates

What changed

Before After
3 template directories (install, adding-platform, publishing) 2 directories (install/, publish/)
Random command collections per platform Consistent journey structure
Publishing templates contained install commands Clean audience separation
Antigravity templates referenced OpenVSX/vsix Skill-based install only
19 template files + 2 generated outputs 15 template files + 2 generated outputs

Test plan

  • Verify find lib/templates/install-docs -type f | wc -l returns 15
  • Verify grep -rn "antigravity --install-extension\|OpenVSX\|skill-installer install" lib/templates/ INSTALL.md PUBLISHING.md returns nothing
  • Verify INSTALL.md has consistent ### Install from GitHub / ### Install from local clone / ### Verify sections for all 6 platforms
  • Verify PUBLISHING.md contains zero install commands
  • Verify Phase 7 glob lib/templates/install-docs/**/*.md still matches all template files

🤖 Generated with Claude Code

discreteds and others added 13 commits April 28, 2026 14:30
…r, Gemini CLI

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…, OpenClaw

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Fix publishing-and-discoverability.md: Gemini auto-discovery, stale
  extension count, fabricated Codex commands, Antigravity OpenVSX removal
- Remove "OpenVSX" from Antigravity platform description in skill
- Add design spec and implementation plan for template restructure

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Antigravity: replace fabricated `antigravity --install-extension` with
  actual skill copy command
- Codex: fix `codex marketplace add` → `codex plugin marketplace add`

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Architecture overview + 7-phase checklist with verification gates.
Addresses Codex review findings: hardcoded platform list coverage,
template variable set expanded to match actual usage.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Also includes the design spec and implementation plan.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- .cursor-plugin/plugin.json: add missing ] for keywords array
- Platform specs: fix MD001 heading increment (h3 → h2 for
  platform-specific notes sections)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@discreteds discreteds merged commit ed92e99 into main Apr 28, 2026
3 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.

1 participant