site: global favicon + cache-busting via build revision

jadercorrea · jadercorrea · commit 2a23c0455b21 · 2025-12-05T11:24:54.000-03:00
home: replace Structured Workflow with Agent Orchestration section
blog: add cache-busting to feedback demo gifs (2025-11-28)
infra: add Liquid include _includes/asset_url.html for versioned asset URLs
plans: add 06-blog-consistency-and-video-pipeline.md
diff --git a/docs/_includes/asset_url.html b/docs/_includes/asset_url.html
@@ -0,0 +1 @@
+{% assign bust = site.github.build_revision | default: site.time | date: '%s' %}{{ include.path | relative_url }}?v={{ bust }}
diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html
@@ -6,9 +6,12 @@
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <title>{{ page.title }} - Chuchu</title>
   <meta name="description" content="{{ page.description | default: site.description }}" />
-  <link rel="icon" type="image/png" href="{{ '/assets/chuchu.png' | relative_url }}" />
+  {% assign bust = site.github.build_revision | default: site.time | date: '%s' %}
+  <link rel="icon" type="image/png" href="{{ '/assets/chuchu.png' | relative_url }}?v={{ bust }}" />
+  <link rel="apple-touch-icon" sizes="180x180" href="{{ '/assets/chuchu.png' | relative_url }}?v={{ bust }}" />
+  <link rel="shortcut icon" href="{{ '/assets/chuchu.png' | relative_url }}?v={{ bust }}" />
 
-  <link rel="stylesheet" href="{{ '/assets/style.css' | relative_url }}" />
+  <link rel="stylesheet" href="{{ '/assets/style.css' | relative_url }}?v={{ bust }}" />
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link
@@ -19,8 +22,8 @@
 <body>
   <nav class="main-nav">
     <div class="nav-container">
-      <a href="{{ '/' | relative_url }}" class="nav-brand">
-        <img src="{{ '/assets/chuchu.png' | relative_url }}" alt="Chuchu" class="nav-logo" />
+<a href="{{ '/' | relative_url }}" class="nav-brand">
+        <img src="{{ '/assets/chuchu.png' | relative_url }}?v={{ bust }}" alt="Chuchu" class="nav-logo" />
         <span>Chuchu</span>
       </a>
       <div class="nav-links">
diff --git a/docs/_posts/2025-11-28-universal-feedback-cli.md b/docs/_posts/2025-11-28-universal-feedback-cli.md
@@ -33,10 +33,10 @@ chu feedback hook install --shell=fish --with-diff
 ## See it in action
 
 ### Keyboard flow (Ctrl+g → run)
-![Two‑keystroke feedback (hook path)](../assets/feedback-hook-demo.gif)
+![Two‑keystroke feedback (hook path)](../assets/feedback-hook-demo.gif?v={{ site.github.build_revision | default: site.time | date: '%s' }})
 
 ### Programmatic flow (CLI submit)
-![Two‑keystroke feedback demo](../assets/feedback-demo.gif)
+![Two‑keystroke feedback demo](../assets/feedback-demo.gif?v={{ site.github.build_revision | default: site.time | date: '%s' }})
 
 ### How it’s used for training
 ```bash
diff --git a/docs/compare.html b/docs/compare.html
@@ -4,7 +4,7 @@
 permalink: /compare/
 ---
 
-<link rel="stylesheet" href="{{ '/assets/css/compare.css' | relative_url }}">
+<link rel="stylesheet" href="{{ '/assets/css/compare.css' | relative_url }}?v={{ site.github.build_revision | default: site.time | date: '%s' }}">
 
 <div class="compare-page">
 <h1>Model Comparison for Coding Tasks</h1>
@@ -109,7 +109,7 @@ <h2>Monthly Cost Calculator</h2>
 </div>
 </div>
 
-<script src="{{ '/assets/js/compare.js' | relative_url }}"></script>
+<script src="{{ '/assets/js/compare.js' | relative_url }}?v={{ site.github.build_revision | default: site.time | date: '%s' }}"></script>
 <script>
     document.addEventListener('DOMContentLoaded', init);
 </script>
diff --git a/docs/index.md b/docs/index.md
@@ -49,36 +49,38 @@ description: AI coding assistant with specialized agents and validation
 
 
 <div class="section">
-  <h2 class="section-title">Structured Workflow: Research → Plan → Implement</h2>
-  <p class="section-subtitle">Go from feature idea to tested code with AI assistance at each step</p>
+  <h2 class="section-title">Agent Orchestration: Analyzer → Planner → Editor → Validator</h2>
+  <p class="section-subtitle">Fast routing, focused context, safe edits, and verified results — end to end</p>
   
   <div class="workflow-steps">
     <div class="workflow-step">
-      <h3>Research</h3>
-      <p>Understand your codebase before making changes</p>
-      <pre><code>chu research "How does authentication work?"</code></pre>
-      <p>Chuchu searches semantically, reads relevant files, and documents findings in <code>~/.chuchu/research/</code></p>
+      <h3>Analyzer</h3>
+      <p>Scans the codebase, builds dependency graph and selects only the relevant files</p>
+      <pre><code>chu do "add authentication"</code></pre>
     </div>
     
     <div class="workflow-step">
-      <h3>Plan</h3>
-      <p>Create detailed implementation plan with phases</p>
-      <pre><code>chu plan "Add password reset feature"</code></pre>
-      <p>Generates step-by-step plan with clear goals, file changes, and test requirements</p>
+      <h3>Planner</h3>
+      <p>Creates a concrete plan with success criteria and allowed file list</p>
+      <pre><code>chu do "add authentication"</code></pre>
     </div>
     
     <div class="workflow-step">
-      <h3>Implement</h3>
-      <p>Execute plan interactively or autonomously</p>
-      <pre><code>chu implement plan.md
-chu implement plan.md --auto</code></pre>
-      <p>Interactive mode for control, autonomous mode for speed with automatic verification and retry</p>
+      <h3>Editor</h3>
+      <p>Applies changes incrementally with file validation and auto-recovery</p>
+      <pre><code>chu do "add authentication"</code></pre>
+    </div>
+    
+    <div class="workflow-step">
+      <h3>Validator</h3>
+      <p>Runs tests and checks success criteria before finishing</p>
+      <pre><code>chu do "add authentication"</code></pre>
     </div>
   </div>
   
   <p style="text-align: center; margin-top: 2rem;">
-    <a href="/workflow-guide" class="btn btn-primary">Complete Workflow Guide</a>
-    <a href="/blog/2025-11-24-complete-workflow-guide" class="btn btn-secondary">Read Tutorial</a>
+    <a href="/features#agent-based-architecture" class="btn btn-primary">Learn the Architecture</a>
+    <a href="/features#file-validation" class="btn btn-secondary">See Validation & Safety</a>
   </p>
 </div>
 
@@ -158,7 +160,14 @@ chu plan "implement rate limiting"</code></pre>
     <li><strong>Affordable</strong>: $2–5/month (Groq) or $0/month (Ollama)</li>
   </ul>
   
-  <p><a href="/blog/2025-12-06-why-chuchu-isnt-trying-to-beat-anyone">Read the full positioning →</a> · <a href="/blog/2025-11-13-why-chuchu">Original vision →</a></p>
+  <p>
+    <a href="/blog/2025-12-06-why-chuchu-isnt-trying-to-beat-anyone">Read the full positioning →</a>
+    · <a href="/blog/2025-11-13-why-chuchu">Original vision →</a>
+    · <a href="/blog/2025-12-01-agent-routing-vs-tool-search">Agent routing vs tool search →</a>
+    · <a href="/blog/2025-12-02-intelligent-model-selection">Intelligent model selection →</a>
+    · <a href="/blog/2025-12-03-dependency-graph-context-optimization">Dependency graph →</a>
+    · <a href="/blog/2025-12-04-chat-repl-conversational-coding">Chat REPL →</a>
+  </p>
 </div>
 
 <div class="section">
diff --git a/docs/plans/06-blog-consistency-and-video-pipeline.md b/docs/plans/06-blog-consistency-and-video-pipeline.md
@@ -0,0 +1,69 @@
+# Revisão dos Posts e Pipeline Blog→Vídeo (Zapfy-AI)
+
+Status: Fase 1 concluída em 2025-12-05  
+Escopo: Padronizar posts recentes do blog e criar um pipeline para gerar vídeos em PT-BR automaticamente a partir desses posts, publicando no canal Zapfy-AI.  
+Dependências: Nenhuma crítica (pipeline pode começar com posts já padronizados).
+
+## Contexto
+Os posts anteriores a 2025-12-01 já seguiam uma estrutura consistente (frontmatter com `description` e `tags`, tom narrativo pessoal, "References", "See Also" e CTA para GitHub Discussions). Os posts a partir de 2025-12-01 até 2025-12-05 divergiam desse padrão.
+
+## Objetivos
+- Garantir consistência editorial e técnica em todos os posts.
+- Transformar cada post em um vídeo curto em português com narrativa clara, demonstração e CTA.
+- Viabilizar publicação contínua no canal Zapfy-AI.
+- Preparar terreno para posicionamento de Chuchu dentro da org Zapfy.
+
+## Fases
+### Fase 1 — Padronização dos posts (Concluída)
+Posts ajustados: 2025-12-01 → 2025-12-05.
+- Frontmatter: `author: Jader Correa`, `tags` (não `categories`), `description` adicionada.
+- Estrutura: seções "References", "See Also" e CTA para Discussions.
+- Tom: introduções com narrativa conectando posts anteriores.
+
+### Fase 2 — Roteiro PT-BR por post
+Para cada post, gerar um roteiro seguindo este esqueleto:
+1. Abertura (hook em 8–12s) — dor do público SMB/Dev.
+2. Contexto rápido — por que isso importa agora.
+3. Demonstração/explicação com 1–2 exemplos concretos.
+4. Resultado/impacto (métricas/tokens/tempo quando fizer sentido).
+5. CTA: "Assine o Zapfy-AI" + link para repo/discussion.
+Saída: `docs/scripts/YYYY-MM-DD-<slug>.pt-BR.md`.
+
+### Fase 3 — Narração/TTS e assets
+- TTS: modelo PT-BR (voz neutra) com fallback local.
+- Legendas: SRT gerado do texto (timestamps aproximados por parágrafo).
+- Assets: capturas/diagramas minimalistas a partir de trechos do post (ex.: PageRank, pipeline de agentes).
+Saídas:
+- `assets/video/YYYY-MM-DD-<slug>/voiceover.wav`
+- `assets/video/YYYY-MM-DD-<slug>/captions.srt`
+- `assets/video/YYYY-MM-DD-<slug>/stills/*.png`
+
+### Fase 4 — Render e publicação
+- Render: template de 1080p com faixas (narrador, música leve, gráficos).
+- Automação: script para juntar voz + imagens + legendas.
+- Publicação: título/descrição/hashtags em PT-BR derivados do post.
+- Checklist de QA: duração 3–5 min, áudio limpo, sem textos pequenos.
+
+### Fase 5 — Migração para org Zapfy
+- Transferência do repositório para `zapfy/chuchu`.
+- Atualização de `go.mod`, README, badges e links do site.
+- Post/Discussion explicando a mudança (OS continua MIT, mantido pela Zapfy).
+
+## Prioridade
+- Este plano entra como prioridade 06 (após 01–05 já existentes). Não bloqueia roadmap técnico e habilita aquisição/marketing.
+
+## Critérios de Sucesso
+- 100% dos posts recentes padronizados (12-01 a 12-05) — OK.
+- 3 primeiros vídeos publicados (Why Chuchu, Context Engineering, Why Chuchu Isn’t Trying...).
+- Tempo total por vídeo ≤ 2h (roteiro→render→publicação) após setup.
+- +10% de engajamento médio nas páginas de docs relacionadas (baseline a ser medido).
+
+## Riscos e Mitigações
+- Risco: Vídeos muito técnicos para SMB → Mitigar com roteiros mais curtos, foco em valor prático.
+- Risco: TTS artificial → Avaliar 2 vozes PT-BR e ajustar entonação/velocidade.
+- Risco: Migração de repo quebra links → Redirecionos e varredura de links após migração.
+
+## Próximas Ações
+1. Gerar roteiros PT-BR para 3 vídeos iniciais.
+2. Testar pipeline TTS + render com um post (piloto).
+3. Preparar comunicado de migração do repositório.

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+{% assign bust = site.github.build_revision \| default: site.time \| date: '%s' %}{{ include.path \| relative_url }}?v={{ bust }}`