chief-of-staff

Claude Code Chief of Staff

How I turned Claude Code into a persistent AI chief of staff — the full architecture, from CLAUDE.md to scheduled background scripts.

Built with Claude Code by @loganinthefuture

---

Install it as a plugin (new)

The architecture below is now installable in one command. In Claude Code:

/plugin marketplace add loganhc-09/claude-chief-of-staff
/plugin install chief-of-staff@chief-of-staff

Restart Claude Code, then run /chief-of-staff:setup — it interviews you and scaffolds your own persistent memory + daily-brief system. No coding required. The plugin lives in plugins/chief-of-staff/; everything it creates is plain Markdown on your machine.

---

The Three Layers

The system has three layers. Most people are already at Layers 1 and 2. The unlock is Layer 3.

Layer 1 — Knowledge (Vault): A markdown vault Claude Code reads and writes. Start with the examples/CLAUDE.md template. That's the smallest viable version of this entire system — works the moment you drop it in a folder you claude from.

Layer 2 — Active (MacBook + Claude Code): You + Claude Code in the moment. Live work, live decisions. Already running if you have Claude Code installed.

Layer 3 — Autonomous (always-on machine): A second machine running scheduled scripts that pull email, calendar, transcripts, and post to Discord. Mine is an old laptop on my desk. Could be a Raspberry Pi, a Mac mini, or a cheap cloud VM. See architecture.md and examples/scripts/ for what runs there.

Cost: I run on Claude Max ($200/month). Most of this works on Max 5x ($100/month) too — see getting-started.md for plan-tier breakdown and cost-reduction habits.

---

What This Is

Most people use Claude Code for one-shot tasks. Write this email. Fix this bug. Explain this code. That's useful — but it's like hiring a brilliant contractor and only giving them 15-minute jobs.

This repo is the architecture for something different: a persistent operational layer that remembers your context, runs in the background, and compounds over time. Morning briefings generated before you wake up. Meeting transcripts processed into facts and follow-ups overnight. Commitments tracked and surfaced when they're overdue.

It's the difference between "I use AI sometimes" and "AI is part of how I operate."

Architecture Overview

DATA SOURCES
  Calendar · Email · Meeting Transcripts · Analytics · Notes
  Discord conversations · YouTube channels · Newsletters · RSS feeds
                          ↓
SCHEDULING LAYER
  launchd/cron jobs · Session hooks · Reminder scripts
  Discord bot (always-on) · Content scout (daily)
                          ↓
PROCESSING
  Transcript extraction · Email triage · Briefing generation
  Follow-up tracking · Content pipeline · Data analysis
  Reading curation · Signal extraction · Cross-source clustering
  Discord fact mining · Approval gate routing
                          ↓
KNOWLEDGE STORE
  SQLite memory (facts, knowledge profile, milestones)
  Semantic search (QMD) · Follow-up queue · Decision log
  Meeting archive · Position documents · Network map
  Reading preferences · Source trust scores · POV pillars
                          ↓
OUTPUTS
  Morning briefings · Draft messages · Reminders
  Content drafts · Intelligence briefs · Approval queues
  Discord channels · Reading recommendations

See architecture.md for the full system diagram, data flows, memory layout, and scheduling config.

The Handoff Model

The key design decision: not everything needs human involvement at every step. Three modes of work, explicit about where AI hands off to you.

Automated: Process transcripts, sync data, generate briefings, flag overdue items. AI owns it.

Approval-gated: Draft replies for you to review. Triage inbox for you to prioritize. Surface follow-ups for you to act on. AI preps, you decide.

Human only: Send messages, publish content, make judgment calls, strategic decisions. Never automated.

Most AI setups try to do everything or nothing. This one is explicit about where the handoff happens.

What's In Here

Core Architecture

File	What It Is
architecture.md	Full system diagram, data flows, memory layout, scheduling
getting-started.md	Progressive build guide — Day 1 to Month 3+
examples/CLAUDE.md	Template for your own chief of staff config
examples/scripts/briefing.py	Morning briefing generator
examples/scripts/meeting_processor.py	Transcript → facts + follow-ups pipeline