Adios
Guideadios.yaml

Guida al manifest

Un manifest, dai sorgenti creati con l’IA all’app online.

`adios.yaml` conserva il contratto di distribuzione accanto al codice: compilazione, avvio, porta, integrità, segreti, risorse, repliche e route. Questo rende più facile verificare le modifiche generate prima che arrivino in produzione.

adios.yaml
name: billing-api
region: de
replicas: 2

build_cmd: pnpm install && pnpm build
start_cmd: pnpm start

runtime:
  name: node@24
  port: 3000
  health_path: /api/health

requires:
  - db

env:
  DATABASE_URL: secret://DATABASE_URL
  API_SIGNING_KEY: secret://API_SIGNING_KEY

Contratto di distribuzione

Verifica il manifest come verifichi il codice di produzione.

Il codice dell’applicazione e la configurazione di distribuzione cambiano insieme. Un piccolo manifest rende visibili gli aspetti operativi nella revisione dei sorgenti, invece di disperderli tra una conversazione, una dashboard e la cronologia della shell.

CampoCosa controllare
nameNome stabile dell’app usato da Adios per il carico di lavoro.
build_cmdComando che prepara gli asset di produzione da un checkout pulito.
start_cmdComando che avvia il processo di produzione.
runtime.portPorta su cui l’app è in ascolto nell’ambiente di esecuzione.
runtime.health_pathPercorso HTTP che Adios può usare per verificare se l’app è pronta.
envVariabili d’ambiente, inclusi i riferimenti secret://DATABASE_URL.
secretsDichiarazioni per la generazione di segreti, come secret://generate:64.
requiresServizi gestiti da cui dipende l’app, come db o cache.

Flusso di lavoro

Usa il manifest per mantenere distribuibile l’output dell’IA.

Quando un agente di IA aggiunge una route API, un worker in background, una chiamata al database o un fornitore esterno, chiedigli di aggiornare il manifest solo se cambiano i requisiti dell’ambiente di esecuzione. Poi verifica comando e configurazione, invece di fidarti ciecamente del file generato.

Compila da un albero di lavoro pulito

Il comando di compilazione deve funzionare senza dipendere dallo stato dell’editor, da cache locali o da strumenti non dichiarati.

Avvia il server di produzione

Il comando di avvio deve eseguire il processo server che riceverà il traffico reale.

Verifica che l’app sia pronta

Il controllo sul percorso di integrità deve fallire quando le dipendenze necessarie per gestire le richieste non sono disponibili.