Context Architecture per lo Sviluppo Assistito dall'AI

Perché Contextia?

Gli agenti AI di coding sono potenti, ma sono ciechi senza contesto. Non sanno quale specifica governa un file, perché una decisione è stata presa, o quali norme si applicano. Contextia risolve questo problema con l’assemblaggio deterministico del contesto — l’agente chiede il contesto e ottiene esattamente i documenti giusti, ogni volta.

Deterministico, non probabilistico

Niente embedding, niente ricerca vettoriale, niente risultati allucinati. Il contesto segue link espliciti: task → specifica → decisioni → norme.

Due interfacce, un unico core

CLI per gli umani (bootstrap, CI/CD, manutenzione). Server MCP per gli agenti AI (accesso diretto tramite Model Context Protocol).

Markdown fino in fondo

Ogni artefatto è Markdown + frontmatter YAML. Leggibile, versionabile, modificabile senza strumenti dedicati.

Scansione consapevole del linguaggio

Scanner di annotazioni basato su Tree-sitter che rileva @spec nei commenti e identifica le classi e funzioni che li contengono.

Come funziona

Il tuo progetto
├── .contextia/
│   ├── system/          # Conoscenza duratura (specifiche, decisioni, norme)
│   ├── work/            # Stato operativo (task, piani, log)
│   └── config.yaml      # Configurazione del progetto
└── src/
    └── auth.py          # @spec SPEC-AUTH-001 ← link bidirezionale

L’agente invoca contextia context TASK-001 e riceve esattamente le specifiche, le decisioni e le norme necessarie per quel task — assemblate in modo deterministico seguendo link espliciti, senza tirare a indovinare.

Introduzione Scopri cos'è Contextia e perché esiste

Guida Rapida Configura il tuo primo progetto in 5 minuti

Riferimento CLI Tutti i comandi documentati

Server MCP Collega il tuo agente AI