Agent Clean Architecture(自動評価エージェント)

Web

概要

Agent Clean Architecture は、プロジェクトの自動評価(コード品質チェック、リポジトリ走査、レビュー報告の自動生成)を行うバックエンドシステムのサンプル実装です。コアに Quarkus を据え、Java 21 と Maven で開発されています。設計は Clean Architecture の原則に従い、ドメインロジックを中心にユースケース層と外部アダプタ(インフラ)を分離。AI ベースのエージェントを組み込んで解析結果から人間に読めるレビューを生成する点が特徴で、Dockerfile や環境サンプルも含まれるためローカルやコンテナ環境で試せる構成になっています。(約300字)

GitHub

リポジトリの統計情報

  • スター数: 1
  • フォーク数: 0
  • ウォッチャー数: 1
  • コミット数: 3
  • ファイル数: 11
  • メインの言語: Java

主な特徴

  • Clean Architecture(ドメイン/ユースケース/アダプタ)に基づくモジュール設計
  • Quarkus + Java 21 を用いた軽量で高速なバックエンド
  • リポジトリ走査・静的解析と AI エージェントによるレビュー生成を統合
  • Docker / 環境設定ファイルを含み、コンテナ化とデプロイ準備が可能

技術的なポイント

本プロジェクトはアーキテクチャ上の責務分離を重視しており、ドメインモデルとユースケースを中心に据えることでビジネスロジックのテスト性・再利用性を高めています。Quarkus を採用することで起動時間やメモリ効率の面で利点があり、開発時のホットリロードやネイティブビルドの恩恵も期待できます。Java 21 の言語機能(記録型、パターンマッチングなど)を想定した実装が可能で、Maven によるモジュール管理で依存解決とビルドの自動化を行います。インフラ層ではリポジトリのクローリング/走査や静的解析ツールのラッパーをアダプタとして実装し、解析結果をユースケース層に渡して AI エージェントが自然言語のレビューを生成するフローを想定しています。Dockerfile と環境変数のサンプル(.env-exemplo)が含まれ、コンテナ化・環境差分の管理が容易です。現状は小規模なプロトタイプの段階であり、拡張点として解析プラグインの追加、AI モデルとの認証・レート制御、永続化・ジョブキューの導入などが考えられます。(約700字)

プロジェクトの構成

主要なファイルとディレクトリ:

  • .dockerignore: file
  • .env-exemplo: file
  • .gitignore: file
  • .mvn: dir
  • Dockerfile: file

…他 6 ファイル

まとめ

Clean Architecture に基づく AI 連携のコードレビュー自動化プロトタイプ。拡張性が高く実用化に繋げやすい構成です。(約50字)

リポジトリ情報:

READMEの抜粋:

Agent Clean Architecture

Este projeto implementa um sistema de avaliação automática de projetos utilizando Clean Architecture. Ele integra análise de código, varredura de repositório e uso de um agente baseado em IA para gerar relatórios de revisão.

O backend é desenvolvido com Quarkus, utilizando Java 21, e segue uma organização modular baseada em domínio, casos de uso e adaptadores.


Tecnologias Utilizadas

Core

  • Java 21
  • Quarkus Framework
  • Maven

Arquitetura

  • C…