Specifica .ai-agent.yml

Il file .ai-agent.yml configura come l’agente Eiryx lavora con il tuo repository. Descrive stack, comandi, architettura, convenzioni e regole.

Come Viene Creato

Quando colleghi un repo in Impostazioni → Repository, Eiryx esegue un pre-scan. Poi puoi scegliere:

Generazione base (gratis, istantanea) — Analisi deterministica: linguaggio, framework, comandi, ignore
Generazione deep (usa AI, ~$0.30-1.00) — Legge 8-12 file chiave e analizza architettura, convenzioni e pattern

Il file va committato nella root del repository. L’agente lo legge prima di ogni task.

Sempre 3 (versione corrente della specifica).

Stack tecnologico: linguaggio, versione, framework, package manager, linter. Supporta sia singolo linguaggio che monorepo multi-linguaggio.

Comandi che l’agente usa: test, lint, build, format, install. Il comando test è critico — se è sbagliato, l’agente fallirà sempre.

Architettura del codebase (solo con generazione deep): pattern, layer, entry point, file chiave, database, auth, state management.

Convenzioni del team: naming, import, error handling, testing, git, code style. L’agente scrive codice che segue il tuo stile.

Guardrail: forbidden_patterns (cose da non fare mai), preferred_patterns (pattern da seguire), custom_instructions (istruzioni libere).

File e directory che l’agente non deve modificare.

Branch bloccati, iterazioni massime, file sensibili da non toccare.

Dipendenze cross-repo per l’analisi di impatto.

Per la specifica completa con esempi YAML, consulta la versione inglese.

La specifica .ai-agent.yml è licenziata Apache 2.0.