ahtserhsuddav/project-setup

Configuración del proyecto

Cada paso utiliza la CLI oficial o la documentación de la herramienta involucrada (skill official-docs). Pregunta antes de cualquier acción remota.

Recién creado (la CLI ya generó, instaló y verificó todo)

1. Lee PROJECT.md y completa Qué (nombre, dominio, tipo, propósito) con el humano, en sus palabras. {{#dotenv}}
2. El humano copia .env.example a .env y lo completa{{#auth}} ({{dlx}} auth@latest secret genera el secreto de autenticación){{/auth}}. Los agentes nunca crean, leen ni escriben .env. Hasta que exista, prueba con valores temporales definidos solo para ese comando. {{/dotenv}} {{#postgres}}
3. Base de datos local: docker compose up -d, luego {{run}} db:migrate (pregunta primero). {{/postgres}} {{#d1}}
4. Base de datos local: {{run}} db:migrate (pregunta primero). {{/d1}}
5. {{run}} docs:sync, luego completa docs/DEPLOYMENT.md (URLs, dónde se configuran los secretos). {{#cloudflare}} Reemplaza los IDs de marcador de posición en wrangler.jsonc una vez que existan los recursos (DEPLOYMENT.md → Configuración inicial). {{/cloudflare}}
6. Deja design/DESIGN.md para el skill website-design, que recopila las entradas de diseño en orden antes de la primera página; la página de inicio es un marcador de posición.
7. Una vez que el repositorio esté en GitHub, el humano activa Settings → Actions → General → "Allow GitHub Actions to create and approve pull requests", para que la actualización semanal de skills del agente pueda abrir su pull request. Dependabot y cambios de flujo de trabajo: skills dependabot y github-actions-hardening.
8. {{run}} log "Project set up" --by <agent>.

Proyecto existente (adoptando el kit)

1. {{dlx}} create-agent-ready-app@latest install . agrega solo la configuración del agente (AGENTS.md, skills, scripts, guardrails); detecta los complementos desde package.json. Los archivos AGENTS.md, CLAUDE.md, .cursorrules y similares antiguos se mueven a docs/legacy-agents.md: integra las reglas que aún apliquen en PROJECT.md → Rules for agents, luego elimínalo (pregunta).
2. Completa PROJECT.md con la información existente (package.json, rutas, un listado rápido de carpetas). No explores en profundidad.
3. No reestructures. Enumera las carencias (estructura, verificaciones, SEO, seguridad) como una única tarea grande propuesta y pregunta.

Agregar un complemento más tarde (Protegido)

1. Haz una pregunta de sí/no: el complemento, los paquetes que agrega, los archivos que crea.
2. {{dlx}} create-agent-ready-app@latest add <add-on> . crea los archivos del complemento que aún no existen, actualiza AGENTS.md y los skills, instala su paquete de skills e imprime los paquetes a agregar.
3. {{add}} esos paquetes. Luego intégralos en los archivos que el proyecto ya posee, siguiendo los archivos del complemento en el repositorio create-agent-ready-app (template/frameworks/) y la documentación oficial:
   • query: {{#tanstack-start}}src/router.tsx (QueryClient + integración SSR) y src/routes/__root.tsx (panel de devtools){{/tanstack-start}}{{#next}}src/shared/lib/tanstack/query-provider.tsx en src/app/layout.tsx{{/next}};
   • shadcn: {{dlx}} shadcn@latest apply --preset nova, luego add los componentes que necesites;
   • auth: los guards en {{#tanstack-start}}src/routes/_private/{{/tanstack-start}}{{#next}}src/app/(private)/{{/next}} y {{run}} auth:generate, luego {{run}} db:generate.
4. {{run}} docs:sync, {{run}} check, actualiza PROJECT.md → Stack and Decisions, y añade una línea de registro.

Eliminar un complemento (Protegido)

{{dlx}} create-agent-ready-app@latest remove <add-on> . elimina sus archivos del kit, skills, scripts y permisos. Eliminar su código y paquetes es una tarea grande: usa rg para cada uso, elimínalo, luego {{run}} check.

Skills del agente

• Los skills de la comunidad en .agents/skills/ provienen de sus creadores (skills-lock.json registra cada fuente y un hash). {{run}} skills:update los actualiza; revisa el diff antes de confirmar, como con cualquier cambio de código.
• Más skills: prefiere los oficiales de los creadores de la herramienta (https://www.skills.sh/official); skill find-skills, o {{dlx}} skills@latest add <owner/repo> --skill <name> -a universal -a claude-code (pregunta primero). Un paquete opcional del kit: {{dlx}} create-agent-ready-app@latest add <pack> . (marketing, security-review…).

Actualizar el kit

{{run}} kit:update actualiza AGENTS.md, skills y scripts. Los archivos del kit modificados en este proyecto se conservan y se reportan; coloca las reglas específicas del proyecto en PROJECT.md en lugar de editar los archivos del kit.