Project automation

Project Automation Skill

Sistema di automazione a 4 layer per quality assurance su progetti client Pixarts.

I 4 Layer

Layer 1: PRE-COMMIT    → Ogni commit     → Husky + lint-staged
Layer 2: CI/CD         → Ogni push/PR    → GitHub Actions
Layer 3: MONITORING    → Ogni 6 ore      → n8n workflows
Layer 4: ON-DEMAND     → Quando serve    → @project-checker (AI)

Layer 1: Pre-commit (Husky + lint-staged)

Cosa blocca: errori TypeScript, lint violations, codice non formattato. Quando gira: prima di ogni git commit.

Setup

npm install -D husky lint-staged
npx husky init

Crea .husky/pre-commit:

npx lint-staged

Crea lint-staged.config.mjs:

export default {
  '*.{ts,tsx}': [
    'eslint --fix',
    () => 'tsc --noEmit',
  ],
  '*.{ts,tsx,js,jsx,json,css,md}': [
    'prettier --write',
  ],
};

Aggiungi a package.json:

{
  "scripts": {
    "prepare": "husky"
  }
}

---

Layer 2: CI/CD (GitHub Actions)

Cosa controlla: build, lint, type check, security audit, Lighthouse. Quando gira: ad ogni push su main/develop e ad ogni PR.

File: .github/workflows/ci.yml

Template in .Claude/templates/project-automation/.github/workflows/ci.yml

Jobs:

1. quality — TypeScript check, lint, project checker script, build
2. security — npm audit per vulnerabilità critiche
3. lighthouse — Solo su PR, misura performance/a11y/SEO con budget

Lighthouse Budget

Template in .Claude/templates/project-automation/lighthouse-budget.json

Target:

• LCP < 2.5s
• FCP < 2s
• TTI < 5s
• JS bundle < 300KB
• Total < 1.5MB

---

Layer 3: Monitoring (n8n)

Cosa controlla: uptime, SSL, response time, sitemap, robots.txt. Quando gira: ogni 6 ore automaticamente.

Workflow n8n

Template in .Claude/templates/project-automation/n8n-monitoring-template.json

Checks:

1. Health endpoint (/api/health) → sito up?
2. SSL → certificato valido?
3. Response time homepage → < 3 secondi?
4. Sitemap.xml → esiste e risponde 200?
5. Robots.txt → esiste?

Alert: email (o Slack) se qualsiasi check fallisce.

Setup

/n8n crea workflow monitoring per sito [NOME_CLIENTE] su [URL]

Oppure importa il template JSON in n8n manualmente.

---

Layer 4: On-demand (@project-checker AI)

Cosa controlla: tutto quello che gli script non coprono — qualità copy, UX review, suggerimenti architetturali, auto-fix intelligente. Quando gira: su richiesta con /check.

Uso

/check                  → auto-detect progetto
/check project          → solo progetto client
/check system           → solo configurazione OpenCode

L'agente:

1. Esegue prima npm run check (script automatico)
2. Analizza i risultati
3. Aggiunge check qualitativi che solo l'AI può fare
4. Propone auto-fix con conferma

---

Template Completo

Tutti i file template si trovano in:

.Claude/templates/project-automation/
├── scripts/
│   └── check-project.mjs      → Script Node.js (9 categorie di check)
├── .github/
│   └── workflows/
│       └── ci.yml              → GitHub Actions CI
├── lighthouse-budget.json      → Budget Lighthouse
├── lint-staged.config.mjs      → Config lint-staged
├── husky-setup.sh              → Script setup Husky
├── package-scripts.json        → Scripts da aggiungere a package.json
└── n8n-monitoring-template.json → Template workflow n8n

Setup per Nuovo Progetto

L'agente @site-scaffolder include automaticamente l'automazione:

1. Copia scripts/check-project.mjs → <progetto>/scripts/
2. Copia .github/workflows/ci.yml → <progetto>/.github/workflows/
3. Copia lighthouse-budget.json → <progetto>/
4. Copia lint-staged.config.mjs → <progetto>/
5. Esegui husky-setup.sh
6. Aggiungi scripts da package-scripts.json al package.json
7. Dopo il deploy: crea workflow n8n di monitoring

npm Scripts Disponibili

Script	Cosa fa
npm run check	Esegue tutti i check localmente
npm run check:fix	Check + auto-fix problemi semplici
npm run check:ci	Check in CI mode (exit 1 se critici)
npm run typecheck	Solo TypeScript check
npm run lint	Solo ESLint
npm run lint:fix	ESLint + auto-fix
npm run format	Prettier su tutto il progetto
npm run format:check	Verifica formatting senza modificare
npm run audit	npm security audit