{
  "markdown": "# Proportione Plugins — Claude Code Playbook\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Claude Code](https://img.shields.io/badge/Claude_Code-marketplace-D97706)](https://docs.claude.com/en/docs/claude-code/plugins)\n[![Plugins](https://img.shields.io/badge/plugins-9-5F322F)](#plugins-9-qa-skills)\n[![Guides](https://img.shields.io/badge/guides-8-3B431C)](#playbook-guides)\n[![Last commit](https://img.shields.io/github/last-commit/Proportione/proportione-plugins)](https://github.com/Proportione/proportione-plugins/commits/main)\n\n**One-liner install:**\n\n```bash\nclaude plugin marketplace add Proportione/proportione-plugins\n```\n\n---\n\nHow a 1-3 person IT consultancy uses Claude Code to manage 13 WordPress sites, 4 GCP microservices, a scientific monorepo, and IaC infrastructure — with quality.\n\n## What's here\n\nThis repo is both a **Claude Code plugin marketplace** (installable skills) and a **playbook** of everything we've learned using Claude Code in production since early 2026.\n\n### Plugins (9 QA skills)\n\nInstall the marketplace, then pick what you need:\n\n```bash\nclaude plugin marketplace add Proportione/proportione-plugins\nclaude plugin install deep-review@proportione-plugins\n```\n\n| Plugin | What it does |\n|--------|-------------|\n| `deep-review` | Deep code review for PRs, commits, or files — logic, naming, complexity, tests, security |\n| `check-security` | OWASP-based security audit with Semgrep and manual analysis |\n| `check-architecture` | Validate code against architectural conventions defined in CLAUDE.md |\n| `check-performance` | Performance analysis: N+1 queries, bundle size, Web Vitals, Lighthouse, GCP sizing |\n| `check-wordpress` | Full WordPress QA: accessibility, SEO, links, images, security, performance |\n| `check-wp-visual` | Visual regression testing for WordPress sites using Playwright |\n| `check-terraform` | IaC validation: terraform validate/plan + Checkov + Semgrep |\n| `triage-bug` | Automated bug triage: error analysis, root cause, fix, and PR creation |\n| `update-whitepaper` | Monthly QA whitepaper update with metrics collection and source research |\n\n### Playbook (guides)\n\nHard-won lessons from running Claude Code in a real production environment:\n\n| Guide | Topic |\n|-------|-------|\n| [CLAUDE.md as Contract](guides/claude-md-as-contract.md) | How we use CLAUDE.md as an architectural contract, not documentation |\n| [MCP Servers](guides/mcp-servers.md) | Building MCP servers for ticketing, CRM, BI — and keeping auth working |\n| [Playwright Tricks](guides/playwright-tricks.md) | Automating Google services, Synology DSM, Looker Studio, and more |\n| [QA Framework](guides/qa-framework.md) | The five-layer QA model for AI-generated code |\n| [Operational Rules](guides/operational-rules.md) | Governance rules for Claude Code in automation pipelines |\n| [GCP Patterns](guides/gcp-patterns.md) | Cloud Run, Firestore, BigQuery patterns we use daily |\n| [Sales & Marketing](guides/sales-marketing-with-claude.md) | CRM, prospecting, content, social media — all from the terminal |\n| [Spec-Driven Ecosystem](guides/spec-driven-ecosystem.md) | GSD, Superpowers, SuperClaude, Alfred Dev — how spec tools complement QA |\n\n## Our stack\n\n- **WordPress** (13 sites): Elementor Pro + SiteGround\n- **Backend**: Node.js 20 (Cloud Run), Python 3.14 (FastAPI), Terraform + Ansible\n- **GCP**: Cloud Run, Firestore, BigQuery, Cloud Tasks, Vertex AI\n- **QA tools**: Semgrep, Checkov, Lighthouse, Playwright, axe-core\n- **IA stack**: Claude Code (architect) + Qwen 2.5 Coder 14B local (routine tasks)\n\n## Why publish this\n\nWe wrote a [whitepaper](guides/qa-framework.md) arguing that AI-generated code needs AI-assisted QA. These are the tools we built to back that argument. If you run a small team writing code with Claude, these skills and patterns might save you time.\n\n## Community\n\n- [Discussions](https://github.com/Proportione/proportione-plugins/discussions) — questions, ideas, use cases\n- [Issues](https://github.com/Proportione/proportione-plugins/issues) — bugs, feature requests\n- [Contributing](CONTRIBUTING.md) — how to propose changes\n- [Security policy](SECURITY.md) — how to report vulnerabilities\n- [Code of conduct](CODE_OF_CONDUCT.md)\n\n## License\n\n[MIT](LICENSE)\n\n---\n\nBuilt by [Proportione](https://proportione.com) — strategy, technology, and people.\n",
  "bytes": 4357,
  "sha": "365f09f8e9f22d600b36065549fd0ea821590749ce3343c3c66b6e875ea8c6f7",
  "repo_slug": "proportione/proportione-plugins",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_proportione_proportione_plugins_proporti_4fa80685/readme"
}