Mejores Prácticas para Proyectos y Artefactos
Diez hábitos prácticos para obtener valor real y duradero de los Proyectos y Artefactos, en lugar de configurar uno una vez y dejar que se desvíe lentamente hacia algo menos útil.
Cómo Usar Esta Lista
- Trata los hábitos de Proyecto (A) como mantenimiento continuo, no como una tarea de configuración única.
- Trata los hábitos de Artefacto (B) como hábitos a aplicar cada vez que estés a punto de solicitar algo sustancial.
- Vuelve al grupo A periódicamente; los Proyectos tienden a desviarse gradualmente, no de golpe.
- Adapta estas prácticas a tu propio flujo de trabajo; lo que importa es que el alcance, las instrucciones y las solicitudes de edición sigan siendo específicos.
A - Mantener los Proyectos Organizados
- Define el alcance de cada Proyecto en torno a un propósito único y estable. Nómbralo según la tarea específica y la audiencia a la que sirve, no una categoría amplia, para que sea obvio más tarde si el nuevo trabajo todavía pertenece allí.
- Escribe instrucciones personalizadas como reglas verificables, no como consejos generales. "Menos de 150 palabras, un paso siguiente claro" se mantiene mejor con el tiempo que "mantenlo conciso".
- Sube solo archivos que respondan a una necesidad real y recurrente. Empieza con poco y añade archivos a medida que surjan lagunas reales en las conversaciones de prueba, en lugar de subir todo lo que parezca potencialmente relevante.
- Revisa el alcance de un Proyecto cuando sus instrucciones comiencen a necesitar excepciones. Las cláusulas frecuentes de "a menos que se trate de X" suelen ser una señal de que el Proyecto cubre más de un propósito real.
- Divide un Proyecto en lugar de dejar que se expanda. Cuando dos audiencias o conjuntos de reglas distintos se hayan infiltrado en un Proyecto, sepáralos en sus propios Proyectos en lugar de continuar parcheando uno compartido.
B - Mantener los Artefactos Fáciles de Revisar y Compartir
- Reserva los Artefactos para entregables genuinos, no para cada respuesta larga. Una salida sustancial que probablemente revisarás pertenece a un Artefacto; una explicación larga que leerás una vez a menudo está bien en el chat.
- Haz que las solicitudes de edición sean específicas y acotadas. Nombrar la sección, fila o parte exacta a cambiar produce una revisión específica; una solicitud vaga como "hazlo mejor" corre el riesgo de una reescritura más amplia de lo que pretendías.
- Indica qué debe permanecer igual, no solo qué debe cambiar. Esto importa más a medida que un Artefacto se alarga o se vuelve más complejo, donde una edición sin acotar tiene más espacio para afectar.
- Usa el historial de versiones como una parte normal de la iteración, no como un último recurso. Volver a una versión anterior y volver a solicitar con una solicitud más específica es un movimiento rutinario, no una señal de que algo salió mal.
- Inicia un nuevo Artefacto cuando la solicitud sea realmente un nuevo entregable. Incluir una nueva salida no relacionada en el historial de edición de un Artefacto existente hace que ambos sean más difíciles de seguir.
Preguntas Frecuentes
¿Qué grupo de prácticas es más importante cuando estoy empezando?
Primero el grupo A. Un Proyecto bien definido hace que cada conversación dentro de él sea mejor desde el principio, mientras que los hábitos de Artefacto solo importan una vez que estás produciendo salidas sustanciales para revisar.
¿Con qué frecuencia debo revisar la configuración de un Proyecto?
No hay un horario fijo, pero revísalo siempre que las instrucciones personalizadas necesiten excepciones frecuentes, o siempre que el uso real del Proyecto parezca haberse desviado de su propósito original.
¿Cuál es el mayor error que cometen las personas con los Proyectos?
Permitir que el alcance se expanda gradualmente: añadir una instrucción más o un archivo más a la vez hasta que un Proyecto, una vez estrecho, cubra varios propósitos no relacionados y produzca respuestas menos consistentes.
¿Cuál es el mayor error que cometen las personas con los Artefactos?
Dar solicitudes de edición vagas. Una instrucción general como "pule esto" tiende a producir una revisión más amplia y menos predecible que una específica que nombra la parte exacta a cambiar.
¿Debería cada Proyecto tener archivos de conocimiento subidos?
No. Algunos Proyectos dependen solo del tono y las reglas de comportamiento y no necesitan archivos de referencia. Sube solo archivos que respondan a una necesidad real y recurrente para ese Proyecto específico.
¿Es malo revertir un Artefacto a una versión anterior?
No, es una parte normal de la iteración. Revertir y volver a solicitar con una solicitud más acotada es una forma rutinaria de recuperarse de una revisión que fue más allá de lo previsto.
¿Cómo sé si un Proyecto se ha vuelto demasiado amplio?
Busca instrucciones que necesiten excepciones frecuentes, archivos que solo se apliquen a algunas conversaciones, o respuestas que parezcan que podrían haber provenido de un chat simple sin contexto de Proyecto.
¿Dividir un Proyecto en otros más pequeños crea trabajo adicional?
Algo de sobrecarga de configuración, sí, pero generalmente vale la pena por respuestas más consistentes y específicas en comparación con un Proyecto amplio que intenta servir a múltiples propósitos a la vez.
¿Por qué la lista recomienda decir qué debe permanecer igual en una solicitud de edición?
Porque las solicitudes de edición sin acotar tienen más espacio para afectar partes del Artefacto que no pretendías tocar, especialmente a medida que el Artefacto se alarga o se vuelve más complejo.
¿Cuándo debo crear un nuevo Artefacto en lugar de seguir editando el actual?
Cuando la nueva solicitud es realmente un entregable diferente, no una revisión del existente. Mantener salidas no relacionadas en el historial del mismo Artefacto hace que ambos sean más difíciles de seguir.
Relacionado
- Qué Hace un Buen Proyecto: Alcance y Contexto Compartido - el razonamiento detrás del grupo A.
- Editar e Iterar sobre un Artefacto - el razonamiento detrás del grupo B.
- Lista de Verificación para la Configuración de Proyectos: Instrucciones, Archivos y Alcance - una lista de verificación paso a paso para configurar un nuevo Proyecto.
- Proyectos y Artefactos: Dos Formas de Organizar el Trabajo con Claude - la distinción fundamental sobre la que se basan ambos grupos.
Versiones de Stack: Escrito contra la línea de modelos de Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado) y Claude Haiku 4.5. Los nombres de los modelos, los precios y las características del producto cambian rápidamente; verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.