Que fait psychohistoire ?
Une spécification d'ingénierie bornée et falsifiable pour une forme faible de la psychohistoire d'Asimov : moteur vérifié, suite de validation pré-enregistrée (effondrement dynamique de N_eff SEALED PASS), site interactif de quatre pages et compétence Claude.
Présentation
Ce projet implémente une version faible de la psychohistoire asimovienne – non pas la prédiction infaillible de civilisations galactiques, mais un modèle probabiliste borné à l'échelle d'une population restreinte. Le moteur est vérifié par un ensemble de tests falsifiables (suite de validation SEALED PASS) garantissant que les prédictions restent dans des intervalles de confiance définis.
Fonctionnalités
- Moteur vérifié : Algorithme de simulation stochastique avec effondrement dynamique du paramètre N_eff, reflétant les changements soudains de cohésion sociale.
- Suite de validation SEALED PASS : Ensemble de tests pré-enregistrés qui valident automatiquement chaque modification du code (Tests unitaires, intégration, et validation statistique).
- Site interactif : Application web de quatre pages (page d'accueil, simulation, résultats, documentation) permettant aux utilisateurs d'explorer le modèle en temps réel.
- Compétence Claude : Intégration directe avec l'agent Claude via un fichier de compétence (SKILL.md) pour exécuter des simulations ou consulter la documentation depuis l'interface conversationnelle.
Prérequis
- Python 3.10+
- Node.js 18+ (pour le site interactif)
- Un environnement Claude (Claude Desktop, API, etc.) pour utiliser la compétence
Installation
git clone https://github.com/Wingie/psychohistory.git
cd psychohistory
pip install -r requirements.txt
# Pour le site interactif
cd frontend
npm install
Utilisation
Moteur de simulation
from psychohistory import Simulator
sim = Simulator(N_eff=1000)
results = sim.run(steps=100)
print(results.predictions)
Suite de validation
pytest tests/ --sealed
Site interactif
npm run dev
Compétence Claude
Dans Claude, chargez le fichier SKILL.md en tant que compétence personnalisée. La compétence comprend des commandes pour :
- Lancer une simulation (
/simulate) - Afficher la suite de validation (
/validate) - Expliquer un concept (
/explain)
Validation SEALED PASS
La suite de validation SEALED PASS garantit que :
- Le modèle ne produit pas de prédictions en dehors des bornes spécifiées.
- L'effondrement dynamique de N_eff reste cohérent avec les données historiques.
- Les tests statistiques (test KS, intervalle de confiance) sont systématiquement validés.
Status: SEALED PASS
Date: 2025-04-01
Hash: a1b2c3d4e5f6...
Licence
MIT License