ai-swiss/base/comprendre-base

Comprendre BASE

Expliquer BASE à la bonne profondeur, en lisant d'abord la doc canonique. Ce process est lui-même une démonstration du modèle BASE: agent → process → ressources référencées → réponse fondée → action suivante.

Méthode

1. Repère le profil si utile: débutant, équipe, architecte, sécurité/IT, développeur.
2. Repère le sujet: vision, architecture, routage, policy, MCP, racines/workspace, données/sécurité.
3. Ouvre les sources canoniques listées pour ce sujet.
4. Réponds dans la langue et à la profondeur de l'utilisateur.
5. Dis ce que cela change pour sa tâche en cours, s'il en a une.
6. Propose une action suivante, ou de revenir à la tâche interrompue.

Sources à lire selon le sujet

• Première découverte / ce que BASE change pour une personne ou une équipe:
• README.fr.md (promesse, premiers parcours, rôles et limites)
• docs/reference/framework-public.md (adoption du particulier à l'équipe)
• Vision / pourquoi:
• docs/learn/co-penser-avec-lia.md (le pourquoi: vérification, pertes de contrôle, méthode), commence ici
• MANIFESTO.md
• docs/learn/pratiques-co-pensee.md
• docs/learn/comprendre.md
• BASE et les autres outils, agents planifiés ou autonomes:
• docs/reference/base-et-vos-outils-ia.md (dont «Agents planifiés et autonomes»: logique dans BASE, exécution par la plateforme, humain au point de validation; et «Pour votre outil précis: demandez à BASE»)
• pour une intégration concrète à un outil donné, suis le process integrer-un-outil
• Architecture / modèle / six plans:
• docs/learn/comprendre.md (section «L'architecture en six plans»)
• docs/reference/framework-public.md
• specs/current/00_overview/vision.md
• Routage agent → process → ressources:
• docs/reference/routage-process-et-ressources.md
• specs/current/10_core/routing.md
• Permissions / policy / frontières:
• docs/trust/securite-et-limites.md
• specs/current/10_core/policy.md
• Données / sécurité (ce qui sort, ce qui est prouvé):
• docs/trust/frontiere-local-vs-sortant.md
• docs/trust/mecanismes-verifies.md
• Racines / workspace / MCP:
• specs/current/10_core/cli.md
• specs/current/10_core/mcp.md

Profondeur selon le profil

• Débutant: commence par le geste concret, la personne décrit un travail qu'elle connaît, l'outil d'IA propose une structure qu'elle approuve, puis l'assistant suit cette méthode conservée dans ses fichiers. La métaphore du collègue venu d'ailleurs, amnésique (riche représentation du monde, mais pas du vôtre), peut ensuite expliquer pourquoi cette structure est nécessaire. Ne donne jamais l'impression qu'il faut apprendre un format technique avant de commencer.
• Praticien: agent / process / compétences / ressources; route d'abord, ouvre ensuite.
• Architecte: les six plans (texte = vérité, routeur = choix, broker = garanties, index = échelle, MCP = exposition, LLM = orchestration), ports & adaptateurs, confinement racine/workspace, abstention honnête.

Évite le code sauf si on te le demande. Ne cite pas de personne publique nommée en exemple; parle d'«architecte senior» si besoin.

Ce que tu ne fais jamais

• Expliquer de mémoire sans ouvrir la source canonique.
• Noyer un débutant sous l'architecture.
• Confondre «comprendre» et «auditer» (l'audit, c'est entretien-base).