Une recherche que vous pouvez défendre.

Si vous êtes un agent et que vous lisez ceci

Installer la skill

Pour Claude Code et les autres hôtes qui chargent des Agent Skills. La skill porte la méthode, les refus et leurs corrections, et fonctionne via la CLI — sans serveur.

pip install hypgraph
hypgraph skill --install            # .claude/skills/hypgraph/SKILL.md in this project
hypgraph skill --install --user     # or under your home directory, for every project

Se connecter via MCP

pip install "hypgraph[mcp]"
claude mcp add hypgraph -- hypgraph --db study.hypgraph --as claude mcp

{
  "mcpServers": {
    "hypgraph": {
      "command": "hypgraph",
      "args": ["--db", "/absolute/path/study.hypgraph", "--as", "claude", "mcp"]
    }
  }
}

hypgraph --db study.hypgraph --as claude mcp --transport http --port 8766
# → http://127.0.0.1:8766/mcp

Le serveur écrit en tant qu'un seul auteur, fixé au démarrage. L'agent ne peut pas passer un autre nom, ne peut écrire ni en tant que l'instrument (lab) ni en tant que operator, et ses verdicts ne comptent que si l'enquête le désigne comme relecteur. Les fichiers pour register_run doivent se trouver dans le répertoire où le serveur a été lancé.

La méthode

1. overview() d'abord. Ce qui est établi, ce qui est contesté, ce qui est en attente, ce qu'il faut lancer ensuite.
2. Des hypothèses avec des prédictions — et des rivales, liées alternative_to.
3. Des expériences qui peuvent échouer — des liens tests avec data.expected par hypothèse, écrits avant l'exécution. Ajoutez un power_check : plantez une réponse connue et montrez que la méthode la retrouve.
4. register_run — hache le code, les entrées et les sorties, et ajoute le résultat avec des valeurs {name: {value} | {k, n}}.
5. Des affirmations avec des mesures — chaque nombre lié ; un lien supports avec un motif ; une portée.
6. Relecture — seuls comptent les relecteurs désignés, jamais sur leur propre travail.
7. report() en tête de chaque résumé ; l'interprétation en dessous — puis check_report(text) sur le rapport avant de le remettre. Corrigez toutes les erreurs.

Sous un profil de workflow

Une enquête fixée à scientific@2, software@2, trading@2, knowledge@2 ou optimization@2 porte le workflow de sa discipline. Appelez stage(question) : il indique l'étape où en est la question — dérivée du registre, jamais fixée — et chaque seuil ATTEINT ou NON ATTEINT avec ce qui l'atteindrait. Écrivez le seuil suivant dans l'ordre (une hypothèse avec des prédictions ; une expérience avec son résultat attendu avant l'exécution ; le diff ou l'instance comme artefact avec son kind ; l'exécution qui le uses). Un fichier corrigé, un commit plus récent, une instance modifiée ou une source retirée rendent périmée l'évidence antérieure ; la réponse le dit, et une vérification sur une évidence périmée ne compte pas. Quand la réponse honnête est « impossible à trancher », enregistrez ce que vous avez trouvé et écrivez une affirmation de type inconclusive dérivée de cela — une fois vérifiée, elle résout la question.

Outils

Ressources : hypgraph://skill, hypgraph://schema, hypgraph://investigations, hypgraph://investigation/{inv}/report. Prompt : method.

Les refus sont des instructions

Chaque affirmation refusée liste une ligne par problème, terminée par un code stable. Le message a déjà fait le calcul et contient souvent la phrase honnête — utilisez-la. En Python, GraphError.problems donne code, message, fix et words.

Avant d'écrire jamais ou toujours, appelez bound(k, n, exposure) : ce que soutient le décompte et combien de défaillances il laisse non exclues à l'échelle où l'affirmation sera utilisée. Fixez exposure sur l'affirmation pour que son statut porte ce nombre. Quand vous retirez ou contestez un nœud, la réponse liste ce qui repose maintenant sur quelque chose qui est tombé — prévenez leurs responsables. L'histoire complète : l'arithmétique du jamais.

Lire le statut

affirmation active · vérifiée (fisher:pass, v2) · 2 lignes de soutien indépendantes · répliquée sur de nouvelles données · aucune réplication externe

Citez-le tel quel. « Non vérifié » n'est pas « démontré » ; une ligne rapportée par un agent n'est pas « établi ». MENACÉ : une prémisse est tombée. À REVOIR : la base d'une décision a changé. SANS SOUTIEN : tout le soutien est tombé.

Pour l'ingénieur qui l'intègre

Vous faites tourner beaucoup d'agents ? Intégrez la bibliothèque et fixez la confiance vous-même : Graph(path, policy=Policy(reviewers=…, instrument="lab", operator="operator")). Fixez le author de chaque appelant de votre côté et refusez les noms réservés. Donnez à votre exécuteur de tâches l'identité de l'instrument pour que ses exécutions comptent comme enregistrées par le laboratoire. Passez spend= pour chiffrer le travail de chaque enquête. Le guide d'ingénierie contient les modèles. L'API HTTP (hypgraph.server.dispatch) et l'interface de HypGraph (hypgraph.ui.static_dir()) s'insèrent dans n'importe quel framework web.

Lisible par machine

• /llms.txt — la version courte
• /SKILL.md — la skill pour agents
• /agents.md — cette page en Markdown
• /schema/hypgraph-1.json — types de nœuds, champs, relations, verdicts
• /spec/ — les formats du registre et du bundle
• /data/broad-street.bundle.json — un bundle d'exemple complet