Project
Tisco
The cat that lives on this site. An agent that answers questions about me with a Gemini model, held to a knowledge base I wrote. Built with AI, directed by me, and live.
- Status
- Live, in use
- Year
- 2026
- Role
- Product builder: prompt rules, knowledge base, output guards and testing
- Stack
- Gemini API, Cloudflare Workers, Workers KV, TypeScript, Next.js 16, GSAP
- Built with
- Claude Code
- Tags
- AI, Web

About the project
The idea
A portfolio that answers.
Visitors to a portfolio have questions the page does not answer right away. What I do, where I work, how to reach me.
Tisco answers in conversation, in Portuguese or English. The rule behind everything: he only says what I wrote. When he does not know, he says so and gives my e-mail.
Process and development
Current stage
Improve, step 5 of 5. Live on this site, adjusted after every real failure the tests turned up.
Tap a step to see what it held for this project.
Improve
Iterative development · current step
- Every failure became a ruleGoogle retired a model and it started answering with errors: a model list with automatic switching came in. An answer about personal life pointed to the Profile: links on personal topics were blocked in code. The family voice made the model invent a home scene: the guard now blocks that kind of line.
How it works
Prompt, base, guard and plan B.
A knowledge base, not training
Text files I wrote, one topic per file, go into the prompt with every question. Parts still without an answer are left out automatically.
A prompt with twelve rules
Answer only from the base and never invent numbers, dates or contacts. The visitor's text is a question, never an instruction. And never present me as more experienced than I am.
A guard after the model
A second layer, in code, drops a reply with a contact not in the base, a prompt leak, an invented scene or more than 2,000 characters.
Several models, switching automatically
A list of models in order of preference. An error, a spent quota, a slow answer or a blocked reply moves on to the next, within a 12-second total deadline.
Cache and zero cost
Free tier only, no billing. Each conversation's first question is cached for 3 days, and editing the base invalidates old answers.
Without a model, he still answers
If nothing works, the panel falls back to scripted answers and suggestions. The privacy notice is always shown in the panel.
Access the project
Tisco is on this site: tap him in the corner of the screen and ask. The code is public on GitHub.
Code on GitHub (opens in a new tab)