dpnmw/agents
1
0
Fork 0
mirror of https://github.com/wshobson/agents.git synced 2026-03-18 09:37:15 +00:00
Code Issues Packages Projects Releases Wiki Activity
216 Commits 2 Branches 0 Tags
0752775afcfdbaa409a61704ecc7a72fc421c1eb
Commit Graph

216 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
Seth Hobson
c7ad381360 feat: implement three-tier model strategy with Opus 4.5 (#139) 
* feat: implement three-tier model strategy with Opus 4.5

This implements a strategic model selection approach based on agent
complexity and use case, addressing Issue #136.

Three-Tier Strategy:
- Tier 1 (opus): 17 critical agents for architecture, security, code review
- Tier 2 (inherit): 21 complex agents where users choose their model
- Tier 3 (sonnet): 63 routine development agents (unchanged)
- Tier 4 (haiku): 47 fast operational agents (unchanged)

Why Opus 4.5 for Tier 1:
- 80.9% on SWE-bench (industry-leading for code)
- 65% fewer tokens for long-horizon tasks
- Superior reasoning for architectural decisions

Changes:
- Update architect-review, cloud-architect, kubernetes-architect,
  database-architect, security-auditor, code-reviewer to opus
- Update backend-architect, performance-engineer, ai-engineer,
  prompt-engineer, ml-engineer, mlops-engineer, data-scientist,
  blockchain-developer, quant-analyst, risk-manager, sql-pro,
  database-optimizer to inherit
- Update README with three-tier model documentation

Relates to #136

* feat: comprehensive model tier redistribution for Opus 4.5

This commit implements a strategic rebalancing of agent model assignments,
significantly increasing the use of Opus 4.5 for critical coding tasks while
ensuring Sonnet is used more than Haiku for support tasks.

Final Distribution (153 total agent files):
- Tier 1 Opus: 42 agents (27.5%) - All production coding + critical architecture
- Tier 2 Inherit: 42 agents (27.5%) - Complex tasks, user-choosable
- Tier 3 Sonnet: 38 agents (24.8%) - Support tasks needing intelligence
- Tier 4 Haiku: 31 agents (20.3%) - Simple operational tasks

Key Changes:

Tier 1 (Opus) - Production Coding + Critical Review:
- ALL code-reviewers (6 total): Ensures highest quality code review across
  all contexts (comprehensive, git PR, code docs, codebase cleanup, refactoring, TDD)
- All major language pros (7): python, golang, rust, typescript, cpp, java, c
- Framework specialists (6): django (2), fastapi (2), graphql-architect (2)
- Complex specialists (6): terraform-specialist (3), tdd-orchestrator (2), data-engineer
- Blockchain: blockchain-developer (smart contracts are critical)
- Game dev (2): unity-developer, minecraft-bukkit-pro
- Architecture (existing): architect-review, cloud-architect, kubernetes-architect,
  hybrid-cloud-architect, database-architect, security-auditor

Tier 2 (Inherit) - User Flexibility:
- Secondary languages (6): javascript, scala, csharp, ruby, php, elixir
- All frontend/mobile (8): frontend-developer (4), mobile-developer (2),
  flutter-expert, ios-developer
- Specialized (6): observability-engineer (2), temporal-python-pro,
  arm-cortex-expert, context-manager (2), database-optimizer (2)
- AI/ML, backend-architect, performance-engineer, quant/risk (existing)

Tier 3 (Sonnet) - Intelligent Support:
- Documentation (4): docs-architect (2), tutorial-engineer (2)
- Testing (2): test-automator (2)
- Developer experience (3): dx-optimizer (2), business-analyst
- Modernization (4): legacy-modernizer (3), database-admin
- Other support agents (existing)

Tier 4 (Haiku) - Simple Operations:
- SEO/Marketing (10): All SEO agents, content, search
- Deployment (4): deployment-engineer (4 instances)
- Debugging (5): debugger (2), error-detective (3)
- DevOps (3): devops-troubleshooter (3)
- Other simple operational tasks

Rationale:
- Opus 4.5 achieves 80.9% on SWE-bench with 65% fewer tokens on complex tasks
- Production code deserves the best model: all language pros now on Opus
- All code review uses Opus for maximum quality and security
- Sonnet > Haiku (38 vs 31) ensures better intelligence for support tasks
- Inherit tier gives users cost control for frontend, mobile, and specialized tasks

Related: #136, #132

* feat: upgrade final 13 agents from Haiku to Sonnet

Based on research into Haiku 4.5 vs Sonnet 4.5 capabilities, upgraded
agents requiring deep analytical intelligence from Haiku to Sonnet.

Research Findings:
- Haiku 4.5: 73.3% SWE-bench, 3-5x faster, 1/3 cost, sub-200ms responses
- Best for Haiku: Real-time apps, data extraction, templates, high-volume ops
- Best for Sonnet: Complex reasoning, root cause analysis, strategic planning

Agents Upgraded (13 total):
- Debugging (5): debugger (2), error-detective (3) - Complex root cause analysis
- DevOps (3): devops-troubleshooter (3) - System diagnostics & troubleshooting
- Network (2): network-engineer (2) - Complex network analysis & optimization
- API Documentation (2): api-documenter (2) - Deep API understanding required
- Payments (1): payment-integration - Critical financial integration

Final Distribution (153 total):
- Tier 1 Opus: 42 agents (27.5%) - Production coding + critical architecture
- Tier 2 Inherit: 42 agents (27.5%) - Complex tasks, user-choosable
- Tier 3 Sonnet: 51 agents (33.3%) - Support tasks needing intelligence
- Tier 4 Haiku: 18 agents (11.8%) - Fast operational tasks only

Haiku Now Reserved For:
- SEO/Marketing (8): Pattern matching, data extraction, content templates
- Deployment (4): Operational execution tasks
- Simple Docs (3): reference-builder, mermaid-expert, c4-code
- Sales/Support (2): High-volume, template-based interactions
- Search (1): Knowledge retrieval

Sonnet > Haiku as requested (51 vs 18)

Sources:
- https://www.creolestudios.com/claude-haiku-4-5-vs-sonnet-4-5-comparison/
- https://www.anthropic.com/news/claude-haiku-4-5
- https://caylent.com/blog/claude-haiku-4-5-deep-dive-cost-capabilities-and-the-multi-agent-opportunity

Related: #136

* docs: add cost considerations and clarify inherit behavior

Addresses PR feedback:
- Added comprehensive cost comparison for all model tiers
- Documented how 'inherit' model works (uses session default, falls back to Sonnet)
- Explained cost optimization strategies
- Clarified when Opus token efficiency offsets higher rate

This helps users make informed decisions about model selection and cost control.
 2025-12-10 15:52:06 -05:00
Seth Hobson
27a246a8c6 Add Claude Code GitHub Workflow (#140) 
* "Claude PR Assistant workflow"

* "Claude Code Review workflow"
 2025-12-10 15:12:53 -05:00
Gurdas Nijor
0669427e9f Add Smithery badge (#131) 2025-12-10 14:55:01 -05:00
Mike Kazmier
16cddabb75 add c4 documentation workflow and agents (#129) 
* add c4 documentation workflow and agents

* update the c4-code agent to use proper mermaid diagram types
 2025-12-10 14:53:11 -05:00
Joe Previte
c660e2454c docs(agents): add haskell-pro (#128) 
* docs(agents): add haskell-pro

* fixup

* Move haskell-pro agent to functional-programming plugin

- Moved plugins/haskell-development/agents/haskell-pro.md to plugins/functional-programming/agents/haskell-pro.md
- Updated path reference in docs/agents.md

This addresses review feedback to place the Haskell agent in the existing functional-programming plugin alongside elixir-pro, rather than creating a new haskell-development plugin.

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

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
 2025-12-10 14:51:03 -05:00
Kiri
ddbd034ca3 feat: add Temporal workflow orchestration to backend-development plugin (#125) 
* docs: enhance payment-integration agent with critical security guidance

Add evidence-based security requirements from Stripe, PayPal, OWASP:
- Webhook security (signature verification, idempotency, quick response, server validation)
- PCI compliance essentials (tokenization, server-side validation, environment separation)
- Real-world failure examples (processor collapse, Lambda failures, malicious price manipulation)

Minimal expansion: 32 to 57 lines (25 lines added)

* feat: add Temporal workflow orchestration to backend-development plugin

Add comprehensive Temporal workflow orchestration support with 1 agent and 2 skills:

**Agent:**
- temporal-python-pro: Python SDK expert for durable workflows, saga patterns,
  async/await patterns, error handling, and production deployment

**Skills:**
- workflow-orchestration-patterns: Language-agnostic patterns for workflows vs
  activities, saga compensation, entity workflows, and determinism constraints
- temporal-python-testing: Progressive disclosure testing guide with unit testing,
  integration testing, replay testing, and local development setup

**Changes:**
- Add agent: plugins/backend-development/agents/temporal-python-pro.md (311 lines)
- Add skill: plugins/backend-development/skills/workflow-orchestration-patterns/ (286 lines)
- Add skill: plugins/backend-development/skills/temporal-python-testing/ (SKILL.md + 4 resource files)
- Update marketplace.json: backend-development plugin v1.2.2 → v1.2.3
- Update docs/agents.md: 85 → 86 agents
- Update docs/agent-skills.md: 55 → 57 skills

**Content Sources:**
- Official Temporal documentation (docs.temporal.io)
- Temporal Python SDK guide (python.temporal.io)
- Temporal architecture docs (github.com/temporalio/temporal)
- OWASP best practices for distributed systems

Addresses #124

---------

Co-authored-by: Kiran Eshwarappa <kiran.eshwarapa@gmail.com>
 2025-11-16 20:45:36 -05:00
Kiri
493e2ea399 docs: enhance payment-integration agent with critical security guidance (#121) 
Add evidence-based security requirements from Stripe, PayPal, OWASP:
- Webhook security (signature verification, idempotency, quick response, server validation)
- PCI compliance essentials (tokenization, server-side validation, environment separation)
- Real-world failure examples (processor collapse, Lambda failures, malicious price manipulation)

Minimal expansion: 32 to 57 lines (25 lines added)

Co-authored-by: Kiran Eshwarappa <kiran.eshwarapa@gmail.com>
 2025-11-16 20:45:22 -05:00
Kunal Shah
1305e48672 Replace GPT and Claude models to latest, better and cheaper models (#118) 
* Updated GPT and Claude models to latest, better and cheaper models

* updated more files to use GPT-5 and Sonnet/Haiku 4.5 because theu are the latest, cheaper and better models
 2025-11-16 20:22:36 -05:00
Matvey Arye
7581142104 feat: add postgresql-table-design skill to database-design plugin (#113) 
Add comprehensive PostgreSQL schema design skill covering:
- Core rules and best practices
- PostgreSQL-specific gotchas and conventions
- Data types with detailed guidance (IDs, strings, time, JSONB, arrays, etc.)
- Indexing strategies (B-tree, GIN, GiST, BRIN, partial, covering)
- Constraints (PK, FK, UNIQUE, CHECK, EXCLUDE)
- Partitioning patterns
- Performance optimization for update-heavy and insert-heavy workloads
- Safe schema evolution
- Extension recommendations

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

Co-authored-by: Claude <noreply@anthropic.com>
 2025-11-08 16:38:51 -05:00
Seth Hobson
51c85a8977 chore: add copyright holder name to LICENSE 2025-11-01 09:35:17 -04:00
Yusheng Zhao
54c78d19b4 feat: add julia-development plugin with julia-pro agent (#110) 
Add comprehensive Julia 1.10+ development support including:
- Modern Julia features (multiple dispatch, metaprogramming)
- Package management with Pkg.jl and PkgTemplates.jl
- Code formatting with JuliaFormatter.jl (BlueStyle)
- Scientific computing (DifferentialEquations.jl, DataFrames.jl)
- Machine learning (Flux.jl, MLJ.jl)
- Performance optimization and type stability
- Testing and benchmarking best practices
- Web development with Genie.jl and Oxygen.jl

The julia-pro agent provides expert guidance on production-ready
Julia development following community best practices.
 2025-11-01 09:13:37 -04:00
Seth Hobson
ed129a899d feat: add developer-essentials plugin with 8 essential skills (#104) 
Add new developer-essentials plugin containing 8 high-value skills that
address critical gaps in the existing skill coverage:

Skills Added:
- git-advanced-workflows: Advanced Git techniques (rebase, cherry-pick, bisect, worktrees, reflog)
- sql-optimization-patterns: SQL query optimization, indexing, and EXPLAIN analysis
- error-handling-patterns: Multi-language error handling strategies and patterns
- code-review-excellence: Effective code review practices and constructive feedback
- e2e-testing-patterns: End-to-end testing with Playwright and Cypress
- auth-implementation-patterns: Authentication/authorization with JWT, OAuth2, RBAC
- debugging-strategies: Systematic debugging techniques and profiling tools
- monorepo-management: Monorepo setup and management with Turborepo, Nx, pnpm

These skills were identified through comprehensive research of:
- Existing 50+ skills across 14 plugins in the project
- Anthropic's official skills repository
- Gap analysis revealing missing coverage in general developer workflows

Changes:
- Added plugins/developer-essentials/ with 8 new SKILL.md files
- Updated .claude-plugin/marketplace.json to register new plugin
- Updated docs/agent-skills.md (47→55 skills, 14→15 plugins)

Each skill follows Anthropic's Agent Skills Specification with proper
YAML frontmatter, progressive disclosure, and clear activation triggers.

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

Co-authored-by: Claude <noreply@anthropic.com>
 2025-10-23 21:05:06 -04:00
Ryan
f6a06c793a feat: add shell-scripting plugin with bash-pro, posix-shell-pro, and 3 skills 
Fantastic work, Ryan! You delivered an exceptional shell-scripting plugin with comprehensive coverage of defensive programming, static analysis, and testing patterns. Your responsiveness to feedback and commitment to quality are exactly what we value in this project. Thanks for the great contribution! 🎉
 2025-10-18 20:36:56 -04:00
Seth Hobson
b8f35d943d chore: add .venv to gitignore 
Add .venv directory to gitignore to exclude virtual environment
created by modern Python tools like uv.
 2025-10-16 21:06:05 -04:00
Seth Hobson
f1051c682e chore: bump remaining plugin versions to 1.2.2 
Bump version from 1.2.1 to 1.2.2 for 3 plugins that had Agent Skills added
and were already at 1.2.1:
- backend-development
- framework-migration
- security-scanning

Follow-up to commit 65e5cb0 (feat: add Agent Skills and restructure documentation)
 2025-10-16 21:01:39 -04:00
Seth Hobson
72864c1e2d chore: bump plugin versions for skills addition 
Bump version from 1.2.0 to 1.2.1 for 11 plugins that had Agent Skills added:
- api-scaffolding
- blockchain-web3
- cicd-automation
- cloud-infrastructure
- javascript-typescript
- kubernetes-operations
- llm-application-dev
- machine-learning-ops
- observability-monitoring
- payment-processing
- python-development

Follow-up to commit 65e5cb0 (feat: add Agent Skills and restructure documentation)
 2025-10-16 21:00:13 -04:00
Seth Hobson
65e5cb093a feat: add Agent Skills and restructure documentation 
- Add 47 Agent Skills across 14 plugins following Anthropic's specification
  - Python (5): async patterns, testing, packaging, performance, UV package manager
  - JavaScript/TypeScript (4): advanced types, Node.js patterns, testing, modern JS
  - Kubernetes (4): manifests, Helm charts, GitOps, security policies
  - Cloud Infrastructure (4): Terraform, multi-cloud, hybrid networking, cost optimization
  - CI/CD (4): pipeline design, GitHub Actions, GitLab CI, secrets management
  - Backend (3): API design, architecture patterns, microservices
  - LLM Applications (4): LangChain, prompt engineering, RAG, evaluation
  - Blockchain/Web3 (4): DeFi protocols, NFT standards, Solidity security, Web3 testing
  - Framework Migration (4): React, Angular, database, dependency upgrades
  - Observability (4): Prometheus, Grafana, distributed tracing, SLO
  - Payment Processing (4): Stripe, PayPal, PCI compliance, billing
  - API Scaffolding (1): FastAPI templates
  - ML Operations (1): ML pipeline workflow
  - Security (1): SAST configuration

- Restructure documentation into /docs directory
  - agent-skills.md: Complete guide to all 47 skills
  - agents.md: All 85 agents with model configuration
  - plugins.md: Complete catalog of 63 plugins
  - usage.md: Commands, workflows, and best practices
  - architecture.md: Design principles and patterns

- Update README.md
  - Add Agent Skills banner announcement
  - Reduce length by ~75% with links to detailed docs
  - Add What's New section showcasing Agent Skills
  - Add Popular Use Cases with real examples
  - Improve navigation with Core Guides and Quick Links

- Update marketplace.json with skills arrays for 14 plugins

All 47 skills follow Agent Skills Specification:
- Required YAML frontmatter (name, description)
- Use when activation clauses
- Progressive disclosure architecture
- Under 1024 character descriptions
 2025-10-16 20:33:27 -04:00
Seth Hobson
1962091501 docs: add banner for Sonnet 4.5 & Haiku 4.5 update 2025-10-15 14:08:10 -04:00
Seth Hobson
8346c1f2f7 refactor: migrate to model-agnostic Sonnet/Haiku architecture 
- Migrate all 48 Opus agents to Sonnet
- Optimize 35 execution-focused agents for Haiku
- Update README with hybrid orchestration patterns
- Simplify model configuration to use agnostic aliases

Final distribution: 97 Sonnet / 47 Haiku agents
 2025-10-15 14:06:54 -04:00
Seth Hobson
93018df532 fix: restore original plugin name arm-cortex-microcontrollers 
- Revert plugin name from embedded-systems to arm-cortex-microcontrollers
- Keep original name chosen by contributor Ryan Snodgrass
- Update all references in README.md and marketplace.json
- Plugin structure remains properly organized in plugins/ directory
 2025-10-14 21:13:27 -04:00
Seth Hobson
571b0c6db4 refactor: move arm-cortex-expert to embedded-systems plugin 
- Refactor standalone agent into proper plugin structure
- Create plugins/embedded-systems/ directory with agents/ subdirectory
- Move arm-cortex-expert.md to plugins/embedded-systems/agents/
- Update marketplace.json plugin name and source path
- Update README.md to reflect 7 language plugins (was 6)
- Add embedded-systems to Languages plugin table
- Update all agent references to new path
- Remove empty agents/ directory

This aligns the embedded-systems plugin with the standard plugin
architecture used throughout the repository.
 2025-10-14 21:06:18 -04:00
Ryan
ff01b4e86b ARM Cortex M* microcontroller development (#79) 
* expert at Teensy microcontroller programming

* Refactor teensy-expert to arm-cortex-expert for broader ARM Cortex-M coverage

- Rename teensy-expert.md to arm-cortex-expert.md
- Update frontmatter: remove triggers field, add model: sonnet
- Generalize content for ARM Cortex-M platforms (Teensy, STM32, nRF52, SAMD)
- Add critical ARM Cortex-M sections:
  * Interrupt Priorities & NVIC Configuration
  * Critical Sections & Interrupt Masking (with BASEPRI formula)
  * Hardfault Debugging Basics
  * Cortex-M Architecture Differences comparison table
  * FPU Context Saving
  * Stack Overflow Protection
- Optimize content: 471 lines → 264 lines (26% reduction)
- Preserve all critical code patterns for correct LLM code generation
- Inline all technical content (no external snippet dependencies)

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

Co-Authored-By: Claude <noreply@anthropic.com>

* Add arm-cortex-expert to README and marketplace

- Added arm-cortex-expert to Specialized Domains section in README
- Created arm-cortex-microcontrollers plugin entry in marketplace.json
- Plugin authored by Ryan Snodgrass for ARM Cortex-M firmware development

---------

Co-authored-by: Claude <noreply@anthropic.com>
 2025-10-14 20:59:07 -04:00
Seth Hobson
7d34619cf3 Update README.md 2025-10-14 20:50:26 -04:00
Seth Hobson
65526f7df8 add star history to readme 2025-10-13 20:16:08 -04:00
Seth Hobson
492adf9353 fix: resolve agent namespace issues across 11 plugins 
Fixed 109 agent namespace issues where external agent references were
missing proper namespace prefixes (plugin-name::agent-name format).

Affected plugins (bumped to v1.2.1):
- tdd-workflows: Fixed 12 references in tdd-cycle, tdd-green, tdd-red
- incident-response: Fixed 29 references in incident-response, smart-fix
- data-engineering: Fixed 12 references in data-driven-feature
- backend-development: Fixed 11 references in feature-development
- framework-migration: Fixed 10 references in legacy-modernize
- git-pr-workflows: Fixed 7 references in git-workflow
- security-scanning: Fixed 7 references in security-hardening
- full-stack-orchestration: Fixed 6 references in full-stack-feature
- application-performance: Fixed 5 references in performance-optimization
- comprehensive-review: Fixed 5 references in full-review
- multi-platform-apps: Fixed 5 references in multi-platform

Changes:
- Added namespace prefixes for all external agent references
- Replaced 14 missing agents with appropriate equivalents
- Updated marketplace.json to bump affected plugin versions

Closes #95
 2025-10-13 19:15:30 -04:00
Seth Hobson
9b64821cc9 Fix broken agent links in README 
Updated all 84 agent references from incorrect `agents/{agent-name}.md` format to correct `plugins/{plugin-name}/agents/{agent-name}.md` paths to resolve 404 errors.
 2025-10-13 11:32:01 -04:00
Seth Hobson
018a6b8878 readme links 2025-10-13 11:19:03 -04:00
Seth Hobson
1ebddda482 Update README usage section to highlight plugin slash commands 
- Add comprehensive slash command documentation as primary interface
- Include real command examples mapped to actual plugins in marketplace
- Add 70+ categorized slash command reference (all real commands)
- Show both command-based and natural language invocation patterns
- Add tdd-workflows to Testing section for better discoverability
- Provide detailed workflow orchestration examples with step breakdowns
- Include command argument examples and discovery instructions

All examples now use actual commands that exist in the plugin system
(backend-development:feature-development, unit-testing:test-generate, etc.)
 2025-10-13 10:47:33 -04:00
Seth Hobson
7a8c0c6368 readme title update 2025-10-13 10:35:29 -04:00
Seth Hobson
743772eae9 readme tidy 2025-10-13 10:34:23 -04:00
Seth Hobson
382721c2e5 Bump all plugin versions to 1.2.0 2025-10-13 10:23:35 -04:00
Seth Hobson
20d4472a3b Restructure marketplace for isolated plugin architecture 
- Organize 62 plugins into isolated directories under plugins/
- Consolidate tools and workflows into commands/ following Anthropic conventions
- Update marketplace.json with isolated source paths for each plugin
- Revise README to reflect plugin-based structure and token efficiency
- Remove shared resource directories (agents/, tools/, workflows/)

Each plugin now contains only its specific agents and commands, enabling
granular installation and minimal token usage. Installing a single plugin
loads only its resources rather than the entire marketplace.

Structure: plugins/{plugin-name}/{agents/,commands/}
 2025-10-13 10:19:10 -04:00
Seth Hobson
e4b6fd5c5d marketplace install -> GitHub short form 2025-10-12 20:05:54 -04:00
yinkev
542a3bdcda Update README.md (#91) 
There was an error in the count. Originally it said 4, but there are actually 5 Opus agents.
 2025-10-12 19:50:19 -04:00
Seth Hobson
918bd6a238 docs: fix Claude Code link in header 
Update header link from docs.anthropic.com to docs.claude.com/overview
 2025-10-12 19:46:29 -04:00
Seth Hobson
40309fd4bb docs: update Subagents documentation link to docs.claude.com 
Migrate from docs.anthropic.com to docs.claude.com for consistency
 2025-10-12 19:44:14 -04:00
Seth Hobson
f5e6c80e5b docs: update Claude Code documentation link to new URL 
Change main documentation link from docs.anthropic.com to docs.claude.com/overview
 2025-10-12 19:43:36 -04:00
Seth Hobson
c8b8b291f3 docs: update README for v1.1.0 with two-tier plugin layout 
Major documentation restructure to improve discoverability and usability:

## Two-Tier Plugin Documentation
- Quick Start section: 12 essential plugins with full descriptions
- Complete Reference: All 62 plugins in categorized tables (23 categories)
- Reduces documentation from verbose listings to scannable tables
- Only +31 lines despite documenting +26 more plugins

## Corrected Counts
- Tools: 42 → 44 (correct actual count)
- Plugins: 36 → 62 (v1.1.0 refactoring)
- Agents: 84, Workflows: 15 (verified)

## Content Improvements
- Removed promotional 'new' language throughout
- Updated version highlights to be factual
- Added Claude Code Plugins Guide link to Resources
- Reorganized plugin categories with emoji icons for scanning
- Updated repository structure to show v1.1.0 tools

## Structure
Quick Start (12 plugins):
- Development Essentials (3)
- Full-Stack Development (3)
- Testing & Quality (2)
- Infrastructure & Operations (2)
- Language Support (2)

Complete Reference (62 plugins):
- 23 categories with 1-6 plugins each
- Compact table format (plugin | description | install)
- Covers: Development, Documentation, Workflows, Testing, Quality,
  Utilities, AI/ML, Data, Database, Operations, Performance,
  Infrastructure, Security, Modernization, API, Marketing, Business,
  Languages, Blockchain, Finance, Payments, Gaming, Accessibility
 2025-10-12 19:42:44 -04:00
Seth Hobson
786db18b8f feat: marketplace v1.1.0 - refactor to 62 focused plugins 
Major marketplace refactoring to optimize plugin granularity and improve
single-responsibility principle adherence, following Anthropic best practices.

Plugin Architecture Changes (36 → 62 plugins)
------------------------------------------------
Split 12 monolithic plugins into focused units:
- claude-code-essentials → code-documentation, debugging-toolkit, git-pr-workflows
- full-stack-development → backend-development, frontend-mobile-development, full-stack-orchestration
- testing-quality-suite → unit-testing, tdd-workflows, code-review-ai
- infrastructure-devops → cloud-infrastructure, kubernetes-orchestration, ci-cd-automation
- development-utilities → code-refactoring, dependency-management, error-debugging
- security-hardening → web-security, mobile-security, devsecops-practices
- data-ml-pipeline → data-engineering, machine-learning, mlops-automation
- api-development-kit → rest-api-development, graphql-development, api-security

Added 6 language-focused plugins for unused agents:
- python-development, javascript-typescript, systems-programming
- jvm-languages, web-scripting, functional-programming

New Tools (6 tools, 2,084 lines)
---------------------------------
1. test-generate.md (302 lines) - Automated unit test generation
2. component-scaffold.md (388 lines) - React/React Native scaffolding
3. xss-scan.md (307 lines) - XSS vulnerability scanner
4. python-scaffold.md (316 lines) - Python project initialization
5. typescript-scaffold.md (346 lines) - TypeScript project setup
6. rust-project.md (425 lines) - Rust project creation

Marketplace Cleanup
-------------------
- Removed 2 empty plugins (advanced-testing, docker-containerization)
- Assigned agents to 4 plugins missing them
- Validated all file references (100% valid paths)

Results
-------
- 62 plugins (was 36) - 72% increase for better granularity
- 84 agents (100% now assigned to plugins)
- 42 tools (was 36) - 16.7% increase
- Average 3.4 components per plugin (follows Anthropic 2-8 pattern)
- 100% of plugins have agents (was 94%)
- 66% of plugins have tools (was 50%)
- Version bumped to 1.1.0

This refactoring optimizes token usage, improves plugin discovery, and makes
installation more granular while maintaining the centralized file structure.
 2025-10-12 19:30:18 -04:00
Seth Hobson
8ddbd604bf feat: marketplace v1.0.5 - focused plugins + optimized tools 
Major refactoring and optimization release transforming marketplace from bloated
to focused, single-purpose plugin architecture following industry best practices.

MARKETPLACE RESTRUCTURING (27 → 36 plugins)
============================================

Plugin Splits:
- infrastructure-devops (22) → kubernetes-operations, docker-containerization,
  deployment-orchestration
- security-hardening (18) → security-scanning, security-compliance,
  backend-api-security, frontend-mobile-security
- data-ml-pipeline (17) → data-engineering, machine-learning-ops,
  ai-agent-development
- api-development-kit (17) → api-scaffolding, api-testing-observability,
  data-validation-suite
- incident-response (16) → incident-diagnostics, observability-monitoring

New Extracted Plugins:
- data-validation-suite: Schema validation, data quality (extracted duplicates)
- deployment-orchestration: Deployment strategies, rollback (extracted duplicates)

Impact:
- Average plugin size: 8-10 → 6.2 components (-27%)
- Bloated plugins (>15): 5 → 0 (-100%)
- Duplication overhead: 45.2% → 12.6% (-72%)
- All plugins now follow single-responsibility principle

FILE OPTIMIZATION (24,392 lines eliminated)
===========================================

Legacy Files Removed (14,698 lines):
- security-scan.md (3,468 lines) - replaced by focused security plugins
- k8s-manifest.md (2,776 lines) - replaced by kubernetes-operations tools
- docker-optimize.md (2,333 lines) - replaced by docker-containerization tools
- test-harness.md (2,015 lines) - replaced by testing-quality-suite tools
- db-migrate.md (1,891 lines) - replaced by database-operations tools
- api-scaffold.md (1,772 lines) - replaced by api-scaffolding tools
- data-validation.md (1,673 lines) - replaced by data-validation-suite
- deploy-checklist.md (1,630 lines) - replaced by deployment-orchestration tools

High-Priority Files Optimized (9,694 lines saved, 62% avg reduction):
- security-sast.md: 1,216 → 473 lines (61% reduction, 82→19 code blocks)
- prompt-optimize.md: 1,206 → 587 lines (51% reduction)
- doc-generate.md: 1,071 → 652 lines (39% reduction)
- ai-review.md: 1,597 → 428 lines (73% reduction)
- config-validate.md: 1,592 → 481 lines (70% reduction)
- security-dependencies.md: 1,795 → 522 lines (71% reduction)
- migration-observability.md: 1,858 → 408 lines (78% reduction)
- sql-migrations.md: 1,600 → 492 lines (69% reduction)
- accessibility-audit.md: 1,229 → 483 lines (61% reduction)
- monitor-setup.md: 1,250 → 501 lines (60% reduction)

Optimization techniques:
- Removed redundant examples (kept 1-2 best vs 5-8)
- Consolidated similar code blocks
- Eliminated verbose prose and documentation
- Streamlined framework-specific examples
- Removed duplicate patterns

PERFORMANCE IMPROVEMENTS
========================

Context & Loading:
- Average tool size: 954 → 626 lines (58% reduction)
- Loading time improvement: 2-3x faster
- Better LLM context window utilization
- Lower token costs (58% less content to process)

Quality Metrics:
- Component references validated: 223 (0 broken)
- Tool duplication: 12.6% (minimal, intentional)
- Naming compliance: 100% (kebab-case standard)
- Component coverage: 90.5% tools, 82.1% agents
- Functional regressions: 0 (zero breaking changes)

ARCHITECTURE PRINCIPLES
=======================

Single Responsibility:
- Each plugin does one thing well (Unix philosophy)
- Clear, focused purposes (describable in 5-7 words)
- Zero bloated plugins (all under 12 components)

Industry Best Practices:
- VSCode extension patterns (focused, composable)
- npm package model (single-purpose modules)
- Chrome extension policy (narrow focus)
- Microservices decomposition (by subdomain)

Design Philosophy:
- Composability over bundling (mix and match)
- Context efficiency (smaller = faster)
- High cohesion, low coupling (related together, independent modules)
- Clear discoverability (descriptive names)

BREAKING CHANGES
================

Plugin names changed (old → new):
- infrastructure-devops → kubernetes-operations, docker-containerization,
  deployment-orchestration
- security-hardening → security-scanning, security-compliance,
  backend-api-security, frontend-mobile-security
- data-ml-pipeline → data-engineering, machine-learning-ops,
  ai-agent-development
- api-development-kit → api-scaffolding, api-testing-observability
- incident-response → incident-diagnostics, observability-monitoring

Users must update plugin references if using explicit plugin names.
Default marketplace discovery requires no changes.

SUMMARY
=======

Total Impact:
- 36 focused, single-purpose plugins (from 27, +33%)
- 24,392 lines eliminated (58% reduction in problematic files)
- 18 files removed/optimized
- 0 functionality lost
- 0 broken references
- Production ready

Files changed:
- Modified: marketplace.json (v1.0.5), README.md, 10 optimized tools
- Deleted: 8 legacy monolithic files
- Net: +2,273 insertions, -28,875 deletions (-26,602 lines total)

Version: 1.0.5
Status: Production ready, fully validated, zero regressions
 2025-10-12 16:39:53 -04:00
Seth Hobson
bd145d26e2 refactor: streamline 5 tool files from verbose to concise format 
Significantly reduced verbosity while retaining core capabilities:
- data-pipeline.md: 2311 → 186 lines
- langchain-agent.md: reduced extensive examples
- smart-debug.md: condensed to essential directives
- tdd-red.md: streamlined TDD workflow
- tdd-refactor.md: simplified refactoring guidance

Each file now focuses on:
- Core capabilities summary
- Concise step-by-step instructions
- Key implementation patterns
- Essential best practices

Removed:
- Extensive code examples
- Verbose explanations
- Redundant implementation details
 2025-10-11 20:58:29 -04:00
Seth Hobson
a58a9addd9 feat: comprehensive upgrade of 32 tools and workflows 
Major quality improvements across all tools and workflows:
- Expanded from 1,952 to 23,686 lines (12.1x growth)
- Added 89 complete code examples with production-ready implementations
- Integrated modern 2024/2025 technologies and best practices
- Established consistent structure across all files
- Added 64 reference workflows with real-world scenarios

Phase 1 - Critical Workflows (4 files):
- git-workflow: 9→118 lines - Complete git workflow orchestration
- legacy-modernize: 10→110 lines - Strangler fig pattern implementation
- multi-platform: 10→181 lines - API-first cross-platform development
- improve-agent: 13→292 lines - Systematic agent optimization

Phase 2 - Unstructured Tools (8 files):
- issue: 33→636 lines - GitHub issue resolution expert
- prompt-optimize: 49→1,207 lines - Advanced prompt engineering
- data-pipeline: 56→2,312 lines - Production-ready pipeline architecture
- data-validation: 56→1,674 lines - Comprehensive validation framework
- error-analysis: 56→1,154 lines - Modern observability and debugging
- langchain-agent: 56→2,735 lines - LangChain 0.1+ with LangGraph
- ai-review: 63→1,597 lines - AI-powered code review system
- deploy-checklist: 71→1,631 lines - GitOps and progressive delivery

Phase 3 - Mid-Length Tools (4 files):
- tdd-red: 111→1,763 lines - Property-based testing and decision frameworks
- tdd-green: 130→842 lines - Implementation patterns and type-driven development
- tdd-refactor: 174→1,860 lines - SOLID examples and architecture refactoring
- refactor-clean: 267→886 lines - AI code review and static analysis integration

Phase 4 - Short Workflows (7 files):
- ml-pipeline: 43→292 lines - MLOps with experiment tracking
- smart-fix: 44→834 lines - Intelligent debugging with AI assistance
- full-stack-feature: 58→113 lines - API-first full-stack development
- security-hardening: 63→118 lines - DevSecOps with zero-trust
- data-driven-feature: 70→160 lines - A/B testing and analytics
- performance-optimization: 70→111 lines - APM and Core Web Vitals
- full-review: 76→124 lines - Multi-phase comprehensive review

Phase 5 - Small Files (9 files):
- onboard: 24→394 lines - Remote-first onboarding specialist
- multi-agent-review: 63→194 lines - Multi-agent orchestration
- context-save: 65→155 lines - Context management with vector DBs
- context-restore: 65→157 lines - Context restoration and RAG
- smart-debug: 65→1,727 lines - AI-assisted debugging with observability
- standup-notes: 68→765 lines - Async-first with Git integration
- multi-agent-optimize: 85→189 lines - Performance optimization framework
- incident-response: 80→146 lines - SRE practices and incident command
- feature-development: 84→144 lines - End-to-end feature workflow

Technologies integrated:
- AI/ML: GitHub Copilot, Claude Code, LangChain 0.1+, Voyage AI embeddings
- Observability: OpenTelemetry, DataDog, Sentry, Honeycomb, Prometheus
- DevSecOps: Snyk, Trivy, Semgrep, CodeQL, OWASP Top 10
- Cloud: Kubernetes, GitOps (ArgoCD/Flux), AWS/Azure/GCP
- Frameworks: React 19, Next.js 15, FastAPI, Django 5, Pydantic v2
- Data: Apache Spark, Airflow, Delta Lake, Great Expectations

All files now include:
- Clear role statements and expertise definitions
- Structured Context/Requirements sections
- 6-8 major instruction sections (tools) or 3-4 phases (workflows)
- Multiple complete code examples in various languages
- Modern framework integrations
- Real-world reference implementations
 2025-10-11 15:33:18 -04:00
Seth Hobson
18f7f6a0b9 Upgrade context-restore.md with advanced context restoration strategies and modern 2024/2025 patterns 2025-10-11 15:16:51 -04:00
Seth Hobson
fa0fb68008 fix: clarify instructions vs examples in doc-generate tool 
Restructure doc-generate.md to clearly distinguish between:
- Concise, directive instructions (what to create)
- Detailed reference examples (how to create it)

Changes:
- Add "How to Use This Tool" section explaining structure
- Rewrite Instructions section to be concise and directive (75 lines)
- Rename and relabel all examples with clear "Example N:" format
- Add purpose statements and "Implementation Example:" labels
- Keep all existing reference code intact

Addresses user feedback in issue #87 about ambiguity between
instructions and examples that could confuse LLMs and humans.

Closes #87
 2025-10-11 13:39:24 -04:00
Seth Hobson
1072d9278e Fix agent count documentation 
- Update total agent count: 83 → 84
- Correct model distribution:
  - Sonnet: 52 → 50
  - Opus: 20 → 23
  - Haiku: 11 (unchanged)
- Fix Opus agent categorization:
  - Architecture & Design: 5 agents
  - Security & Code Review: 5 agents
  - Performance & Observability: 3 agents
  - AI/ML Complex: 5 agents
  - Business Critical: 5 agents
- Correct agent names in tables (architect-review vs architect-reviewer)
- Add missing agents to appropriate categories (risk-manager, database-architect)

Closes #88
 2025-10-11 11:12:07 -04:00
Seth Hobson
dc42c9d53a Migrate implementation-focused agents to Sonnet model 
- Update terraform-specialist from opus to sonnet
- Update database-optimizer from opus to sonnet
- Update tdd-orchestrator from opus to sonnet
- Update tutorial-engineer from opus to sonnet
- Update README.md with new model distribution (Sonnet: 52, Opus: 20)
- Remove duplicate agents/README.md file

These agents are implementation-focused rather than reasoning-focused,
making Sonnet the more appropriate model choice. This change follows
feedback from PR #72 while maintaining our task-complexity-tier
philosophy.
 2025-10-11 10:45:19 -04:00
Seth Hobson
61898aea32 Fix installation instructions to use HTTPS URL format 
- Update primary installation method to use full HTTPS URL
- Remove redundant manual installation section
- Simplify instructions to two commands
- Resolves SSH authentication issues reported in #85

Users were experiencing "Failed to clone marketplace repository" errors
when using the short format (wshobson/agents) because Claude Code
defaults to SSH cloning. Using the full HTTPS URL bypasses this issue.
 2025-10-11 09:55:36 -04:00
Seth Hobson
652cc9ab28 Update installation instructions to reflect /plugin command flow 
- Replace Quick Start section with interactive /plugin command instructions
- Add note about using wshobson/agents as marketplace source
- Simplify installation steps to match actual UI prompts
- Keep Available Plugins section as reference
 2025-10-09 12:33:02 -04:00
Seth Hobson
79f89500a4 Merge pull request #78 from wshobson/feature/plugin-marketplace 
Feature/plugin marketplace
 2025-10-09 12:01:22 -04:00
Seth Hobson
3802bca865 Refine plugin marketplace for launch readiness 
Plugin Scope Improvements:
- Remove language-specialists plugin (not task-focused)
- Split specialized-domains into 5 focused plugins:
  * blockchain-web3 - Smart contract development only
  * quantitative-trading - Financial modeling and trading only
  * payment-processing - Payment gateway integration only
  * game-development - Unity and Minecraft only
  * accessibility-compliance - WCAG auditing only
- Split business-operations into 3 focused plugins:
  * business-analytics - Metrics and reporting only
  * hr-legal-compliance - HR and legal docs only
  * customer-sales-automation - Support and sales workflows only
- Fix infrastructure-devops scope:
  * Remove database concerns (db-migrate, database-admin)
  * Remove observability concerns (observability-engineer)
  * Move slo-implement to incident-response
  * Focus purely on container orchestration (K8s, Docker, Terraform)
- Fix customer-sales-automation scope:
  * Remove content-marketer (unrelated to customer/sales workflows)

Marketplace Statistics:
- Total plugins: 27 (was 22)
- Tool coverage: 100% (42/42 tools referenced)
- Fat plugins removed: 3 (language-specialists, specialized-domains, business-operations)
- All plugins now have clear, focused tasks

Model Migration:
- Migrate all 42 tools from claude-sonnet-4-0/opus-4-1 to model: sonnet
- Migrate all 15 workflows from claude-opus-4-1 to model: sonnet
- Use short model syntax consistent with agent files

Documentation Updates:
- Update README.md with refined plugin structure
- Update plugin descriptions to be task-focused
- Remove anthropomorphic and marketing language
- Improve category organization (now 16 distinct categories)

Ready for October 9, 2025 @ 9am PST launch
 2025-10-08 20:54:29 -04:00