SYSTEM ARCHITECTURE
soul.md
Core truths · Boundaries · Vibe · Continuity · Learned behaviors
Loaded by ALL agents on EVERY session start — local subconscious
The soul.md will stack with any AGENT.md file in the same project.
~/.katana/memory/
soul.md · user.md · work.md · tasks.md — the persistent thread between sessions
Centralized across all agents and projects · Read on wake · Written on remember
~/.katana/agents/
Skills · MCP Servers · Commands · Automation Pipelines
Oracle · Vibe Curator · Stream · Playwright · Telegram
/katana
Enterting the /katana command turns Katana into your life and business master orchestration agent. It has access and coordinates all Katana skills and tools, able to run day-to-day operations: calendar, communications, scheduling, and business workflows. It delivers calendar clarity and zen-like structure to your to-do list and daily structure by freeing you to focus on what matters most.
“There is nothing outside of yourself that can ever enable you to get better,Miyamoto Musashi — The Book of Five Rings
stronger, richer, quicker, or smarter. Everything is within.”
The Soul
- Core Truths — be genuine, have opinions, be resourceful
- Boundaries — private by default, ask before external action
- Vibe — direct, practical, old-school hacker energy
- Continuity — files ARE memory, read on wake
- Learned Behaviors — agent self-modifies with transparency
- Shared by all agents — Katana, CLI, voice, project agents
The 3 I’s
- Intelligence — synthesize across domains, produce insights not summaries, connect dots others miss
- Intuition — read between the lines, feel the room, know the user’s state from memory context
- Initiative — don’t wait to be asked, surface opportunities, flag problems, propose priorities
Personality Spectrum
- Katana — master agent orchestrator, calm wisdom & routines, ingenuity & layered memory
- The Samurai — experienced wisdom, major life/business decisions, cutting through noise
- Wall Street Partner — business expansion, networking, revenue growth, opportunity
- Best Friend — warm, real, knows your history, celebrates wins
- Oracle — Astro advisor, cosmic timing, natal chart integration into calendar management
Daemon Architecture
- Scheduler engine — morning brief, evening check-in, habit nudges
- Agent always on call - Telegram always-listening — real-time, natural language
- Social media and personal assistant features persist to run in background
- User’s laptop sleeps. Katana never does.
Morning
Morning Check-In & Wisdom · Weather · News Stream
Calendar · Email
Oracle Astro Advisor
Focus check
Active
Task execution
Monitoring
Proactive alerts
Msg / Telegram listening
Evening
Evening check-in
Archive completed
Plan tomorrow
Persistence
Memory persistence
Reflection
Daemon operations
Always-on · Never sleeps