convez.ai
PluginProdutividadeIntermediário
10CG

Aria — AI-DDD para Desenvolvimento Colaborativo

10CG/Aria

Metodologia AI-DDD para IA como colaboradora genuína em software

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin que implementa a metodologia AI-DDD (AI-Assisted Domain-Driven Design) para transformar Claude em um colaborador genuíno em projetos de software. Estrutura o desenvolvimento através de um ciclo de 10 passos, mantendo estado do projeto, sincronizando documentação e especificações, e garantindo que IA compreenda o contexto e as convenções do seu projeto.

Instalação

$npx convez-ai 10CG/Aria

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
2
Forks
0
Acompanhando
0
Saúde
37%
Último commit
há 1 semana
Versão
—
Issues abertas
0
Contribuidores
3

Casos de uso

  • Estruturar fluxo de trabalho entre desenvolvedores e Claude com contexto persistente
  • Especificar requisitos com OpenSpec e rastrear mudanças com auditoria
  • Desenvolver com TDD garantindo testes primeiro e documentação sincronizada
  • Brainstorming colaborativo onde IA participa de decisões arquiteturais

Veredito

Aria é uma abordagem séria e estruturada para elevar IA de 'ferramenta que gera código' para 'colaboradora que entende projeto'. Ideal para equipes que buscam reprodutibilidade, rastreabilidade e contexto persistente—exige disciplina metodológica mas entrega ganhos reais em consistência e eficiência.

README

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

English | 中文 | 日本語 | 한국어

Aria

Make AI a genuine collaborator in your software projects

License: MIT Plugin Version


What is Aria?

Aria is an AI-DDD (AI-Assisted Domain-Driven Design) methodology that enables AI assistants like Claude Code to deeply participate in the entire software development lifecycle through structured workflows.

Unlike traditional "AI writes code" tools, Aria focuses on: how to make AI understand project intent and become a valuable collaborator.

Traditional ModeAria Mode
AI is a tool — you ask, AI answersAI is a collaborator — AI understands, you confirm, you deliver together

Aria 2.0 (v2.0.0, in progress) extends the methodology to autonomous execution. See docs/architecture/system-architecture.md for the two-layer architecture.


Why Aria?

The Problem

  • AI suggestions don't follow your project conventions
  • You re-explain project context every session
  • Code and documentation drift apart
  • Requirement changes have no audit trail

The Solution

FeatureDescription
State AwarenessAI automatically scans your project and understands current progress
Spec FirstOpenSpec standardizes requirement descriptions
Ten-Step CycleStructured AI collaboration workflow
Docs in SyncArchitecture docs evolve with your code
TDD DrivenTest-first development with enforcement
Collaborative ThinkingStructured brainstorming with AI participation

See the Aria 2.0 PRD for the roadmap and autonomous execution vision.


Quick Start

Prerequisites

  • Claude Code installed and authenticated
  • Git 2.x+ (if using the standards submodule)

Install the Aria Plugin

# Add marketplace
/plugin marketplace add 10CG/aria-plugin

# Install (Skills + Agents included)
/plugin install aria@10CG-aria-plugin

Install Standards (Optional)

The standards submodule provides OpenSpec requirement specifications. Skip this if you don't need spec-driven workflows.

# HTTPS
git submodule add https://github.com/10CG/aria-standards.git standards

# Or SSH
git submodule add git@github.com:10CG/aria-standards.git standards

Configure Your Project

Create .aria/config.json from the template, or simply start using Aria:

# Scan project status
/aria:state-scanner

# Create a requirement spec
/aria:spec-drafter

# Structured brainstorming
/aria:brainstorm

# Call a specialized agent
/aria:tech-lead Please plan the architecture for this feature

How It Works: The Ten-Step Cycle

flowchart LR
    subgraph A["A. Planning"]
        A0[A.0 Scan] --> A1[A.1 Spec] --> A2[A.2 Plan] --> A3[A.3 Assign]
    end
    subgraph B["B. Development"]
        B1[B.1 Branch] --> B2[B.2 Develop + Review]
    end
    subgraph C["C. Integration"]
        C1[C.1 Commit] --> C2[C.2 Merge]
    end
    subgraph D["D. Closure"]
        D1[D.1 Update] --> D2[D.2 Archive]
    end
    A3 --> B1
    B2 --> C1
    C2 --> D1

Each phase has a dedicated Skill that ensures consistent, repeatable workflows:

PhaseWhat Happens
A. PlanningScan project state → Create spec → Break down tasks → Assign agents
B. DevelopmentCreate branch → Develop with TDD + code review
C. IntegrationGenerate commit message → Merge to main
D. ClosureUpdate progress → Archive spec

What You Get

Skills (34 user-facing + 7 internal = 41 total)

CategorySkillsPurpose
Cycle Corestate-scanner, workflow-runner, phase-a-planner, phase-b-developer, phase-c-integrator, phase-d-closer, spec-drafter, task-planner, progress-updaterStructured ten-step workflow
Collaborative ThinkingbrainstormStructured brainstorming sessions
Git Workflowcommit-msg-generator, strategic-commit-orchestrator, branch-manager, branch-finisherCommit and branch management
Dev Toolssubagent-driver, tdd-enforcer, requesting-code-reviewTDD enforcement, code review
Architecture Docsarch-search, arch-update, arch-scaffolder, api-doc-generatorKeep docs in sync with code
Requirements & Issuesrequirements-validator, requirements-sync, forgejo-sync, openspec-archive, issue-triageRequirement tracking and issue triage
Project Adaptationproject-analyzer, agent-gap-analyzer, agent-creatorAnalyze projects, identify Agent gaps, generate configs
Observability & Estimationaria-context-monitor, ai-native-estimator, aria-dashboardContext/token telemetry, workload estimation, progress visualization
Feedback & Diagnosticsaria-report, aria-doctorBug reports and environment health checks
Infrastructure (7 internal, non-user-invocable)config-loader, audit-engine, agent-team-audit, agent-router, arch-common, git-remote-helper, aria-token-telemetryConfiguration, audit orchestration, task routing, shared infra

Agents (11)

AgentRole
tech-leadTechnical decisions and architecture planning
context-managerCross-agent context management
knowledge-managerKnowledge base management
code-reviewerCode review
backend-architectBackend architecture design
mobile-developerMobile development
qa-engineerQuality assurance
ai-engineerAI/LLM application development
api-documenterAPI documentation
ui-ux-designerInterface design
legal-advisorLegal and compliance documentation

Use Cases

ScenarioHow Aria Helps
New FeatureEnd-to-end flow from requirements to code
Bug FixTDD-driven fix workflow
RefactoringCode evolution with architecture docs in sync
Code ReviewAutomated convention compliance checks
Knowledge TransferHelp newcomers understand a project quickly
Technical DecisionsStructured brainstorming and solution design

OpenSpec: Requirement Specifications

A standardized format for describing requirements so AI and humans agree on "what to build":

LevelWhen to UseOutput
1 (Skip)Simple fixesNo spec needed
2 (Minimal)Medium featuresproposal.md
3 (Full)Architecture changesproposal.md + tasks.md

Aria plugin reads specs from openspec/changes/ in your project root directory (not inside standards/). The standards submodule provides the methodology definitions that the plugin references.


Project Structure

Your project (after adopting Aria):

your-project/
├── .aria/
│   └── config.json            # Project configuration
├── openspec/
│   └── changes/                # Your requirement specs go here
├── standards/                  # (Optional) Methodology specs submodule
├── docs/                       # (Recommended) Architecture docs
│   └── architecture/           # Kept in sync with code
└── [your code...]

Aria repository (this repo):

Aria/
├── README.md                   # This document
├── CLAUDE.md                   # AI project context
├── VERSION                     # Version info
├── LICENSE                     # MIT License
├── standards/                  # Methodology specs (submodule)
│   ├── core/                   # Core definitions (ten-step cycle)
│   ├── openspec/               # Requirement spec format
│   └── conventions/            # Conventions (git commit, etc.)
├── aria/                       # Aria Plugin (submodule)
│   ├── skills/                 # 41 Skills (34 user-facing + 7 internal)
│   ├── agents/                 # 11 Agents (with STCO descriptions + capabilities)
│   └── .claude-plugin/         # Plugin configuration
├── aria-plugin-benchmarks/     # Skill benchmark suite
│   ├── ab-suite/               # AB test fixtures
│   └── ab-results/             # AB test result archives
├── docs/                       # Research documentation
│   ├── architecture/           # System architecture
│   └── requirements/           # PRD + User Stories
├── tests/                      # Test files
└── openspec/                   # Aria's own OpenSpec changes
    └── archive/                # Completed change archives

Project Status

Project Version:  1.7.0
Plugin Version:   1.46.5 (aria-plugin, 41 Skills + 11 Agents)
Maturity:         Core workflows verified + project adaptation
PRD v2.0:        Approved (AI autonomous development)
Research Focus:   Reproducibility of AI collaboration patterns

Contributing

Contributions and discussions are welcome!

  1. Fork this repository
  2. Create your branch (git checkout -b feature/your-feature)
  3. Follow the ten-step cycle workflow
  4. Submit a Pull Request

License

MIT License — see LICENSE


Contact

Ver o original no GitHub

Bom para

Relacionados