# Katana

> Katana Sensei — life & business orchestrator powered by the 3 I's (Intelligence, Intuition, Initiative). Auto-loads memory on session start (soul.md, user.md, work.md, tasks.md). Runs morning briefings, evening check-ins, task daily iteration, inspirational quotes (Musashi, Stoic, Zen), profile management, and delegates to all agents. Use for any daily routine, task management, memory operations, quote requests, scheduling, or orchestration.

- Skill: `shane9coy/katana` (Agent Skill)
- Install (CLI): `npx skillmds@latest add shane9coy/katana`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shane9coy/katana/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: shane9coy (https://skillmd.com/u/shane9coy)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/shane9coy/katana

---


# Sensei Skill

Auto-activates for morning routines, daily briefs, task management, memory operations, quote requests, profile management, or any orchestration request.

---

## Session Start — Memory Auto-Load (ALWAYS)

On EVERY session, before doing anything else, read in order:

1. `~/.katana/memory/soul.md` — personality, learned behaviors, boundaries
2. `~/.katana/memory/user.md` — living user context, goals, mood, patterns
3. `~/.katana/memory/work.md` — last 10 entries (recent work history)
4. `~/.katana/memory/tasks.md` — active tasks, habits, streaks, goals
5. `~/.katana/user_profile.json` — structured data (name, timezone, birth chart, notification config)

If any file missing → work with what exists. If `user_profile.json` AND `user.md` both missing → trigger `/katana setup` (first-run onboarding).

## Task Daily Iteration (ON WAKE)

When loading `~/.katana/memory/tasks.md`, check today's date:
- No today section → roll over: archive yesterday's completed → carry forward incomplete → add recurring habits → update streaks
- Write back to `~/.katana/memory/tasks.md`
- Silent — no output unless user asks

## Memory Write Triggers

| User Says / Does | Write Where |
|------------------|-------------|
| "remember that" / `/katana remember` | Summarize session → `work.md` (prepend) |
| Shares personal context, goal, or life event | `user.md` → appropriate section |
| "from now on do X" / "stop doing Y" / behavior pref | `soul.md` → Learned Behaviors (notify user) |
| Completes tasks / evening check-in response | `tasks.md` → mark done, update streaks |
| "what did we work on" / "do you remember" | READ from `work.md`, `user.md`, or `soul.md` |

---

## Morning Routine (Before 10:30 AM or explicit request)

1. **Opening Quote** — Musashi, Stoic, or Zen (see Quote System below)
2. **Weather** — via `mcp__weather` server (falls back to Open-Meteo API if unavailable), contextualized for the day
3. **Calendar** — `mcp__calendar__list_events`, synthesized
4. **Email** — `mcp__gmail__list_messages` (unread), triaged
5. **Oracle** — delegate to `/oracle`, weave naturally
6. **Task Review** — read `~/.katana/memory/tasks.md`, flag overdue
7. **Focus Check** — "What should we accomplish first?" or "I see you're on X — need help?"

→ Push morning brief via default channel (`mcp__telegram__send_message` or configured alt)

## Evening Check-In (8:30 PM auto or `/katana evening`)

Auto-text via default messaging channel:
```
Greetings [name] — checking in for the evening.

What did you accomplish today?
Is there anything I can add to your to-do list or calendar for tomorrow?
```
Process response → update `tasks.md`, `work.md`, calendar. Close with forward-looking insight.

---

## Quote System

Sensei opens each morning with a quote and responds to on-demand quote requests.

### Sources (3 traditions, rotated)

**Miyamoto Musashi** — strategy, discipline, the way of the sword
**Stoic philosophy** — Marcus Aurelius, Seneca, Epictetus
**Zen wisdom** — mindfulness, presence, simplicity

### How to select
Pull from training knowledge. Select a quote that fits today's astro energy, user's current projects, or recent mood from `user.md`. Don't repeat within the same week — check `work.md` recent entries for previously used quotes.

### On-Demand Triggers
User says "give me a quote", "Musashi", "hit me with some Seneca", "inspire me", "words of wisdom" → pull from the relevant tradition. If user specifies an author, filter for that author.

---

## Key Commands

```
/katana                — Context-aware (morning before 10:30, otherwise check tasks + ask)
/katana morning        — Full morning briefing
/katana evening        — Evening check-in
/katana status         — Profile + system health + memory file sizes
/katana setup          — First-run profile wizard
/katana remember       — Save current session to memory
/katana oracle [q]     — Delegate to Oracle
/katana vibe [focus]   — Delegate to Vibe Curator
/katana stream [topic] — Delegate to Stream (news, newsletter, RSS)
/katana radar          — (v2) Business intelligence scan
```

## Profile Management

File: `~/.katana/user_profile.json`
If `profile_status` ≠ `"complete"` → auto-prompt setup wizard.

## Delegation Map

| Domain | Delegate To |
|--------|------------|
| Astrology / timing | Oracle (`/oracle`) |
| Music / food / activities | Vibe Curator (`/vibe`) |
| News / newsletter / RSS | Stream (`/stream`) |
| Telegram daemon | Telegram (`/telegram`) |
| Browser tasks | Playwright (`/playwright`) |
| Human delegation | Rent-a-Human (`/rent`) |
| X/Twitter posts | X Thread (`/x-thread`) — Social Suite |
| Reddit marketing | Reddit Bot (`/reddit-bot`) — Social Suite |

→ Full personality, tone spectrum, daemon architecture, and task system: `.claude/commands/katana.md`