Que contient Intent ?

Specs & user stories · Critères d'acceptance · Maquettes · Decision Directives · OKRs & roadmap · Personas · Hypothèses produit.


L'invariante fondamentale


Humains vs Agents IA

Humain

Formule l'intention, aligne l'équipe sur ce qu'on construit, priorise, décide les arbitrages.

Agent IA

Consomme comme instruction directe pour générer du code, des tests, des composants, des migrations. La précision de ce registre détermine directement la qualité de l'output.

Asymétrie : formulation vs exécution.


Modes de consommation

System Prompt

Les Decision Directives universelles (applicables à tous les tickets) vont dans le system prompt.

Context Injection

La spec en cours, les user stories et les Decision Directives task-specific sont passées par context injection.


Structure d'une Decision Directive

intent/directives/event-driven-indexation.md YAML + Markdown
---
register: intent
level: team
owner: tech-lead
status: active
consumption-mode: system-prompt
last-validated: 2026-06-03
supersedes: null
exception-to: null
---

# Decision Directive — Event-driven indexation

All hotel catalogue updates must transit through a Kafka event
before any write to Elasticsearch. No synchronous catalogue write
to Elasticsearch is allowed in this bounded context.

Acceptance criteria: see Contracts/search-indexation-sla.md
Decision context: Knowledge/decision-contexts/event-driven-indexation.md

Structure d'une spec dans Intent

intent/specs/SEARCH-89.md YAML + Markdown
---
register: intent
consumption-mode: context-injection
---

# Spec SEARCH-89

## Objective
Reduce P95 latency of the results page to under 200ms.

## Acceptance criteria
- [ ] P95 measured on the indexation pipeline: ≤ 200ms
- [ ] No synchronous Elasticsearch write (see Decision Directive /directives/event-driven)
- [ ] Load test: 500 req/s for 5 minutes without degradation