convez.ai
SkillDevOps & InfraestruturaAvançado
wfukatsu

Nexus Architect

wfukatsu/nexus-architect

Agente unificado para arquitetura, refatoração e design de sistemas com ScalarDB

Ver no GitHub
InicialPluginScore · de 0 a 100

Kit completo de arquitetura de sistemas para Claude Code e Codex com 52 skills distribuídas em 9 categorias. Oferece capacidades de refatoração legada, design greenfield, migração de bancos de dados ScalarDB e entrega de consultorias técnicas com geração de relatórios e diagramas Mermaid.

Instalação

$npx convez-ai wfukatsu/nexus-architect

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
14
Forks
1
Acompanhando
1
Saúde
42%
Último commit
há 3 dias
Versão
v0.69.0
Issues abertas
1
Contribuidores
1

Casos de uso

  • Refatoração de sistemas legados com análise estruturada
  • Design de aplicações greenfield com ScalarDB
  • Migração de bancos de dados e modernização de arquitetura
  • Geração de relatórios técnicos e diagramas de arquitetura
  • Consultorias e avaliações de código em projetos complexos

Veredito

Ferramenta robusta e bem-estruturada para arquitetos de software que trabalham com análise e refatoração de sistemas complexos. Integração nativa com Claude Code/Codex e suporte a ScalarDB são diferenciais, mas requer conhecimento avançado de arquitetura para aproveitamento máximo.

README

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

Nexus Architect

System architecture toolkit for Claude Code and Codex. Claude Code uses this repository as two plugins with 52 skills; Codex uses the same skill files through AGENTS.md compatibility rules.

  • architect (41 skills) — Legacy refactoring, greenfield design, database migration, consulting deliverables
  • scalardb (11 skills) — ScalarDB application development toolkit

Installation

As a Claude Code Plugin (Recommended)

# 1. Add the marketplace
claude plugin marketplace add wfukatsu/nexus-architect

# 2. Install both plugins
claude plugin install architect@nexus-architect --scope user
claude plugin install scalardb@nexus-architect --scope user

After installation, commands are available as /architect:skill-name and /scalardb:skill-name.

To update to the latest version:

claude plugin update architect@nexus-architect
claude plugin update scalardb@nexus-architect

Manual Installation

# 1. Clone the repository
git clone https://github.com/wfukatsu/nexus-architect.git

# 2. Add as a local marketplace
claude plugin marketplace add ./nexus-architect

# 3. Install both plugins
claude plugin install architect@nexus-architect --scope user
claude plugin install scalardb@nexus-architect --scope user

Verify Installation

In a Claude Code session, type any command to confirm:

/architect:start
/scalardb:model

If the skills are recognized, the installation is successful.

Using with Codex

Codex can use the same skill files without installing Claude Code plugins.

# 1. Clone the repository
git clone https://github.com/wfukatsu/nexus-architect.git
cd nexus-architect

# 2. Optional Python dependencies
pip install -r requirements.txt

Open Codex at the repository root. AGENTS.md tells Codex how to translate Claude Code conventions:

  • /architect:<name> -> skills/<name>/SKILL.md
  • /scalardb:<name> -> skills/<name>/SKILL.md
  • CLAUDE_PLUGIN_ROOT -> the repository root
  • .claude/docs/* -> skills/common/references/*
  • .claude/rules/* -> rules/*
  • ${CLAUDE_PLUGIN_ROOT}/subagents/* -> skills/common/subagents/*

Then invoke the same command text in chat:

/architect:start ./path/to/target
/architect:pipeline ./path/to/target
/scalardb:model
/scalardb:review-code ./path/to/app

When a skill asks to use Claude tools, Codex follows these mappings:

Claude Code referenceCodex behavior
Read, Glob, Grep, LSUse shell reads, rg, rg --files, find, or ls
Write, Edit, MultiEditEdit files with apply_patch
BashRun shell commands
AskUserQuestionPresent numbered choices in chat and wait for the reply
Task, SubagentRun in the main Codex thread unless the user explicitly asks for sub-agents
WebFetch, WebSearchUse Codex web access, Context7, or approved curl

After editing generated reports or Mermaid diagrams in Codex, run the hooks manually when relevant:

hooks/validate-frontmatter.sh reports/before/example/technology-stack.md
hooks/validate-mermaid.sh reports/before/example/codebase-structure.md

Claude Code continues to use the plugin metadata and slash commands unchanged. See Using Nexus Architect with Codex for the full Codex guide.

Quick Start

# Interactive workflow (recommended)
/architect:start ./path/to/target

# Automated full pipeline
/architect:pipeline ./path/to/target

# Individual skills
/architect:investigate ./path/to/target
/architect:analyze ./path/to/target
/architect:evaluate-mmi ./path/to/target

# ScalarDB development
/scalardb:scaffold
/scalardb:model
/scalardb:build-app

Commands

Orchestration

CommandDescription
/architect:startInteractively start system analysis and design
/architect:pipelineAutomated pipeline execution (supports --resume, --skip)
/architect:init-outputInitialize output directories

Requirements

CommandDescription
/architect:define-requirementsRequirements definition: FR/NFR classification, data/transaction requirements, ScalarDB applicability (greenfield entry point)

Investigation & Analysis

CommandDescription
/architect:investigateTech stack, structure, debt, DDD readiness survey
/architect:investigate-securityOWASP Top 10, access control assessment
/architect:analyzeUbiquitous language, actors, domain mapping
/architect:analyze-data-modelData model, DB design, ER diagrams

Evaluation

CommandDescription
/architect:evaluate-mmiMMI 4-axis qualitative evaluation
/architect:evaluate-dddDDD 12-criteria 3-layer evaluation
/architect:integrate-evaluationsMMI+DDD integration, improvement plan

Design

CommandDescription
/architect:map-domainsDomain classification, BC mapping
/architect:redesignBounded context redesign
/architect:design-microservicesTarget architecture
/architect:select-scalardb-editionScalarDB edition selection
/architect:design-scalardbScalarDB schema and transaction design
/architect:design-scalardb-analyticsHTAP analytics platform design
/architect:design-data-layerGeneric DB design (non-ScalarDB)
/architect:design-apiREST/GraphQL/gRPC/AsyncAPI specifications

Implementation & Codegen

CommandDescription
/architect:design-implementationImplementation specifications
/architect:generate-test-specsBDD/unit/integration test specifications
/architect:generate-scalardb-codeSpring Boot + ScalarDB code generation
/architect:generate-infra-codeK8s/Terraform/Helm code generation

Infrastructure

CommandDescription
/architect:design-infrastructureK8s, IaC, multi-environment
/architect:design-securityAuthentication, authorization, secrets management
/architect:design-observabilityMonitoring, tracing, alerting
/architect:design-disaster-recoveryRTO/RPO, backup, DR

Review (5-perspective parallel)

CommandDescription
/architect:review-consistencyStructural coherence
/architect:review-scalardbScalarDB constraints
/architect:review-data-integrityData integrity (non-ScalarDB)
/architect:review-operationsOperational readiness
/architect:review-riskDistributed system risks
/architect:review-businessBusiness requirements
/architect:review-synthesizerConsolidation and quality gate

Reporting

CommandDescription
/architect:reportMarkdown to HTML consolidated report
/architect:render-mermaidMermaid to PNG/SVG + syntax fix
/architect:estimate-costInfrastructure, license, and operational costs

Database Migration

CommandDescription
/architect:migrate-databaseUnified migration router (Oracle/MySQL/PostgreSQL)
/architect:migrate-oracleOracle to ScalarDB (schema, analysis, AQ, SP/trigger)
/architect:migrate-mysqlMySQL to ScalarDB (schema, analysis, SP/trigger)
/architect:migrate-postgresqlPostgreSQL to ScalarDB (schema, analysis, SP/trigger)

ScalarDB Development (/scalardb:*)

CommandDescription
/scalardb:modelInteractive schema design wizard
/scalardb:configConfiguration file generator (6 interface combos)
/scalardb:scaffoldComplete starter project generator
/scalardb:error-handlerException handling code generator and reviewer
/scalardb:crud-opsCRUD API operation patterns guide
/scalardb:jdbc-opsJDBC/SQL operation patterns guide
/scalardb:local-envDocker Compose local environment setup
/scalardb:docsScalarDB documentation search
/scalardb:build-appBuild complete app from requirements
/scalardb:review-codeJava code review (16 check categories)
/scalardb:migrateMigration advisor (Core/Cluster, CRUD/JDBC, 1PC/2PC)

Workflows

Legacy Refactoring

Analyze existing systems, evaluate architecture maturity, and design microservices transformation.

investigate -> analyze -> evaluate -> redesign -> implement -> review -> report

Greenfield Design

Design new systems from requirements through ScalarDB architecture to deployment.

requirements -> domain modeling -> ScalarDB design -> infra -> deploy

ScalarDB Application Development

Build ScalarDB applications with guided schema design, code generation, and code review.

/scalardb:model -> /scalardb:config -> /scalardb:scaffold -> /scalardb:review-code

Database Migration to ScalarDB

Migrate existing Oracle, MySQL, or PostgreSQL databases to ScalarDB with automated schema analysis, migration planning, and Java code generation.

migrate-database -> schema extraction -> migration analysis -> SP/trigger conversion -> (AQ integration)

Pipeline Dependency Graph

investigate -> analyze -> [evaluate-mmi, evaluate-ddd] -> integrate-evaluations
  -> redesign -> design-microservices -> [design-scalardb | design-data-layer, design-api]
  -> [review-consistency, review-scalardb | review-data-integrity,
     review-operations, review-risk, review-business]
  -> review-synthesizer -> report

Output Language

Output language is configurable per project. Set during /architect:start initialization or via flag:

/architect:pipeline ./path/to/project --lang=ja

Supported: en (English, default), ja (Japanese).

Output Structure

All outputs are written to git-ignored directories:

reports/          # Analysis and design documents
generated/        # Generated code per service
work/             # Pipeline state and intermediate files

Requirements

  • Claude Code CLI (latest), for Claude Code plugin usage
  • Codex, for Codex usage
  • Python 3.9+
  • Node.js 18+ (optional, for Mermaid rendering)

Optional MCP Servers

  • Serena: Advanced code analysis with AST-level understanding
  • Context7: Latest ScalarDB documentation

Documentation

DocumentDescription
Getting StartedInstallation and first steps
Codex UsageUsing the same skills from Codex
Skill ReferenceComplete skill catalog
ScalarDB DevelopmentScalarDB development guide
Database MigrationMigration guide (Oracle/MySQL/PostgreSQL)

Japanese translations: Getting Started (日本語) | Codex Usage (日本語) | Skill Reference (日本語) | ScalarDB Development (日本語) | Database Migration (日本語)

License

MIT

Ver o original no GitHub

Bom para

Relacionados