lucaszb-orla/lucas-setup

Lucas Setup

Preparar la fundación de un proyecto sin elegir silenciosamente producto, stack o arquitectura. Aplicar las plantillas incluidas y adaptar solo lo que el contexto real sustente.

Flujo

1. Inspeccionar el directorio destino, archivos de instrucción, manifiestos y estado del Git.
2. Determinar si el proyecto es web, Apple o multiplataforma según el pedido y los archivos existentes.
3. Si la elección de plataforma o stack cambia materialmente el resultado y no puede descubrirse, hacer una pregunta corta antes de crear código.
4. Aplicar los archivos base:
   • En directorio nuevo o sin archivos conflictivos, ejecutar python3 <skill-dir>/scripts/apply_setup.py --target <directorio> --platform <web|apple|both>.
   • En proyecto con AGENTS.md, CLAUDE.md o PROJECT_CONTEXT.md, no sobrescribir. Leer ambos, consolidar reglas compatibles y señalar conflictos reales.
5. Rellenar PROJECT_CONTEXT.md con hechos observados. No dejar ejemplos que parezcan decisiones.
6. Crear o adaptar el proyecto solo si el pedido incluye scaffolding o implementación.
7. Configurar el Conductor solo cuando se pida o cuando el proyecto se esté preparando para él.
8. Validar archivos, comandos, Git y ausencia de secretos.

Aplicar los assets

Usar scripts/apply_setup.py para una copia determinista y sin sobrescritura. El script:

• crea el directorio destino cuando sea necesario;
• copia AGENTS.md, CLAUDE.md y PROJECT_CONTEXT.md;
• copia solo las orientaciones de las plataformas elegidas;
• rechaza cualquier archivo existente con contenido diferente;
• acepta --dry-run;
• acepta --conductor para una plataforma única.

Para un proyecto Apple:

python3 <skill-dir>/scripts/apply_setup.py \
  --target /ruta/del/proyecto \
  --platform apple \
  --conductor

Para un proyecto web:

python3 <skill-dir>/scripts/apply_setup.py \
  --target /ruta/del/proyecto \
  --platform web \
  --conductor

Después de la copia, editar PROJECT_CONTEXT.md con apply_patch.

Decisiones de proyecto

• No elegir framework, base de datos, arquitectura, bundle ID, deployment target o proveedor sin evidencia en el pedido o en el repositorio.
• Preferir el stack y el gestor ya adoptados.
• En proyecto realmente vacío, ofrecer una recomendación corta basada en el producto, pero separar recomendación de decisión confirmada.
• No añadir dependencias o servicios solo para completar una plantilla.
• No modificar archivos generados cuando exista fuente declarativa.

Preferencias obligatorias

• No usar guion largo en interfaz, documentación, comentarios o contenido exportado.
• No añadir borde decorativo al onboarding.
• Cuando haya arte principal en el onboarding, mantenerlo como único destaque material.
• Preservar cambios del usuario y mantener el alcance quirúrgico.
• Hacer commits pequeños y atómicos después de validar incrementos relevantes.
• Actualizar la memoria del proyecto cuando surja una decisión o un gotcha duradero.

Conductor

Antes de crear configuración, investigar los comandos reales de setup, ejecución y prueba.

• Usar .conductor/settings.toml para configuración compartida.
• Usar .conductor/settings.local.toml para preferencias locales del repositorio.
• Usar CONDUCTOR_PORT en servidores configurables.
• Marcar ejecución como no concurrente cuando la base de datos, el puerto o el servicio local no pueda aislarse.
• No crear worktree anidada dentro de un workspace del Conductor.
• Tratar los TOMLs en assets/conductor/ como puntos de partida, nunca como hechos del proyecto.

Git y GitHub

• Inicializar Git y crear repositorio remoto solo cuando el pedido autorice estas acciones.
• Antes del primer commit, validar el diff y buscar secretos.
• Usar la rama por defecto main, salvo convención existente.
• No renombrar la rama activa sin un pedido explícito.
• No publicar el proyecto como público cuando la visibilidad no esté clara.

Verificación

Confirmar:

• AGENTS.md, CLAUDE.md y PROJECT_CONTEXT.md existen y son coherentes;
• solo se añadieron las orientaciones de plataforma aplicables;
• el contexto no contiene ejemplos tratados como decisiones;
• las configuraciones del Conductor usan comandos reales;
• las pruebas o comandos relevantes y acotados pasan;
• el Git no contiene secretos, artefactos ni cambios fuera del alcance.

Informar al final lo que se creó, lo que necesita completarse y cualquier validación no ejecutada.