Structured memory

La semaine dernière, vous avez décidé d’utiliser JWT plutôt que des sessions, et vous avez capturé pourquoi. Vous avez découvert qu’une API tierce limite le débit à 100 requêtes/min, à moins que vous ne passiez un en-tête spécifique. L’agent qui vous a aidé est parti — limite de crédit, onglet de navigateur fermé, pause week-end. Le prochain agent qui examine votre code n’a aucune idée de l’existence de ces contraintes, et propose avec enthousiasme les choses que vous avez déjà écartées.

brainclaw résout ce problème. Les décisions, contraintes et pièges résident dans .brainclaw/memory/, un fichier par élément, versionné dans Git. Chaque agent qui ouvre le projet les lit lors de son premier appel de contexte. Ils survivent aux sessions, aux agents et aux pauses humaines.

# Lorsque vous prenez une décision — capturez-la
bclaw_create entity=decision data={
  text: "JWT pour l'auth, pas des sessions. Sans état, évolutif horizontalement.",
  outcome: "approved"
}

# Lorsque vous trouvez un piège — capturez-le
bclaw_create entity=trap data={
  text: "L'API fournisseur limite le débit à 100 req/min sans l'en-tête X-Throttle-Override",
  severity: "high"
}

# Session suivante, sur n'importe quel agent
bclaw_context kind=memory path="src/api/"
# → retourne la contrainte ET le piège, classés par pertinence

Trois types : les décisions (les choix que vous avez validés), les contraintes (les règles à suivre), les pièges (les problèmes que vous auriez aimé connaître). Tous sont recherchables par tags et en texte intégral, et tous apparaissent automatiquement dans le bon contexte. Consultez release hardening pour voir comment cela change la manière dont les équipes livrent.