b9769fac41
- README.md: full English translation, .es.md preserved - docs/architecture.md: full translation (1039 lines) - configs/portfolio-bot.yaml: full English translation, .es.yaml preserved - data/projects/README.md + example-project.md: translated with banners Default language is now English (standard for OSS). Spanish remains available via .es.* suffix files.
49 lines
No EOL
1.1 KiB
Markdown
49 lines
No EOL
1.1 KiB
Markdown
# Portfolio Projects
|
|
|
|
Place a `.md` file here for each project you want the bot to be able to answer about.
|
|
|
|
## File naming convention
|
|
|
|
- One file per project: `project-name.md`
|
|
- Name in kebab-case (lowercase with hyphens)
|
|
- Example: `rony-harness.md`, `rony-llm-agent.md`, `portfolio-astro.md`
|
|
|
|
## Frontmatter (optional but recommended)
|
|
|
|
```markdown
|
|
---
|
|
title: "Rony Harness"
|
|
date: 2026-06
|
|
status: "active" # active | archived | wip
|
|
tags: ["go", "ai", "cli"]
|
|
repo: "https://github.com/VictorVargas/rony-harness"
|
|
demo: "https://..." # optional
|
|
---
|
|
|
|
# Rony Harness
|
|
|
|
AI agent harness for software development...
|
|
```
|
|
|
|
## How they're processed
|
|
|
|
1. The bot scans this directory on startup
|
|
2. Each `.md` is split into chunks of ~500 characters
|
|
3. Each chunk is converted to embedding with Ollama
|
|
4. Embeddings are stored in ChromaDB
|
|
5. When someone asks a question, the top-5 most relevant chunks are searched
|
|
6. Those chunks are injected into the LLM context
|
|
|
|
## Re-index
|
|
|
|
If you modify the `.md` files, run:
|
|
|
|
```bash
|
|
./bin/chat-bot reindex
|
|
```
|
|
|
|
This rebuilds ChromaDB from scratch.
|
|
|
|
## Project example
|
|
|
|
See [`example-project.md`](./example-project.md) for a template. |