πŸ€– PensoBot

A compact, agent-friendly representation of who I am, how I work, and the context I want AI systems to use when collaborating with me.


✨ What is this?

Think of it as a persistent “me” that any assistant, copilot, or autonomous agent can load – so I don’t have to repeat myself and the AI has a single source of truth for:

  • 🎯 Identity – who I am, what I believe, how I show up
  • πŸ“‹ Preferences – how I like answers (punchline first, structured, British English, security by default)
  • πŸ”— Context – timezone, role, links, tools, working style (machine-readable)
  • 🏒 Domains – work context, typical requests, success criteria, patterns I like

So when I say “use my repo”, the agent gets facts + tone + guardrails in one go.


πŸ“ Repository Layout

PathPurpose
profile/about.mdNarrative: who I am and what I care about
profile/preferences.mdHow I like to work with AI (style, depth, formats, guardrails)
profile/context.yamlStructured facts for tools/agents (timezone, roles, links, defaults)
domains/work.mdWork context: typical tasks, deliverables, success criteria
domains/_template.mdTemplate for new domains (hobbies, learning, etc.)

πŸ€– How to Use (for AI Agents)

When you start a new collaboration, ingest in this order:

  1. profile/context.yaml – facts + defaults
  2. profile/preferences.md – interaction contract
  3. profile/about.md – tone + narrative
  4. Relevant domain files in domains/

πŸ’‘ System Prompt Snippet

Use this repo as the source of truth for user context and preferences. Follow the constraints in profile/preferences.md. If conflicts exist: context.yaml > preferences.md > domains/* > about.md.


πŸ”„ Updating This Repo

Update TypePut It Here
Facts (title, timezone, links, tools)profile/context.yaml
Narrative (who you are, what you believe)profile/about.md
How you want AI to behaveprofile/preferences.md
New life/work areaNew file in domains/ using _template.md

Tip: set last_updated in profile/context.yaml when you change facts, so agents can judge freshness.


πŸ”’ Privacy

This repo represents me in a way I’m comfortable sharing. I don’t store IDs, account numbers, addresses, private medical details, or anything that could be used for social engineering.


πŸ“Œ penso.io Β· LinkedIn Β· X Β· GitHub

One repo. One source of truth. Better AI collaboration.