@agentrica/mcp 0.5.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), logs nothing and has no telemetry. It connects to Agentrica in one case only: when you confirm an [agent rating](#ratings), and it sends only the score, the comment and the version. With `--no-ratings` it never connects. 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`.
23
37
 
24
- **Claude Code**, from your project folder:
38
+ **Without installing anything**, for Claude Code:
25
39
 
26
40
  ```sh
27
- claude mcp add agentrica -- npx -y @agentrica/mcp@0.5.0
41
+ npx -y @agentrica/mcp@0.6.0 add
28
42
  ```
29
43
 
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.
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).
53
+
54
+ **By hand in Claude Code**, without `install` or `add`:
55
+
56
+ ```sh
57
+ claude mcp add --scope user agentrica -- npx -y @agentrica/mcp@0.6.0
58
+ ```
59
+
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.5.0"]
69
+ "args": ["-y", "@agentrica/mcp@0.6.0"]
70
+ }
71
+ }
72
+ }
73
+ ```
74
+
75
+ On Windows:
76
+
77
+ ```json
78
+ {
79
+ "mcpServers": {
80
+ "agentrica": {
81
+ "command": "cmd",
82
+ "args": ["/c", "npx", "-y", "@agentrica/mcp@0.6.0"]
40
83
  }
41
84
  }
42
85
  }
43
86
  ```
44
87
 
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. With these permissions, sending a [rating](#ratings) fails with a clear message: to rate agents add `--allow-net`, otherwise add `--no-ratings` at the end of the command.
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.5.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.5.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.
@@ -93,13 +144,16 @@ While working, the agent says who it is, for example "AISA-02 · ALTAIR — Seni
93
144
 
94
145
  ## Ratings
95
146
 
96
- 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. When the agent has finished the task it suggests a rating, once per session; if it has been working for more than 30 minutes, the server reminds the model once. You can also ask ("rate AISA-02").
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.
97
148
 
98
- - **Nothing is sent without your yes.** `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. With `--panel` you rate from the page, in the "Valuta gli agenti" section.
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.
99
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.
100
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.
101
155
  - **If sending fails** (offline, service down) the tool says so and the work goes on; the rating is not stored anywhere.
102
- - **To drop the tool** and the suggestions, add `--no-ratings` to the command: the server never connects.
156
+ - **To drop the tool**, the form and the suggestions, add `--no-ratings` to the command: the server no longer connects to Agentrica.
103
157
 
104
158
  How ratings are handled: [legal notes](https://agentrica.vercel.app/note-legali#valutazioni) (in Italian).
105
159
 
@@ -108,12 +162,12 @@ How ratings are handled: [legal notes](https://agentrica.vercel.app/note-legali#
108
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:
109
163
 
110
164
  ```sh
111
- claude mcp add agentrica -- npx -y @agentrica/mcp@0.5.0 --panel
165
+ npx -y @agentrica/mcp@0.6.0 install --panel
112
166
  ```
113
167
 
114
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:
115
169
 
116
- - **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;
117
171
  - **Piano** (plan): the open phase with backlog and acceptance criteria, and all project phases;
118
172
  - **Rilievi** (findings): open findings from phases and audits, by priority and department.
119
173
 
@@ -139,7 +193,7 @@ If the page is not open, `ask_user` opens it. The client waits for the answer as
139
193
  `init` creates a project with Agentrica's way of working, ready for Claude Code:
140
194
 
141
195
  ```sh
142
- npx -y @agentrica/mcp@0.5.0 init my-project --name "My project"
196
+ npx -y @agentrica/mcp@0.6.0 init my-project --name "My project"
143
197
  ```
144
198
 
145
199
  Without a folder it uses the current one; without `--name` the name is the folder's. It writes, in Italian:
@@ -148,7 +202,7 @@ Without a folder it uses the current one; without `--name` the name is the folde
148
202
  - `plan/` with `README.md` (decisions, glossary, phases) and `00-base.md`, the F0 phase to start from; `audit/` and `docs/`;
149
203
  - `agents/` and `.claude/agents/`: the 56 roles of this version and one subagent per role, with the project name;
150
204
  - `.github/workflows/ci.yml` (`npm run verify` and `verify:e2e`, skipped until F0 creates them), `.gitignore`, `.nvmrc`, `.env.example`;
151
- - `.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`).
152
206
 
153
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.
154
208
 
@@ -164,23 +218,27 @@ Three agents tested on 2026-11-15 against three small projects with planted, doc
164
218
 
165
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.
166
220
 
167
- ## 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
+ ```
168
234
 
169
- 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`.
170
236
 
171
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.
172
238
 
173
239
  ## Versions
174
240
 
175
- - **0.5.0**: agent ratings (two-step `rate_agent` tool with preview and code, "Valuta gli agenti" section in the panel, suggestion at the end of the work and a reminder after 30 minutes), the server's only connection and only after your confirmation; `--no-ratings` removes it. The agent says who it is (code name, role, department) at the start, at handovers and in the summary.
176
- - **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.
177
- - **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.
178
- - **0.3.2**: the panel has three pages (Sessione, Piano, Rilievi) with a menu counting pending choices and findings; agents and server behaviour unchanged.
179
- - **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.
180
- - **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.
181
- - **0.2.1**: name `io.github.flgisimone/agentrica` for the official MCP registry; agents and behaviour unchanged.
182
- - **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.
183
- - **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`).
184
242
 
185
243
  ## License
186
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 registra e non ha telemetria. Apre una connessione verso Agentrica in un caso solo: quando confermi la [valutazione di un agente](#valutazioni), e invia solo voto, commento e versione. Con `--no-ratings` non si collega mai. 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`.
21
35
 
22
- **Claude Code**, dalla cartella del tuo progetto:
36
+ **Senza installare nulla**, per Claude Code:
23
37
 
24
38
  ```sh
25
- claude mcp add agentrica -- npx -y @agentrica/mcp@0.5.0
39
+ npx -y @agentrica/mcp@0.6.0 add
26
40
  ```
27
41
 
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.
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:
43
+
44
+ ```sh
45
+ npx -y @agentrica/mcp@0.6.0 add --project
46
+ ```
47
+
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.5.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. Con questi permessi l'invio di una [valutazione](#valutazioni) fallisce con un messaggio chiaro: se vuoi votare gli agenti aggiungi `--allow-net`, altrimenti aggiungi `--no-ratings` in fondo al comando.
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.5.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.5.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.
@@ -91,13 +142,16 @@ I file degli agenti sono in italiano; l'agente risponde nella lingua in cui gli
91
142
 
92
143
  ## Valutazioni
93
144
 
94
- Puoi dare a un agente un voto da 1 a 5 e un commento su cosa migliorare: servono a correggere i file di ruolo. Quando l'agente ha finito il compito te lo propone, una volta per sessione; se lavora da più di 30 minuti, il server lo ricorda al modello una volta. Puoi anche chiederlo tu («valuta AISA-02»).
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.
95
146
 
96
- - **Niente parte senza il tuo sì.** `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. Con `--panel` voti dalla pagina, nella sezione «Valuta gli agenti».
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».
97
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.
98
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.
99
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.
100
- - **Per non avere il tool** né le proposte, aggiungi `--no-ratings` al comando: il server non si collega mai.
154
+ - **Per non avere il tool**, il modulo né le proposte, aggiungi `--no-ratings` al comando: il server non si collega più ad Agentrica.
101
155
 
102
156
  Come trattiamo le valutazioni: [note legali](https://agentrica.vercel.app/note-legali#valutazioni).
103
157
 
@@ -106,12 +160,12 @@ Come trattiamo le valutazioni: [note legali](https://agentrica.vercel.app/note-l
106
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:
107
161
 
108
162
  ```sh
109
- claude mcp add agentrica -- npx -y @agentrica/mcp@0.5.0 --panel
163
+ npx -y @agentrica/mcp@0.6.0 install --panel
110
164
  ```
111
165
 
112
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:
113
167
 
114
- - **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;
115
169
  - **Piano**: la fase in corso con backlog e criteri di accettazione, e tutte le fasi del progetto;
116
170
  - **Rilievi**: i rilievi aperti delle fasi e quelli degli audit, per priorità e reparto.
117
171
 
@@ -124,7 +178,7 @@ Con il pannello il modello ha due tool in più:
124
178
 
125
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.
126
180
 
127
- **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, 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`.
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`.
128
182
 
129
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.
130
184
 
@@ -137,7 +191,7 @@ Se la pagina non è aperta, `ask_user` la apre. Il client aspetta la risposta fi
137
191
  `init` crea un progetto con il metodo di lavoro di Agentrica, pronto per Claude Code:
138
192
 
139
193
  ```sh
140
- npx -y @agentrica/mcp@0.5.0 init mio-progetto --name "Mio progetto"
194
+ npx -y @agentrica/mcp@0.6.0 init mio-progetto --name "Mio progetto"
141
195
  ```
142
196
 
143
197
  Senza cartella usa quella corrente; senza `--name` il nome è quello della cartella. Scrive:
@@ -146,7 +200,7 @@ Senza cartella usa quella corrente; senza `--name` il nome è quello della carte
146
200
  - `plan/` con `README.md` (decisioni, glossario, fasi) e `00-base.md`, la fase F0 da cui si parte; `audit/` e `docs/`;
147
201
  - `agents/` e `.claude/agents/`: i 56 ruoli di questa versione e un subagent per ruolo, con il nome del progetto;
148
202
  - `.github/workflows/ci.yml` (`npm run verify` e `verify:e2e`, saltati finché F0 non li crea), `.gitignore`, `.nvmrc`, `.env.example`;
149
- - `.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`).
150
204
 
151
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ù.
152
206
 
@@ -162,23 +216,27 @@ Tre agenti provati il 2026-11-15 su tre piccoli progetti con difetti piantati e
162
216
 
163
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.
164
218
 
165
- ## 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
+ ```
166
232
 
167
- 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`.
168
234
 
169
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.
170
236
 
171
237
  ## Versioni
172
238
 
173
- - **0.5.0**: 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), unica connessione del server e solo dopo la conferma; `--no-ratings` la toglie. L'agente dice chi è (nome in codice, ruolo, reparto) all'inizio, ai cambi e nel riepilogo.
174
- - **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.
175
- - **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.
176
- - **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.
177
- - **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.
178
- - **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.
179
- - **0.2.1**: nome `io.github.flgisimone/agentrica` per il registro MCP ufficiale; agenti e comportamento invariati.
180
- - **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.
181
- - **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`).
182
240
 
183
241
  ## Licenza
184
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"],
@@ -1,6 +1,6 @@
1
1
  /** I subagent di Agentrica nominano il progetto solo in questa frase (lo controlla init.test.ts). */
2
2
  export declare const SUBAGENT_PROJECT = "del progetto Agentrica.";
3
3
  /** I file del progetto nuovo, per percorso relativo, con i segnaposto già sostituiti. */
4
- export declare function projectFiles(name: string, path: string, date: string): Map<string, string>;
4
+ export declare function projectFiles(name: string, path: string, date: string, platform?: NodeJS.Platform): Map<string, string>;
5
5
  /** Esegue il comando; restituisce il codice di uscita. */
6
6
  export declare function runInit(args: string[]): number;