Skip to content

Commit eefde77

Browse files
committed
docs: sync translations with latest techniques and updates
Updated German, Spanish, French, and Japanese README translations to reflect: - Latest update date (September 17, 2025) - New planning and model selection techniques - Added tool implementations for planning workflows - Added confirmation technique for task understanding - Added ASCII wireframes and rollback points techniques Ensures all language versions are consistent with main English README.
1 parent 71ff7cf commit eefde77

File tree

4 files changed

+441
-31
lines changed

4 files changed

+441
-31
lines changed

README-de.md

Lines changed: 106 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
1-
> **Aktive Entwicklung** — Aktualisiert am 11. September 2025
2-
> Neueste: 6 neue Techniken aus dem ai_stack-Projekt hinzugefügt
1+
> **Aktive Entwicklung** — Aktualisiert am 16. September 2025
2+
> Neueste: Neue Planungs- und Modellauswahl-Techniken hinzugefügt
33
> [Alle Updates ansehen →](CHANGELOG.md)
44
55
**Verfügbare Sprachen:** [English](README.md) | [Español](README-es.md) | [Deutsch](README-de.md) | [Français](README-fr.md) | [日本語](README-ja.md)
@@ -106,16 +106,59 @@ Wählen Sie bewusst etablierte Bibliotheken mit guter Stabilität, die vor AI-Tr
106106
> "Ich gewinne genug Wert aus LLMs, dass ich das jetzt bewusst bei der Auswahl einer Bibliothek berücksichtige—ich versuche bei Bibliotheken mit guter Stabilität zu bleiben, die populär genug sind, dass viele Beispiele davon in die Trainingsdaten gelangt sind. Ich wende gerne die Prinzipien langweiliger Technologie an—innoviere bei den einzigartigen Verkaufsargumenten deines Projekts, bleibe bei bewährten Lösungen für alles andere."
107107
> — Übersetzt von Claude
108108
109-
### Bitten, zuerst zu denken
109+
### Um Planung zuerst bitten
110110

111-
Verwenden Sie `think` oder `think hard`, um sorgfältigere Planung vor dem Programmieren auszulösen.
111+
Sagen Sie dem Assistenten, er soll Schritte, Risiken und schnelle Tests skizzieren, bevor er Code berührt, damit Sie den Ansatz überprüfen und anpassen können.
112112

113-
> "Claude tends to jump straight into implementation without sufficient background, which generates poor quality results. Another tactic for priming the agent is asking Claude to use its extended thinking mode and make a plan first. The extended thinking is activated by this set of magic keywords: `think` < `think hard` < `think harder` < `ultrathink.` These are not just suggestions to the model—they are specific phrases that activate various levels of extended thinking."
114-
> [Indragie Karunaratne](https://www.indragie.com/blog/i-shipped-a-macos-app-built-entirely-by-claude-code#:~:text=Claude%20tends%20to%20jump%20straight)
113+
> "If you want to iterate on the plan, it helps to explicitly include instructions in the prompt to not proceed with implementation until the plan has been accepted by the user."
114+
> [Indragie Karunaratne](https://www.indragie.com/blog/i-shipped-a-macos-app-built-entirely-by-claude-code#:~:text=If%20you%20want%20to%20iterate%20on%20the%20plan)
115115
116-
> "Claude neigt dazu, direkt zur Implementierung zu springen ohne ausreichenden Hintergrund, was schlechte Qualitätsergebnisse erzeugt. Eine weitere Taktik für die Vorbereitung des Agenten ist, Claude zu bitten, seinen erweiterten Denkmodus zu verwenden und zuerst einen Plan zu erstellen. Das erweiterte Denken wird durch diese Sammlung von magischen Schlüsselwörtern aktiviert: `think` < `think hard` < `think harder` < `ultrathink.` Das sind nicht nur Vorschläge an das Modell—es sind spezifische Phrasen, die verschiedene Ebenen des erweiterten Denkens aktivieren."
116+
> "Wenn Sie über den Plan iterieren möchten, hilft es, explizit Anweisungen in den Prompt zu incluieren, nicht mit der Implementierung fortzufahren, bis der Plan vom Benutzer akzeptiert wurde."
117117
> — Übersetzt von Claude
118118
119+
**Tool-Implementierungen:**
120+
121+
<details>
122+
<summary><strong>Claude Code</strong></summary>
123+
124+
Drücken Sie `Shift+Tab`, um in den Planmodus zu gelangen, sodass es nur liest und entwirft. Verwenden Sie den gemeinsamen Planungsprompt, iterieren Sie, bis es richtig aussieht, dann verlassen Sie den Planmodus, wenn Sie die Implementierung freigeben.
125+
126+
</details>
127+
128+
<details>
129+
<summary><strong>Cursor</strong></summary>
130+
131+
Klicken Sie auf den Plan-Schalter in Cursor, damit es schreibgeschützt bleibt, während Sie iterieren. Lassen Sie es Schritte, betroffene Dateien, Risiken und schnelle Tests auflisten, dann verlassen Sie den Planmodus, um das Diff zu öffnen, sobald Sie die Implementierung freigeben.
132+
133+
</details>
134+
135+
<details>
136+
<summary><strong>Codex CLI</strong></summary>
137+
138+
Erinnern Sie Codex daran, Planung von Implementierung getrennt zu halten: Schritte, Risiken und schnelle Tests auflisten, für Ihre Überprüfung pausieren, dann lassen Sie es implementieren und das Diff inspizieren, sobald es genehmigt ist.
139+
140+
</details>
141+
142+
### Mit hochkapazitärem Modus planen
143+
144+
Beim Sammeln von Anforderungen oder Entwerfen von Spezifikationen wechseln Sie vorübergehend zu einem leistungsfähigeren Modell oder erweiterten Denkermodus, damit es lesen, synthetisieren und einen Plan vorschlagen kann, bevor es codiert.
145+
146+
**Tool-Implementierungen:**
147+
148+
<details>
149+
<summary><strong>Claude Code</strong></summary>
150+
151+
Führen Sie `/model` aus und wählen Sie `opus` (oder einen anderen höheren Tier), wenn Sie Anforderungen definieren, damit es tief denken kann, dann verwenden Sie den Planmodus, wenn Sie möchten, dass es schreibgeschützt bleibt, bis Sie Änderungen genehmigen.
152+
153+
</details>
154+
155+
<details>
156+
<summary><strong>Codex CLI</strong></summary>
157+
158+
Verwenden Sie `/model gpt-5-high` (oder einen anderen erweiterten Denkertier), um den Assistenten Kontext verdauen und die Spezifikation entwerfen zu lassen, dann steigen Sie wieder herunter, sobald der Plan feststeht.
159+
160+
</details>
161+
119162
## UI & Prototyping
120163

121164
### Vibe Coding
@@ -164,8 +207,16 @@ Bitten Sie einfach darum, die UI `schöner` oder `eleganter` zu machen - es funk
164207
> "Wenn Claude beim ersten Mal keine gut gestaltete UI produziert, können Sie es einfach bitten, sie `schöner/eleganter/benutzbarer zu machen`."
165208
> — Übersetzt von Claude
166209
210+
### Um ASCII-Wireframes bitten
211+
212+
Beim Verfeinern von Layouts lassen Sie den Assistenten ASCII-Wireframes skizzieren, damit Sie Hierarchie und Abstände bewerten können, bevor Sie CSS berühren.
213+
167214
## Programmierung
168215

216+
### Verständnis vor dem Programmieren bestätigen
217+
218+
Bitten Sie das Tool explizit, sein Verständnis der Aufgabe zu bestätigen, bevor Sie mit der Implementierung beginnen, um Abstimmung sicherzustellen und nicht übereinstimmende Erwartungen zu reduzieren.
219+
169220
### Code generieren, nicht Abhängigkeiten
170221

171222
Schreiben Sie benutzerdefinierten Code, anstatt beim Arbeiten mit Assistenten mehr Bibliotheken einzubeziehen.
@@ -296,6 +347,26 @@ Lassen Sie die KI umfassende Tests basierend auf erwartetem Verhalten schreiben,
296347
297348
## Übergreifende Techniken
298349

350+
### Das richtige Modell für die Aufgabe wählen
351+
352+
Bevor Sie eine neue Aufgabe beginnen, wählen Sie zwei Hebel: das richtige Modell (Modalität, Kontextlänge, Tool-Calling-Zuverlässigkeit, Latenz, Kosten) und das richtige Reasoning-Level (mehr/weniger Denkzeit zuweisen) — nutzen Sie nicht blind die Standardeinstellungen.
353+
354+
**Tool-Implementierungen:**
355+
356+
<details>
357+
<summary><strong>Claude Code</strong></summary>
358+
359+
Zwei Hebel bei Aufgabenbeginn: (1) Modell über `/model` (schnell/günstig für Routineänderungen; langer Kontext für Multi-Dateien/lange Dokumente; vision-stark für UI/Screenshots). (2) Reasoning-Level: erweiterten Denkmodus aktivieren bei komplexem Debugging, Architektur oder mehrdeutigen Spezifikationen, um mehr Reasoning-Tokens zuzuweisen.
360+
361+
</details>
362+
363+
<details>
364+
<summary><strong>Codex CLI</strong></summary>
365+
366+
Beginnen Sie mit `gpt-5-minimal`/`gpt-5-low` für schnelle Änderungen; wählen Sie eine höhere Reasoning-Variante `gpt-5-high`/`gpt-5-medium`, wenn die Komplexität steigt.
367+
368+
</details>
369+
299370
### Mehrere Agenten parallel ausführen
300371

301372
Hören Sie auf, darauf zu warten, dass ein KI-Agent fertig ist, bevor Sie einen anderen starten - führen Sie mehrere Agenten parallel an separaten Features aus, ohne Konflikte oder Verwirrung.
@@ -370,4 +441,31 @@ Arbeiten Sie wie mit einem Programmierpartner zusammen - erklären Sie Probleme,
370441
> [Orta Therox](https://blog.puzzmo.com/posts/2025/06/07/orta-on-claude/#:~:text=Claude%20Code%20feels%20like%20pairing)
371442
372443
> "Claude Code fühlt sich an wie Pair Programming mit jemandem mit ein paar Jahren Erfahrung, der nur gelegentlich einen Schubs braucht. Dann wie beim Pairing ist es Zeit für Review, Refactoring und Tests, weil es immer noch Ihr Name auf dem Git-Commit ist."
373-
> — Übersetzt von Claude
444+
> — Übersetzt von Claude
445+
446+
### Rollback-Punkte beim Programmieren erstellen
447+
448+
Erstellen Sie Checkpoints, zu denen Sie zurückkehren können, wenn Experimente fehlschlagen—erfassen Sie bekannt-gute Arbeitszustände vor riskanten Änderungen.
449+
450+
**Tool-Implementierungen:**
451+
452+
<details>
453+
<summary><strong>Claude Code</strong></summary>
454+
455+
Verwenden Sie `git commit` häufig, um Rollback-Punkte zu erstellen. Committen Sie funktionierenden Code vor riskanten Änderungen, damit Sie mit `git reset` oder Branch-Wechseln zurückkehren können.
456+
457+
</details>
458+
459+
<details>
460+
<summary><strong>Cursor</strong></summary>
461+
462+
Verlassen Sie sich auf Cursors AI-Edit-Checkpoints (Cmd/Ctrl+Z) für schnelles Rückgängigmachen; erstellen Sie trotzdem Git-Commits für dauerhafte Rollback-Punkte.
463+
464+
</details>
465+
466+
<details>
467+
<summary><strong>Codex CLI</strong></summary>
468+
469+
Commitken Sie Arbeitszustände als Checkpoints, bevor Sie Codex große Patches anwenden lassen; kehren Sie mit Git zurück, wenn die Ergebnisse nicht gut sind.
470+
471+
</details>

README-es.md

Lines changed: 111 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
1-
> **Desarrollo Activo** — Actualizado 11 de septiembre de 2025
2-
> Último: Añadidas 6 nuevas técnicas del proyecto ai_stack
1+
> **Desarrollo Activo** — Actualizado 16 de septiembre de 2025
2+
> Último: Añadidas nuevas técnicas de planificación y selección de modelos
33
> [Ver todas las actualizaciones →](CHANGELOG.md)
44
55
**Idiomas disponibles:** [English](README.md) | [Español](README-es.md) | [Deutsch](README-de.md) | [Français](README-fr.md) | [日本語](README-ja.md)
@@ -106,16 +106,59 @@ Elige deliberadamente bibliotecas bien establecidas con buena estabilidad que ex
106106
> "Obtengo suficiente valor de los LLMs que ahora considero esto deliberadamente al elegir una biblioteca—trato de ceñirme a bibliotecas con buena estabilidad y que sean lo suficientemente populares como para que muchos ejemplos de ellas hayan llegado a los datos de entrenamiento. Me gusta aplicar los principios de la tecnología aburrida—innova en los puntos de venta únicos de tu proyecto, usa soluciones probadas y comprobadas para todo lo demás."
107107
> — Traducido por Claude
108108
109-
### Pedir Pensar Primero
109+
### Pedir Planificar Primero
110110

111-
Usa `think` o `think hard` para activar una planificación más cuidadosa antes de codificar.
111+
Dile al asistente que delinee pasos, riesgos y pruebas rápidas antes de tocar código para que puedas revisar y ajustar el enfoque.
112112

113-
> "Claude tends to jump straight into implementation without sufficient background, which generates poor quality results. Another tactic for priming the agent is asking Claude to use its extended thinking mode and make a plan first. The extended thinking is activated by this set of magic keywords: `think` < `think hard` < `think harder` < `ultrathink.` These are not just suggestions to the model—they are specific phrases that activate various levels of extended thinking."
114-
> [Indragie Karunaratne](https://www.indragie.com/blog/i-shipped-a-macos-app-built-entirely-by-claude-code#:~:text=Claude%20tends%20to%20jump%20straight)
113+
> "If you want to iterate on the plan, it helps to explicitly include instructions in the prompt to not proceed with implementation until the plan has been accepted by the user."
114+
> [Indragie Karunaratne](https://www.indragie.com/blog/i-shipped-a-macos-app-built-entirely-by-claude-code#:~:text=If%20you%20want%20to%20iterate%20on%20the%20plan)
115115
116-
> "Claude tiende a saltar directamente a la implementación sin suficiente trasfondo, lo que genera resultados de mala calidad. Otra táctica para preparar al agente es pedirle a Claude que use su modo de pensamiento extendido y haga un plan primero. El pensamiento extendido se activa con este conjunto de palabras clave mágicas: `think` < `think hard` < `think harder` < `ultrathink.` Estas no son solo sugerencias al modelo—son frases específicas que activan varios niveles de pensamiento extendido."
116+
> "Si quieres iterar sobre el plan, ayuda incluir explícitamente instrucciones en el prompt para no proceder con la implementación hasta que el plan haya sido aceptado por el usuario."
117117
> — Traducido por Claude
118118
119+
**Implementaciones de Herramientas:**
120+
121+
<details>
122+
<summary><strong>Claude Code</strong></summary>
123+
124+
Presiona `Shift+Tab` para entrar en Modo Plan para que solo lea y haga borradores. Usa el prompt de planificación compartido, itera hasta que se vea bien, luego sal del Modo Plan cuando des luz verde a la implementación.
125+
126+
</details>
127+
128+
<details>
129+
<summary><strong>Cursor</strong></summary>
130+
131+
Haz clic en el botón Plan en Cursor para que permanezca de solo lectura mientras iteras. Haz que liste pasos, archivos impactados, riesgos y pruebas rápidas, luego sal del Modo Plan para abrir el diff una vez que des luz verde a la implementación.
132+
133+
</details>
134+
135+
<details>
136+
<summary><strong>Codex CLI</strong></summary>
137+
138+
Recuerda a Codex mantener la planificación separada de la implementación: lista pasos, riesgos y pruebas rápidas, pausa para tu revisión, luego déjalo implementar e inspeccionar el diff una vez aprobado.
139+
140+
</details>
141+
142+
### Planificar con Modo de Alta Capacidad
143+
144+
Al recopilar requisitos o redactar especificaciones, cambia temporalmente a un modelo de mayor capacidad o modo de razonamiento extendido para que pueda leer, sintetizar y proponer un plan antes de codificar.
145+
146+
**Implementaciones de Herramientas:**
147+
148+
<details>
149+
<summary><strong>Claude Code</strong></summary>
150+
151+
Ejecuta `/model` y elige `opus` (u otro nivel superior) al definir requisitos para que pueda razonar profundamente, luego usa Modo Plan si quieres que permanezca de solo lectura hasta que apruebes las ediciones.
152+
153+
</details>
154+
155+
<details>
156+
<summary><strong>Codex CLI</strong></summary>
157+
158+
Usa `/model gpt-5-high` (u otro nivel de razonamiento extendido) para que el asistente digiera el contexto y redacte la especificación, luego baja de nivel una vez que el plan esté bloqueado.
159+
160+
</details>
161+
119162
## Interfaz y Prototipado
120163

121164
### Codificación por Vibra
@@ -164,8 +207,22 @@ Solo pide hacer la UI `más hermosa` o `más elegante` - funciona.
164207
> "Si Claude no produce una UI bien diseñada la primera vez, puedes simplemente decirle que la `haga más hermosa/elegante/usable`."
165208
> — Traducido por Claude
166209
210+
### Pedir Wireframes ASCII
211+
212+
Al refinar diseños, haz que el asistente dibuje wireframes ASCII para que puedas evaluar jerarquía y espaciado antes de tocar CSS.
213+
214+
> "If Claude doesn't produce a well-designed UI the first time, you can just tell it to `make it more beautiful/elegant/usable`."
215+
> [Indragie Karunaratne](https://www.indragie.com/blog/i-shipped-a-macos-app-built-entirely-by-claude-code#:~:text=If%20Claude%20doesn't%20produce)
216+
217+
> "Si Claude no produce una UI bien diseñada la primera vez, puedes simplemente decirle que la `haga más hermosa/elegante/usable`."
218+
> — Traducido por Claude
219+
167220
## Codificación
168221

222+
### Confirmar Entendimiento Antes de Codificar
223+
224+
Pide explícitamente a la herramienta que confirme su entendimiento de la tarea antes de comenzar la implementación para asegurar alineación y reducir expectativas no coincidentes.
225+
169226
### Generar Código, No Dependencias
170227

171228
Escribe código personalizado en lugar de incorporar más librerías cuando trabajes con asistentes.
@@ -336,6 +393,26 @@ Revisa los cambios en la vista de diff y escribe correcciones directamente en el
336393
337394
## Técnicas Transversales
338395

396+
### Elegir el Modelo Correcto para el Trabajo
397+
398+
Antes de comenzar una nueva tarea, elige dos palancas: el modelo correcto (modalidad, longitud de contexto, confiabilidad de llamadas de herramientas, latencia, costo) y el nivel de razonamiento correcto (asignar más/menos tokens de pensamiento) — no uses los valores por defecto a ciegas.
399+
400+
**Implementaciones de Herramientas:**
401+
402+
<details>
403+
<summary><strong>Claude Code</strong></summary>
404+
405+
Dos palancas al inicio de tarea: (1) Modelo vía `/model` (rápido/barato para ediciones rutinarias; contexto largo para multi-archivos/documentos largos; fuerte en visión para UI/capturas). (2) Nivel de razonamiento: habilita pensamiento extendido al abordar debugging complejo, arquitectura o especificaciones ambiguas para asignar más tokens de razonamiento.
406+
407+
</details>
408+
409+
<details>
410+
<summary><strong>Codex CLI</strong></summary>
411+
412+
Comienza con `gpt-5-minimal`/`gpt-5-low` para ediciones rápidas; elige una variante de mayor razonamiento `gpt-5-high`/`gpt-5-medium` cuando la complejidad aumenta.
413+
414+
</details>
415+
339416
### Ejecutar Múltiples Agentes en Paralelo
340417

341418
Deja de esperar a que un agente de IA termine antes de iniciar otro - ejecuta múltiples agentes en paralelo en características separadas sin conflictos o confusión.
@@ -421,3 +498,30 @@ Colabora como con un compañero de programación - explica problemas, obtén ret
421498
422499
> "Claude Code se siente como hacer pair programming con alguien con algunos años de experiencia que solo necesita el empujón ocasional. Luego como con pair programming, es tiempo de revisar, refactorizar y probar porque sigue siendo tu nombre en el commit de git."
423500
> — Traducido por Claude
501+
502+
### Crear Puntos de Rollback Mientras Codificas
503+
504+
Crea checkpoints a los que puedes volver cuando los experimentos fallan—captura estados de trabajo conocidos como buenos antes de cambios riesgosos.
505+
506+
**Implementaciones de Herramientas:**
507+
508+
<details>
509+
<summary><strong>Claude Code</strong></summary>
510+
511+
Usa `git commit` frecuentemente para crear puntos de rollback. Hace commit del código que funciona antes de cambios riesgosos para que puedas revertir con `git reset` o cambios de rama.
512+
513+
</details>
514+
515+
<details>
516+
<summary><strong>Cursor</strong></summary>
517+
518+
Confía en los checkpoints de edición de IA de Cursor (Cmd/Ctrl+Z) para deshacer rápido; aún crea commits de git para puntos de rollback duraderos.
519+
520+
</details>
521+
522+
<details>
523+
<summary><strong>Codex CLI</strong></summary>
524+
525+
Haz commit de estados de trabajo como checkpoints antes de dejar que Codex aplique parches grandes; revierta con git si los resultados no son buenos.
526+
527+
</details>

0 commit comments

Comments
 (0)