Construye tu primer prompt → context pack → arnésBuild your first prompt → context pack → harnessConstrua seu primeiro prompt → context pack → arnês
Pasos numerados. Cada paso trae un CHECK (qué verificar antes), un PROMPT y un TEMPLATE copiable. Síguelos en orden.Numbered steps. Each brings a CHECK (what to verify first), a PROMPT and a copyable TEMPLATE. Follow in order.Passos numerados. Cada um traz um CHECK (o que verificar antes), um PROMPT e um TEMPLATE copiável. Siga em ordem.
§01PasosStepsPassos
1
Formula el promptFrame the promptFormule o prompt
CHECK: ¿tienes una tarea concreta y repetible en una línea?do you have a concrete, repeatable task in one line?tem uma tarefa concreta e repetível numa linha?
PROMPT: aplica SPEC (ver playbook de prompts).apply SPEC (see prompt playbook).aplique SPEC (veja playbook de prompts).
[inputs]
- TAREA: {{TAREA}} > tarea concreta
[prompt]
S| para qué · P| arquetipo+entregable · E| Interpreta>Planifica>Ejecuta · C| formato+criterio
[checklist]
- [ ] reproducible con entradas distintas[inputs]
- TASK: {{TASK}} > concrete task
[prompt]
S| what for · P| archetype+deliverable · E| Interpret>Plan>Execute · C| format+criteria
[checklist]
- [ ] reproducible with different inputs[inputs]
- TAREFA: {{TAREFA}} > tarefa concreta
[prompt]
S| para quê · P| arquétipo+entregável · E| Interprete>Planeje>Execute · C| formato+critério
[checklist]
- [ ] reproduzível com entradas diferentes2
Arma el context packAssemble the context packMonte o context pack
CHECK: ¿qué necesita saber el modelo SIEMPRE para esta tarea?what must the model ALWAYS know for this task?o que o modelo precisa saber SEMPRE para esta tarefa?
PROMPT: guárdalo como archivo y adjúntalo (ver playbook de contexto).save it as a file and attach it (see context playbook).salve como arquivo e anexe (veja playbook de contexto).
# CONTEXT.md ## Rol · ## Reglas duras · ## Vocabulario · ## Fuentes de verdad · ## Qué NO hacer
# CONTEXT.md ## Role · ## Hard rules · ## Vocabulary · ## Sources of truth · ## What NOT to do
# CONTEXT.md ## Papel · ## Regras duras · ## Vocabulário · ## Fontes de verdade · ## O que NÃO fazer
3
Monta el arnésMount the harnessMonte o arnês
CHECK: ¿qué herramienta, qué bucle y qué guarda necesita?which tool, which loop and which guardrail does it need?qual ferramenta, loop e guarda precisa?
PROMPT: una herramienta + un bucle de verificación + una guarda (ver playbook de arneses).one tool + one verification loop + one guardrail (see harness playbook).uma ferramenta + um loop + uma guarda (veja playbook de arneses).
# MINI-HARNESS 1. Herramienta: [...] (cuándo sí / cuándo no) 2. Bucle: producir > verificar > corregir (máx 2) 3. Guarda: NUNCA [acción irreversible]; ante duda, preguntar Criterio de "listo": [condición observable]
# MINI-HARNESS 1. Tool: [...] (when yes / when no) 2. Loop: produce > verify > fix (max 2) 3. Guardrail: NEVER [irreversible action]; when in doubt, ask "Done" criterion: [observable condition]
# MINI-HARNESS 1. Ferramenta: [...] (quando sim / quando não) 2. Loop: produzir > verificar > corrigir (máx 2) 3. Guarda: NUNCA [ação irreversível]; na dúvida, perguntar Critério de "pronto": [condição observável]
§02Catálogo · qué usar cuándoCatalog · what to use whenCatálogo · o que usar quando
| NecesidadNeedNecessidade | DisciplinaDisciplineDisciplina | |
|---|---|---|
| Respuesta más precisaMore precise answerResposta mais precisa | Prompt | Ver → |
| El modelo no sabe lo míoThe model doesn't know my stuffO modelo não sabe o meu | Context | Ver → |
| Tarea repetible y confiableRepeatable, reliable taskTarefa repetível e confiável | Harness | Ver → |
| Algo ya hechoSomething ready-madeAlgo pronto | Biblioteca | Ver → |
§03Plan de adopciónAdoption planPlano de adoção
Prompt
Convierte tus 3 tareas más frecuentes en prompts SPEC.Turn your 3 most frequent tasks into SPEC prompts.Transforme suas 3 tarefas mais frequentes em prompts SPEC.
Context
Crea un CONTEXT.md y un MEMORY.md para cada flujo.Create a CONTEXT.md and MEMORY.md per flow.Crie um CONTEXT.md e MEMORY.md por fluxo.
Harness
Añade bucles y guardas al flujo que más repites.Add loops and guardrails to your most repeated flow.Adicione loops e guardas ao fluxo mais repetido.
§04TroubleshootingTroubleshootingTroubleshooting
| SíntomaSymptomSintoma | |
|---|---|
| Respuestas genéricasGeneric answersRespostas genéricas | Ver → |
| Alucina datosHallucinates dataAlucina dados | Ver → |
| Se contradice / pierde el hiloContradicts / loses the threadContradiz / perde o fio | Ver → |
| Funciona a vecesWorks sometimesFunciona às vezes | Ver → |
§05GlosarioGlossaryGlossário
| TérminoTermTermo | DefiniciónDefinitionDefinição |
|---|---|
| SPEC | Situación · Pedido · Ejecución · Criterio. Anatomía de un prompt.Situation · Request · Execution · Criteria. Prompt anatomy.Situação · Pedido · Execução · Critério. Anatomia de um prompt. |
| Context rot | Degradación de la atención del modelo cuando la ventana se llena de ruido.Decay of the model's attention as the window fills with noise.Degradação da atenção do modelo quando a janela enche de ruído. |
| RAG | Recuperar fragmentos relevantes de un corpus para inyectarlos al contexto.Retrieve relevant chunks from a corpus to inject into context.Recuperar trechos relevantes de um corpus para injetar no contexto. |
| Harness | Todo lo que rodea al modelo: herramientas, bucles, agentes, guardas.Everything wrapping the model: tools, loops, agents, guardrails.Tudo que cerca o modelo: ferramentas, loops, agentes, guardas. |
| Guardrail | Regla dura que el sistema no puede violar.Hard rule the system cannot violate.Regra dura que o sistema não pode violar. |
| Eval | Caso de prueba con resultado esperado para medir un agente.Test case with expected result to measure an agent.Caso de teste com resultado esperado para medir um agente. |
¿Buscas prompts hechos? Ve a la Biblioteca.Looking for ready prompts? Go to the Library.Procura prompts prontos? Vá à Biblioteca.