add c4 documentation workflow and agents (#129)

* add c4 documentation workflow and agents

* update the c4-code agent to use proper mermaid diagram types

README.md

@@ -4,22 +4,22 @@
 >
 > **🎯 Agent Skills Enabled** — 47 specialized skills extend Claude's capabilities across plugins with progressive disclosure
 
-A comprehensive production-ready system combining **85 specialized AI agents**, **15 multi-agent workflow orchestrators**, **47 agent skills**, and **44 development tools** organized into **63 focused, single-purpose plugins** for [Claude Code](https://docs.claude.com/en/docs/claude-code/overview).
+A comprehensive production-ready system combining **91 specialized AI agents**, **15 multi-agent workflow orchestrators**, **47 agent skills**, and **45 development tools** organized into **65 focused, single-purpose plugins** for [Claude Code](https://docs.claude.com/en/docs/claude-code/overview).
 
 ## Overview
 
 This unified repository provides everything needed for intelligent automation and multi-agent orchestration across modern software development:
 
-- **63 Focused Plugins** - Granular, single-purpose plugins optimized for minimal token usage and composability
-- **85 Specialized Agents** - Domain experts with deep knowledge across architecture, languages, infrastructure, quality, data/AI, documentation, business operations, and SEO
+- **65 Focused Plugins** - Granular, single-purpose plugins optimized for minimal token usage and composability
+- **91 Specialized Agents** - Domain experts with deep knowledge across architecture, languages, infrastructure, quality, data/AI, documentation, business operations, and SEO
 - **47 Agent Skills** - Modular knowledge packages with progressive disclosure for specialized expertise
 - **15 Workflow Orchestrators** - Multi-agent coordination systems for complex operations like full-stack development, security hardening, ML pipelines, and incident response
-- **44 Development Tools** - Optimized utilities including project scaffolding, security scanning, test automation, and infrastructure setup
+- **45 Development Tools** - Optimized utilities including project scaffolding, security scanning, test automation, and infrastructure setup
 
 ### Key Features
 
-- **Granular Plugin Architecture**: 63 focused plugins optimized for minimal token usage
-- **Comprehensive Tooling**: 44 development tools including test generation, scaffolding, and security scanning
+- **Granular Plugin Architecture**: 65 focused plugins optimized for minimal token usage
+- **Comprehensive Tooling**: 45 development tools including test generation, scaffolding, and security scanning
 - **100% Agent Coverage**: All plugins include specialized agents
 - **Agent Skills**: 47 specialized skills following for progressive disclosure and token efficiency
 - **Clear Organization**: 23 categories with 1-6 plugins each for easy discovery
@@ -47,7 +47,7 @@ Add this marketplace to Claude Code:
 /plugin marketplace add wshobson/agents
 ```
 
-This makes all 63 plugins available for installation, but **does not load any agents or tools** into your context.
+This makes all 65 plugins available for installation, but **does not load any agents or tools** into your context.
 
 ### Step 2: Install Plugins
 
@@ -83,8 +83,8 @@ Each installed plugin loads **only its specific agents, commands, and skills** i
 
 ### Core Guides
 
-- **[Plugin Reference](docs/plugins.md)** - Complete catalog of all 63 plugins
-- **[Agent Reference](docs/agents.md)** - All 85 agents organized by category
+- **[Plugin Reference](docs/plugins.md)** - Complete catalog of all 65 plugins
+- **[Agent Reference](docs/agents.md)** - All 91 agents organized by category
 - **[Agent Skills](docs/agent-skills.md)** - 47 specialized skills with progressive disclosure
 - **[Usage Guide](docs/usage.md)** - Commands, workflows, and best practices
 - **[Architecture](docs/architecture.md)** - Design principles and patterns
@@ -125,8 +125,8 @@ Specialized knowledge packages following Anthropic's progressive disclosure arch
 ### Hybrid Model Orchestration
 
 Strategic model assignment for optimal performance and cost:
-- **47 Haiku agents** - Fast execution for deterministic tasks
-- **97 Sonnet agents** - Complex reasoning and architecture
+- **48 Haiku agents** - Fast execution for deterministic tasks
+- **100 Sonnet agents** - Complex reasoning and architecture
 
 Orchestration patterns combine models for efficiency:
 ```
@@ -179,10 +179,10 @@ Uses kubernetes-architect agent with 4 specialized skills for production-grade c
 
 ## Plugin Categories
 
-**23 categories, 63 plugins:**
+**23 categories, 65 plugins:**
 
 - 🎨 **Development** (4) - debugging, backend, frontend, multi-platform
-- 📚 **Documentation** (2) - code docs, API specs, diagrams
+- 📚 **Documentation** (3) - code docs, API specs, diagrams, C4 architecture
 - 🔄 **Workflows** (3) - git, full-stack, TDD
 - ✅ **Testing** (2) - unit testing, TDD workflows
 - 🔍 **Quality** (3) - code review, comprehensive review, performance
@@ -211,7 +211,7 @@ Uses kubernetes-architect agent with 4 specialized skills for production-grade c
 - **Single responsibility** - Each plugin does one thing well
 - **Minimal token usage** - Average 3.4 components per plugin
 - **Composable** - Mix and match for complex workflows
-- **100% coverage** - All 85 agents accessible across plugins
+- **100% coverage** - All 91 agents accessible across plugins
 
 ### Progressive Disclosure (Skills)
 
@@ -225,7 +225,7 @@ Three-tier architecture for token efficiency:
 ```
 claude-agents/
 ├── .claude-plugin/
-│   └── marketplace.json          # 63 plugins
+│   └── marketplace.json          # 65 plugins
 ├── plugins/
 │   ├── python-development/
 │   │   ├── agents/               # 3 Python experts
@@ -235,7 +235,7 @@ claude-agents/
 │   │   ├── agents/               # K8s architect
 │   │   ├── commands/             # Deployment tools
 │   │   └── skills/               # 4 K8s skills
-│   └── ... (61 more plugins)
+│   └── ... (63 more plugins)
 ├── docs/                          # Comprehensive documentation
 └── README.md                      # This file
 ```