README

Claude Code Plugins

A collection of plugins for Claude Code that bootstrap new projects with a quality + security toolchain baked in, then maintain, review, and ship changes with maximum safe automation — pulling a human into the loop only when human judgment is genuinely required.

Why

Bootstrap projects fast, ship high-quality and secure-by-default software, and use Claude for maximum automation — building the seams, gates, and policies today so that as the model gets stronger, the share of work it can safely close out without a human grows automatically.

What's in the box

Plugin	Purpose
development	Language-agnostic workflow tooling — bootstrap, maintenance orchestrator, commit, resolve-issue, refine-issue, define-personas, open-pr, branch naming
development-python	Full Python maintenance tier — triage, autonomous upgrades, coverage, review, Approver
development-java	Full Java/Gradle maintenance tier (Gradle + Kotlin DSL only)
development-swift	Full Swift maintenance tier — incl. Swift 6 migration
development-go	Full Go maintenance tier — triage, coverage, autonomous upgrades, review, Approver, proto-first advisors
development-spring	Topic plugin for Spring Boot 4+ (composes alongside development-java)
development-claude-plugin	Topic plugin for repos that are Claude Code plugins — validators + test harness
development-docs	Topic plugin for documentation (C4 architecture docs; marker `docs/architecture/`) — dispatch path only in v1
development-react	Topic plugin for React (composes alongside development-javascript; marker `react` in a `package.json`'s runtime deps) — composition wiring only in v0.1
development-kubernetes	Topic plugin for infrastructure-as-code (Kubernetes manifests, Helm, Kustomize, Argo CD; may be primary for a repo with no application language) — ownership boundary, maintenance dispatch, and the agents and review panel in v0.3; its CI pipeline ships as a `development` bootstrap template (six requirable checks over rendered output); test fixtures still to come

Full command + agent inventory: docs/reference/plugins.md.

Install & use

claude --plugin-dir ./development --plugin-dir ./development-python

/development:bootstrap        # install the quality + security toolchain
/development:maintenance      # fix everything safely fixable on this project
/development:resolve-issue 42 # drive an issue (or epic) to a merge-ready PR

New here? Start with the Getting started tutorial. Prerequisites (macOS + Homebrew, gh): Requirements.

Documentation

Full documentation lives under docs/ and follows the Diátaxis framework:

📚 Tutorials — learning-oriented
🔧 How-to guides — task-oriented
📖 Reference — lookup
💡 Explanation — concepts & rationale
🏗 Architecture — C4 System Context + Container diagrams

Contributor-facing contracts stay at the repo root: ARCHITECTURE.md (architecture & schema) and MAINTAINING.md (quarterly template refresh).

Contributing

main is protected: PRs only, 1 approving review, all required checks green, and cryptographically signed commits required. See How-to: contribute for the SSH-signing setup.

License

MIT

Rendered live from timo-jakob/timos-claude-code-plugins's GitHub README — not stored, always reflects the source repo.

11 Plugins

Name	Description	Category	Source
development-swift	Swift development plugin with code review, formatting/linting, and Swift-specific tooling.	development	./development-swift
development-go	Go maintenance + review plugin. Review panel: /development-go:review runs 6 specialist agents, with go-resilience-reviewer anchored to the bootstrap sony/gobreaker payload as its reference implementation (#1144). Maintenance dispatches findings from /development:maintenance to go-format-lint-fixer (golangci-lint v2), the static-analysis triage agents go-sonar-triage + go-code-scanning-triage + go-semgrep-triage, go-maintenance-planner, and go-ci-fixer, with a per-package coverage pre-flight (go test -coverprofile) that spawns go-coverage-improver in a worktree when affected code sits below Required. The go-approver synthesis layer posts merge verdicts via /development-go:approve, fed by the 6 review dimensions the Approver walks as risk-register lenses — the panel's own dimension table, resilience included (#1147). The proto-first advisors go-grpc-advisor (buf codegen) and go-api-contract-advisor (grpc-gateway REST facade + 2.0→3.0 OpenAPI pipeline) audit the API-contract wiring. Blessed toolchain: Go modules, Taskfile, golangci-lint v2, go test -coverprofile, buf + grpc-gateway, ko.	development	./development-go
development	General development workflow skills for committing, branch naming, and other git operations, plus the shared telemetry/v1 emit + validate contract, its stream-generic rollup, and a committed Grafana reference dashboard for the cross-repo hand-off; ships a PreToolUse(Agent) hook, inert unless switch_fable_to_opus is truthy, that then redirects dispatches whose effective model is fable to opus; bootstrap also ships the blessed Spring, non-Spring-Java, Python and Go resilience + dependency-health payloads (resilience4j for the JVM, circuitbreaker+tenacity for Python, sony/gobreaker for Go, wired to the ops-api /health surface). Gathers kubernetes/IaC findings (Helm/Kustomize/Argo CD manifest presence, Kyverno policy + policy-test detection) for the development-kubernetes topic dispatcher.	development	./development
development-python	Python maintenance dispatcher — fixes ruff / semgrep / Code Scanning / SonarCloud findings autonomously via per-tool agents in parallel worktrees, auto-bumps deps (patch + minor + major) with test-based verification. Favors autonomy over speed: expect tens-of-thousands of tokens per run.	development	./development-python
development-java	Java/Gradle maintenance plugin — full-maintenance tier mirroring development-python. Dispatches per-tool agents (Spotless, SonarCloud, CodeQL/Scorecard, semgrep, Dependabot/Snyk PRs, Gradle major upgrades) in worktrees, with a JaCoCo coverage pre-flight; ships the java-approver reviewer + /development-java:approve. JDK runtime upgrades land in a later slice (#308).	development	./development-java
development-spring	Spring framework TOPIC plugin — composes alongside development-java for Java + Spring Boot 4+ repos (baseline Spring Framework 7 / Jakarta EE 11; older Boot lines out of scope). Audits Spring configuration via spring-config-advisor, plus a conforms-to-ops-api check whose recommendations branch on whether the repo has adopted the Spring resilience payload (which owns /health via its opshealth endpoint); reuses java-ci-fixer for CI. Incremental: config audit in v0.1; a Spring Boot version-upgrade agent, bootBuildImage, and the contract-first API drift gate land in later slices (#296).	development	./development-spring
development-claude-plugin	Plugin family for projects that ARE Claude Code plugins. Ships a test harness (/development-claude-plugin:test), a review panel (/development-claude-plugin:review — prose logic, contract integrity, script quality, tests, manifests), and a maintenance dispatcher that validates plugin conventions and composes alongside the language plugin. Validators: version sync, SKILL.md/agent frontmatter, orphaned skill/agent references, directory layout, and shell-script quality (shellcheck / zsh -n).	development	./development-claude-plugin
development-docs	Language-agnostic documentation topic plugin. Composes ALONGSIDE the language plugin via /development:maintenance (a TOPIC plugin, like development-spring), triggered by the docs/architecture/ marker. Ships the c4_drift finding source (declared C4 containers vs detected reality → docs-c4-drift-advisor).	development	./development-docs
development-javascript	JavaScript/TypeScript maintenance plugin (foundation slice, #729). Receives findings from /development:maintenance, validates its JSON payload, and dispatches the format_lint group to js-format-lint-fixer (ESLint --fix + Prettier --write), with js-ci-fixer handling CI-failure remediation on the resulting PRs. Blessed toolchain installed by /development:bootstrap: flat eslint.config.js, Prettier @120, vitest + v8 coverage, a strict tsconfig base, npm, and Node 24 LTS. The contract-consumer machinery (orval typed client + MSW), the review panel, static-analysis triage, coverage, vendor PRs, and the approver land in later slices of #683.	development	./development-javascript
development-react	React framework topic plugin (foundation slice, #956). Composes ALONGSIDE development-javascript via /development:maintenance (a TOPIC plugin, like development-spring composes with development-java), triggered by the React marker — `react` in the runtime dependencies of any package.json — and only when javascript is also detected. This slice ships the composition wiring only: a real but tool-less gather that places `react` in supported_topics, and a dispatcher stub returning a zero-group plan, reusing js-ci-fixer for CI remediation.	development	./development-react
development-kubernetes	Infrastructure-as-code topic plugin for Kubernetes manifests, Helm charts, Kustomize overlays and Argo CD resources. Composes ALONGSIDE a language plugin, and can itself be PRIMARY for a repo with no application language (a GitOps repo). Charter — mechanism only: render and validate manifests, and run the repo's own Kyverno policies from policies/kyverno/*/.{yaml,yml}, skipping when no policy file matches. Defers Dockerfiles and image builds to language plugins (language-first). Ships no approver agent — a cluster definition is approved by a human. This slice adds the five agents and the review panel (#1153): the security, reliability and Argo CD review dimensions behind /development-kubernetes:review, plus the manifest fixer and policy triage agents the maintenance dispatcher now routes every finding group to. Its CI pipeline ships as a `development` bootstrap template — six requirable checks over rendered manifests (#1154).	development	./development-kubernetes

timos-claude-code-plugins

Install to Claude Code