Tu primer prompt, context pack y mini-arnésYour first prompt, context pack & mini-harnessSeu primeiro prompt, context pack e mini-arnês
Al terminar esta sesión te llevas tres artefactos reales, no teoría. Trabaja sobre una tarea tuya de hoy.By the end of this session you take three real artifacts, not theory. Work on a task of yours from today.Ao fim desta sessão você leva três artefatos reais, não teoria. Trabalhe numa tarefa sua de hoje.
§00PreparaciónSetupPreparação
Elige una tarea concreta y repetible (ej.: redactar el status semanal, revisar un PR, resumir reuniones). Escríbela en una línea. Esa es tu materia prima.Pick a concrete, repeatable task (e.g. write the weekly status, review a PR, summarize meetings). Write it in one line. That is your raw material.Escolha uma tarefa concreta e repetível (ex.: escrever o status semanal, revisar um PR, resumir reuniões). Escreva-a numa linha. Essa é sua matéria-prima.
§01Artefacto A · El prompt (SPEC)Artifact A · The prompt (SPEC)Artefato A · O prompt (SPEC)
Rellena la plantilla SPEC: Situación, Pedido, Ejecución, Criterio. Copia, pega tus datos y pruébalo.Fill the SPEC template: Situation, Pedido/Request, Execution, Criteria. Copy, paste your data and test it.Preencha o modelo SPEC: Situação, Pedido, Execução, Critério. Copie, cole seus dados e teste.
[inputs]
- TAREA: {{TAREA}} > la tarea concreta que quieres resolver
- CONTEXTO: {{CONTEXTO}} > datos, restricciones, audiencia
- ADJUNTOS: {{ADJUNTOS}} > archivos/URLs o "Sin adjuntos"
[prompt]
--- S | SITUACION ---
Para qué sirve esta tarea y qué se desbloquea al resolverla.
Si {{TAREA}} está vacía o es ambigua, pídela antes de avanzar; no inventes.
--- P | PEDIDO ---
Arquetipo: actúa como [experto creíble en el dominio].
Entregable: [qué quiero exactamente, en qué forma].
--- E | EJECUCION ---
>> Protocolo MetodologIA: Interpreta > Planifica > Ejecuta.
Reformula en una línea lo que entendiste, presenta el plan y solo entonces ejecuta.
Método: [pasos o marco que debe seguir]. Supuestos y límites explícitos.
--- C | CRITERIO ---
Formato: [estructura de salida]. Tono: [registro]. Audiencia: [quién lo lee].
Cierre: [acción concreta con la que termina].
[checklist]
- [ ] Cumple el formato y el tono pedidos
- [ ] No inventó datos; marcó supuestos
- [ ] Entrega la acción de cierre
[inputs]
- TASK: {{TASK}} > the concrete task you want to solve
- CONTEXT: {{CONTEXT}} > data, constraints, audience
- ATTACHMENTS: {{ATTACHMENTS}} > files/URLs or "No attachments"
[prompt]
--- S | SITUATION ---
What this task is for and what gets unblocked by solving it.
If {{TASK}} is empty or ambiguous, ask for it before proceeding; do not invent.
--- P | REQUEST ---
Archetype: act as [credible expert in the domain].
Deliverable: [what I want exactly, in what form].
--- E | EXECUTION ---
>> MetodologIA protocol: Interpret > Plan > Execute.
Restate in one line what you understood, present the plan and only then execute.
Method: [steps or framework to follow]. Explicit assumptions and limits.
--- C | CRITERIA ---
Format: [output structure]. Tone: [register]. Audience: [who reads it].
Close: [concrete action it ends with].
[checklist]
- [ ] Meets the requested format and tone
- [ ] Invented no data; marked assumptions
- [ ] Delivers the closing action
[inputs]
- TAREFA: {{TAREFA}} > a tarefa concreta que quer resolver
- CONTEXTO: {{CONTEXTO}} > dados, restrições, audiência
- ANEXOS: {{ANEXOS}} > arquivos/URLs ou "Sem anexos"
[prompt]
--- S | SITUAÇÃO ---
Para que serve esta tarefa e o que se desbloqueia ao resolvê-la.
Se {{TAREFA}} estiver vazia ou ambígua, peça antes de avançar; não invente.
--- P | PEDIDO ---
Arquétipo: atue como [especialista crível no domínio].
Entregável: [o que quero exatamente, em que forma].
--- E | EXECUÇÃO ---
>> Protocolo MetodologIA: Interprete > Planeje > Execute.
Reformule numa linha o que entendeu, apresente o plano e só então execute.
Método: [passos ou marco a seguir]. Supostos e limites explícitos.
--- C | CRITÉRIO ---
Formato: [estrutura de saída]. Tom: [registro]. Audiência: [quem lê].
Fecho: [ação concreta com que termina].
[checklist]
- [ ] Cumpre o formato e o tom pedidos
- [ ] Não inventou dados; marcou supostos
- [ ] Entrega a ação de fecho
§02Artefacto B · El context pack mínimoArtifact B · The minimal context packArtefato B · O context pack mínimo
Reúne lo mínimo que el modelo necesita saber siempre para esta tarea. Guárdalo como un archivo y adjúntalo (no lo pegues entero cada vez).Gather the minimum the model must always know for this task. Save it as a file and attach it (don't paste it whole each time).Reúna o mínimo que o modelo precisa saber sempre para esta tarefa. Salve como arquivo e anexe (não cole inteiro toda vez).
# CONTEXT.md — [nombre de la tarea] ## Quién soy / rol [tu rol, tu equipo, tu objetivo en esta tarea] ## Reglas duras (siempre) - [restricción 1 · ej.: sin datos confidenciales en outputs externos] - [restricción 2 · ej.: tono directo, evidencia sobre opinión] ## Vocabulario / convenciones - [término] = [definición canónica] ## Fuentes de verdad - [archivo/sistema] → [qué contiene] ## Qué NO hacer - [anti-objetivo 1]
# CONTEXT.md — [task name] ## Who I am / role [your role, your team, your goal in this task] ## Hard rules (always) - [constraint 1 · e.g.: no confidential data in external outputs] - [constraint 2 · e.g.: direct tone, evidence over opinion] ## Vocabulary / conventions - [term] = [canonical definition] ## Sources of truth - [file/system] → [what it contains] ## What NOT to do - [anti-goal 1]
# CONTEXT.md — [nome da tarefa] ## Quem sou / papel [seu papel, seu time, seu objetivo nesta tarefa] ## Regras duras (sempre) - [restrição 1 · ex.: sem dados confidenciais em outputs externos] - [restrição 2 · ex.: tom direto, evidência sobre opinião] ## Vocabulário / convenções - [termo] = [definição canônica] ## Fontes de verdade - [arquivo/sistema] → [o que contém] ## O que NÃO fazer - [antiobjetivo 1]
§03Artefacto C · El mini-arnésArtifact C · The mini-harnessArtefato C · O mini-arnês
Un arnés mínimo = una herramienta + un bucle de verificación + una guarda. Define el tuyo:A minimal harness = one tool + one verification loop + one guardrail. Define yours:Um arnês mínimo = uma ferramenta + um loop de verificação + uma guarda. Defina o seu:
# MINI-HARNESS — [tarea] ## 1. Herramienta (tool use) El modelo puede usar: [búsqueda / lectura de archivos / ejecutar código / API]. Cuándo usarla: [condición]. Cuándo NO: [condición]. ## 2. Bucle de verificación Después de producir, el modelo debe: - [ ] Revisar contra el [checklist del prompt] - [ ] Si falla un punto → corregir y re-verificar (máx. 2 iteraciones) - [ ] Reportar qué verificó ## 3. Guarda (guardrail) NUNCA: [acción irreversible / dato sensible / supuesto sin marcar]. Ante duda → preguntar, no asumir. ## Criterio de "listo" [condición observable que indica que el trabajo está terminado]
# MINI-HARNESS — [task] ## 1. Tool (tool use) The model may use: [search / read files / run code / API]. When to use it: [condition]. When NOT: [condition]. ## 2. Verification loop After producing, the model must: - [ ] Check against the [prompt checklist] - [ ] If a point fails → fix and re-verify (max. 2 iterations) - [ ] Report what it verified ## 3. Guardrail NEVER: [irreversible action / sensitive data / unmarked assumption]. When in doubt → ask, don't assume. ## "Done" criterion [observable condition signaling the work is finished]
# MINI-HARNESS — [tarefa] ## 1. Ferramenta (tool use) O modelo pode usar: [busca / leitura de arquivos / executar código / API]. Quando usar: [condição]. Quando NÃO: [condição]. ## 2. Loop de verificação Após produzir, o modelo deve: - [ ] Revisar contra o [checklist do prompt] - [ ] Se um ponto falhar → corrigir e reverificar (máx. 2 iterações) - [ ] Reportar o que verificou ## 3. Guarda (guardrail) NUNCA: [ação irreversível / dado sensível / suposto sem marcar]. Na dúvida → perguntar, não assumir. ## Critério de "pronto" [condição observável que indica que o trabalho terminou]
§04Cierre · checklist de salidaClose · exit checklistFecho · checklist de saída
- Tengo un prompt SPEC que probé al menos 2 veces.I have a SPEC prompt I tested at least twice.Tenho um prompt SPEC testado ao menos 2 vezes.
- Tengo un CONTEXT.md guardado como archivo.I have a CONTEXT.md saved as a file.Tenho um CONTEXT.md salvo como arquivo.
- Tengo un mini-arnés con herramienta, bucle y guarda.I have a mini-harness with tool, loop and guardrail.Tenho um mini-arnês com ferramenta, loop e guarda.
- Sé cuál es mi criterio de "listo".I know my "done" criterion.Sei qual é meu critério de "pronto".
¿Listo para profundizar? Ve a los playbooks o al runbook.Ready to go deeper? Head to the playbooks or the runbook.Pronto para aprofundar? Vá aos playbooks ou ao runbook.