cotcodec — 여기서 작업하기
목적
CoTCodec은 에이전트 오케스트레이션 선택을 명시적, 측정 가능, 최적화 가능하게 만드는 연구 프로그램 및 실행 가능한 평가 도구입니다. Paper 1은 언어를 연구하며, 공유 도구와 증명 원장은 더 넓은 오케스트레이션 변수 프로그램을 다룹니다.
정신 모델 및 주요 파일
memory.json은 컴파일된 프로젝트 상태 및 활성 우선순위 원장입니다.wiki/log.md는 추가 전용 운영 타임라인입니다.directions/는 연구 가설을 소유하며,experiments/는 사전 등록된 실행을 소유합니다.harness/는 조건을 실행하고 벤치마크합니다.scripts/는 검증하고 봉인합니다.research/evidence/는 이식 가능한 결정 번들을 포함합니다. 원시/로컬 결과물은 무시된data/아래에 속하며, 실수로 Git에 포함되지 않아야 합니다.README.md는 인간 진입점입니다.AGENTS.md는 완전한 운영 참조입니다. 디렉터리SKILL.md파일은 로컬 절차를 소유합니다.
따라야 할 패턴 / 불변 사항
- 실질적인 작업 전에
wiki/SOUL.md,wiki/USER.md,wiki/HEARTBEAT.md및memory.json을 읽으십시오. - 처리 결과를 관찰하기 전에 반증자, 예산, 주장 경계 및 중지 조건을 사전 등록하십시오. 완료된 실험 계약을 다시 작성하지 마십시오.
- 부정적 및 사전 결과 증거를 보존하십시오. 실패한 출력 디렉터리를 덮어쓰지 말고 버전별 재실행을 생성하십시오.
- 결정적 인프라 허용을 라이브 모델 또는 과학적 주장과 분리하십시오. CPU 적합성은 H100 허용 또는 메모리 품질을 의미하지 않습니다.
- 연구 결정에 사용된 모든 결과에 대해 소스 개정, 트리, 라이선스, 종속성, 이미지/모델 ID 및 실행 해시를 바인딩하십시오.
memory.json컴파일된 진실과wiki/log.md타임라인을 동기화 상태로 유지하십시오.
일반 작업 → 첫 번째 조치
| 작업 | 첫 번째 조치 |
|---|---|
| 연구 계속 | memory.json 우선순위와 최신 wiki/log.md 항목을 읽으십시오. |
| 실험 실행 | skills/run-experiment.md를 읽은 다음 해당 YAML 계약을 읽으십시오. |
| 벤치마크 추가 | harness/benchmarks/SKILL.md와 기본 어댑터를 읽으십시오. |
| 오케스트레이션 로직 변경 | 가장 가까운 harness/**/SKILL.md 및 관련 테스트를 읽으십시오. |
| 메모리 시스템 추가 | infra/memory-baselines/SKILL.md 및 포트폴리오/소스 검증기를 읽으십시오. |
| 증거 전달 | 아티팩트를 라우팅하는 소스, 실험, 증거 및 포트폴리오 검증기를 실행하십시오. |
| 문서 업데이트 | Agent-Docs, README/current-state 페이지, memory.json 및 wiki/log.md를 새로 고치십시오. |
주의 사항
- 많은 벤치마크 어댑터는 의도적으로 스텁입니다. 존재가 준비 상태를 의미하지는 않습니다.
data/에는 기가바이트 규모의 모델, 데이터베이스, 소스 트리 및 Docker 아티팩트가 포함될 수 있습니다. 스테이징 전에 무시/추적되지 않은 파일을 검사하십시오.- 정확한 소스 수명 주기 작업은 GPU 호스트에서 CPU 할당을 사용하는 경우가 많습니다.
h100을 포함하는 호스트 이름이 GPU가 요청되었거나 사용되었음을 증명하지는 않습니다. - 기존
~/Documents/GitHub/kevin-wiki경로가 로컬에 없을 수 있습니다. 필요 시scripts/run-agent-docs.ts를 위해KEVIN_WIKI_ROOT를 설정하십시오.