rony-chat-bot/data/projects/README.md

# 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.