cotcodec — trabajar aquí
Propósito
CoTCodec es un programa de investigación y un arnés de evaluación ejecutable para hacer que las elecciones de orquestación de agentes sean explícitas, medibles y optimizables. El Paper 1 estudia el lenguaje; el arnés compartido y el libro de evidencia cubren el programa más amplio de variables de orquestación.
Modelo mental y archivos clave
memory.jsones el estado compilado del proyecto y el registro de prioridades activo.wiki/log.mdes la línea de tiempo operativa de solo adición.directions/posee las hipótesis de investigación;experiments/posee las ejecuciones preregistradas.harness/ejecuta condiciones y puntos de referencia;scripts/valida y sella.research/evidence/contiene paquetes de decisión portátiles. El agotamiento local/bruto pertenece adata/ignorado, nunca en Git por accidente.README.mdes el punto de entrada humano;AGENTS.mdes la referencia operativa completa; los archivosSKILL.mdde directorio poseen procedimientos locales.
Patrones a seguir / invariantes
- Lee
wiki/SOUL.md,wiki/USER.md,wiki/HEARTBEAT.mdymemory.jsonantes de realizar trabajo sustantivo. - Prerregistra falsadores, presupuestos, límites de afirmaciones y condiciones de parada antes de observar los resultados del tratamiento. Nunca reescribas un contrato de experimento completado.
- Preserva la evidencia negativa y previa al resultado. Crea reejecuciones versionadas en lugar de sobrescribir directorios de salida fallidos.
- Separa la admisión determinista de infraestructura de las afirmaciones científicas o de modelo en vivo. La conformidad de CPU nunca implica admisión H100 o calidad de memoria.
- Vincula la revisión de origen, el árbol, la licencia, las dependencias, la identidad de imagen/modelo y los hashes de ejecución para cualquier resultado utilizado en una decisión de investigación.
- Mantén sincronizados la verdad compilada de
memory.jsony la línea de tiempo dewiki/log.md.
Tareas comunes → primera acción
| Tarea | Primera acción |
|---|---|
| Continuar investigación | Lee las prioridades de memory.json y la entrada más reciente de wiki/log.md. |
| Ejecutar un experimento | Lee skills/run-experiment.md, luego su contrato YAML. |
| Agregar un punto de referencia | Lee harness/benchmarks/SKILL.md y el adaptador base. |
| Cambiar la lógica de orquestación | Lee el harness/**/SKILL.md más cercano y las pruebas emparejadas. |
| Agregar un sistema de memoria | Lee infra/memory-baselines/SKILL.md y los validadores de cartera/fuente. |
| Enviar evidencia | Ejecuta los validadores de fuente, experimento, evidencia y cartera que enrutan el artefacto. |
| Actualizar documentación | Actualiza Agent-Docs, páginas README/estado actual, memory.json y wiki/log.md. |
Advertencias
- Muchos adaptadores de puntos de referencia son intencionalmente esqueletos; la presencia no implica preparación.
data/puede contener modelos de varios gigabytes, bases de datos, árboles fuente y artefactos Docker. Inspecciona los archivos ignorados/no rastreados antes de prepararlos.- Los trabajos de ciclo de vida de fuente exacta a menudo usan asignaciones de CPU en hosts GPU. Un nombre de host
que contenga
h100no prueba que se haya solicitado o utilizado una GPU. - La ruta histórica
~/Documents/GitHub/kevin-wikipuede estar ausente localmente; estableceKEVIN_WIKI_ROOTparascripts/run-agent-docs.tscuando sea necesario.