Kimi Code — Instrucciones de proyecto (AGENTS.md) · Agentes de IA para programar

Kimi Code CLI usa AGENTS.md como convención de archivo de instrucciones. Su contenido se inyecta en el system prompt como datos de referencia (disponible en las plantillas de prompt como ${agents_md}) — orienta al agente, pero no sustituye al system prompt.

Ubicaciones

Archivo	Ámbito	Notas
`AGENTS.md` (raíz del proyecto)	Proyecto	Se sube al repositorio; aplica a todo el mundo
`.kimi-code/AGENTS.md`	Proyecto	Ubicación alternativa dentro del árbol
`~/.kimi-code/AGENTS.md`	Global, propio de Kimi	Vive en `$KIMI_CODE_HOME/AGENTS.md`; se mueve con `KIMI_CODE_HOME`
`~/.agents/AGENTS.md`	Global, compartido entre herramientas	En el home real del sistema; NO se mueve con `KIMI_CODE_HOME`

? No se ha podido verificar:

El límite exacto de tamaño o truncado de AGENTS.md. El changelog menciona un aviso cuando AGENTS.md se trunca, pero no hay ningún límite numérico documentado.
Si los AGENTS.md anidados en subdirectorios se fusionan de forma jerárquica.
Si los archivos CLAUDE.md se leen directamente. Sólo está documentada la vía de importación /import-from-cc-codex (que trae a Kimi Code las instrucciones, skills y ajustes de MCP de Claude Code y Codex).

Generar las instrucciones con /init

/init

/init analiza el código actual y genera un AGENTS.md para el proyecto (sólo con el agente parado). Revisa el resultado y súbelo — se convierte en datos de referencia dentro del system prompt de todas las sesiones futuras en ese repositorio.

Sobrescribir con SYSTEM.md

$KIMI_CODE_HOME/SYSTEM.md sustituye de forma permanente el system prompt del agente principal por defecto (sólo el prompt; la descripción, las herramientas y la lista de subagentes permitidos se heredan). Es bastante más potente que AGENTS.md:

Precedencia: un archivo de agente del proyecto con override: true y --agent-file > SYSTEM.md; --agent se lo salta; y SYSTEM.md gana sobre los archivos de agente de ámbito usuario con el mismo nombre.
Nota de seguridad de la documentación: los archivos de agente de proyecto (por ejemplo .kimi-code/agents/agent.md con override: true) que vengan de repositorios no confiables pueden tomar el control completo del agente — a diferencia de AGENTS.md, que sólo se inyecta como datos.

Ejemplo de AGENTS.md

# AGENTS.md

## Proyecto
API de pagos — monorepo TypeScript (pnpm workspaces). Los servicios viven en `services/`
y las librerías compartidas en `packages/`.

## Puesta en marcha
- Node 22, pnpm 10. Instalación: `pnpm install`
- Copia `.env.example` a `.env` y pídele a alguien del equipo las claves de sandbox.

## Comandos
- Build:      `pnpm build`
- Tests:      `pnpm test` (vitest); un solo archivo: `pnpm vitest run <ruta>`
- Typecheck:  `pnpm typecheck` — tiene que pasar antes de dar una tarea por terminada
- Lint:       `pnpm lint --fix`
- Servidor:   `pnpm --filter api dev`

## Convenciones
- Módulos ES, TypeScript estricto, nada de `any` sin un comentario que lo justifique.
- Errores: usa la clase `AppError` de `packages/errors`, nunca lances cadenas sueltas.
- Los cambios de base de datos requieren una migración en `services/api/migrations/` —
  nunca edites el esquema a mano.
- Mensajes de commit: Conventional Commits (`feat:`, `fix:`, `chore:`).

## Límites
- Nunca commitees `.env` ni nada bajo `secrets/`.
- No modifiques `packages/proto/` — es código generado; regenéralo con `pnpm proto:gen`.
- Ejecuta siempre los tests antes de terminar; no marques nada como completo con tests en rojo.

Que sea corto y operativo: puesta en marcha, comandos, convenciones y límites. El agente lee esto en cada sesión, así que valen más los hechos duraderos que la prosa.

Última verificación: 2026-09-07

Fuentes oficiales:

Las herramientas de IA para programar evolucionan rápido. Si encuentras información desactualizada, abre un issue o un pull request.