From 2ca15679cb7f739ef3ca449481dd6492ff41f491 Mon Sep 17 00:00:00 2001 From: Victor Vargas Date: Sun, 28 Jun 2026 23:22:15 -0700 Subject: [PATCH] chore:split documents --- README.md | 22 +++++++++++----------- docs/README.md | 4 ++-- docs/architecture.md | 16 ++++++++-------- docs/components.md | 2 +- docs/phase2.md | 6 +++--- examples/README.md | 2 +- go.mod | 2 +- pkg/llm/README.md | 4 ++-- pkg/rag/README.md | 4 ++-- 9 files changed, 31 insertions(+), 31 deletions(-) diff --git a/README.md b/README.md index 0373084..c69bf31 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,10 @@ -# go-llm-agent +# rony-llm-agent > 🔑 **Librería core reutilizable** para construir agentes LLM en Go. Esta librería es el corazón de varios proyectos de Victor Vargas: -- [`harness`](https://github.com/VictorVargas/harness) — AI agent harness para desarrollo de software (TUI) -- [`chat-bot`](https://github.com/VictorVargas/chat-bot) — Chatbot HTTP para portfolios y sitios web +- [`harness`](https://github.com/VictorVargas/rony-harness) — AI agent harness para desarrollo de software (TUI) +- [`chat-bot`](https://github.com/VictorVargas/rony-chat-bot) — Chatbot HTTP para portfolios y sitios web Provee toda la lógica **genérica** de un agente LLM: @@ -27,14 +27,14 @@ Provee toda la lógica **genérica** de un agente LLM: ## 📦 Instalación ```bash -go get github.com/VictorVargas/go-llm-agent +go get github.com/VictorVargas/rony-llm-agent ``` ## 🔧 Setup del proyecto (si vas a contribuir) ```bash -git clone https://github.com/VictorVargas/go-llm-agent.git -cd go-llm-agent +git clone https://github.com/VictorVargas/rony-llm-agent.git +cd rony-llm-agent # El go.mod ya existe con module + go version # Las dependencias se agregan automáticamente cuando escribes código: @@ -52,9 +52,9 @@ package main import ( "context" "fmt" - "github.com/VictorVargas/go-llm-agent/pkg/agent" - "github.com/VictorVargas/go-llm-agent/pkg/llm" - "github.com/VictorVargas/go-llm-agent/pkg/persona" + "github.com/VictorVargas/rony-llm-agent/pkg/agent" + "github.com/VictorVargas/rony-llm-agent/pkg/llm" + "github.com/VictorVargas/rony-llm-agent/pkg/persona" ) func main() { @@ -128,8 +128,8 @@ MIT — ver [`LICENSE`](./LICENSE). ## 🔗 Proyectos que usan esta librería -- [`VictorVargas/harness`](https://github.com/VictorVargas/harness) — TUI agent para software dev -- [`VictorVargas/chat-bot`](https://github.com/VictorVargas/chat-bot) — HTTP chatbot +- [`VictorVargas/rony-harness`](https://github.com/VictorVargas/rony-harness) — TUI agent para software dev +- [`VictorVargas/rony-chat-bot`](https://github.com/VictorVargas/rony-chat-bot) — HTTP chatbot ## 📚 Documentación adicional diff --git a/docs/README.md b/docs/README.md index 4386e93..4178198 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,4 +1,4 @@ -# go-llm-agent — Documentación +# rony-llm-agent — Documentación Documentación técnica detallada de la librería. @@ -6,7 +6,7 @@ Documentación técnica detallada de la librería. ``` ┌────────────────────────────────────────────────────────────────┐ -│ go-llm-agent (pkg/) │ +│ rony-llm-agent (pkg/) │ │ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │ │ │ agent │ │ persona │ │ tools │ │ diff --git a/docs/architecture.md b/docs/architecture.md index 2a358ef..e8bdf37 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -1,4 +1,4 @@ -# 🏗️ go-llm-agent — Architecture +# 🏗️ rony-llm-agent — Architecture **Versión:** 1.0 **Autor:** Victor Hugo Vargas @@ -14,14 +14,14 @@ ## 🎯 1. Visión de la Librería -### 1.1 ¿Qué es go-llm-agent? +### 1.1 ¿Qué es rony-llm-agent? Una librería Go que provee toda la lógica **genérica y reusable** para construir agentes basados en LLMs. No es un producto final — es el cimiento sobre el cual se construyen productos específicos. **Productos que la consumen:** -- [`VictorVargas/harness`](https://github.com/VictorVargas/harness) — AI agent harness para desarrollo de software (TUI CLI) -- [`VictorVargas/chat-bot`](https://github.com/VictorVargas/chat-bot) — Chatbot HTTP para portfolios y sitios web +- [`VictorVargas/rony-harness`](https://github.com/VictorVargas/rony-harness) — AI agent harness para desarrollo de software (TUI CLI) +- [`VictorVargas/rony-chat-bot`](https://github.com/VictorVargas/rony-chat-bot) — Chatbot HTTP para portfolios y sitios web ### 1.2 Principios de diseño @@ -51,7 +51,7 @@ Una librería Go que provee toda la lógica **genérica y reusable** para constr │ usan interfaces públicas ▼ ┌─────────────────────────────────────────────────────────────────┐ -│ go-llm-agent (pkg/ — API pública) │ +│ rony-llm-agent (pkg/ — API pública) │ │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ agent │ │ llm │ │ persona │ │ tools │ ... │ @@ -386,7 +386,7 @@ func (s *Sandbox) WriteFile(path string, data []byte, perm os.FileMode) error | Path encoding (`%2e%2e`) | No detectado | Detectado por stdlib | | Null bytes en path | Depende del OS | Manejado por stdlib | -> 🔒 Por eso la librería **requiere Go 1.26+** (ver [README §16.1.3.1](https://github.com/VictorVargas/harness/blob/main/docs/architecture.md#16131)). +> 🔒 Por eso la librería **requiere Go 1.26+** (ver [README §16.1.3.1](https://github.com/VictorVargas/rony-harness/blob/main/docs/architecture.md#16131)). ### 3.7 Configuration (`pkg/config/`) @@ -487,7 +487,7 @@ Capa 6: Secret redaction → no expone secrets en logs/outputs Para tests deterministas, los productos pueden usar `pkg/llm/mock`: ```go -import "github.com/VictorVargas/go-llm-agent/pkg/llm/mock" +import "github.com/VictorVargas/rony-llm-agent/pkg/llm/mock" mockClient := mock.New(mock.Responses{ {Match: "hola", Response: "¡Hola! ¿Cómo estás?"}, @@ -498,7 +498,7 @@ mockClient := mock.New(mock.Responses{ ### 6.2 Mock Memory ```go -import "github.com/VictorVargas/go-llm-agent/pkg/rag/mock" +import "github.com/VictorVargas/rony-llm-agent/pkg/rag/mock" memory := mock.NewMemory([]rag.Fragment{ {Content: "doc1", ProjectID: "test"}, diff --git a/docs/components.md b/docs/components.md index 0d8d536..a385900 100644 --- a/docs/components.md +++ b/docs/components.md @@ -145,7 +145,7 @@ package myprovider import ( "context" - "github.com/VictorVargas/go-llm-agent/pkg/llm" + "github.com/VictorVargas/rony-llm-agent/pkg/llm" ) type Client struct { diff --git a/docs/phase2.md b/docs/phase2.md index 6604675..a1a9fba 100644 --- a/docs/phase2.md +++ b/docs/phase2.md @@ -1,4 +1,4 @@ -# 🚀 go-llm-agent — Phase 2 Features +# 🚀 rony-llm-agent — Phase 2 Features **Versión:** 1.0 **Autor:** Victor Hugo Vargas @@ -8,7 +8,7 @@ > 📚 **Documentos relacionados:** > - [`architecture.md`](./architecture.md) — Core interfaces (LLMClient, Tool, Agent Loop, etc.) > - [`components.md`](./components.md) — Referencia por paquete -> - Productos que consumen estas features: [`harness`](https://github.com/VictorVargas/harness), [`chat-bot`](https://github.com/VictorVargas/chat-bot) +> - Productos que consumen estas features: [`harness`](https://github.com/VictorVargas/rony-harness), [`chat-bot`](https://github.com/VictorVargas/rony-chat-bot) --- @@ -726,4 +726,4 @@ import "github.com/tetratelabs/wazero" - [`architecture.md`](./architecture.md) — Core architecture - [`components.md`](./components.md) — Per-package reference -- Productos: [`harness`](https://github.com/VictorVargas/harness), [`chat-bot`](https://github.com/VictorVargas/chat-bot) \ No newline at end of file +- Productos: [`harness`](https://github.com/VictorVargas/rony-harness), [`chat-bot`](https://github.com/VictorVargas/rony-chat-bot) \ No newline at end of file diff --git a/examples/README.md b/examples/README.md index f9e9660..f88d1b5 100644 --- a/examples/README.md +++ b/examples/README.md @@ -1,6 +1,6 @@ # Examples -> Ejemplos de uso de `go-llm-agent` en distintos contextos. +> Ejemplos de uso de `rony-llm-agent` en distintos contextos. ## 📁 Contenido planeado diff --git a/go.mod b/go.mod index 183166a..2cc601f 100644 --- a/go.mod +++ b/go.mod @@ -1,3 +1,3 @@ -module github.com/VictorVargas/go-llm-agent +module github.com/VictorVargas/rony-llm-agent go 1.26 \ No newline at end of file diff --git a/pkg/llm/README.md b/pkg/llm/README.md index 568a0c7..5c551f3 100644 --- a/pkg/llm/README.md +++ b/pkg/llm/README.md @@ -51,7 +51,7 @@ type ProviderCapabilities struct { ## Uso ```go -import "github.com/VictorVargas/go-llm-agent/pkg/llm/providers/anthropic" +import "github.com/VictorVargas/rony-llm-agent/pkg/llm/providers/anthropic" client, err := anthropic.New(anthropic.Config{ APIKey: os.Getenv("ANTHROPIC_API_KEY"), @@ -77,7 +77,7 @@ for chunk, err := range client.Stream(ctx, req) { ## Mock para tests ```go -import "github.com/VictorVargas/go-llm-agent/pkg/llm/mock" +import "github.com/VictorVargas/rony-llm-agent/pkg/llm/mock" mockClient := mock.New(mock.Responses{ {Match: "hola", Response: "¡Hola! ¿Cómo estás?"}, diff --git a/pkg/rag/README.md b/pkg/rag/README.md index 184947d..180578c 100644 --- a/pkg/rag/README.md +++ b/pkg/rag/README.md @@ -58,8 +58,8 @@ type Embedder interface { ## Uso ```go -import "github.com/VictorVargas/go-llm-agent/pkg/rag" -import "github.com/VictorVargas/go-llm-agent/pkg/rag/backends/chroma" +import "github.com/VictorVargas/rony-llm-agent/pkg/rag" +import "github.com/VictorVargas/rony-llm-agent/pkg/rag/backends/chroma" backend, _ := chroma.New(chroma.Config{ Path: "~/.local/share/rony/chroma",