Ingeniería de PromptsPrompt EngineeringEngenharia de Prompts
Formular con precisión es la palanca de mayor retorno. Un prompt bien diseñado es reproducible, auditable y reutilizable. Aquí está el método.Precise framing is the highest-return lever. A well-designed prompt is reproducible, auditable and reusable. Here is the method.Formular com precisão é a alavanca de maior retorno. Um prompt bem desenhado é reproduzível, auditável e reutilizável. Aqui está o método.
§01Anatomía SPECSPEC anatomyAnatomia SPEC
SPEC estructura un prompt en cuatro bloques. Clic en cada fila para el detalle.SPEC structures a prompt into four blocks. Click each row for detail.SPEC estrutura um prompt em quatro blocos. Clique em cada linha.
| SPEC | SecciónSectionSeção | PreguntaQuestionPergunta | |
|---|---|---|---|
| S | SituaciónSituationSituação | ¿Para qué?What for?Para quê? | Ver → |
| P | PedidoRequestPedido | ¿Qué necesito?What do I need?O que preciso? | Ver → |
| E | EjecuciónExecutionExecução | ¿Cómo se hace?How is it done?Como se faz? | Ver → |
| C | CriterioCriteriaCritério | ¿Cómo sé que está listo?How do I know it's done?Como sei que está pronto? | Ver → |
[inputs]
- VAR_1: {{VAR_1}} > descripción autodescriptiva del input
- ADJUNTOS: {{ADJUNTOS}} > archivos/URLs o "Sin adjuntos"
[prompt]
--- S | SITUACION --- (para qué, qué se desbloquea, regla de no-inventar)
--- P | PEDIDO --- (arquetipo experto + entregable exacto)
--- E | EJECUCION --- (>> Interpreta > Planifica > Ejecuta; método, supuestos, límites)
--- C | CRITERIO --- (formato, tono, audiencia, acción de cierre)
[checklist]
- [ ] criterio verificable 1
- [ ] criterio verificable 2
[inputs]
- VAR_1: {{VAR_1}} > self-describing description of the input
- ATTACHMENTS: {{ATTACHMENTS}} > files/URLs or "No attachments"
[prompt]
--- S | SITUATION --- (what for, what gets unblocked, no-invent rule)
--- P | REQUEST --- (expert archetype + exact deliverable)
--- E | EXECUTION --- (>> Interpret > Plan > Execute; method, assumptions, limits)
--- C | CRITERIA --- (format, tone, audience, closing action)
[checklist]
- [ ] verifiable criterion 1
- [ ] verifiable criterion 2
[inputs]
- VAR_1: {{VAR_1}} > descrição autodescritiva do input
- ANEXOS: {{ANEXOS}} > arquivos/URLs ou "Sem anexos"
[prompt]
--- S | SITUAÇÃO --- (para quê, o que se desbloqueia, regra de não-inventar)
--- P | PEDIDO --- (arquétipo especialista + entregável exato)
--- E | EXECUÇÃO --- (>> Interprete > Planeje > Execute; método, supostos, limites)
--- C | CRITÉRIO --- (formato, tom, audiência, ação de fecho)
[checklist]
- [ ] critério verificável 1
- [ ] critério verificável 2
§02Los 5 pilaresThe 5 pillarsOs 5 pilares
Rol / ArquetipoRole / ArchetypePapel / Arquétipo
Un experto creíble y específico, no "asistente útil".A credible, specific expert, not "helpful assistant".Um especialista crível e específico, não "assistente útil".
Tarea inequívocaUnambiguous taskTarefa inequívoca
Un objetivo, un entregable, una forma de salida.One goal, one deliverable, one output shape.Um objetivo, um entregável, uma forma de saída.
Método explícitoExplicit methodMétodo explícito
Los pasos o marco que debe seguir, no solo el resultado.The steps or framework to follow, not just the result.Os passos ou marco a seguir, não só o resultado.
Restricciones y límitesConstraints & limitsRestrições e limites
Qué NO hacer, supuestos marcados, casos borde.What NOT to do, marked assumptions, edge cases.O que NÃO fazer, supostos marcados, casos-limite.
Criterio de éxitoSuccess criteriaCritério de sucesso
El checklist con que se autoevalúa antes de entregar.The checklist it self-evaluates against before delivering.O checklist com que se autoavalia antes de entregar.
§03Notación de inputs + tags de procedenciaInput notation + provenance tagsNotação de inputs + tags de procedência
Los inputs van como {{VARIABLE}} autodescriptivos: portables entre herramientas y obvios para quien rellena. Toda afirmación lleva su tag de procedencia:Inputs go as self-describing {{VARIABLE}}: portable across tools and obvious to whoever fills them. Every claim carries its provenance tag:Os inputs vão como {{VARIABLE}} autodescritivos: portáveis entre ferramentas e óbvios para quem preenche. Toda afirmação leva sua tag de procedência:
[DOC] documentado/verificabledocumented/verifiabledocumentado/verificável [INFERENCIA] deducido del contextoinferred from contextinferido do contexto [SUPUESTO] asunción a confirmarassumption to confirmsuposição a confirmar
§04Output engineering · few-shot · cadena de pensamientoOutput engineering · few-shot · chain-of-thoughtOutput engineering · few-shot · cadeia de pensamento
- Output engineering. Especifica la forma de salida (tabla, JSON, secciones). El formato es parte del pedido, no un detalle.Specify the output shape (table, JSON, sections). Format is part of the request, not a detail.Especifique a forma da saída (tabela, JSON, seções). Formato é parte do pedido.
- Few-shot. 1–3 ejemplos de entrada→salida deseada fijan el estándar mejor que diez adjetivos.1–3 input→desired-output examples set the standard better than ten adjectives.1–3 exemplos entrada→saída fixam o padrão melhor que dez adjetivos.
- Chain-of-thought. Pide "piensa paso a paso / planifica antes de ejecutar" cuando el problema tiene razonamiento intermedio.Ask "think step by step / plan before executing" when the problem has intermediate reasoning.Peça "pense passo a passo / planeje antes de executar" quando há raciocínio intermediário.
§05Evaluación · rúbrica de 10 criteriosEvaluation · 10-criteria rubricAvaliação · rubrica de 10 critérios
Cada prompt se mide contra estos 10. Clic en la fila para qué exige cada uno.Every prompt is scored against these 10. Click a row for what each demands.Cada prompt é medido contra estes 10. Clique na linha.
| # | CriterioCriterionCritério | |
|---|---|---|
| 1 | Fundamento | Ver → |
| 2 | Veracidad | Ver → |
| 3 | Calidad | Ver → |
| 4 | Densidad | Ver → |
| 5 | Simplicidad | Ver → |
| 6 | Claridad | Ver → |
| 7 | Precisión | Ver → |
| 8 | Profundidad | Ver → |
| 9 | Coherencia | Ver → |
| 10 | Valor | Ver → |
§06Anti-patronesAnti-patternsAntipadrões
- El prompt-novela: tres párrafos de contexto y ningún pedido claro.The novel-prompt: three paragraphs of context and no clear request.O prompt-romance: três parágrafos de contexto e nenhum pedido claro.
- El adjetivo mágico: "sé excelente, detallado, profesional" en vez de un criterio verificable.The magic adjective: "be excellent, detailed, professional" instead of a verifiable criterion.O adjetivo mágico: "seja excelente, detalhado, profissional" em vez de critério verificável.
- Sin no-inventar: no decirle qué hacer si faltan datos → alucina con seguridad.No no-invent rule: not telling it what to do when data is missing → it hallucinates confidently.Sem regra de não-inventar: não dizer o que fazer se faltam dados → alucina com confiança.
- Multitarea: cinco objetivos en un prompt → ninguno se cumple bien.Multitasking: five goals in one prompt → none done well.Multitarefa: cinco objetivos num prompt → nenhum bem feito.
§07Estándar 100✓100✓ standardPadrão 100✓
Antes de dar por bueno un prompt, debe pasar:Before accepting a prompt, it must pass:Antes de aceitar um prompt, ele deve passar:
- Rol, tarea, método, límites y criterio están presentes (5 pilares).Role, task, method, limits and criteria are present (5 pillars).Papel, tarefa, método, limites e critério presentes (5 pilares).
- Tiene regla de no-inventar y tags de procedencia.Has a no-invent rule and provenance tags.Tem regra de não-inventar e tags de procedência.
- Produce el mismo nivel de calidad con entradas distintas (reproducible).Produces the same quality with different inputs (reproducible).Produz a mesma qualidade com entradas diferentes (reproduzível).
- Pasa los 10 criterios de la rúbrica.Passes the 10 rubric criteria.Passa os 10 critérios da rubrica.
¿Listo? Lleva tu prompt al contexto y luego al arnés, o busca uno hecho en la Biblioteca.Ready? Take your prompt to context then the harness, or grab a ready one in the Library.Pronto? Leve seu prompt ao contexto e ao arnês, ou pegue um pronto na Biblioteca.