Guía de ClaudeNivel 4 · Pensar antes de construirLevel 4 · Thinking before building

La entrevista que arma todoThe interview that sets everything up

Un documento largo y un prompt corto para que Claude te entreviste y adapte todo esto a vos.A long document and a short prompt so Claude interviews you and adapts all this to you.

Esta guía tiene un problema: es mía. Las carpetas, los nombres, las reglas del archivo general, todo salió de cómo trabajo yo. Si la copiás tal cual, vas a pasar una tarde borrando mis proyectos de tus plantillas. Para eso armé un documento aparte, pensado para que Claude lo lea y te haga las preguntas que yo ya me contesté solo.

Qué es el documento

Es un solo archivo, guia-para-compartir.md, que se descarga del kit. Junta lo esencial de estas tarjetas sin ningún dato mío: cómo se gasta la cuota, las reglas de economía de tokens, la organización de carpetas, las plantillas del archivo general y del archivo de proyecto, los criterios de calidad y un cuestionario por bloques. Es largo a propósito. Está hecho para leerse una vez, no para cargarse en cada sesión (sería repetir el error que cuento en Cómo se gasta).

La primera versión es del 8 de octubre, justo la semana en que me quedé sin cuota (la casualidad tiene sentido del humor), y la fui actualizando con lo que aprendí. Por eso trae los topes de sesión y la regla de planear en Opus y ejecutar en Sonnet.

Cómo se usa

  1. Guardalo en tu carpeta madre, la que contiene todos tus proyectos, con el nombre _guia-claude.md. El guion bajo avisa que es de consulta. Si todavía no tenés una carpeta madre, Carpetas explica por qué conviene.
  2. Abrí Claude Code en esa carpeta y elegí Opus. Es la única vez: diseñar el sistema es trabajo de pensar.
  3. Pegá el prompt de abajo.
  4. Cuando termine, volvé a Sonnet, que es el modelo del día a día.

La entrevista dura un rato, pero está hecha de a tres preguntas por vez, así que se puede dejar y retomar. Si contestás “no sé”, Claude propone la opción que recomienda el documento y sigue. Tampoco hace falta que sepas programar: el prompt le pide que explique cualquier término técnico con palabras simples.

Qué hace Claude

Primero mira lo que ya tenés, sin tocar nada: las carpetas de primer nivel, tu archivo general si existe, los de cada proyecto, las skills y los permisos. Te cuenta qué encontró. Después te entrevista, saltea lo que se deduce de tus archivos (y te avisa qué salteó) y recién al final propone, de a una cosa por vez, tu archivo general, los archivos de calidad, el de cada proyecto, un plan de migración si querés renombrar carpetas, la primera skill que valdría la pena armar y una lista corta de lo que te toca hacer a mano.

Dos reglas del prompt las puse por experiencia. Nunca borra nada y, si algo de tus archivos contradice el documento, te pregunta cuál queda. Y cada archivo se muestra antes de guardarse. Una entrevista que reescribe tu configuración sin avisar es un buen modo de perder lo que ya funcionaba.

Si te sirvió

El documento termina con una invitación: si el prompt te sirvió, volvé a esta guía. No es obligatorio, pero me ayuda a saber si alguien lo usa de verdad (confieso que es la parte que más me importa).

El prompt

Leé una sola vez el archivo _guia-claude.md de esta carpeta: es una guía para organizar proyectos con Claude Code. Quiero adaptarla a mí sin romper lo que ya tengo.

Primero mirá lo que existe, sin cambiar nada: carpetas de primer nivel, mi ~/.claude/CLAUDE.md, los CLAUDE.md de cada proyecto, las skills y los permisos. Contame en pocas líneas qué encontraste.

Después entrevistame con el cuestionario de la guía, de a tres preguntas por vez y por bloques. Salteá lo que ya se deduce de mis archivos y avisame qué salteaste. Si respondo "no sé", proponé la opción recomendada y seguí. Explicame cualquier término técnico con palabras simples.

Al terminar, proponé de a uno, mostrándome cada archivo o diff antes de guardarlo: mi archivo general, los archivos de calidad, el de cada proyecto y la primera skill. Nunca borres ni muevas nada, y no guardes nada sin que yo lo apruebe. Cuando termines, decime que vuelva a Sonnet.

This guide has a problem: it's mine. The folders, the names, the rules in the general file, all of it came out of how I work. If you copy it as is, you'll spend an afternoon deleting my projects from your templates. So I built a separate document, meant for Claude to read and ask you the questions I'd already answered for myself.

What the document is

It's a single file, guide-to-share.md, that you download from the kit. It gathers the essentials of these cards with none of my data: how the quota gets spent, the token-economy rules, the folder organization, the templates for the general file and the project file, the quality criteria and a questionnaire in blocks. It's long on purpose. It's made to be read once, not loaded in every session (that would be repeating the mistake I tell about in How the quota gets spent).

The first version is from October 8, right the week I ran out of quota (coincidence has a sense of humor), and I've kept updating it with what I learned. That's why it includes the session caps and the rule of planning in Opus and executing in Sonnet.

How to use it

  1. Save it in your parent folder, the one that holds all your projects, with the name _claude-guide.md. The underscore signals that it's an internal, reference file. If you don't have a parent folder yet, Folders explains why it's worth having one.
  2. Open Claude Code in that folder and pick Opus. It's the only time: designing the system is thinking work.
  3. Paste the prompt below.
  4. When it's done, go back to Sonnet, the everyday model.

The interview takes a while, but it's built around three questions at a time, so you can leave it and pick it up later. If you answer “I don't know,” Claude proposes the option the document recommends and moves on. You don't need to know how to code, either: the prompt asks it to explain any technical term in plain words.

What Claude does

First it looks at what you already have, without touching anything: the top-level folders, your general file if you have one, each project's file, the skills and the permissions. It tells you what it found. Then it interviews you, skips whatever can be deduced from your files (and tells you what it skipped) and only at the end proposes, one thing at a time, your general file, the quality files, each project's file, a migration plan if you want to rename folders, the first skill worth building and a short list of what's left for you to do by hand.

I put two of the prompt's rules in from experience. It never deletes anything and, if something in your files contradicts the document, it asks you which one stays. And every file is shown before it's saved. An interview that rewrites your setup without telling you is a good way to lose what was already working.

If it helped

The document ends with an invitation: if the prompt helped, come back to this guide. It's not mandatory, but it helps me know whether anyone really uses it (I confess it's the part I care about most).

The prompt

Read the file _claude-guide.md in this folder once: it's a guide to organizing projects with Claude Code. I want to adapt it to me without breaking what I already have.

First look at what exists, without changing anything: top-level folders, my ~/.claude/CLAUDE.md, each project's CLAUDE.md, the skills and the permissions. Tell me in a few lines what you found.

Then interview me with the guide's questionnaire, three questions at a time and in blocks. Skip what can already be deduced from my files and tell me what you skipped. If I answer "I don't know," propose the recommended option and keep going. Explain any technical term to me in plain words.

When you're done, propose one at a time, showing me each file or diff before saving it: my general file, the quality files, each project's file and the first skill. Never delete or move anything, and don't save anything until I approve it. When you finish, tell me to go back to Sonnet.