@agentrica/mcp 0.3.3 → 0.4.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/.claude/agents/business-product/biz-business-analyst-requirements-strategist.md +18 -0
- package/.claude/agents/business-product/biz-business-development-manager.md +18 -0
- package/.claude/agents/business-product/biz-business-financial-analyst.md +18 -0
- package/.claude/agents/business-product/biz-chief-officer.md +18 -0
- package/.claude/agents/business-product/biz-customer-success-retention-strategist.md +18 -0
- package/.claude/agents/business-product/biz-growth-monetization-manager.md +18 -0
- package/.claude/agents/business-product/biz-market-research-analyst.md +18 -0
- package/.claude/agents/business-product/biz-product-innovation-strategist.md +18 -0
- package/.claude/agents/business-product/biz-product-manager.md +18 -0
- package/.claude/agents/business-product/biz-product-marketing-manager.md +18 -0
- package/.claude/agents/business-product/biz-product-portfolio-roadmap-manager.md +18 -0
- package/.claude/agents/business-product/biz-sales-revenue-strategist.md +18 -0
- package/.claude/agents/cybersecurity/sec-appsec-engineer.md +18 -0
- package/.claude/agents/cybersecurity/sec-awareness-engineer.md +18 -0
- package/.claude/agents/cybersecurity/sec-ciso.md +18 -0
- package/.claude/agents/cybersecurity/sec-cloud-security-engineer.md +18 -0
- package/.claude/agents/cybersecurity/sec-iam-engineer.md +18 -0
- package/.claude/agents/cybersecurity/sec-incident-response.md +18 -0
- package/.claude/agents/cybersecurity/sec-network-security-engineer.md +18 -0
- package/.claude/agents/cybersecurity/sec-pentest-specialist.md +18 -0
- package/.claude/agents/cybersecurity/sec-risk-compliance-auditor.md +18 -0
- package/.claude/agents/cybersecurity/sec-security-architect.md +18 -0
- package/.claude/agents/cybersecurity/sec-soc-analyst.md +18 -0
- package/.claude/agents/cybersecurity/sec-vulnerability-management.md +18 -0
- package/.claude/agents/privacy-compliance/privacy-breach-response.md +18 -0
- package/.claude/agents/privacy-compliance/privacy-chief-officer.md +18 -0
- package/.claude/agents/privacy-compliance/privacy-compliance-auditor.md +18 -0
- package/.claude/agents/privacy-compliance/privacy-data-governance.md +18 -0
- package/.claude/agents/privacy-compliance/privacy-data-subject-rights.md +18 -0
- package/.claude/agents/privacy-compliance/privacy-dpia-specialist.md +18 -0
- package/.claude/agents/privacy-compliance/privacy-gdpr-specialist.md +18 -0
- package/.claude/agents/privacy-compliance/privacy-legal-specialist.md +18 -0
- package/.claude/agents/privacy-compliance/privacy-security-engineer.md +18 -0
- package/.claude/agents/privacy-compliance/privacy-vendor-compliance.md +18 -0
- package/.claude/agents/software/sw-architect.md +18 -0
- package/.claude/agents/software/sw-backend-developer.md +18 -0
- package/.claude/agents/software/sw-code-reviewer.md +18 -0
- package/.claude/agents/software/sw-cto.md +18 -0
- package/.claude/agents/software/sw-database-engineer.md +18 -0
- package/.claude/agents/software/sw-devops-engineer.md +18 -0
- package/.claude/agents/software/sw-frontend-developer.md +18 -0
- package/.claude/agents/software/sw-fullstack-developer.md +18 -0
- package/.claude/agents/software/sw-functional-analyst.md +18 -0
- package/.claude/agents/software/sw-performance-engineer.md +18 -0
- package/.claude/agents/software/sw-qa-engineer.md +18 -0
- package/.claude/agents/software/sw-security-engineer.md +18 -0
- package/.claude/agents/web-design/design-accessibility-specialist.md +18 -0
- package/.claude/agents/web-design/design-dataviz-designer.md +18 -0
- package/.claude/agents/web-design/design-director.md +18 -0
- package/.claude/agents/web-design/design-information-architect.md +18 -0
- package/.claude/agents/web-design/design-system-specialist.md +18 -0
- package/.claude/agents/web-design/design-ui-designer.md +18 -0
- package/.claude/agents/web-design/design-usability-auditor.md +18 -0
- package/.claude/agents/web-design/design-ux-designer.md +18 -0
- package/.claude/agents/web-design/design-ux-researcher.md +18 -0
- package/.claude/agents/web-design/design-ux-writer.md +18 -0
- package/README.en.md +26 -7
- package/README.md +26 -7
- package/dist/mcp/src/init.d.ts +6 -0
- package/dist/mcp/src/init.js +103 -0
- package/dist/mcp/src/page/style.css +1 -1
- package/dist/mcp/src/project.js +2 -2
- package/dist/mcp/src/prompt.d.ts +1 -1
- package/dist/mcp/src/prompt.js +1 -1
- package/dist/mcp/src/server.js +6 -1
- package/package.json +4 -2
- package/starter/.github/workflows/ci.yml +65 -0
- package/starter/.nvmrc +1 -0
- package/starter/AGENTS.md +89 -0
- package/starter/CLAUDE.md +1 -0
- package/starter/CONVENTIONS.md +192 -0
- package/starter/README.md +20 -0
- package/starter/audit/README.md +15 -0
- package/starter/docs/AI Multi-Agency System.md +516 -0
- package/starter/docs/README.md +7 -0
- package/starter/gitignore +36 -0
- package/starter/plan/00-base.md +47 -0
- package/starter/plan/README.md +37 -0
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
# Convenzioni di {{PROJECT_NAME}}
|
|
2
|
+
|
|
3
|
+
Regole per chi lavora al codice di {{PROJECT_NAME}}, persone o agenti. `AGENTS.md` le completa con le regole per gli agenti e le agenzie (§16). Le parti marcate «da compilare» dipendono dallo stack e si scrivono in F0; il resto vale per ogni progetto.
|
|
4
|
+
|
|
5
|
+
## 1. Scopo
|
|
6
|
+
|
|
7
|
+
<!-- Da compilare: cos'è il prodotto, per chi, e cosa non si deve mai rompere (dati reali, partite salvate, contenuti pubblicati…). -->
|
|
8
|
+
|
|
9
|
+
Le regole servono a tre cose, in quest'ordine: non perdere né alterare i dati e il lavoro dell'utente, tenere il codice semplice e leggibile, consegnare modifiche verificate.
|
|
10
|
+
|
|
11
|
+
## 2. Flusso di lavoro
|
|
12
|
+
|
|
13
|
+
### 2.1 Leggere prima
|
|
14
|
+
Prima di modificare il codice si leggono questo documento (le sezioni pertinenti), `AGENTS.md`, il file della fase in `plan/` e i criteri di accettazione. Uno script, una libreria o una configurazione esiste solo se lo si trova nel repository, non perché un documento lo descrive.
|
|
15
|
+
|
|
16
|
+
### 2.2 Capire il codice esistente
|
|
17
|
+
Si guardano i file coinvolti e le loro dipendenze, si cercano helper, tipi e componenti che risolvono già il problema, si capisce come scorrono i dati. Si seguono i pattern esistenti, salvo un motivo concreto.
|
|
18
|
+
|
|
19
|
+
### 2.3 Chiarire le ambiguità che contano
|
|
20
|
+
Si procede da soli quando i requisiti sono chiari e le scelte sono a basso rischio e reversibili. Si chiede all'utente quando un'ambiguità può cambiare il comportamento visibile, l'integrità dei dati, la sicurezza, il modello dei dati o il perimetro. Le decisioni di prodotto non si prendono in silenzio.
|
|
21
|
+
|
|
22
|
+
### 2.4 La soluzione più piccola che regge
|
|
23
|
+
Si applica la scala Ponytail di `AGENTS.md`. Niente refactoring estranei, niente astrazioni o dipendenze non necessarie, comportamento esistente preservato.
|
|
24
|
+
|
|
25
|
+
### 2.5 Verificare
|
|
26
|
+
Si rilegge il diff, si eseguono i controlli (§13), si verificano i criteri di accettazione sull'implementazione reale. Non si dichiara superato un controllo che non è stato eseguito.
|
|
27
|
+
|
|
28
|
+
### 2.6 Fasi e backlog
|
|
29
|
+
Il lavoro si divide in fasi, una alla volta, elencate in `plan/README.md` (tabella «Fasi») con le decisioni prese.
|
|
30
|
+
- **File di fase.** Ogni fase ha `plan/NN-nome.md` con obiettivo, stato, agenzie, situazione di partenza, decisioni dell'utente, `## Backlog`, `## Criteri di accettazione` e, alla chiusura, «Fatto», «Verifiche» e «Rilievi aperti» (modello: `plan/00-base.md`).
|
|
31
|
+
- **Backlog.** Una tabella con id `FN-NN`, task e priorità (`P0`–`P3`, come in `AGENTS.md`), confermata dall'utente all'apertura. Un task è fatto quando «Fatto» cita il suo id in grassetto (`**FN-NN**`) con l’evidenza: il pannello di `@agentrica/mcp` (`--panel`) legge questo formato.
|
|
32
|
+
- **Apertura.** Le «proposte da confermare» del file si decidono con l'utente; si apre `fase/fN-nome` da `develop`.
|
|
33
|
+
- **Durante.** Ciò che esce dal perimetro diventa una voce del backlog o un rilievo aperto, non una modifica di passaggio (§14). Le correzioni fuori fase vanno su `fix/nome`.
|
|
34
|
+
- **Chiusura.** Procedura di §13.7; i «Rilievi aperti» restano visibili finché una fase successiva non li chiude con un'evidenza.
|
|
35
|
+
|
|
36
|
+
## 3. Scrittura del codice
|
|
37
|
+
|
|
38
|
+
- **Leggibilità prima di tutto**: nomi che dicono cosa contengono, funzioni brevi con una responsabilità, flusso lineare con uscite anticipate.
|
|
39
|
+
- **Semplicità**: il codice più corto che resta chiaro. Niente «per dopo».
|
|
40
|
+
- **DRY senza esagerare**: si estrae alla terza ripetizione o quando la logica deve restare identica.
|
|
41
|
+
- **Costanti**: niente valori magici ripetuti; le stringhe di dominio stanno in un solo punto.
|
|
42
|
+
- **Commenti**: spiegano il perché, non il cosa. Brevi, in italiano. Una semplificazione voluta si segna con `ponytail:`, dicendo il limite e quando superarlo.
|
|
43
|
+
- **Codice morto**: si toglie, non si commenta.
|
|
44
|
+
- **Difese**: si valida l'input ai confini (azioni lato server, route, import, input dell'utente); dentro, si usano i tipi.
|
|
45
|
+
|
|
46
|
+
## 4. TypeScript
|
|
47
|
+
|
|
48
|
+
- `strict` resta attivo, con `noUncheckedIndexedAccess`. Niente `any`; `unknown` ai confini, poi restringimento.
|
|
49
|
+
- Asserzioni (`as`, `!`) solo dove un controllo precedente le garantisce, con un commento se non è evidente.
|
|
50
|
+
- Un tipo si definisce una volta e si deriva (`Pick`, `Omit`, tipi inferiti dallo schema) invece di ridefinirlo.
|
|
51
|
+
- <!-- Da compilare: unità e formati del dominio (es. importi interi in centesimi, date `YYYY-MM-DD`, unità di misura del mondo di gioco). -->
|
|
52
|
+
|
|
53
|
+
## 5. Architettura del repository
|
|
54
|
+
|
|
55
|
+
| Cartella | Contenuto |
|
|
56
|
+
|---|---|
|
|
57
|
+
| `src/lib/` | logica pura e testata: niente DOM, rete, database né orologio (riceve `today` o `dt` come parametro) |
|
|
58
|
+
| <!-- da compilare --> | <!-- pagine, componenti, scena, server… --> |
|
|
59
|
+
| `e2e/` | test end-to-end e cattura delle evidenze degli audit |
|
|
60
|
+
| `scripts/` | script di progetto (migrazioni, dati dei test, utilità) |
|
|
61
|
+
| `plan/` | decisioni e fasi |
|
|
62
|
+
| `agents/`, `.claude/agents/` | ruoli delle agenzie e subagent |
|
|
63
|
+
| `audit/` | rilievi e report degli audit |
|
|
64
|
+
| `docs/` | materiale di riferimento |
|
|
65
|
+
|
|
66
|
+
La logica che si può testare senza framework, rete o database va in `src/lib`. Un controllo di lint lo fa rispettare quando lo stack lo permette.
|
|
67
|
+
|
|
68
|
+
## 6. Dati e stato
|
|
69
|
+
|
|
70
|
+
<!-- Da compilare: dove si leggono e si scrivono i dati, dove vive lo stato (URL, server, client locale), come si invalida dopo una scrittura. Regola comune: lo stato che deve sopravvivere a un link sta nell'URL; niente librerie di stato globale senza un motivo registrato in plan/README.md. -->
|
|
71
|
+
|
|
72
|
+
## 7. Confini: API, azioni, input
|
|
73
|
+
|
|
74
|
+
<!-- Da compilare: come entrano dati e comandi (Server Actions, API, eventi di input, file importati). Regole comuni: -->
|
|
75
|
+
|
|
76
|
+
- Ogni scrittura passa da un solo punto per area, valida i suoi input e restituisce un esito vero: un aggiornamento che non tocca nulla non risponde «aggiornato».
|
|
77
|
+
- Le scritture in più passi sono atomiche (transazione o equivalente).
|
|
78
|
+
|
|
79
|
+
## 8. Form e interazioni
|
|
80
|
+
|
|
81
|
+
<!-- Da compilare: componenti dei form, formati di input (es. importi in formato italiano), comportamento dopo il salvataggio; oppure, per un gioco, mappa dei comandi e feedback. -->
|
|
82
|
+
|
|
83
|
+
## 9. Componenti
|
|
84
|
+
|
|
85
|
+
- Un componente fa una cosa. Si riusano i componenti condivisi prima di crearne di nuovi.
|
|
86
|
+
- Le chiavi delle liste sono stabili e uniche. Niente effetti per calcolare valori derivabili.
|
|
87
|
+
- <!-- Da compilare: regole del framework (Server/Client Components, ciclo di vita della scena…). -->
|
|
88
|
+
|
|
89
|
+
## 10. Accesso e protezione
|
|
90
|
+
|
|
91
|
+
- Nessun segreto nel codice né nei log. I file `.env*` (tranne `.env.example`) non entrano in git.
|
|
92
|
+
- Ogni controllo d'accesso si ripete dove si usano i dati, non solo al primo filtro.
|
|
93
|
+
- <!-- Da compilare quando arrivano account o dati per utente: come si entra, dove vive la sessione, come si separano i dati. -->
|
|
94
|
+
|
|
95
|
+
## 11. Interfaccia, coerenza e accessibilità
|
|
96
|
+
|
|
97
|
+
- Si usano i token del design system, mai colori scritti a mano.
|
|
98
|
+
- Lo stato non si affida mai al solo colore: c'è sempre un segno, una forma o un testo.
|
|
99
|
+
- HTML semantico: un `h1` per pagina, titoli di sezione, tabelle con intestazioni, etichette sui campi.
|
|
100
|
+
- Tastiera: ogni azione è raggiungibile, il focus è visibile, i dialoghi lo intrappolano e lo restituiscono.
|
|
101
|
+
- Contrasto WCAG 2.2 AA: almeno 4,5:1 per il testo, 3:1 per gli elementi grafici.
|
|
102
|
+
- Responsive fino a 390 px senza scorrimento orizzontale della pagina. <!-- adattare ai dispositivi del progetto -->
|
|
103
|
+
- Ogni dato ha i suoi stati: caricamento, vuoto, errore.
|
|
104
|
+
- Testi in italiano, brevi, con il glossario di `plan/README.md`.
|
|
105
|
+
|
|
106
|
+
## 12. Prestazioni e affidabilità
|
|
107
|
+
|
|
108
|
+
- Si ottimizza solo su misure.
|
|
109
|
+
- Le dipendenze nuove richiedono un motivo e l'ok dell'utente; prima si guarda la libreria standard e la piattaforma. Le versioni si fissano esatte.
|
|
110
|
+
- Le operazioni distruttive (import, eliminazioni, migrazioni, reset dei salvataggi) hanno conferma, esito e un modo per tornare indietro.
|
|
111
|
+
|
|
112
|
+
## 13. Test e controlli
|
|
113
|
+
|
|
114
|
+
### 13.1 Cosa testare
|
|
115
|
+
Si testano il comportamento e i rischi, con i casi limite del dominio. Un bug corretto ha il suo test di regressione.
|
|
116
|
+
|
|
117
|
+
### 13.2 Test unitari
|
|
118
|
+
<!-- Da compilare: strumento e posizione, es. «`node --test` in `src/lib/*.test.ts` (`npm test`), senza dipendenze in più». -->
|
|
119
|
+
|
|
120
|
+
### 13.3 Schema e migrazioni
|
|
121
|
+
<!-- Da compilare se c'è un database: come si generano, si rileggono e si provano su una copia prima di applicarle. -->
|
|
122
|
+
|
|
123
|
+
### 13.4 Test end-to-end
|
|
124
|
+
Con Playwright in `e2e/`. I test usano solo dati finti e non toccano mai i dati reali dell'utente. L'accessibilità si controlla con axe dove c'è un'interfaccia HTML: nessuna violazione serious o critical, salvo i rilievi aperti elencati.
|
|
125
|
+
|
|
126
|
+
### 13.5 Controlli prima del commit e del merge
|
|
127
|
+
- `npm run verify`: typecheck, lint, test unitari e build. Prima di ogni commit. Stampa solo errori e riepiloghi.
|
|
128
|
+
- `npm run verify:e2e`: test end-to-end. Prima del merge di una fase.
|
|
129
|
+
|
|
130
|
+
La CI esegue gli stessi due script: se uno manca, quel passo della CI si salta.
|
|
131
|
+
|
|
132
|
+
### 13.6 Riferire i risultati
|
|
133
|
+
Si riportano i comandi eseguiti e l'esito reale, e si dice esplicitamente cosa non è stato verificato.
|
|
134
|
+
|
|
135
|
+
### 13.7 Chiusura di una fase
|
|
136
|
+
Si lavora su `fase/fN-nome` (o `fix/nome` per una correzione fuori fase), partendo da `develop`. Quando i criteri di accettazione sono soddisfatti, la fase si chiude con questi passi, in quest'ordine:
|
|
137
|
+
|
|
138
|
+
1. **Piano.** Il file della fase passa a «completata» con «Fatto», «Verifiche» e «Rilievi aperti»; si aggiornano la riga in «Fasi» e, se servono, «Decisioni» e «Glossario» di `plan/README.md`.
|
|
139
|
+
2. **Controlli.** `npm run verify` e `npm run verify:e2e` (da quando esiste), con l'esito reale.
|
|
140
|
+
3. **Proposta.** All'utente si presentano il riepilogo (§19) e la sequenza dei passi 4–7, con un'unica domanda di conferma. Senza l'ok non si va avanti; se l'utente chiede modifiche, si riparte dal passo 1.
|
|
141
|
+
4. **Commit** sul branch della fase, con il messaggio che dice cosa cambia.
|
|
142
|
+
5. **Merge** in `develop` con `--no-ff` e messaggio «Merge fase/fN-nome in develop».
|
|
143
|
+
6. **Push** di `develop` e del branch della fase; la CI (`.github/workflows/ci.yml`) deve diventare verde (`gh run list`, `gh run watch`). Se è rossa, la si corregge su un `fix/…` prima di aprire la fase successiva.
|
|
144
|
+
7. **Indice.** `tokensave sync` dalla root.
|
|
145
|
+
8. **Sessione nuova.** Si dice all'utente che lo stato è completo in `plan/` e in git e che può fare `/clear`; la fase successiva riparte leggendo `plan/README.md` e il suo file.
|
|
146
|
+
|
|
147
|
+
Se un passo fallisce ci si ferma, si riferisce l'errore e non si salta ai passi successivi. Una correzione `fix/…` segue gli stessi passi; il messaggio del merge è «Merge fix/nome in develop».
|
|
148
|
+
|
|
149
|
+
### 13.8 Rilascio in `main`
|
|
150
|
+
Non fa parte della chiusura di una fase: si fa solo quando l'utente lo chiede, con la CI di `develop` verde.
|
|
151
|
+
1. Pull request da `develop` a `main` (`gh pr create --base main --head develop --title "Rilascio: FN descrizione breve"`), unita con merge commit quando la CI è verde (`gh pr merge --merge`). Conviene un ruleset su `main` che vieti push diretti e force push.
|
|
152
|
+
2. <!-- Da compilare: hosting, cosa pubblica `main`, passi per le migrazioni, controllo dopo il deploy. -->
|
|
153
|
+
|
|
154
|
+
Deploy e migrazioni in produzione partono sempre con un ok esplicito, a parte da quello della fase.
|
|
155
|
+
|
|
156
|
+
## 14. Perimetro e difetti esistenti
|
|
157
|
+
|
|
158
|
+
- Si fa ciò che la fase chiede. Un difetto direttamente collegato si corregge nello stesso task e si segnala; gli altri diventano voci del backlog in `plan/`, non modifiche di passaggio.
|
|
159
|
+
- Il comportamento esistente si preserva, salvo che la fase lo cambi.
|
|
160
|
+
|
|
161
|
+
## 15. Configurazione del repository
|
|
162
|
+
|
|
163
|
+
### 15.1 Stack
|
|
164
|
+
<!-- Da compilare in F0: framework, versioni, file di configurazione e loro particolarità. Una sottosezione per strumento (15.2, 15.3…). -->
|
|
165
|
+
|
|
166
|
+
### 15.x Evidenze per gli audit
|
|
167
|
+
<!-- Quando serve: uno script `audit:capture` (Playwright) che salva screenshot, report axe e albero accessibile in `audit/<audit_id>/evidenze/`, su dati finti. -->
|
|
168
|
+
|
|
169
|
+
### 15.y Agenzie
|
|
170
|
+
Ruoli, attivazione e coordinamento delle agenzie sono in `AGENTS.md`, sezione «Agenzie», e in `docs/AI Multi-Agency System.md`. Le regole delle agenzie si aggiungono a questo documento, non lo sostituiscono.
|
|
171
|
+
|
|
172
|
+
## 16. Istruzioni e conflitti
|
|
173
|
+
|
|
174
|
+
L'ordine di precedenza è: richiesta esplicita dell'utente, poi decisioni registrate in `plan/`, poi questo documento, poi `AGENTS.md` e i file di ruolo delle agenzie. Se due regole si contraddicono si segnala il conflitto all'utente invece di sceglierne una in silenzio. `CLAUDE.md` importa `AGENTS.md`.
|
|
175
|
+
|
|
176
|
+
## 17. Definition of Done
|
|
177
|
+
|
|
178
|
+
**Implementazione**: criteri di accettazione soddisfatti, codice secondo queste regole, nessun codice morto, nessun segreto.
|
|
179
|
+
|
|
180
|
+
**Esperienza e affidabilità**: stati di caricamento, vuoto ed errore; tastiera e contrasto; dispositivi del progetto provati; esiti veri; nessun dato dell'utente perso o alterato.
|
|
181
|
+
|
|
182
|
+
**Verifica**: `npm run verify` superato; `npm run verify:e2e` superato per il merge; test nuovi per il comportamento nuovo; revisione del Code Reviewer.
|
|
183
|
+
|
|
184
|
+
**Comunicazione**: file della fase aggiornato; rilievi aperti elencati; conferma dell'utente per commit, merge e push.
|
|
185
|
+
|
|
186
|
+
## 18. Eccezioni
|
|
187
|
+
|
|
188
|
+
Un'eccezione a queste regole si scrive nella tabella «Decisioni» di `plan/README.md` o nel file della fase, con il motivo, prima del codice.
|
|
189
|
+
|
|
190
|
+
## 19. Risposta finale
|
|
191
|
+
|
|
192
|
+
Chi chiude un task riferisce, in quest'ordine: cosa è stato fatto, file toccati, controlli eseguiti con l'esito reale, ruoli delle agenzie consultati, rilievi rimasti aperti e decisioni che servono all'utente.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# {{PROJECT_NAME}}
|
|
2
|
+
|
|
3
|
+
<!-- Cos'è, per chi, stato attuale. -->
|
|
4
|
+
|
|
5
|
+
## Avvio
|
|
6
|
+
|
|
7
|
+
<!-- Da compilare in F0: requisiti (Node da .nvmrc), npm ci, npm run dev, variabili da .env.example. -->
|
|
8
|
+
|
|
9
|
+
## Come si lavora
|
|
10
|
+
|
|
11
|
+
| File | Contenuto |
|
|
12
|
+
|---|---|
|
|
13
|
+
| [AGENTS.md](AGENTS.md) | regole per gli agenti: tokensave, Ponytail, efficienza, verifica, agenzie (`CLAUDE.md` lo importa) |
|
|
14
|
+
| [CONVENTIONS.md](CONVENTIONS.md) | convenzioni del codice, test, pubblicazione |
|
|
15
|
+
| [plan/](plan/README.md) | decisioni e fasi, una per file |
|
|
16
|
+
| [agents/](agents/) e [.claude/agents/](.claude/agents/) | ruoli delle agenzie e subagent |
|
|
17
|
+
| [audit/](audit/README.md) | rilievi e report degli audit |
|
|
18
|
+
| [docs/](docs/README.md) | materiale di riferimento |
|
|
19
|
+
|
|
20
|
+
Branch: `develop` per lo sviluppo, `main` per le versioni stabili, `fase/fN-nome` e `fix/nome` partendo da `develop`. Controlli: `npm run verify` prima di ogni commit, `npm run verify:e2e` prima del merge di una fase.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Audit
|
|
2
|
+
|
|
3
|
+
Un audit è una cartella `audit/<audit_id>/`, dove `audit_id` è la data (`AAAA-MM-GG`) con un suffisso se nello stesso giorno ce n'è più d'uno (`AAAA-MM-GG-privacy`).
|
|
4
|
+
|
|
5
|
+
| File | Contenuto |
|
|
6
|
+
|---|---|
|
|
7
|
+
| `<ruolo>.json` | rilievi di un agente, nel formato JSON del suo file di ruolo in `agents/` |
|
|
8
|
+
| `report-<agenzia>.md` | report consolidato del direttore dell'agenzia: priorità, backlog proposto, decisioni per l'utente |
|
|
9
|
+
| `evidenze/` | screenshot, report axe, alberi accessibili, log usati come prova |
|
|
10
|
+
|
|
11
|
+
Regole:
|
|
12
|
+
|
|
13
|
+
- Ogni rilievo ha evidenza, priorità P0–P3 motivata e raccomandazione; un rilievo è una proposta finché l'utente non lo conferma.
|
|
14
|
+
- Le decisioni prese sull'audit vanno nella tabella «Decisioni» di `plan/README.md`; i rilievi accettati diventano task di una fase.
|
|
15
|
+
- Le evidenze si catturano su dati finti. Se mostrano dati personali, si attiva la riga `audit/*/evidenze/` del `.gitignore`.
|