Repository avatar
AI Tools
v0.3.1
active

agentrica

io.github.flgisimone/agentrica

56 AI agents for software, design, privacy, security and product work, as MCP prompts.

Documentation

Agentrica

Agentrica è una società di consulenza fittizia fatta interamente di agenti IA. Ha cinque reparti, uno per competenza, e 56 agenti specializzati, ciascuno con un ruolo preciso, un metodo di lavoro e dei limiti dichiarati.

Il repository ha due obiettivi, in quest'ordine:

  1. Un sito che presenta Agentrica: la landing, i cinque reparti e una biografia per ogni agente, ricavata dal suo file di ruolo.
  2. Un server MCP: gli stessi agenti usabili come strumenti in qualsiasi progetto (Claude Code o un altro client MCP), senza copiarne a mano i prompt.

Il sito è online su https://agentrica.vercel.app; il server MCP si installa con npx -y @agentrica/mcp@0.3.1 (vedi packages/mcp/README.md).

Sito e server MCP leggono la stessa fonte: i file Markdown di agents/. Un ruolo si modifica in un solo punto e cambia in entrambi.

I reparti

SiglaRepartoAgentiCosa faCartella
AIBPDAI Business & Product Development12obiettivi, requisiti, priorità, roadmap, business case, mercatoagents/ai_business_product_development_agency/
AICAAI Cybersecurity12threat model, configurazioni, accessi, vulnerabilità, risposta agli incidentiagents/ai_cybersecurity_agency/
AIPCAAI Privacy & Compliance10GDPR, basi giuridiche, conservazione, fornitori, DPIAagents/ai_privacy_compliance_agency/
AISAAI Software12analisi, architettura, sviluppo, test, sicurezza applicativa, revisione del codiceagents/ai_software_agency/
AIWDAAI Web Design10ricerca UX, UI, architettura informativa, design system, accessibilità, testiagents/ai_web_design_agency/

Ogni agente ha un nome in codice di stella: la sigla del reparto, il numero del suo file di ruolo e una stella, per esempio AISA-02 · ALTAIR per il Senior Software Architect. Il numero 01 di ogni reparto è il direttore.

Agentrica non ha persone, clienti o casi di successo: il sito non ne inventa.

Struttura

agentrica/
├── agents/              # i ruoli: la fonte unica dei contenuti (un .md per agente, 00-common-rules.md per reparto)
├── packages/catalog/    # TypeScript: legge agents/ e restituisce reparti e agenti tipizzati, con i nomi in codice
├── apps/site/           # il sito in Next.js (Tailwind, shadcn/ui): landing, reparti, agenti
├── packages/mcp/        # il server MCP degli agenti (stdio), pacchetto npm @agentrica/mcp: vedi packages/mcp/README.md
├── plan/                # decisioni e fasi del progetto
├── .claude/agents/      # gli stessi ruoli come subagent di Claude Code, per lavorare a questo repository
└── AGENTS.md, CONVENTIONS.md, CLAUDE.md   # regole di lavoro

Le agenzie servono due volte: sono il contenuto del prodotto e sono anche il team con cui il progetto viene sviluppato in Claude Code (oggi Software e Web Design, vedi AGENTS.md).

Stato

FaseContenutoStato
F0Monorepo, catalogo da agents/, sito Astro di base, controlli e CIcompletata
F1Landing di Agentricacompletata
F2Il sito passa da Astro a Next.js con Tailwind e shadcncompletata
F3Pagine dei reparticompletata
F4Pagine degli agenti con biografiacompletata
F5Server MCP su stdio: gli agenti come prompt e tool nei progetticompletata
F6Rilievicompletata
F7Identità corporate: palette dai ritratti, header con menu, volti, sfondo animato, transizionicompletata
F8Sezioni: simulazione di sviluppo e server MCPcompletata
F9Simboli: ritorno al tema scuro, un glifo per ogni stella al posto dei volticompletata
F10Pubblicazione: pacchetto npm, CI di release, header di sicurezza, note legalicompletata
F11Statistiche: download npm da terminalecompletata
F12Squadre: --agents nell'MCP e regola per i progetti vuoticompletata
F13Prove e distribuzione: casi di prova degli agenti, registri MCPcompletata
F14Pannello locale: agenti in uso e scelte da prendere da una pagina su localhost (--panel, da 0.3.0)completata
F15Rilievi aperti da F5 a F14 (0.3.1)completata
F16Area personale: accesso Google + TOTP (sospesa)sospesa

Il dettaglio è in plan/README.md.

Avvio

Requisiti: Node (versione in .nvmrc) e npm.

npm ci
npm run dev       # il sito in locale
npm run verify    # typecheck, lint, test, build: prima di ogni commit
npm run stats     # download npm di @agentrica/mcp e stelle su GitHub

Come si lavora

Il repository è nato da agentic-starter e ne segue il metodo:

  • una fase alla volta: un file in plan/, un branch fase/fN-nome da develop, chiusura con la procedura di CONVENTIONS §13.7;
  • agenzie su richiesta: i ruoli sono un modo di lavorare, i subagent si avviano solo per gli audit;
  • ogni decisione finale è confermata dall'utente, commit e push compresi.

Per riprendere il lavoro in Claude Code: apri il repository, leggi plan/README.md e il file della fase in corso.

Licenza

MIT, vedi LICENSE.

NPM
@agentrica/mcp
Install Command
npm install @agentrica/mcp