john/claude-engineering-plugin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Add /release-docs command, changelog page, and build instructions

Browse Source 
- Add /release-docs command for regenerating documentation site
- Add commands/README.md with usage instructions for all commands
- Add changelog.html page rendering CHANGELOG.md in HTML format
- Add changelog CSS styles to docs.css
- Update navigation in all docs pages to include changelog link
- Fix command count from 16 to 13 in navigation
- Update CLAUDE.md with:
  - Documentation Site section explaining structure
  - /release-docs command in update checklist
  - Instructions for keeping docs up-to-date

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Claude
2025-11-26 16:39:54 +00:00
parent 53ba12f0ca
commit 92d0e23768
10 changed files with 1074 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

162
plugins/compounding-engineering/docs/css/docs.css
View File

@@ -511,3 +511,165 @@
z-index: -1;
}
}
/* ============================================
Changelog Styles
============================================ */
.version-section {
margin-bottom: var(--space-xxl);
padding-bottom: var(--space-xl);
border-bottom: 1px solid var(--color-border);
}
.version-section:last-child {
border-bottom: none;
}
.version-header {
display: flex;
align-items: center;
gap: var(--space-m);
margin-bottom: var(--space-l);
flex-wrap: wrap;
}
.version-header h2 {
margin: 0;
padding: 0;
border: none;
font-size: var(--font-size-xl);
color: var(--color-text-primary);
}
.version-date {
font-size: var(--font-size-s);
color: var(--color-text-tertiary);
background-color: var(--color-surface);
padding: var(--space-xs) var(--space-m);
border-radius: var(--radius-s);
}
.version-badge {
font-size: var(--font-size-xs);
font-weight: 600;
padding: var(--space-xs) var(--space-m);
border-radius: var(--radius-s);
background-color: var(--color-accent);
color: white;
}
.version-badge.major {
background-color: var(--color-warning);
}
.version-description {
font-size: var(--font-size-m);
color: var(--color-text-secondary);
margin-bottom: var(--space-l);
font-style: italic;
}
.changelog-category {
margin-bottom: var(--space-l);
padding: var(--space-l);
background-color: var(--color-surface);
border-radius: var(--radius-m);
border-left: 4px solid var(--color-border);
}
.changelog-category h3 {
margin: 0 0 var(--space-m) 0;
font-size: var(--font-size-m);
display: flex;
align-items: center;
gap: var(--space-s);
}
.changelog-category h3 i {
font-size: var(--font-size-s);
}
.changelog-category h4 {
margin: var(--space-l) 0 var(--space-s) 0;
font-size: var(--font-size-s);
color: var(--color-text-secondary);
}
.changelog-category ul {
margin: 0;
padding-left: var(--space-xl);
}
.changelog-category li {
margin-bottom: var(--space-s);
}
.changelog-category.added {
border-left-color: var(--color-success);
}
.changelog-category.added h3 {
color: var(--color-success);
}
.changelog-category.improved {
border-left-color: var(--color-accent);
}
.changelog-category.improved h3 {
color: var(--color-accent);
}
.changelog-category.changed {
border-left-color: var(--color-warning);
}
.changelog-category.changed h3 {
color: var(--color-warning);
}
.changelog-category.fixed {
border-left-color: var(--color-error);
}
.changelog-category.fixed h3 {
color: var(--color-error);
}
.version-summary {
margin-top: var(--space-l);
}
.version-summary h4 {
margin-bottom: var(--space-m);
}
.version-summary table {
width: 100%;
max-width: 400px;
border-collapse: collapse;
font-size: var(--font-size-s);
}
.version-summary th,
.version-summary td {
padding: var(--space-s) var(--space-m);
text-align: left;
border-bottom: 1px solid var(--color-border);
}
.version-summary th {
font-weight: 600;
background-color: var(--color-surface);
}
.version-summary .positive {
color: var(--color-success);
font-weight: 600;
}
.version-summary .negative {
color: var(--color-error);
font-weight: 600;
}

8
plugins/compounding-engineering/docs/pages/agents.html
View File

@@ -34,11 +34,17 @@
<h3>Reference</h3>
<ul>
<li><a href="agents.html" class="active">Agents (24)</a></li>
<li><a href="commands.html">Commands (16)</a></li>
<li><a href="commands.html">Commands (13)</a></li>
<li><a href="skills.html">Skills (11)</a></li>
<li><a href="mcp-servers.html">MCP Servers (2)</a></li>
</ul>
</div>
<div class="nav-section">
<h3>Resources</h3>
<ul>
<li><a href="changelog.html">Changelog</a></li>
</ul>
</div>
<div class="nav-section">
<h3>On This Page</h3>
<ul>

476
plugins/compounding-engineering/docs/pages/changelog.html Normal file
View File

@@ -0,0 +1,476 @@
<!DOCTYPE html>
<html lang="en" class="theme-dark">
<head>
<meta charset="utf-8" />
<title>Changelog - Compounding Engineering</title>
<meta content="Version history and release notes for the Compounding Engineering plugin." name="description" />
<meta content="width=device-width, initial-scale=1" name="viewport" />
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.1/css/all.min.css" />
<link href="../css/style.css" rel="stylesheet" type="text/css" />
<link href="../css/docs.css" rel="stylesheet" type="text/css" />
<script src="../js/main.js" type="text/javascript" defer></script>
</head>
<body>
<div class="background-gradient"></div>
<div class="docs-layout">
<aside class="docs-sidebar">
<div class="sidebar-header">
<a href="../index.html" class="nav-brand">
<span class="logo-icon"><i class="fa-solid fa-layer-group"></i></span>
<span class="logo-text">CE Docs</span>
</a>
</div>
<nav class="sidebar-nav">
<div class="nav-section">
<h3>Getting Started</h3>
<ul>
<li><a href="getting-started.html">Installation</a></li>
</ul>
</div>
<div class="nav-section">
<h3>Reference</h3>
<ul>
<li><a href="agents.html">Agents (24)</a></li>
<li><a href="commands.html">Commands (13)</a></li>
<li><a href="skills.html">Skills (11)</a></li>
<li><a href="mcp-servers.html">MCP Servers (2)</a></li>
</ul>
</div>
<div class="nav-section">
<h3>Resources</h3>
<ul>
<li><a href="changelog.html" class="active">Changelog</a></li>
</ul>
</div>
<div class="nav-section">
<h3>On This Page</h3>
<ul>
<li><a href="#v2.5.0">v2.5.0</a></li>
<li><a href="#v2.4.1">v2.4.1</a></li>
<li><a href="#v2.4.0">v2.4.0</a></li>
<li><a href="#v2.3.0">v2.3.0</a></li>
<li><a href="#v2.2.1">v2.2.1</a></li>
<li><a href="#v2.2.0">v2.2.0</a></li>
<li><a href="#v2.1.0">v2.1.0</a></li>
<li><a href="#v2.0.0">v2.0.0</a></li>
<li><a href="#v1.1.0">v1.1.0</a></li>
<li><a href="#v1.0.0">v1.0.0</a></li>
</ul>
</div>
</nav>
</aside>
<main class="docs-content">
<div class="docs-header">
<nav class="breadcrumb">
<a href="../index.html">Home</a>
<span>/</span>
<a href="getting-started.html">Docs</a>
<span>/</span>
<span>Changelog</span>
</nav>
<button class="mobile-menu-toggle" data-sidebar-toggle>
<i class="fa-solid fa-bars"></i>
</button>
</div>
<article class="docs-article">
<h1><i class="fa-solid fa-clock-rotate-left color-accent"></i> Changelog</h1>
<p class="lead">
All notable changes to the compounding-engineering plugin. This project follows
<a href="https://semver.org/">Semantic Versioning</a> and
<a href="https://keepachangelog.com/">Keep a Changelog</a> conventions.
</p>
<!-- Version 2.5.0 -->
<section id="v2.5.0" class="version-section">
<div class="version-header">
<h2>v2.5.0</h2>
<span class="version-date">2024-11-25</span>
</div>
<div class="changelog-category added">
<h3><i class="fa-solid fa-plus"></i> Added</h3>
<ul>
<li>
<strong><code>/report-bug</code> command</strong> - New slash command for reporting bugs in the
compounding-engineering plugin. Provides a structured workflow that gathers bug information
through guided questions, collects environment details automatically, and creates a GitHub
issue in the EveryInc/every-marketplace repository.
</li>
</ul>
</div>
</section>
<!-- Version 2.4.1 -->
<section id="v2.4.1" class="version-section">
<div class="version-header">
<h2>v2.4.1</h2>
<span class="version-date">2024-11-24</span>
</div>
<div class="changelog-category improved">
<h3><i class="fa-solid fa-arrow-up"></i> Improved</h3>
<ul>
<li>
<strong>design-iterator agent</strong> - Added focused screenshot guidance: always capture
only the target element/area instead of full page screenshots. Includes browser_resize
recommendations, element-targeted screenshot workflow using browser_snapshot refs, and
explicit instruction to never use fullPage mode.
</li>
</ul>
</div>
</section>
<!-- Version 2.4.0 -->
<section id="v2.4.0" class="version-section">
<div class="version-header">
<h2>v2.4.0</h2>
<span class="version-date">2024-11-24</span>
</div>
<div class="changelog-category fixed">
<h3><i class="fa-solid fa-bug"></i> Fixed</h3>
<ul>
<li>
<strong>MCP Configuration</strong> - Moved MCP servers back to <code>plugin.json</code>
following working examples from anthropics/life-sciences plugins.
</li>
<li>
<strong>Context7 URL</strong> - Updated to use HTTP type with correct endpoint URL.
</li>
</ul>
</div>
</section>
<!-- Version 2.3.0 -->
<section id="v2.3.0" class="version-section">
<div class="version-header">
<h2>v2.3.0</h2>
<span class="version-date">2024-11-24</span>
</div>
<div class="changelog-category changed">
<h3><i class="fa-solid fa-arrows-rotate"></i> Changed</h3>
<ul>
<li>
<strong>MCP Configuration</strong> - Moved MCP servers from inline <code>plugin.json</code>
to separate <code>.mcp.json</code> file per Claude Code best practices.
</li>
</ul>
</div>
</section>
<!-- Version 2.2.1 -->
<section id="v2.2.1" class="version-section">
<div class="version-header">
<h2>v2.2.1</h2>
<span class="version-date">2024-11-24</span>
</div>
<div class="changelog-category fixed">
<h3><i class="fa-solid fa-bug"></i> Fixed</h3>
<ul>
<li>
<strong>Playwright MCP Server</strong> - Added missing <code>"type": "stdio"</code> field
required for MCP server configuration to load properly.
</li>
</ul>
</div>
</section>
<!-- Version 2.2.0 -->
<section id="v2.2.0" class="version-section">
<div class="version-header">
<h2>v2.2.0</h2>
<span class="version-date">2024-11-24</span>
</div>
<div class="changelog-category added">
<h3><i class="fa-solid fa-plus"></i> Added</h3>
<ul>
<li>
<strong>Context7 MCP Server</strong> - Bundled Context7 for instant framework documentation
lookup. Provides up-to-date docs for Rails, React, Next.js, and 100+ other frameworks.
</li>
</ul>
</div>
</section>
<!-- Version 2.1.0 -->
<section id="v2.1.0" class="version-section">
<div class="version-header">
<h2>v2.1.0</h2>
<span class="version-date">2024-11-24</span>
</div>
<div class="changelog-category added">
<h3><i class="fa-solid fa-plus"></i> Added</h3>
<ul>
<li>
<strong>Playwright MCP Server</strong> - Bundled <code>@playwright/mcp</code> for browser
automation across all projects. Provides screenshot, navigation, click, fill, and evaluate tools.
</li>
</ul>
</div>
<div class="changelog-category changed">
<h3><i class="fa-solid fa-arrows-rotate"></i> Changed</h3>
<ul>
<li>Replaced all Puppeteer references with Playwright across agents and commands:
<ul>
<li><code>bug-reproduction-validator</code> agent</li>
<li><code>design-iterator</code> agent</li>
<li><code>design-implementation-reviewer</code> agent</li>
<li><code>figma-design-sync</code> agent</li>
<li><code>generate_command</code> command</li>
</ul>
</li>
</ul>
</div>
</section>
<!-- Version 2.0.2 -->
<section id="v2.0.2" class="version-section">
<div class="version-header">
<h2>v2.0.2</h2>
<span class="version-date">2024-11-24</span>
</div>
<div class="changelog-category changed">
<h3><i class="fa-solid fa-arrows-rotate"></i> Changed</h3>
<ul>
<li>
<strong>design-iterator agent</strong> - Updated description to emphasize proactive usage
when design work isn't coming together on first attempt.
</li>
</ul>
</div>
</section>
<!-- Version 2.0.1 -->
<section id="v2.0.1" class="version-section">
<div class="version-header">
<h2>v2.0.1</h2>
<span class="version-date">2024-11-24</span>
</div>
<div class="changelog-category added">
<h3><i class="fa-solid fa-plus"></i> Added</h3>
<ul>
<li><strong>CLAUDE.md</strong> - Project instructions with versioning requirements</li>
<li><strong>docs/solutions/plugin-versioning-requirements.md</strong> - Workflow documentation</li>
</ul>
</div>
</section>
<!-- Version 2.0.0 -->
<section id="v2.0.0" class="version-section">
<div class="version-header">
<h2>v2.0.0</h2>
<span class="version-date">2024-11-24</span>
<span class="version-badge major">Major Release</span>
</div>
<p class="version-description">
Major reorganization consolidating agents, commands, and skills from multiple sources into
a single, well-organized plugin.
</p>
<div class="changelog-category added">
<h3><i class="fa-solid fa-plus"></i> Added</h3>
<h4>New Agents (7)</h4>
<ul>
<li><code>design-iterator</code> - Iteratively refine UI components through systematic design iterations</li>
<li><code>design-implementation-reviewer</code> - Verify UI implementations match Figma design specifications</li>
<li><code>figma-design-sync</code> - Synchronize web implementations with Figma designs</li>
<li><code>bug-reproduction-validator</code> - Systematically reproduce and validate bug reports</li>
<li><code>spec-flow-analyzer</code> - Analyze user flows and identify gaps in specifications</li>
<li><code>lint</code> - Run linting and code quality checks on Ruby and ERB files</li>
<li><code>ankane-readme-writer</code> - Create READMEs following Ankane-style template for Ruby gems</li>
</ul>
<h4>New Commands (9)</h4>
<ul>
<li><code>/changelog</code> - Create engaging changelogs for recent merges</li>
<li><code>/plan_review</code> - Multi-agent plan review in parallel</li>
<li><code>/resolve_parallel</code> - Resolve TODO comments in parallel</li>
<li><code>/resolve_pr_parallel</code> - Resolve PR comments in parallel</li>
<li><code>/reproduce-bug</code> - Reproduce bugs using logs and console</li>
<li><code>/prime</code> - Prime/setup command</li>
<li><code>/create-agent-skill</code> - Create or edit Claude Code skills</li>
<li><code>/heal-skill</code> - Fix skill documentation issues</li>
<li><code>/workflows:codify</code> - Document solved problems for knowledge base</li>
</ul>
<h4>New Skills (10)</h4>
<ul>
<li><code>andrew-kane-gem-writer</code> - Write Ruby gems following Andrew Kane's patterns</li>
<li><code>codify-docs</code> - Capture solved problems as categorized documentation</li>
<li><code>create-agent-skills</code> - Expert guidance for creating Claude Code skills</li>
<li><code>dhh-ruby-style</code> - Write Ruby/Rails code in DHH's 37signals style</li>
<li><code>dspy-ruby</code> - Build type-safe LLM applications with DSPy.rb</li>
<li><code>every-style-editor</code> - Review copy for Every's style guide compliance</li>
<li><code>file-todos</code> - File-based todo tracking system</li>
<li><code>frontend-design</code> - Create production-grade frontend interfaces</li>
<li><code>git-worktree</code> - Manage Git worktrees for parallel development</li>
<li><code>skill-creator</code> - Guide for creating effective Claude Code skills</li>
</ul>
</div>
<div class="changelog-category changed">
<h3><i class="fa-solid fa-arrows-rotate"></i> Changed</h3>
<h4>Agents Reorganized by Category</h4>
<ul>
<li><code>review/</code> (10 agents) - Code quality, security, performance reviewers</li>
<li><code>research/</code> (4 agents) - Documentation, patterns, history analysis</li>
<li><code>design/</code> (3 agents) - UI/design review and iteration</li>
<li><code>workflow/</code> (6 agents) - PR resolution, bug validation, linting</li>
<li><code>docs/</code> (1 agent) - README generation</li>
</ul>
</div>
<div class="version-summary">
<h4>Summary</h4>
<table>
<thead>
<tr>
<th>Component</th>
<th>v1.1.0</th>
<th>v2.0.0</th>
<th>Change</th>
</tr>
</thead>
<tbody>
<tr>
<td>Agents</td>
<td>17</td>
<td>24</td>
<td class="positive">+7</td>
</tr>
<tr>
<td>Commands</td>
<td>6</td>
<td>15</td>
<td class="positive">+9</td>
</tr>
<tr>
<td>Skills</td>
<td>1</td>
<td>11</td>
<td class="positive">+10</td>
</tr>
</tbody>
</table>
</div>
</section>
<!-- Version 1.1.0 -->
<section id="v1.1.0" class="version-section">
<div class="version-header">
<h2>v1.1.0</h2>
<span class="version-date">2024-11-22</span>
</div>
<div class="changelog-category added">
<h3><i class="fa-solid fa-plus"></i> Added</h3>
<ul>
<li>
<strong>gemini-imagegen Skill</strong>
<ul>
<li>Text-to-image generation with Google's Gemini API</li>
<li>Image editing and manipulation</li>
<li>Multi-turn refinement via chat interface</li>
<li>Multiple reference image composition (up to 14 images)</li>
<li>Model support: <code>gemini-2.5-flash-image</code> and <code>gemini-3-pro-image-preview</code></li>
</ul>
</li>
</ul>
</div>
<div class="changelog-category fixed">
<h3><i class="fa-solid fa-bug"></i> Fixed</h3>
<ul>
<li>Corrected component counts in documentation (17 agents, not 15)</li>
</ul>
</div>
</section>
<!-- Version 1.0.0 -->
<section id="v1.0.0" class="version-section">
<div class="version-header">
<h2>v1.0.0</h2>
<span class="version-date">2024-10-09</span>
<span class="version-badge">Initial Release</span>
</div>
<p class="version-description">
Initial release of the compounding-engineering plugin.
</p>
<div class="changelog-category added">
<h3><i class="fa-solid fa-plus"></i> Added</h3>
<h4>17 Specialized Agents</h4>
<p><strong>Code Review (5)</strong></p>
<ul>
<li><code>kieran-rails-reviewer</code> - Rails code review with strict conventions</li>
<li><code>kieran-python-reviewer</code> - Python code review with quality standards</li>
<li><code>kieran-typescript-reviewer</code> - TypeScript code review</li>
<li><code>dhh-rails-reviewer</code> - Rails review from DHH's perspective</li>
<li><code>code-simplicity-reviewer</code> - Final pass for simplicity and minimalism</li>
</ul>
<p><strong>Analysis & Architecture (4)</strong></p>
<ul>
<li><code>architecture-strategist</code> - Architectural decisions and compliance</li>
<li><code>pattern-recognition-specialist</code> - Design pattern analysis</li>
<li><code>security-sentinel</code> - Security audits and vulnerability assessments</li>
<li><code>performance-oracle</code> - Performance analysis and optimization</li>
</ul>
<p><strong>Research (4)</strong></p>
<ul>
<li><code>framework-docs-researcher</code> - Framework documentation research</li>
<li><code>best-practices-researcher</code> - External best practices gathering</li>
<li><code>git-history-analyzer</code> - Git history and code evolution analysis</li>
<li><code>repo-research-analyst</code> - Repository structure and conventions</li>
</ul>
<p><strong>Workflow (3)</strong></p>
<ul>
<li><code>every-style-editor</code> - Every's style guide compliance</li>
<li><code>pr-comment-resolver</code> - PR comment resolution</li>
<li><code>feedback-codifier</code> - Feedback pattern codification</li>
</ul>
<h4>6 Slash Commands</h4>
<ul>
<li><code>/plan</code> - Create implementation plans</li>
<li><code>/review</code> - Comprehensive code reviews</li>
<li><code>/work</code> - Execute work items systematically</li>
<li><code>/triage</code> - Triage and prioritize issues</li>
<li><code>/resolve_todo_parallel</code> - Resolve TODOs in parallel</li>
<li><code>/generate_command</code> - Generate new slash commands</li>
</ul>
<h4>Infrastructure</h4>
<ul>
<li>MIT license</li>
<li>Plugin manifest (<code>plugin.json</code>)</li>
<li>Pre-configured permissions for Rails development</li>
</ul>
</div>
</section>
</article>
</main>
</div>
</body>
</html>

8
plugins/compounding-engineering/docs/pages/commands.html
View File

@@ -34,11 +34,17 @@
<h3>Reference</h3>
<ul>
<li><a href="agents.html">Agents (24)</a></li>
<li><a href="commands.html" class="active">Commands (16)</a></li>
<li><a href="commands.html" class="active">Commands (13)</a></li>
<li><a href="skills.html">Skills (11)</a></li>
<li><a href="mcp-servers.html">MCP Servers (2)</a></li>
</ul>
</div>
<div class="nav-section">
<h3>Resources</h3>
<ul>
<li><a href="changelog.html">Changelog</a></li>
</ul>
</div>
<div class="nav-section">
<h3>On This Page</h3>
<ul>

1
plugins/compounding-engineering/docs/pages/getting-started.html
View File

@@ -58,6 +58,7 @@
<li><a href="commands.html">Command Reference</a></li>
<li><a href="skills.html">Skill Reference</a></li>
<li><a href="mcp-servers.html">MCP Servers</a></li>
<li><a href="changelog.html">Changelog</a></li>
</ul>
</div>
</nav>

8
plugins/compounding-engineering/docs/pages/mcp-servers.html
View File

@@ -34,11 +34,17 @@
<h3>Reference</h3>
<ul>
<li><a href="agents.html">Agents (24)</a></li>
<li><a href="commands.html">Commands (16)</a></li>
<li><a href="commands.html">Commands (13)</a></li>
<li><a href="skills.html">Skills (11)</a></li>
<li><a href="mcp-servers.html" class="active">MCP Servers (2)</a></li>
</ul>
</div>
<div class="nav-section">
<h3>Resources</h3>
<ul>
<li><a href="changelog.html">Changelog</a></li>
</ul>
</div>
<div class="nav-section">
<h3>On This Page</h3>
<ul>

8
plugins/compounding-engineering/docs/pages/skills.html
View File

@@ -34,11 +34,17 @@
<h3>Reference</h3>
<ul>
<li><a href="agents.html">Agents (24)</a></li>
<li><a href="commands.html">Commands (16)</a></li>
<li><a href="commands.html">Commands (13)</a></li>
<li><a href="skills.html" class="active">Skills (11)</a></li>
<li><a href="mcp-servers.html">MCP Servers (2)</a></li>
</ul>
</div>
<div class="nav-section">
<h3>Resources</h3>
<ul>
<li><a href="changelog.html">Changelog</a></li>
</ul>
</div>
<div class="nav-section">
<h3>On This Page</h3>
<ul>