@agentrica/mcp 0.4.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md ADDED
@@ -0,0 +1,75 @@
1
+ # Novità di @agentrica/mcp
2
+
3
+ Ogni versione con la data di pubblicazione su npm e le novità per tipo: Nuovo, Cambiato, Corretto, Incompatibile. La versione si fissa nel comando del server (`@agentrica/mcp@<versione>`): un aggiornamento arriva solo quando la cambi tu.
4
+
5
+ ## 0.6.0 — 2026-11-18
6
+
7
+ ### Nuovo
8
+ - `npx -y @agentrica/mcp@0.6.0 install`: installa il pacchetto sul computer con `npm install -g` e lo registra in Claude Code per tutti i tuoi progetti. Lo stesso comando su Mac, Windows e Linux; per aggiornare lo rilanci con la versione nuova.
9
+ - `npx -y @agentrica/mcp@0.6.0 add`: registra in Claude Code il server avviato con npx, senza installare nulla; `--project` scrive `.mcp.json` per il team, `--local` vale solo per il progetto corrente.
10
+ - La valutazione la chiede il server con un modulo del client (elicitation MCP): quando carichi un altro agente, per quello di prima, e dopo 30 minuti d'uso. Una volta per agente; se rifiuti non te la chiede più. I client senza moduli hanno il flusso di prima.
11
+ - Avviso di versione nuova: all'avvio il server chiede al registro npm qual è l'ultima versione (nessun dato inviato) e, se ce n'è una più nuova, lo dice con il comando per aggiornare, nella risposta di un tool e nel banner del pannello. `--no-update-check` spegne il controllo.
12
+ - Questo file, `CHANGELOG.md`, al posto della sezione «Versioni» del README.
13
+
14
+ ### Cambiato
15
+ - Il pannello scrive il nome del reparto accanto alla sigla: «reparto AISA · Software».
16
+ - Senza moduli, l'invito a valutare l'agente sta in fondo al suo testo, dopo il compito.
17
+
18
+ ### Corretto
19
+ - Su Windows `init` scrive nel `.mcp.json` `cmd /c npx`: con `npx` da solo Claude Code non avviava il server.
20
+
21
+ ### Incompatibile
22
+ - I prompt hanno il reparto nel nome: `aisa-02` diventa `aisa-02-software` (anche `-business`, `-cybersecurity`, `-privacy`, `-design`), così il menu dei comandi mostra il reparto. Restano uguali l'id dell'agente (`AISA-02`), il nome in codice, l'argomento del tool `agente` e `--agents`.
23
+
24
+ ## 0.5.0 — 2026-11-17
25
+
26
+ ### Nuovo
27
+ - Valutazione degli agenti: tool `rate_agent` in due passi, con anteprima e codice; sezione «Valuta gli agenti» nel pannello; proposta a fine lavoro e promemoria dopo 30 minuti. È l'unica connessione del server, e parte solo dopo la tua conferma; `--no-ratings` la toglie.
28
+ - L'agente dice chi è (nome in codice, ruolo, reparto) all'inizio, quando passa a un altro agente e nel riepilogo.
29
+
30
+ ## 0.4.0 — 2026-11-16
31
+
32
+ ### Nuovo
33
+ - Comando `init`: crea un progetto con regole, piano a fasi, agenzie, subagent, CI e `.mcp.json`. Prende il posto di agentic-starter. Il server è invariato.
34
+
35
+ ## 0.3.3 — 2026-11-16
36
+
37
+ ### Nuovo
38
+ - Export `@agentrica/mcp/catalog` per leggere reparti e agenti da codice. Agenti e comportamento del server invariati.
39
+
40
+ ## 0.3.2 — 2026-11-16
41
+
42
+ ### Cambiato
43
+ - Pannello in tre pagine (Sessione, Piano, Rilievi), con menu e contatori delle scelte in attesa e dei rilievi. Agenti e comportamento del server invariati.
44
+
45
+ ## 0.3.1 — 2026-11-15
46
+
47
+ ### Cambiato
48
+ - Regole comuni con una scala di gravità condivisa (P0–P3) e una scala per il reparto software.
49
+
50
+ ### Corretto
51
+ - Il pannello nasconde i rilievi chiusi e conta a parte i file nuovi.
52
+ - L'id del tool `agente` accetta solo le sigle dei reparti.
53
+
54
+ ## 0.3.0 — 2026-11-15
55
+
56
+ ### Nuovo
57
+ - Pannello locale con `--panel`: fasi, backlog, rilievi, agenti in uso e scelte da prendere dalla pagina (tool `open_panel` e `ask_user`). Senza `--panel` nulla cambia.
58
+
59
+ ## 0.2.1 — 2026-11-15
60
+
61
+ ### Nuovo
62
+ - Nome `io.github.flgisimone/agentrica` per il registro MCP ufficiale. Agenti e comportamento invariati.
63
+
64
+ ## 0.2.0 — 2026-11-15
65
+
66
+ ### Nuovo
67
+ - Argomento `--agents` per caricare solo una squadra di agenti o reparti.
68
+
69
+ ### Cambiato
70
+ - Con un progetto vuoto, o senza ciò che il ruolo deve esaminare, l'agente lo dice e propone i primi passi da confermare, senza inventare rilievi.
71
+
72
+ ## 0.1.0 — 2026-11-15
73
+
74
+ ### Nuovo
75
+ - Prima versione pubblicata: 56 agenti in cinque reparti, un prompt per agente e i tool `elenca_agenti` e `agente`.
package/README.en.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # Agentrica MCP
2
2
 
3
+ [![Agentrica MCP on mcprush](https://mcprush.com/badge/agentrica-mcp/compact.svg)](https://mcprush.com/to/agentrica-mcp?ref=badge)
4
+
3
5
  [Italiano](README.md)
4
6
 
5
7
  The Agentrica MCP server: the 56 AI agents of the five departments (AIBPD, AICA, AIPCA, AISA, AIWDA), usable in your project from Claude Code or any MCP client.
@@ -12,22 +14,50 @@ The agent files are in Italian. The agent answers in the language you write in.
12
14
 
13
15
  - The server runs only locally: the client starts it on your computer and the two talk over stdio. The server has no remote part.
14
16
  - The only content it reads is the `agents/` files included in the package, once, at startup. The text that reaches the model is the text of those files: you can read it before using it.
15
- - The server writes no files (only the [`init`](#new-project) command does, when you run it), opens no network connections, logs nothing, collects and sends no data, and has no telemetry. With `--panel` it opens a page on your computer only: see [Local panel](#local-panel).
17
+ - The server writes no files (only the [`init`](#new-project) command does, when you run it), logs nothing and has no telemetry. It connects to the internet in two cases:
18
+ - to Agentrica, when you confirm an [agent rating](#ratings), and it sends only the score, the comment and the version; `--no-ratings` turns it off;
19
+ - to the npm registry, at startup, to find out whether there is a [new version](#updating-and-uninstalling): a request with no data, npm only sees your IP address and program, as when npx downloads the package; `--no-update-check` turns it off.
20
+
21
+ With `--no-ratings --no-update-check` it never connects. With `--panel` it opens a page on your computer only: see [Local panel](#local-panel).
16
22
  - It runs nothing in your project. It only gives instructions to the model: what the model does in the project depends on the client and on the permissions you grant it.
17
23
  - **Where the data goes.** The agent's text, the task and the files the model reads in your project go to the model provider through your client, under that provider's terms. Agentrica does not receive them. Leave personal data, secrets and customer data out of the task unless they are needed.
18
24
  - The agents are AI: their conclusions are proposals to check. The privacy and security agents do not replace a DPO, a lawyer or a security officer, and their findings are not a compliance certification.
19
25
 
20
26
  ## Installation
21
27
 
22
- You need Node 22 or later, with npm.
28
+ You need Node 22 or later, with npm. The commands are the same on Mac, Windows (PowerShell or cmd) and Linux.
29
+
30
+ **On the whole computer (recommended)**, for Claude Code:
31
+
32
+ ```sh
33
+ npx -y @agentrica/mcp@0.6.0 install
34
+ ```
35
+
36
+ It installs the package with `npm install -g` and registers it in Claude Code with `user` scope: every project you open already has Agentrica. The server starts with `node` from npm's global folder: it starts fast and also works offline. Restart Claude Code and check with `claude mcp list`.
37
+
38
+ **Without installing anything**, for Claude Code:
39
+
40
+ ```sh
41
+ npx -y @agentrica/mcp@0.6.0 add
42
+ ```
43
+
44
+ It registers the server started with npx (on Windows `cmd /c npx`), which downloads the package to its cache on first start. The scope is `user`, all your projects; with `--project` it writes `.mcp.json` in the current folder, to share with your team (it works on the system it was created on), with `--local` it applies to the current project and to you only. For your team, from the project folder:
45
+
46
+ ```sh
47
+ npx -y @agentrica/mcp@0.6.0 add --project
48
+ ```
49
+
50
+ The server options (`--agents`, `--panel`, `--no-ratings`, `--no-update-check`) go at the end of `install` and `add`, which pass them to the server. Run again, they replace Agentrica's registration in the same scope. If Node 22, npm or the `claude` command are missing, they say so and print the commands to run by hand.
51
+
52
+ The version stays the one you set until you change it: role updates do not arrive unless you choose them. See [Updating and uninstalling](#updating-and-uninstalling).
23
53
 
24
- **Claude Code**, from your project folder:
54
+ **By hand in Claude Code**, without `install` or `add`:
25
55
 
26
56
  ```sh
27
- claude mcp add agentrica -- npx -y @agentrica/mcp@0.4.0
57
+ claude mcp add --scope user agentrica -- npx -y @agentrica/mcp@0.6.0
28
58
  ```
29
59
 
30
- On first start npx downloads the package from npm. The version stays the one you set until you change it: role updates do not arrive unless you choose them.
60
+ On Windows: `claude mcp add --scope user agentrica -- cmd /c npx -y @agentrica/mcp@0.6.0`.
31
61
 
32
62
  **Other MCP clients**: add the server to the client configuration, usually a JSON file like this:
33
63
 
@@ -36,23 +66,42 @@ On first start npx downloads the package from npm. The version stays the one you
36
66
  "mcpServers": {
37
67
  "agentrica": {
38
68
  "command": "npx",
39
- "args": ["-y", "@agentrica/mcp@0.4.0"]
69
+ "args": ["-y", "@agentrica/mcp@0.6.0"]
40
70
  }
41
71
  }
42
72
  }
43
73
  ```
44
74
 
45
- **Least privilege (recommended).** Install the package in its own folder and start it with Node's permission model: the server can only read that folder, and Node blocks file writes, network connections and child processes. The server needs none of them, so it works the same; the permissions limit the damage of any future defect.
75
+ On Windows:
76
+
77
+ ```json
78
+ {
79
+ "mcpServers": {
80
+ "agentrica": {
81
+ "command": "cmd",
82
+ "args": ["/c", "npx", "-y", "@agentrica/mcp@0.6.0"]
83
+ }
84
+ }
85
+ }
86
+ ```
87
+
88
+ **Least privilege (recommended).** Install the package in its own folder and start it with Node's permission model: the server can only read that folder, and Node blocks file writes, network connections and child processes. The server needs none of them, so it works the same; the permissions limit the damage of any future defect. With these permissions, sending a [rating](#ratings) fails with a clear message and the version check does not run: to rate agents add `--allow-net`, otherwise add `--no-ratings --no-update-check` at the end of the command.
46
89
 
47
90
  ```sh
48
- npm install -g --ignore-scripts @agentrica/mcp@0.4.0
91
+ npm install -g --ignore-scripts @agentrica/mcp@0.6.0
49
92
  npm root -g
50
93
  ```
51
94
 
52
95
  With the folder printed by `npm root -g` in place of `/global/folder`:
53
96
 
54
97
  ```sh
55
- claude mcp add agentrica -- node --permission --allow-fs-read=/global/folder/@agentrica/mcp /global/folder/@agentrica/mcp/dist/mcp/src/server.js
98
+ claude mcp add --scope user agentrica -- node --permission --allow-fs-read=/global/folder/@agentrica/mcp /global/folder/@agentrica/mcp/dist/mcp/src/server.js
99
+ ```
100
+
101
+ On Windows the folder is usually `C:\Users\<name>\AppData\Roaming\npm\node_modules`; if it contains spaces, quote the path and the whole option:
102
+
103
+ ```sh
104
+ claude mcp add --scope user agentrica -- node --permission "--allow-fs-read=C:\Users\<name>\AppData\Roaming\npm\node_modules\@agentrica\mcp" "C:\Users\<name>\AppData\Roaming\npm\node_modules\@agentrica\mcp\dist\mcp\src\server.js"
56
105
  ```
57
106
 
58
107
  **Provenance.** The package is published by the repository CI with provenance: npm shows which commit it was built from, and `npm audit signatures` in your project verifies its signature.
@@ -61,18 +110,20 @@ claude mcp add agentrica -- node --permission --allow-fs-read=/global/folder/@ag
61
110
 
62
111
  ## Usage
63
112
 
64
- **Prompts.** Each agent is a prompt named after its lowercase id (`aisa-02`, `aica-01`…) with one optional argument, `compito` (the task). In Claude Code prompts become commands:
113
+ **Prompts.** Each agent is a prompt named after its lowercase id and its department (`aisa-02-software`, `aica-01-cybersecurity`, `aibpd-01-business`, `aipca-02-privacy`, `aiwda-08-design`) with one optional argument, `compito` (the task). In Claude Code prompts become commands, and the menu shows the department:
65
114
 
66
115
  ```
67
- /mcp__agentrica__aisa-02 "Review the boundaries between the modules in src/"
116
+ /mcp__agentrica__aisa-02-software "Review the boundaries between the modules in src/"
68
117
  ```
69
118
 
119
+ Up to 0.5.0 the name was the id alone (`aisa-02`).
120
+
70
121
  Put the task in quotes: Claude Code splits arguments on spaces.
71
122
 
72
123
  **Squad.** With `--agents` the server loads only the agents you list: agent ids and department codes, comma-separated, case-insensitive. For example the whole software department plus the accessibility agent:
73
124
 
74
125
  ```sh
75
- claude mcp add agentrica -- npx -y @agentrica/mcp@0.4.0 --agents aisa,aiwda-08
126
+ npx -y @agentrica/mcp@0.6.0 install --agents aisa,aiwda-08
76
127
  ```
77
128
 
78
129
  The command menu shows only the squad's prompts, and `elenca_agenti` and `agente` see only those agents too. Without `--agents` all 56 agents are available. An unknown id or code stops the server with a message naming it, in the client's logs. In Claude Code prompts do not enter the model's context (we checked with `/context`): a squad makes the menu shorter, it does not save tokens.
@@ -83,22 +134,40 @@ The command menu shows only the squad's prompts, and `elenca_agenti` and `agente
83
134
  |---|---|---|
84
135
  | `elenca_agenti` (list agents) | optional `reparto` (department: `AIBPD`, `AICA`, `AIPCA`, `AISA`, `AIWDA`) | id, code name, role and department of each agent |
85
136
  | `agente` (agent) | `id` (e.g. `AISA-02`), optional `compito` (task) | the agent's full instructions |
137
+ | `rate_agent` | `id`, `rating` from 1 to 5, optional `comment` and `publish`; then `code` | a preview of the rating and a code; with the code, the sending (see [Ratings](#ratings)) |
86
138
 
87
139
  For example: "Use elenca_agenti, pick the right Agentrica agent and check the accessibility of the login form".
88
140
 
89
141
  Number 01 in each department is the director: it coordinates the specialists and consolidates their findings.
90
142
 
143
+ While working, the agent says who it is, for example "AISA-02 · ALTAIR — Senior Software Architect, reparto AISA (AI Software)": at the start, when it hands over to another agent and in the final summary.
144
+
145
+ ## Ratings
146
+
147
+ You can give an agent a score from 1 to 5 and a comment on what to improve: ratings are used to fix the role files.
148
+
149
+ - **The form.** If the client shows forms (MCP elicitation, like Claude Code), the server asks you itself, with a form: score, comment and whether to publish it. It asks when you load another agent, for the previous one, which has finished, and after 30 minutes of use. Once per agent per session: if you decline, it does not ask again for that agent. Submitting the form is the confirmation, and only what is in the form is sent.
150
+ - **Without forms.** With clients that do not show forms, the agent suggests a rating when it has finished the task, once per session; if it has been working for more than 30 minutes, the server reminds the model once. `rate_agent` first shows a preview of what will be sent and a code valid for 10 minutes; the model shows it to you and sends only with the code, exactly that content.
151
+ - You can also ask ("rate AISA-02"), or rate from the panel (`--panel`), in the "Valuta gli agenti" section.
152
+ - **What is sent.** The agent id, the score, the comment, whether you allow the comment to be published on the site (off by default), the package version and a random rating code. No task, files, paths or project name, no account. Do not write names, personal data or parts of your project in the comment.
153
+ - **On the site.** Every agent with at least 5 ratings shows the average, the number of ratings and their distribution, and a ranking appears once at least 5 agents pass that threshold. A comment appears only if you allowed it to be published and after it is approved (criteria in the [legal notes](https://agentrica.vercel.app/note-legali#valutazioni), in Italian), with the score and the month.
154
+ - **After sending** you get the rating code: with it you can ask for the rating to be deleted or for the comment not to be published. An agent can be rated once per session and once a day from the same network.
155
+ - **If sending fails** (offline, service down) the tool says so and the work goes on; the rating is not stored anywhere.
156
+ - **To drop the tool**, the form and the suggestions, add `--no-ratings` to the command: the server no longer connects to Agentrica.
157
+
158
+ How ratings are handled: [legal notes](https://agentrica.vercel.app/note-legali#valutazioni) (in Italian).
159
+
91
160
  ## Local panel
92
161
 
93
162
  With `--panel` the server also opens a page on your computer where you follow the project and make the choices the agent asks you for, instead of answering in the terminal:
94
163
 
95
164
  ```sh
96
- claude mcp add agentrica -- npx -y @agentrica/mcp@0.4.0 --panel
165
+ npx -y @agentrica/mcp@0.6.0 install --panel
97
166
  ```
98
167
 
99
168
  Then ask the agent to open the panel (`open_panel` tool): the page opens in your browser. It has three pages, with a menu at the top counting pending choices and findings:
100
169
 
101
- - **Sessione** (session): pending choices (*Da decidere*, to decide), with options and reasons, whose answer, with an optional note, goes back to the agent; next to them, the Agentrica agents called in this session (*Agenti in uso*, agents in use), with the start of the task;
170
+ - **Sessione** (session): pending choices (*Da decidere*, to decide), with options and reasons, whose answer, with an optional note, goes back to the agent; next to them, the Agentrica agents called in this session (*Agenti in uso*, agents in use), with the department and the start of the task;
102
171
  - **Piano** (plan): the open phase with backlog and acceptance criteria, and all project phases;
103
172
  - **Rilievi** (findings): open findings from phases and audits, by priority and department.
104
173
 
@@ -111,7 +180,7 @@ With the panel the model has two more tools:
111
180
 
112
181
  If the page is not open, `ask_user` opens it. The client waits for the answer as long as the server sends progress notifications (up to 4 hours; 25 minutes with a client that does not request them), then the agent asks in the terminal. The client's own questions, such as tool permissions, stay in the client.
113
182
 
114
- **What changes with `--panel`.** The server opens a random port on `127.0.0.1` only, reads `plan/`, `audit/` and the git status (`git status`) of the project folder, and keeps the last 20 agent calls in memory. It writes no files and sends no data off your computer. The page opens only with the random token in the URL, valid for that session; requests from other sites or with another `Host` are refused. The Node permission model recommended above does not apply with `--panel`, which needs the local network and `git`.
183
+ **What changes with `--panel`.** The server opens a random port on `127.0.0.1` only, reads `plan/`, `audit/` and the git status (`git status`) of the project folder, and keeps the last 20 agent calls in memory. It writes no files and sends no data off your computer, except the ratings you send from the page. The page opens only with the random token in the URL, valid for that session; requests from other sites or with another `Host` are refused. The Node permission model recommended above does not apply with `--panel`, which needs the local network and `git`.
115
184
 
116
185
  **Format of `plan/` and `audit/`.** The panel reads the plan format created by `init`, in Italian, the same as Agentrica's own [`plan/`](https://github.com/flgisimone/agentrica/tree/main/plan) and [`audit/`](https://github.com/flgisimone/agentrica/tree/main/audit); if something is missing, the page says what.
117
186
 
@@ -124,7 +193,7 @@ If the page is not open, `ask_user` opens it. The client waits for the answer as
124
193
  `init` creates a project with Agentrica's way of working, ready for Claude Code:
125
194
 
126
195
  ```sh
127
- npx -y @agentrica/mcp@0.4.0 init my-project --name "My project"
196
+ npx -y @agentrica/mcp@0.6.0 init my-project --name "My project"
128
197
  ```
129
198
 
130
199
  Without a folder it uses the current one; without `--name` the name is the folder's. It writes, in Italian:
@@ -133,7 +202,7 @@ Without a folder it uses the current one; without `--name` the name is the folde
133
202
  - `plan/` with `README.md` (decisions, glossary, phases) and `00-base.md`, the F0 phase to start from; `audit/` and `docs/`;
134
203
  - `agents/` and `.claude/agents/`: the 56 roles of this version and one subagent per role, with the project name;
135
204
  - `.github/workflows/ci.yml` (`npm run verify` and `verify:e2e`, skipped until F0 creates them), `.gitignore`, `.nvmrc`, `.env.example`;
136
- - `.mcp.json` with this server at an exact version and `--panel`, so the panel reads the plan right away.
205
+ - `.mcp.json` with this server at an exact version and `--panel`, so the panel reads the plan right away (on Windows with `cmd /c npx`).
137
206
 
138
207
  If even one file already exists, `init` writes nothing and lists them. Outside a git repository it makes the first commit on `main` and leaves `develop` checked out; inside one it does not commit. Then open Claude Code in the folder and ask it to open phase F0. `init` is the only command that writes files: the server stays read-only. It replaces agentic-starter, which is no longer updated.
139
208
 
@@ -149,22 +218,27 @@ Three agents tested on 2026-11-15 against three small projects with planted, doc
149
218
 
150
219
  Limits: the defects are few, known and fairly obvious; one model and one run per case; a result like this says nothing about how an agent does on a large project. Projects, expected defects, counting rules and the agents' full reports (in Italian) are in [`examples/`](https://github.com/flgisimone/agentrica/tree/main/examples): you can repeat the tests.
151
220
 
152
- ## Updates
221
+ ## Updating and uninstalling
222
+
223
+ The agents' text comes from the `agents/` files of the installed version. When a new version is out the server tells you once per session, in a tool response and in the panel, with the right command for how you installed it. Ids and code names do not change.
224
+
225
+ - **Installed with `install`**: run `install` again with the new version, e.g. `npx -y @agentrica/mcp@<version> install`, then restart Claude Code.
226
+ - **With `add` or `init`**: run `add` again with the new version, or change the version in the server command or in `.mcp.json`, then restart the client.
227
+
228
+ To uninstall:
229
+
230
+ ```sh
231
+ claude mcp remove agentrica --scope user
232
+ npm uninstall -g @agentrica/mcp
233
+ ```
153
234
 
154
- The agents' text comes from the `agents/` files of the installed version. To update, change the version in the command (or reinstall with `npm install -g`) and restart the client. Ids and code names do not change.
235
+ The second command is needed only if you used `install`; with `add --project` or `--local` use that scope instead of `user`.
155
236
 
156
237
  The same catalog can be read from code, without starting the server: `import { loadCatalog } from "@agentrica/mcp/catalog"` returns departments and agents (with the `Department` and `Agent` types) from the package's `agents/`. The Agentrica site uses it.
157
238
 
158
239
  ## Versions
159
240
 
160
- - **0.4.0**: `init` command that creates a project with rules, phased plan, agencies, subagents, CI and `.mcp.json` (replaces agentic-starter); the server is unchanged.
161
- - **0.3.3**: `@agentrica/mcp/catalog` export to read departments and agents from code (used by the site, now in a separate repository); agents and server behaviour unchanged.
162
- - **0.3.2**: the panel has three pages (Sessione, Piano, Rilievi) with a menu counting pending choices and findings; agents and server behaviour unchanged.
163
- - **0.3.1**: the panel hides closed findings and counts new files separately; the `agente` tool only accepts department codes in ids; common rules with a shared severity scale (P0–P3) and a scale for the software department.
164
- - **0.3.0**: local panel with `--panel`: phases, backlog, findings, agents in use and choices made from the page (`open_panel` and `ask_user` tools). Without `--panel` nothing changes.
165
- - **0.2.1**: name `io.github.flgisimone/agentrica` for the official MCP registry; agents and behaviour unchanged.
166
- - **0.2.0**: `--agents` argument to load only a squad of agents or departments; in an empty project, or when what the role must examine is missing, the agent says so and proposes first steps to confirm, without inventing findings.
167
- - **0.1.0**: first published version. 56 agents in five departments, one prompt per agent and the `elenca_agenti` and `agente` tools.
241
+ What changed in each version, with its date, is in [CHANGELOG.md](https://github.com/flgisimone/agentrica/blob/main/packages/mcp/CHANGELOG.md) (in Italian). 0.6.0 renames the prompts (`aisa-02` becomes `aisa-02-software`).
168
242
 
169
243
  ## License
170
244
 
package/README.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # Agentrica MCP
2
2
 
3
+ [![Agentrica MCP su mcprush](https://mcprush.com/badge/agentrica-mcp/compact.svg)](https://mcprush.com/to/agentrica-mcp?ref=badge)
4
+
3
5
  [English](README.en.md)
4
6
 
5
7
  Il server MCP di Agentrica: i 56 agenti IA dei cinque reparti (AIBPD, AICA, AIPCA, AISA, AIWDA) usabili nel tuo progetto da Claude Code o da qualsiasi client MCP.
@@ -10,22 +12,50 @@ Ogni agente è un ruolo con un metodo e dei limiti dichiarati, per esempio `AISA
10
12
 
11
13
  - Il server gira solo in locale: lo avvia il client sul tuo computer e i due comunicano con stdio. Il server non ha una parte remota.
12
14
  - Come contenuto legge solo i file di `agents/` inclusi nel pacchetto, una volta all'avvio. Il testo che arriva al modello è quello di quei file: puoi leggerlo prima di usarlo.
13
- - Il server non scrive file (lo fa solo il comando [`init`](#nuovo-progetto), quando lo lanci tu), non apre connessioni di rete, non registra, non raccoglie e non invia dati, non ha telemetria. Con `--panel` apre una pagina solo sul tuo computer: vedi [Pannello locale](#pannello-locale).
15
+ - Il server non scrive file (lo fa solo il comando [`init`](#nuovo-progetto), quando lo lanci tu), non registra e non ha telemetria. Si collega a internet in due casi:
16
+ - verso Agentrica, quando confermi la [valutazione di un agente](#valutazioni), e invia solo voto, commento e versione; `--no-ratings` lo spegne;
17
+ - verso il registro npm, all'avvio, per sapere se c'è una [versione nuova](#aggiornare-e-disinstallare): è una richiesta senza dati, npm vede solo indirizzo IP e programma, come quando npx scarica il pacchetto; `--no-update-check` lo spegne.
18
+
19
+ Con `--no-ratings --no-update-check` non si collega mai. Con `--panel` apre una pagina solo sul tuo computer: vedi [Pannello locale](#pannello-locale).
14
20
  - Non esegue niente nel tuo progetto. Dà soltanto istruzioni al modello: quello che il modello fa nel progetto dipende dal client e dai permessi che gli concedi.
15
21
  - **Dove vanno i dati.** Il testo dell'agente, il compito e i file che il modello legge nel tuo progetto vanno al fornitore del modello attraverso il tuo client, secondo le condizioni di quel fornitore. Agentrica non li riceve. Nel compito non inserire dati personali, segreti o dati di clienti che non servono.
16
22
  - Gli agenti sono IA: le loro conclusioni sono proposte da verificare. Gli agenti di privacy e sicurezza non sostituiscono un DPO, un avvocato o un responsabile della sicurezza, e i loro rilievi non sono una certificazione di conformità.
17
23
 
18
24
  ## Installazione
19
25
 
20
- Serve Node 22 o successivo, con npm.
26
+ Serve Node 22 o successivo, con npm. I comandi sono gli stessi su Mac, Windows (PowerShell o cmd) e Linux.
27
+
28
+ **Su tutto il computer (consigliato)**, per Claude Code:
29
+
30
+ ```sh
31
+ npx -y @agentrica/mcp@0.6.0 install
32
+ ```
33
+
34
+ Installa il pacchetto con `npm install -g` e lo registra in Claude Code con ambito `user`: ogni progetto che apri ha già Agentrica. Il server parte con `node` dalla cartella globale di npm: parte in fretta e funziona anche offline. Riavvia Claude Code e controlla con `claude mcp list`.
35
+
36
+ **Senza installare nulla**, per Claude Code:
37
+
38
+ ```sh
39
+ npx -y @agentrica/mcp@0.6.0 add
40
+ ```
21
41
 
22
- **Claude Code**, dalla cartella del tuo progetto:
42
+ Registra il server avviato con npx (su Windows `cmd /c npx`), che al primo avvio scarica il pacchetto nella sua cache. L'ambito è `user`, tutti i tuoi progetti; con `--project` scrive `.mcp.json` nella cartella corrente, da condividere con il team (vale per il sistema su cui l'hai creato), con `--local` vale solo per il progetto corrente e solo per te. Per il team, dalla cartella del progetto:
23
43
 
24
44
  ```sh
25
- claude mcp add agentrica -- npx -y @agentrica/mcp@0.4.0
45
+ npx -y @agentrica/mcp@0.6.0 add --project
26
46
  ```
27
47
 
28
- Al primo avvio npx scarica il pacchetto da npm. La versione resta quella indicata finché non la cambi tu: un aggiornamento dei ruoli non arriva senza che tu lo scelga.
48
+ Le opzioni del server (`--agents`, `--panel`, `--no-ratings`, `--no-update-check`) si aggiungono in fondo a `install` e `add`, che le passano al server. Lanciati di nuovo, sostituiscono la registrazione di Agentrica nello stesso ambito. Se mancano Node 22, npm o il comando `claude`, lo dicono e stampano i comandi da lanciare a mano.
49
+
50
+ La versione resta quella indicata finché non la cambi tu: un aggiornamento dei ruoli non arriva senza che tu lo scelga. Vedi [Aggiornare e disinstallare](#aggiornare-e-disinstallare).
51
+
52
+ **A mano in Claude Code**, senza `install` né `add`:
53
+
54
+ ```sh
55
+ claude mcp add --scope user agentrica -- npx -y @agentrica/mcp@0.6.0
56
+ ```
57
+
58
+ Su Windows: `claude mcp add --scope user agentrica -- cmd /c npx -y @agentrica/mcp@0.6.0`.
29
59
 
30
60
  **Altri client MCP**: aggiungi il server alla configurazione del client, di solito un file JSON come questo:
31
61
 
@@ -34,23 +64,42 @@ Al primo avvio npx scarica il pacchetto da npm. La versione resta quella indicat
34
64
  "mcpServers": {
35
65
  "agentrica": {
36
66
  "command": "npx",
37
- "args": ["-y", "@agentrica/mcp@0.4.0"]
67
+ "args": ["-y", "@agentrica/mcp@0.6.0"]
68
+ }
69
+ }
70
+ }
71
+ ```
72
+
73
+ Su Windows:
74
+
75
+ ```json
76
+ {
77
+ "mcpServers": {
78
+ "agentrica": {
79
+ "command": "cmd",
80
+ "args": ["/c", "npx", "-y", "@agentrica/mcp@0.6.0"]
38
81
  }
39
82
  }
40
83
  }
41
84
  ```
42
85
 
43
- **Permessi minimi (consigliato).** Installa il pacchetto in una cartella sua e avvialo con il permission model di Node: il server può solo leggere quella cartella, e Node blocca scritture su file, connessioni di rete e processi figli. Il server non ne ha bisogno, quindi funziona uguale; i permessi limitano i danni di un eventuale difetto futuro.
86
+ **Permessi minimi (consigliato).** Installa il pacchetto in una cartella sua e avvialo con il permission model di Node: il server può solo leggere quella cartella, e Node blocca scritture su file, connessioni di rete e processi figli. Il server non ne ha bisogno, quindi funziona uguale; i permessi limitano i danni di un eventuale difetto futuro. Con questi permessi l'invio di una [valutazione](#valutazioni) fallisce con un messaggio chiaro e il controllo della versione non parte: se vuoi votare gli agenti aggiungi `--allow-net`, altrimenti aggiungi `--no-ratings --no-update-check` in fondo al comando.
44
87
 
45
88
  ```sh
46
- npm install -g --ignore-scripts @agentrica/mcp@0.4.0
89
+ npm install -g --ignore-scripts @agentrica/mcp@0.6.0
47
90
  npm root -g
48
91
  ```
49
92
 
50
93
  Con la cartella stampata da `npm root -g` al posto di `/cartella/globale`:
51
94
 
52
95
  ```sh
53
- claude mcp add agentrica -- node --permission --allow-fs-read=/cartella/globale/@agentrica/mcp /cartella/globale/@agentrica/mcp/dist/mcp/src/server.js
96
+ claude mcp add --scope user agentrica -- node --permission --allow-fs-read=/cartella/globale/@agentrica/mcp /cartella/globale/@agentrica/mcp/dist/mcp/src/server.js
97
+ ```
98
+
99
+ Su Windows la cartella è di solito `C:\Users\<nome>\AppData\Roaming\npm\node_modules`; se contiene spazi, metti fra virgolette il percorso e l'intera opzione:
100
+
101
+ ```sh
102
+ claude mcp add --scope user agentrica -- node --permission "--allow-fs-read=C:\Users\<nome>\AppData\Roaming\npm\node_modules\@agentrica\mcp" "C:\Users\<nome>\AppData\Roaming\npm\node_modules\@agentrica\mcp\dist\mcp\src\server.js"
54
103
  ```
55
104
 
56
105
  **Provenienza.** Il pacchetto è pubblicato dalla CI del repository con provenance: su npm si vede da quale commit è stato costruito, e `npm audit signatures` nel tuo progetto ne verifica la firma.
@@ -59,18 +108,20 @@ claude mcp add agentrica -- node --permission --allow-fs-read=/cartella/globale/
59
108
 
60
109
  ## Uso
61
110
 
62
- **Prompt.** Ogni agente è un prompt con il suo id in minuscolo (`aisa-02`, `aica-01`…) e un argomento facoltativo, `compito`. In Claude Code i prompt diventano comandi:
111
+ **Prompt.** Ogni agente è un prompt con il suo id in minuscolo e il reparto (`aisa-02-software`, `aica-01-cybersecurity`, `aibpd-01-business`, `aipca-02-privacy`, `aiwda-08-design`) e un argomento facoltativo, `compito`. In Claude Code i prompt diventano comandi, e il menu mostra il reparto:
63
112
 
64
113
  ```
65
- /mcp__agentrica__aisa-02 "Rivedi i confini fra i moduli di src/"
114
+ /mcp__agentrica__aisa-02-software "Rivedi i confini fra i moduli di src/"
66
115
  ```
67
116
 
117
+ Fino alla 0.5.0 il nome era solo l'id (`aisa-02`).
118
+
68
119
  Metti il compito fra virgolette: Claude Code separa gli argomenti con gli spazi.
69
120
 
70
121
  **Squadra.** Con `--agents` il server carica solo gli agenti che indichi: id di agenti e sigle di reparti, separati da virgole, senza distinguere maiuscole. Per esempio tutto il reparto software più l'agente dell'accessibilità:
71
122
 
72
123
  ```sh
73
- claude mcp add agentrica -- npx -y @agentrica/mcp@0.4.0 --agents aisa,aiwda-08
124
+ npx -y @agentrica/mcp@0.6.0 install --agents aisa,aiwda-08
74
125
  ```
75
126
 
76
127
  Nel menu dei comandi restano solo i prompt della squadra, e anche `elenca_agenti` e `agente` vedono solo quelli. Senza `--agents` ci sono tutti i 56 agenti. Un id o una sigla sconosciuti fermano il server con un messaggio che li nomina, nei log del client. In Claude Code i prompt non entrano nel contesto del modello (lo abbiamo verificato con `/context`): la squadra rende il menu più corto, ma non fa risparmiare token.
@@ -81,24 +132,40 @@ Nel menu dei comandi restano solo i prompt della squadra, e anche `elenca_agenti
81
132
  |---|---|---|
82
133
  | `elenca_agenti` | `reparto` facoltativo (`AIBPD`, `AICA`, `AIPCA`, `AISA`, `AIWDA`) | id, nome in codice, ruolo e reparto di ogni agente |
83
134
  | `agente` | `id` (es. `AISA-02`), `compito` facoltativo | le istruzioni complete dell'agente |
135
+ | `rate_agent` | `id`, `rating` da 1 a 5, `comment` e `publish` facoltativi; poi `code` | l'anteprima della valutazione e un codice; con il codice, l'invio (vedi [Valutazioni](#valutazioni)) |
84
136
 
85
137
  Per esempio: «Usa elenca_agenti, scegli l'agente di Agentrica adatto e verifica l'accessibilità del form di login».
86
138
 
87
139
  Il numero 01 di ogni reparto è il direttore: coordina gli specialisti e consolida i loro rilievi.
88
140
 
89
- I file degli agenti sono in italiano; l'agente risponde nella lingua in cui gli scrivi.
141
+ I file degli agenti sono in italiano; l'agente risponde nella lingua in cui gli scrivi. Durante il lavoro l'agente dice chi è, per esempio «AISA-02 · ALTAIR — Senior Software Architect, reparto AISA (AI Software)»: all'inizio, quando passa a un altro agente e nel riepilogo finale.
142
+
143
+ ## Valutazioni
144
+
145
+ Puoi dare a un agente un voto da 1 a 5 e un commento su cosa migliorare: servono a correggere i file di ruolo.
146
+
147
+ - **Il modulo.** Se il client mostra moduli (elicitation MCP, come Claude Code), è il server a chiedertelo, con un modulo: voto, commento e se pubblicarlo. Te lo chiede quando carichi un altro agente, per quello di prima, che ha finito, e dopo 30 minuti d'uso. Una volta per agente per sessione: se rifiuti, per quell'agente non te lo chiede più. Inviare il modulo vale come conferma, e parte solo ciò che c'è nel modulo.
148
+ - **Senza modulo.** Con i client che non mostrano moduli te lo propone l'agente quando ha finito il compito, una volta per sessione; se lavora da più di 30 minuti, il server lo ricorda al modello una volta. `rate_agent` prima mostra l'anteprima di ciò che parte e un codice valido 10 minuti; il modello te la mostra e invia solo con il codice, esattamente quel contenuto.
149
+ - Puoi anche chiederlo tu («valuta AISA-02»), o votare dal pannello (`--panel`), nella sezione «Valuta gli agenti».
150
+ - **Cosa parte.** Id dell'agente, voto, commento, se permetti di pubblicare il commento sul sito (spento di default), versione del pacchetto e un codice casuale della valutazione. Niente compito, file, percorsi o nome del progetto, niente account. Nel commento non scrivere nomi, dati personali o parti del progetto.
151
+ - **Sul sito.** Ogni agente con almeno 5 voti mostra media, numero e distribuzione dei voti, e c'è una classifica quando almeno 5 agenti superano la soglia. Un commento compare solo se hai permesso di pubblicarlo e dopo l'approvazione (criteri nelle [note legali](https://agentrica.vercel.app/note-legali#valutazioni)), con il voto e il mese.
152
+ - **Dopo l'invio** ricevi il codice della valutazione: con quello puoi chiedere di cancellarla o di non pubblicare il commento. Un agente si valuta una volta per sessione e una volta al giorno dalla stessa rete.
153
+ - **Se l'invio non riesce** (offline, servizio giù) il tool lo dice e il lavoro continua; il voto non resta salvato da nessuna parte.
154
+ - **Per non avere il tool**, il modulo né le proposte, aggiungi `--no-ratings` al comando: il server non si collega più ad Agentrica.
155
+
156
+ Come trattiamo le valutazioni: [note legali](https://agentrica.vercel.app/note-legali#valutazioni).
90
157
 
91
158
  ## Pannello locale
92
159
 
93
160
  Con `--panel` il server apre anche una pagina sul tuo computer da cui segui il progetto e prendi le scelte che l'agente ti chiede, invece di rispondere nel terminale:
94
161
 
95
162
  ```sh
96
- claude mcp add agentrica -- npx -y @agentrica/mcp@0.4.0 --panel
163
+ npx -y @agentrica/mcp@0.6.0 install --panel
97
164
  ```
98
165
 
99
166
  Poi chiedi all'agente di aprire il pannello (tool `open_panel`): la pagina si apre nel browser. Ha tre pagine, con il menu in alto che conta le scelte in attesa e i rilievi:
100
167
 
101
- - **Sessione**: le scelte da prendere (*Da decidere*), con le opzioni e le motivazioni, la cui risposta, con una nota facoltativa, torna all'agente; accanto, gli agenti di Agentrica chiamati in questa sessione (*Agenti in uso*), con l'inizio del compito;
168
+ - **Sessione**: le scelte da prendere (*Da decidere*), con le opzioni e le motivazioni, la cui risposta, con una nota facoltativa, torna all'agente; accanto, gli agenti di Agentrica chiamati in questa sessione (*Agenti in uso*), con il reparto e l'inizio del compito;
102
169
  - **Piano**: la fase in corso con backlog e criteri di accettazione, e tutte le fasi del progetto;
103
170
  - **Rilievi**: i rilievi aperti delle fasi e quelli degli audit, per priorità e reparto.
104
171
 
@@ -111,7 +178,7 @@ Con il pannello il modello ha due tool in più:
111
178
 
112
179
  Se la pagina non è aperta, `ask_user` la apre. Il client aspetta la risposta finché il server manda notifiche di avanzamento (fino a 4 ore; 25 minuti con un client che non le chiede), poi l'agente chiede nel terminale. Le domande del client, come i permessi dei tool, restano nel client.
113
180
 
114
- **Cosa cambia con `--panel`.** Il server apre una porta casuale solo su `127.0.0.1`, legge `plan/`, `audit/` e lo stato di git (`git status`) della cartella del progetto e tiene in memoria le ultime 20 chiamate agli agenti. Non scrive file e non manda dati fuori dal computer. La pagina si apre solo con il token casuale contenuto nell'URL, che vale per quella sessione; le richieste da altri siti o con un altro `Host` sono rifiutate. Il permission model di Node consigliato sopra non si usa con `--panel`, che ha bisogno della rete locale e di `git`.
181
+ **Cosa cambia con `--panel`.** Il server apre una porta casuale solo su `127.0.0.1` (se c'è una versione nuova, la pagina lo dice in alto), legge `plan/`, `audit/` e lo stato di git (`git status`) della cartella del progetto e tiene in memoria le ultime 20 chiamate agli agenti. Non scrive file e non manda dati fuori dal computer, salvo le valutazioni che invii dalla pagina. La pagina si apre solo con il token casuale contenuto nell'URL, che vale per quella sessione; le richieste da altri siti o con un altro `Host` sono rifiutate. Il permission model di Node consigliato sopra non si usa con `--panel`, che ha bisogno della rete locale e di `git`.
115
182
 
116
183
  **Formato di `plan/` e `audit/`.** Il pannello legge il formato dei piani creati da `init`, lo stesso del [`plan/`](https://github.com/flgisimone/agentrica/tree/main/plan) e dell'[`audit/`](https://github.com/flgisimone/agentrica/tree/main/audit) di Agentrica; se qualcosa manca, la pagina dice cosa.
117
184
 
@@ -124,7 +191,7 @@ Se la pagina non è aperta, `ask_user` la apre. Il client aspetta la risposta fi
124
191
  `init` crea un progetto con il metodo di lavoro di Agentrica, pronto per Claude Code:
125
192
 
126
193
  ```sh
127
- npx -y @agentrica/mcp@0.4.0 init mio-progetto --name "Mio progetto"
194
+ npx -y @agentrica/mcp@0.6.0 init mio-progetto --name "Mio progetto"
128
195
  ```
129
196
 
130
197
  Senza cartella usa quella corrente; senza `--name` il nome è quello della cartella. Scrive:
@@ -133,7 +200,7 @@ Senza cartella usa quella corrente; senza `--name` il nome è quello della carte
133
200
  - `plan/` con `README.md` (decisioni, glossario, fasi) e `00-base.md`, la fase F0 da cui si parte; `audit/` e `docs/`;
134
201
  - `agents/` e `.claude/agents/`: i 56 ruoli di questa versione e un subagent per ruolo, con il nome del progetto;
135
202
  - `.github/workflows/ci.yml` (`npm run verify` e `verify:e2e`, saltati finché F0 non li crea), `.gitignore`, `.nvmrc`, `.env.example`;
136
- - `.mcp.json` con questo server a versione esatta e `--panel`, così il pannello legge subito il piano.
203
+ - `.mcp.json` con questo server a versione esatta e `--panel`, così il pannello legge subito il piano (su Windows con `cmd /c npx`).
137
204
 
138
205
  Se anche un solo file esiste già, `init` non scrive nulla e dice quali sono. Fuori da un repository git fa il primo commit su `main` e lascia attivo `develop`; dentro un repository non fa commit. Poi apri Claude Code nella cartella e chiedi di aprire la fase F0. `init` è l'unico comando che scrive file: il server resta in sola lettura. Prende il posto di agentic-starter, che non si aggiorna più.
139
206
 
@@ -149,22 +216,27 @@ Tre agenti provati il 2026-11-15 su tre piccoli progetti con difetti piantati e
149
216
 
150
217
  Limiti: i difetti sono pochi, noti e abbastanza evidenti; un solo modello e una sola esecuzione per caso; un risultato del genere non dice come va un agente su un progetto grande. Progetti, difetti attesi, regole di conteggio e rapporti completi degli agenti sono in [`examples/`](https://github.com/flgisimone/agentrica/tree/main/examples): puoi ripetere le prove.
151
218
 
152
- ## Aggiornamenti
219
+ ## Aggiornare e disinstallare
220
+
221
+ Il testo degli agenti viene dai file di `agents/` della versione installata. Quando esce una versione nuova il server te lo dice una volta per sessione, nella risposta di un tool e nel pannello, con il comando giusto per come l'hai installato. Gli id e i nomi in codice non cambiano.
222
+
223
+ - **Installato con `install`**: rilancia `install` con la versione nuova, es. `npx -y @agentrica/mcp@<versione> install`, poi riavvia Claude Code.
224
+ - **Con `add` o `init`**: rilancia `add` con la versione nuova, o cambia la versione nel comando del server o nel `.mcp.json`, poi riavvia il client.
225
+
226
+ Per disinstallare:
227
+
228
+ ```sh
229
+ claude mcp remove agentrica --scope user
230
+ npm uninstall -g @agentrica/mcp
231
+ ```
153
232
 
154
- Il testo degli agenti viene dai file di `agents/` della versione installata. Per aggiornare cambia la versione nel comando (o reinstalla con `npm install -g`) e riavvia il client. Gli id e i nomi in codice non cambiano.
233
+ Il secondo comando serve solo se avevi usato `install`; con `add --project` o `--local` usa quell'ambito al posto di `user`.
155
234
 
156
235
  Lo stesso catalogo si legge anche da codice, senza avviare il server: `import { loadCatalog } from "@agentrica/mcp/catalog"` restituisce reparti e agenti (con i tipi `Department` e `Agent`) dagli `agents/` del pacchetto. È ciò che usa il sito di Agentrica.
157
236
 
158
237
  ## Versioni
159
238
 
160
- - **0.4.0**: comando `init` che crea un progetto con regole, piano a fasi, agenzie, subagent, CI e `.mcp.json` (prende il posto di agentic-starter); il server è invariato.
161
- - **0.3.3**: export `@agentrica/mcp/catalog` per leggere reparti e agenti da codice (lo usa il sito, ora in un repository a parte); agenti e comportamento del server invariati.
162
- - **0.3.2**: pannello in tre pagine (Sessione, Piano, Rilievi) con menu e contatori delle scelte in attesa e dei rilievi; agenti e comportamento del server invariati.
163
- - **0.3.1**: pannello che nasconde i rilievi chiusi e conta a parte i file nuovi; id del tool `agente` limitato alle sigle dei reparti; regole comuni con una scala di gravità condivisa (P0–P3) e una scala per il reparto software.
164
- - **0.3.0**: pannello locale con `--panel`: fasi, backlog, rilievi, agenti in uso e scelte da prendere dalla pagina (tool `open_panel` e `ask_user`). Senza `--panel` nulla cambia.
165
- - **0.2.1**: nome `io.github.flgisimone/agentrica` per il registro MCP ufficiale; agenti e comportamento invariati.
166
- - **0.2.0**: argomento `--agents` per caricare solo una squadra di agenti o reparti; con un progetto vuoto, o senza ciò che il ruolo deve esaminare, l'agente lo dice e propone i primi passi da confermare, senza inventare rilievi.
167
- - **0.1.0**: prima versione pubblicata. 56 agenti in cinque reparti, un prompt per agente e i tool `elenca_agenti` e `agente`.
239
+ Le novità di ogni versione, con la data, sono in [CHANGELOG.md](https://github.com/flgisimone/agentrica/blob/main/packages/mcp/CHANGELOG.md). La 0.6.0 cambia il nome dei prompt (`aisa-02` diventa `aisa-02-software`).
168
240
 
169
241
  ## Licenza
170
242
 
@@ -2,6 +2,8 @@ export type DepartmentCode = "AIBPD" | "AICA" | "AIPCA" | "AISA" | "AIWDA";
2
2
  export interface DepartmentInfo {
3
3
  code: DepartmentCode;
4
4
  name: string;
5
+ /** Nome breve, nel nome dei prompt dell'MCP («aisa-02-software») e nel pannello: non cambia dopo la pubblicazione (0.6.0). */
6
+ short: string;
5
7
  /** Cartella in agents/. */
6
8
  folder: string;
7
9
  /** Cosa fa il reparto, in una riga. */
@@ -4,6 +4,7 @@ export const DEPARTMENTS = [
4
4
  {
5
5
  code: "AIBPD",
6
6
  name: "AI Business & Product Development",
7
+ short: "Business",
7
8
  folder: "ai_business_product_development_agency",
8
9
  summary: "Obiettivi, requisiti, priorità, roadmap, business case e mercato.",
9
10
  stars: ["ALDERAMIN", "PROCYON", "ALPHARD", "HAMAL", "ALGIEBA", "DIPHDA", "MENKENT", "MIRACH", "ALPHERATZ", "RASALHAGUE", "KOCHAB", "DENEBOLA"],
@@ -11,6 +12,7 @@ export const DEPARTMENTS = [
11
12
  {
12
13
  code: "AICA",
13
14
  name: "AI Cybersecurity",
15
+ short: "Cybersecurity",
14
16
  folder: "ai_cybersecurity_agency",
15
17
  summary: "Threat model, configurazioni, accessi, vulnerabilità e risposta agli incidenti.",
16
18
  stars: ["VEGA", "RIGEL", "BETELGEUSE", "ALNILAM", "ALNITAK", "MINTAKA", "SAIPH", "ELNATH", "WEZEN", "SARGAS", "ATRIA", "NUNKI"],
@@ -18,6 +20,7 @@ export const DEPARTMENTS = [
18
20
  {
19
21
  code: "AIPCA",
20
22
  name: "AI Privacy & Compliance",
23
+ short: "Privacy",
21
24
  folder: "ai_privacy_compliance_agency",
22
25
  summary: "GDPR, basi giuridiche, conservazione dei dati, fornitori e DPIA.",
23
26
  stars: ["ARCTURUS", "ALIOTH", "DUBHE", "ALKAID", "MIZAR", "MERAK", "ALCOR", "PHECDA", "MEGREZ", "THUBAN"],
@@ -25,6 +28,7 @@ export const DEPARTMENTS = [
25
28
  {
26
29
  code: "AISA",
27
30
  name: "AI Software",
31
+ short: "Software",
28
32
  folder: "ai_software_agency",
29
33
  summary: "Analisi, architettura, sviluppo, test, sicurezza applicativa e revisione del codice.",
30
34
  stars: ["SIRIUS", "ALTAIR", "ALDEBARAN", "ANTARES", "SPICA", "POLLUX", "FOMALHAUT", "DENEB", "REGULUS", "CASTOR", "BELLATRIX", "MIRFAK"],
@@ -32,6 +36,7 @@ export const DEPARTMENTS = [
32
36
  {
33
37
  code: "AIWDA",
34
38
  name: "AI Web Design",
39
+ short: "Design",
35
40
  folder: "ai_web_design_agency",
36
41
  summary: "Ricerca UX, interfacce, architettura informativa, design system, accessibilità e testi.",
37
42
  stars: ["CANOPUS", "ACHERNAR", "HADAR", "ACRUX", "MIMOSA", "ADHARA", "SHAULA", "GACRUX", "ALNAIR", "AVIOR"],