convez.ai
AgenteProdutividadeIntermediário
bborbe

Coding — Agente de Revisão de Código com Guidelines

bborbe/coding

Revisão automática de código Go/Python contra guidelines opinativos

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent para Claude Code que enforça 50+ guidelines opinativos para Go e Python através de comandos slash. Realiza revisões automatizadas de PRs e código contra padrões de arquitetura, tratamento de erros, testes e documentação. Inclui geração de testes, auditoria de guias e integração com Git/GitHub.

Instalação

$npx convez-ai bborbe/coding

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 5 dias
Versão
v0.66.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Revisar pull requests contra standards de projeto
  • Gerar testes automatizados para código Go
  • Encontrar guias relevantes antes de implementar features
  • Auditar e melhorar documentação de padrões
  • Automatizar commits com changelog e versionamento

Veredito

Excelente ferramenta para times que buscam consistência em bases grandes de código Go/Python. A abordagem de 50+ guidelines estruturados + agentes especializados elimina discussões repetitivas em PR reviews. Requer investimento inicial em estudar/customizar guides, mas retorno é alto em produtividade.

README

A tradução para o português deste README ainda está na fila.

Coding

CI License: BSD-2-Clause

Opinionated coding guidelines, quality review agents, and slash commands for Go and Python — packaged as a Claude Code plugin.

Overview

Writing consistent, idiomatic code across a large codebase is hard. This plugin bundles 50+ opinionated guides (Go architecture, error handling, testing, HTTP handlers, Python structure, Git workflow, documentation) together with specialized Claude Code agents that enforce them on your code. Install once, then run /coding:code-review or /coding:pr-review to review your work against the full ruleset.

Requirements

Install

claude plugin marketplace add bborbe/coding
claude plugin install coding

Update:

claude plugin marketplace update coding
claude plugin update coding@coding

Quick Start

Review your current branch against all guidelines:

/coding:pr-review

Review code in standard mode (7 agents) or full mode (14 agents):

/coding:code-review standard
/coding:code-review full

Find relevant guides before starting work:

/coding:check-guides "add Prometheus metrics to HTTP handler"

Commit with changelog and version bump:

/coding:commit

Commands

CommandDescription
/coding:pr-reviewReview pull request diff against standards
/coding:code-review [short|standard|full]Review code against guidelines (standard: 7 agents, full: 14)
/coding:check-guides "task"Find relevant guides before implementation
/coding:commitGit commit with changelog and versioning
/coding:go-write-test [basic|standard|integration]Generate Go tests for changed files
/coding:github-release [target] [--dry-run]Release a git repo (cwd, dir, or owner/repo clone-to-tmp) — classify bump, rewrite header, commit, tag, push, PR fallback
/coding:go-version [check|update]Check/update Go version across project files
/coding:improve-guide [file]Refactor guide into structured rule sets
/coding:audit-guide [file]Audit guide against style, structure, and indexing
/coding:audit-agent [file]Audit agent against Agent & Command Development Guide
/coding:audit-skill [path]Audit skill directory against Claude Code Skill Writing Guide
/coding:audit-slash-command [file]Audit slash command against Agent & Command Development Guide
/coding:vscode [dir]Open VS Code in directory
/coding:intellij [dir]Open IntelliJ IDEA in directory

Guides

All guides live in docs/ and can be read standalone without the plugin.

Go — Architecture & Patterns

GuideDescription
Architecture PatternsInterface → Constructor → Struct → Method
Service ImplementationDecision frameworks, type design
Factory PatternDependency composition
Functional OptionsFlexible constructors
Functional CompositionComposable function types
Enum PatternString-based enums
Filter PatternComposable predicates
Boolean Combinator PatternAnd / Or / Not for predicate interfaces
Parse PatternCustom type conversion
CQRSCommand Query Separation
CompositionStruct embedding
ConcurrencyGoroutines, channels
State MachinePhase-dispatched workflows, resumable multi-step processes

Go — Code Quality

GuideDescription
Error Wrappingbborbe/errors patterns
Context Cancellationctx.Done() in loops
Time Injectionbborbe/time, CurrentDateTimeGetter
GoDocDocumentation standards
LoggingStructured logging
glog Levelsglog verbosity-level discipline (legacy projects)
Design PatternsCommon Go patterns

Go — Testing

GuideDescription
Testing GuideGinkgo v2 + Gomega
Test TypesUnit vs integration vs e2e
Mocking GuideCounterfeiter patterns
TDD GuideRed-green-refactor

Go — Infrastructure

GuideDescription
Makefile CommandsBuild targets
Build ArgsBUILD_GIT_VERSION / BUILD_GIT_COMMIT / BUILD_DATE injection + Prometheus build_info
Library GuideLibrary structure
CLI GuideCLI patterns
ValidationInput validation
Prometheus MetricsMetrics implementation
LicensingLicense management
PrecommitPre-commit workflow
Replace DirectiveWhen to use replace in go.mod
LintingStatic analysis
Security LintingSecurity analysis
Kubernetes CRD ControllerCRD types, informer, self-install
Kubernetes Manifest Layoutk8s/ folder, filename suffixes, templating

Go — HTTP & APIs

GuideDescription
HTTP ServiceCanonical admin endpoint block, port 9090, gateway annotations
HTTP HandlersHandler organization
JSON Error HandlerStructured error responses

Python

GuideDescription
Project Structuresrc/ layout, pyproject.toml
ArchitectureConstructor injection
Factory PatternDependency composition
IoC / DIProtocol vs ABC
PydanticData validation
LoggingStructured logging
CLI Argumentsargparse, BaseSettings
Makefile CommandsBuild targets

Workflows & Documentation

GuideDescription
Git CommitCommit workflow
Git WorkflowBranching strategy
ChangelogCHANGELOG.md format
Definition of DoneCompletion checklist
Documentation GuideREADME, docs/, PRDs
README GuideREADME.md standards
PRD GuideProduct Requirements
ADR GuideArchitecture Decisions
Markdown & TodosFormatting standards

Claude Code Authoring

GuideDescription
Agent & Command DevelopmentAgent + slash-command authoring standards
Skill WritingClaude Code skill directory structure
Rule Block Schema### RULE block contract and index schema
ast-grep Rule Writing Guideast-grep YAML conventions for mechanical rule enforcement
Selector Mode GuideIn-session classify + adjudicate procedure for --selector mode

Frontend

GuideDescription
Vue 3 + TypeScriptComposition API, Vite
AstroAstro framework

Agents

Agents are invoked by commands — you rarely call them directly. Each reads its matching guide as source of truth.

AgentDocChecks
go-quality-assistantgo-architecture-patterns.mdNaming, file layout, logging, concurrency, transactions
go-context-assistantgo-context-cancellation-in-loops.mdcontext.Background(), missing ctx.Done() in loops
go-error-assistantgo-error-wrapping-guide.mdfmt.Errorf, bare return err, missing wrapping
go-time-assistantgo-time-injection.mdtime.Time in structs, time.Now() in production
go-factory-pattern-assistantgo-factory-pattern.mdFactory compliance, zero-business-logic
go-http-handler-assistantgo-http-handler-refactoring-guide.mdHandler organization, inline detection
go-test-coverage-assistantgo-testing-guide.mdTest coverage gaps
AgentDocChecks
go-metrics-assistantgo-prometheus-metrics-guide.mdMetric types, naming, labels, pre-init
godoc-assistantgo-doc-best-practices.mdGoDoc completeness and format
go-test-quality-assistantgo-testing-guide.mdGinkgo/Gomega patterns, mock usage
go-security-specialistgo-security-linting.mdVulnerabilities, OWASP
srp-checker—Single Responsibility Principle (unit-level)
go-architecture-assistant—Cross-unit architecture, naive extractions, layering, boundaries
go-version-manager—Go version currency
go-tooling-assistantgo-makefile-commands.mdMakefile, tools.go
AgentDescription
license-assistantLICENSE file, headers, README section
readme-quality-assistantREADME.md completeness
shellcheck-assistantShell script quality
python-quality-assistantPython code quality
python-architecture-assistantCross-module architecture, naive extractions, layering, boundaries
context7-library-checkerLibrary API currency
go-test-writer-assistantGenerate Go tests
guide-improvement-assistantRefactor guides
guide-auditorAudit guides against style/structure/indexing
agent-auditorAudit agent files against Agent & Command Development Guide
slash-command-auditorAudit slash commands against Agent & Command Development Guide
skill-auditorAudit skills against Claude Code Skill Writing Guide
simple-bash-runnerRun build commands
pre-implementation-assistantFind relevant guides
coding-guidelines-finderSearch docs/
release-changelog-assistantClassify semver bump from ## Unreleased + optionally rewrite to conventional-prefix style; invoked by /coding:commit Workflow B, /coding:github-release, and K8s agent/github-releaser
project-docs-finderSearch project docs/

Acceptance Scenarios

End-to-end acceptance walks for the doc-driven review pipeline, following the dark-factory scenario writing guide. Each scenario file under scenarios/ is a manually-walked checklist; promote draft → active after the first successful walk.

#ScenarioValidates
001toolchain-preflightStep 4.0 / Step 0 preflight blocks exit 1 with documented stderr when ast-grep / sg is absent from PATH
002clean-pr-zero-findings/coding:code-review master against a zero-violation diff produces empty Must Fix / Should Fix / Nice to Have (no LLM hallucination)
003scaling-funnel-100-files100-file synthetic fixture: mechanical funnel ≤30s, distinct Owners ≤30 (structural ceiling on Step 4b LLM calls)
004findings-exist-path/coding:pr-review against the stable test PR bborbe/maintainer#2: Step 4a surfaces ≥4 findings, every Owner has an agent file, citation discipline holds

Contributing

Issues and pull requests welcome at github.com/bborbe/coding.

Guides are the source of truth — agents enforce them. To propose a rule change, edit the relevant file in docs/ and open a PR.

License

BSD-2-Clause. See LICENSE.

Ver o original no GitHub

Bom para

Relacionados