Campi del Task Contract
Riferimento per i campi minimi e opzionali che definiscono un singolo task TCAF autorizzato.
Il Task Contract definisce il permesso. È il confine revisionato di un singolo passaggio eseguibile, non un piano esteso di progetto.
Campi minimi
Task ID:
Type:
Goal:
Inspect:
Modify:
Allowed:
Forbidden:
Check mode:
Checks:
Stop:Task ID
Usa la convenzione già adottata dal team o dal tracker. TCAF non impone un formato universale e non rinomina gli identificativi storici.
Type
Classifica il lavoro, per esempio feature, fix, aggiornamento documentazione/stato, attività di adozione o altro tipo definito dal progetto.
Goal
Un solo risultato delimitato. Quando cambia l’obiettivo primario, sostituisci il contratto o crea un task separato.
Inspect
La superficie completa di lettura pertinente attesa prima dell’implementazione. Deve essere abbastanza stretta da evitare contesto inutile ma coprire il comportamento che può influenzare il task.
Modify
La superficie completa di modifica. Un file o un’area non elencati non sono autorizzati.
Allowed
L’insieme completo dei tipi di modifica permessi dentro Modify, per esempio aggiungere una diramazione locale, adeguare un metodo esistente o introdurre un test mirato quando il progetto lo supporta già.
Forbidden
Esclusioni esplicite che restringono permessi globali o di progetto, come nessun refactoring, nessuna dipendenza, nessuna modifica API o nessuna operazione Git.
Check mode
Uno tra:
DEVELOPER_RUN— default; fornisce comandi esatti e attende i risultati riportati;AGENT_RUN— l’agente esegue controlli non distruttivi approvati;CI— la pipeline produce le evidenze;MANUAL— il developer verifica comportamento o UI;MIXED— combina soltanto ciò che serve.
Checks
La più piccola sequenza eseguibile pertinente, normalmente da uno a tre controlli comprese le precondizioni necessarie.
Stop
Condizioni che obbligano l’agente a fermarsi, riportare e richiedere una decisione invece di indovinare o ampliare il perimetro.
Campi opzionali
Profile:
Source of truth:
Origin:
Expected behavior:
Acceptance criteria:
Open decisions:Ometti i campi opzionali quando non aggiungono informazione utile. Minimum-first significa breve, non incompleto.
Approvazione e amendment
Un contratto completo approvato dal developer autorizza soltanto quel passaggio. Non autorizza riconciliazione, commit o push successivi.
Modifiche a comportamento, criteri di accettazione, superficie di modifica, interfacce pubbliche, dipendenze, rischio o esclusioni esplicite richiedono un amendment visibile e approvato prima dell’implementazione.
Un chiarimento neutro rispetto al perimetro, una correzione necessaria a soddisfare il contratto o un adattamento locale interamente dentro Modify e Allowed possono restare nello stesso task quando riportati secondo le regole del framework.