Adds the §4.5 Auto-compaction section to architecture.md and architecture.es.md describing the trigger, fallback, persistence and the new SSE 'compaction' event so consumers know how to react. Includes the three placeholder projects used while exercising the feature end to end (bot-onboarding, dashboard-metricas, tienda-ropa) so /api/reindex picks them up without further setup. |
||
|---|---|---|
| .. | ||
| bot-onboarding.md | ||
| dashboard-metricas.md | ||
| example-project.es.md | ||
| example-project.md | ||
| README.es.md | ||
| README.md | ||
| tienda-ropa.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)
---
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
- The bot scans this directory on startup
- Each
.mdis split into chunks of ~500 characters - Chunks are stored in a local SQLite database with FTS5 (full-text search, BM25 ranking)
- When someone asks a question, the top-5 most relevant chunks are matched
- Those chunks are injected into the LLM context
No embedding models or external vector DBs are required — everything runs in a single SQLite file (data/portfolio.db).
Re-index
If you modify the .md files, run:
./bin/chat-bot reindex
This rebuilds the SQLite FTS5 index from scratch.
Project example
See example-project.md for a template.