delegation-protocol

Delegation Protocol — Instrucciones claras para code-writer

Objetivo

Estructurar las tareas que el orquestador delega a code-writer para evitar que code-writer confunda contenido del archivo con instrucciones de ejecución.

Regla de oro

** Separa siempre qué escribir de cómo ejecutarlo.**

Formato obligatorio

Usa estos marcadores para delimitar cada sección:

Para creación de archivos nuevos

=== CONTENIDO DEL ARCHIVO ===
[archivo: ruta/absoluta/al/archivo]
[tipo: TypeScript | HTML | SCSS | JSON | Markdown]
[Comportamiento esperado: descripción de lo que debe hacer]
[Estructura completa: propiedades, métodos con tipos, lógica]

=== INSTRUCCIONES ===
[Método: bash heredoc (cat > ruta << 'EOF')]
[Skills a cargar: json-safe-edit]
[Pasos específicos para la ejecución]

Para modificación de archivos existentes (code .ts, .html, .scss)

Sigue el formato de partial-edit-protocol como base, y además:

=== FRAGMENTO A CAMBIAR ===
[archivo: ruta/absoluta/al/archivo]
[Contexto antes/después con líneas de referencia]
[Líneas exactas a modificar]

=== INSTRUCCIONES ===
[Método: edit]
[Resto del archivo debe mantenerse intacto]
[Skills a cargar si aplica]

Para modificar JSON (especialmente opencode.json)

** NO uses === CONTENIDO DEL ARCHIVO ===.** Las modificaciones de propiedades JSON no escriben un archivo completo, solo cambian una propiedad. Usa solo === INSTRUCCIONES === con el comando exacto.

En lugar de incluir el valor largo en el comando (riesgo de colisión de comillas entre bash y JavaScript), escribe el valor en un archivo temporal primero:

Paso 1 — Preparar el valor:

=== INSTRUCCIONES (paso 1) ===
[Método: bash heredoc]
[Escribe el nuevo valor del prompt en /tmp/nuevo_valor.txt:]
cat > /tmp/nuevo_valor.txt << 'EOF'
Aquí el texto del prompt con "comillas" y 'simples'
EOF
[Carga json-safe-edit antes de continuar]

Paso 2 — Aplicar la modificación:

=== INSTRUCCIONES (paso 2) ===
[Método: node -e programático leyendo desde /tmp/]
[Comando:]
node -e "
const fs = require('fs');
const ruta = 'opencode.json';
const nuevoValor = fs.readFileSync('/tmp/nuevo_valor.txt', 'utf8');
const doc = JSON.parse(fs.readFileSync(ruta, 'utf8'));
doc.agent.X.prompt = nuevoValor;
fs.writeFileSync(ruta, JSON.stringify(doc, null, 2) + '\n');
console.log('✅ JSON actualizado');
"
[Validar JSON post-edición]