Que fait cotcodec — travailler ici ?
Objectif
CoTCodec est un programme de recherche et un banc d’essai exécutable conçu pour rendre les choix d’orchestration d’agents explicites, mesurables et optimisables. L’article 1 étudie le langage ; le banc d’essai partagé et le registre de preuves couvrent le programme plus large des variables d’orchestration.
Modèle mental et fichiers clés
memory.jsonest l’état compilé du projet et le registre actif des priorités.wiki/log.mdest la chronologie opérationnelle en annexe uniquement.directions/contient les hypothèses de recherche ;experiments/contient les essais préenregistrés.harness/exécute les conditions et les benchmarks ;scripts/valide et scelle.research/evidence/contient des ensembles de décisions portables. Les données brutes/locales appartiennent au répertoire ignorédata/, jamais dans Git par accident.README.mdest le point d’entrée humain ;AGENTS.mdest la référence opérationnelle complète ; les fichiersSKILL.mddes répertoires possèdent leurs propres procédures locales.
Modèles à suivre / invariants
- Lire
wiki/SOUL.md,wiki/USER.md,wiki/HEARTBEAT.mdetmemory.jsonavant tout travail substantiel. - Préenregistrer les falsificateurs, budgets, limites de revendication et conditions d’arrêt avant d’observer les résultats d’un traitement. Ne jamais réécrire un contrat d’expérience terminé.
- Conserver les preuves négatives et les résultats préliminaires. Créer des réexécutions versionnées plutôt que d’écraser les répertoires de sortie défaillants.
- Séparer l’infrastructure déterministe d’admission des affirmations scientifiques ou relatives aux modèles vivants. La conformité CPU n’implique jamais l’admission H100 ni la qualité mémoire.
- Lier la révision source, l’arbre, la licence, les dépendances, l’identité de l’image/modèle et les hachages d’exécution pour tout résultat utilisé dans une décision de recherche.
- Maintenir la synchronisation entre la vérité compilée
memory.jsonet la chronologiewiki/log.md.
Tâches courantes → première action
| Tâche | Première action |
|---|---|
| Continuer la recherche | Lire les priorités de memory.json et la dernière entrée de wiki/log.md. |
| Exécuter une expérience | Lire skills/run-experiment.md, puis son contrat YAML. |
| Ajouter un benchmark | Lire harness/benchmarks/SKILL.md et l’adaptateur de base. |
| Modifier la logique d’orchestration | Lire le fichier harness/**/SKILL.md le plus proche et les tests associés. |
| Ajouter un système mémoire | Lire infra/memory-baselines/SKILL.md et les validateurs de portefeuille/source. |
| Publier des preuves | Exécuter les validateurs de source, d’expérience, de preuve et de portefeuille qui acheminent l’artefact. |
| Mettre à jour la documentation | Actualiser Agent-Docs, les pages README/état-courant, memory.json et wiki/log.md. |
Pièges à éviter
- De nombreux adaptateurs de benchmark sont intentionnellement des ébauches ; leur présence n’est pas une preuve de fonctionnalité.
data/peut contenir des modèles, bases de données, arbres source et artefacts Docker de plusieurs gigaoctets. Inspecter les fichiers ignorés/non suivis avant de les indexer.- Les tâches de cycle de vie à source exacte utilisent souvent des allocations CPU sur des hôtes GPU. Un nom d’hôte contenant
h100ne prouve pas qu’un GPU a été demandé ou utilisé. - Le chemin historique
~/Documents/GitHub/kevin-wikipeut être absent localement ; définirKEVIN_WIKI_ROOTpourscripts/run-agent-docs.tssi nécessaire.