Volver a la wiki

Iniciador de proyectos — el método completo con Biblioteca propia en un formulario

Iniciador de proyectos — el método completo con Biblioteca propia en un formulario

Construido y verificado E2E el 03-08-2026 (s251). Diseño: grill de 7 decisiones (D1-D8) + plan v1.4 endurecido por 3 paneles de /method:plan-review (21 bloqueantes cazados antes de escribir código — estreno de la skill el mismo día). Plan durable: CreaRack-Pro/brainstorms/2026-08-03-iniciador-plan.md. Apuesta #4 en WAGERS.md.

Qué es

La skill /method:iniciar-proyecto (user-invoked, plugin method) arranca un proyecto NUEVO — o “viste” uno ya empezado — con el método completo: harness (CLAUDE.md desde plantilla, reglas, hooks) y una Biblioteca PROPIA y aislada desplegada en Cloudflare: grafo + búsqueda semántica + bib_ask respondiendo sobre el código del proyecto + gate Regla 0. Cada proyecto queda nombrado por su slug (D1, índice Vectorize, Pages, hostname, credenciales prefijadas) y conectado por el .mcp.json de su repo — cero filtraciones entre proyectos en la misma máquina.

Flujo (5 fases de la skill)

  1. Formulario corto (7 preguntas): nombre/slug · descripción · ¿nuevo o existente? · org GitHub · equipo · stack · ¿wiki día 1?
  2. Credenciales con parada dura: CF_INIT_TOKEN (6 scopes verificados con llamadas de solo lectura) + GOOGLE_AI_API_KEY + gh + wrangler. Sin credencial verificada no se promete nada.
  3. Resumen de confirmación: recursos con nombre definitivo + coste DERIVADO del volumen del seed (no afirmado) + qué NO se toca. El dueño da el OK explícito ANTES de crear nada.
  4. Ejecución (harness/init-project.ps1): infra CF (D1 + Vectorize 1024/cosine + Pages + CNAME + app Access con policy Service Auth verificada por API) → secrets (MCP_TOKENS formato nombre:token + key de AI Studio) → deploy → repos GitHub → harness del repo de código (.mcp.json con vars <PREFIX>_*, marcador .claude/bib-gate.json, bib.env por-repo GITIGNORADO, CLAUDE.md con huecos honestos) → seed sin LLM (nodos fichero/módulo + imports, chunks con embeddings Workers AI) → smoke de las 11 tools (200 + body sin error) + verificación de Access (302 a cloudflareaccess o 403 con Cf-Access-Aud; un 401 pelado = Access NO enforza).
  5. Recap: URLs, verificaciones literales, y el aviso de reiniciar Claude Code (setx no alcanza procesos vivos).

Piezas

PiezaDónde
Skill + scriptclaude-method (plugins/method/skills/iniciar-proyecto/ + harness/init-project.ps1)
Plantilla del cerebrorepo CreaRackSL/workspace-template — MCP de 11 tools bib_* extraído del workspace real (poda POR HANDLER, no por prefijo), migración consolidada, seeder 2-pasos, prompt de bib_ask genérico parametrizado por PROJECT_NAME/PROJECT_DESCRIPTION en [vars]
Gate Regla 0migrado al plugin method, OPT-IN por marcador .claude/bib-gate.json (un proyecto sin Biblioteca no queda bloqueado); method-doctor avisa si un repo con harness pierde el marcador
Guíaclaude-method/guides/PROJECT_INITIALIZER.md + README § “Onboarding de un proyecto NUEVO”

Verificación real (demo-init, 03-08-2026)

Mini-app Python adoptada por el camino “existente”: infra creada con confirmación previa, MCP en demo-init.esfericlabs.com/api/mcp, Access enforzando, seed 4 nodos/1 edge/20 chunks (ningún chunk >600 palabras, ningún fichero sin chunk), smoke 11/11 y bib_ask explicando el planificador de riego con 5 fuentes. Coste recurrente: 0 € (modo eco).

Límites de v1 y FASE B

Sin re-run idempotente tras fallo parcial (credenciales SÍ persisten al nacer; continuación manual documentada) · sin wiki/ingest/AST — eso es la FASE B (task #210, sin fecha): wiki completa + Astro + Bibliotecario eco desacoplado + AST por stack. Detalle de límites en la guía.

Lecciones que quedaron cableadas

Las 3 rondas de review y la corrida real dejaron reglas en el propio código: credenciales persistidas en el momento de nacer · bib.env jamás al repo · el 403 de Access como bloqueo legítimo API-like · deploy sin pasar . como directorio de assets · y el footgun del move de hooks con sesiones vivas (shim exit-0 en el mismo commit — memoria footguns_hook_move_sesiones_vivas).

Véase también

Subir