Autoría de reinos
Un reino le indica a un agente cuándo está de servicio, qué hacer a continuación y cómo saber que funcionó. Dale a esa disciplina una voz de casa memorable.
Antes de escribir
Lee la guía de destino y la tabla de disparadores del estatuto. Conserva la asignación de casa acordada y distínguela de reinos vecinos. Trabaja a partir de situaciones reales de desarrollo que el usuario quiera manejar. Nombra técnicas reconocibles: "mocks, stubs y fakes" ayuda al descubrimiento más que "dobles controlados" por sí solo.
Pon la selección en la habilidad principal
El SKILL.md principal de realms-of-code posee cuándo usar cada reino. Su tabla debe permitir que un agente elija antes de cargar una guía. Usa situaciones concretas: probar la eliminación de archivos, seleccionar un estándar de API o proteger una mejora en el conteo de consultas. Mantén los disparadores allí una vez, en lugar de repetirlos en cada guía.
Pon las mejores prácticas en la guía del reino
- Nombre, disciplina, lema: un encabezado, una línea de alcance concreta y el lema.
- El lore: un párrafo breve y vívido que conecte la facción con su rol de ingeniería. Haz que la metáfora explique el trabajo.
- Axiomas: unos pocos principios compactos que guíen las decisiones. Conserva los compromisos establecidos al revisar un reino existente.
- Qué hacer: pasos prácticos que comiencen con verbos. Identifica qué inspeccionar o cambiar, cómo elegir un enfoque y qué verificar. Usa nombres de técnicas explícitas y reutiliza las herramientas del proyecto. Explica alternativas significativas y trampas.
- Evidencia: el resultado observable o artefacto que respalde la finalización, además de cualquier límite importante sobre lo que esa evidencia demuestra.
Los axiomas explican el juicio; los pasos lo hacen ejecutable. Evita repetir el mismo consejo en ambos. Mantén cada sección tan breve como su labor lo permita. Los archivos de referencia de reinos son Markdown simple: sin IDs, campos YAML duplicados, etiquetas de origen del lema ni charla de atribución. Solo un SKILL.md detectable necesita frontmatter de habilidad.
Corrección trabajada
Para los Hombres Sin Rostro, "controlar dependencias" es demasiado abstracto. Un disparador útil es "probar un trabajo que elimina archivos o llama a un servicio de pago externo". La siguiente acción es aislar ese límite, elegir un mock/stub/fake y ejercitar el comportamiento de éxito, fallo y reintento sin efectos vivos no deseados. La evidencia incluye el objetivo previsto y el estado resultante, además de una prueba de integración donde el contrato real importa. Un espía que aún llama al servicio vivo es una trampa que vale la pena nombrar.
Cuando la habilidad compañera de realms-of-code esté disponible, su references/realms/faceless-men.md es el ejemplo completo trabajado.
Para Arryn, "elegir protocolos" pertenece a la tabla de disparadores principal. Su guía debe decir que se encuentren estándares y tecnología existentes, se verifique el estado actual de mantenimiento y obsolescencia, se evalúe la viabilidad, se reutilice la implementación compatible y se pruebe la interoperabilidad.
Enseña protección durante la implementación: codifica reglas importantes como barandillas y mejoras verificadas como trinquetes. Un trinquete registra una línea base reproducible, rechaza regresiones y se ajusta después de la mejora. Ciudadela construye la protección; Banco de Hierro la hace cumplir. Nunca resuelvas una verificación fallida debilitándola en silencio.
Revisión antes de publicar
Prueba dos tareas de coincidencia realistas y una tarea cercana que pertenezca a otro reino. Elige el reino desde la tabla principal, luego identifica la primera acción concreta y la evidencia requerida desde su guía. Si algún paso sigue siendo ambiguo, revisa el archivo responsable. Evita puertas genéricas no relacionadas con la tarea.
Mantén vivo el sabor en un lema, lore y alguna frase de trabajo ocasional como "¿Qué le decimos a los bugs? Hoy no". Combínalo con orientación de ingeniería útil. Elimina palabras que no añaden ni una decisión ni carácter. Sigue el flujo de trabajo de publicación del repositorio y verifica los enlaces relativos y el descubrimiento de habilidades cuando se vean afectados.