myPKA

An AI powered Personal Knowledge Assistance system, based on our business-proven ICOR methodology. Plain markdown. Any LLM. Yours forever.

myPKA is a folder. You drop it on your machine, point your LLM at it, and you have a six-person AI team that organizes your life end to end. It works on its own. No database to set up, no SaaS to log into, no vendor to lose your data to.

Watch the full walkthrough on YouTube:

Why this is different from other scaffolds. Most folder structures are someone's preference dressed up as a system. myPKA is the working slice of ICOR, a methodology Paperless Movement S.L. and thousands of professionals world wide have been running their own business on for years. Every folder, every routing decision, every specialist contract maps to a piece of that framework. The structure is not arbitrary. The reasoning is teachable. Both matter when you scale past the first week.

What's new in v2.0.0

This is a MAJOR, breaking release. The base scaffold roster moves from nine specialists to six.

The three creative specialists — Iris (Design System Architect), Charta (Infographic Designer), and Pixel (Visual Specialist) — and everything they own (their contracts, their per-agent journals, four design SOPs, the GL-003-design-system Guideline, and their team-portrait images) come out of the base scaffold. They now ship as the optional Designer Expansion Pack from the AI Library.

The base scaffold now ships exactly six specialists: Larry, Nolan, Pax, Penn, Mack, and Silas.

• Why the change. The base scaffold is the working slice of ICOR everyone needs — PKM, journaling, research, hiring, automation, database work. Brand and visual work is real work, but it isn't universal. Pulling the creative trio into an opt-in pack keeps the base lean for the majority and gives design-focused users a clean, dedicated pack instead of carrying weight they may never use.
• What you get if you do design work. Install the Designer Expansion Pack from the AI Library — it restores Iris, Charta, Pixel, the four design SOPs, and GL-003-design-system as a drop-in pack. Nothing is lost; the capability simply moves to opt-in.
• Why it's a MAJOR bump. Removing specialists from the base roster is a breaking structural change under semver. An existing myPKA folder updated from 1.10.x to 2.0.0 will lose the three creative agents from its base roster unless the Designer Expansion Pack is installed. See Migrating to v2.0.0 below.

Everything else is unchanged — the task system, per-agent journals, and the LLM-readable migration changelog introduced earlier all carry forward. Plain markdown, any LLM, yours forever.

Get going now

1. Clone or download the repo into a folder you'll actually use.
2. Open the folder in your LLM tool (Claude Code, Codex CLI, Gemini CLI, Cursor, or Obsidian + chat plugin).
3. Paste the contents of initialize yourself in this folder as your first message.
4. The LLM reads ADAPTER-PROMPT.md, writes a tool-specific pointer file (CLAUDE.md, GEMINI.md, etc.), and reports the team is online.
5. Ask "Who are you?" and you'll see Larry is at your service.
6. Ask "What's open?" and Larry walks the new Team Knowledge/tasks/open/ folder for you.

That's the whole setup. There is no install step.

Once you have the team online and start using it, you'll hit moments where you wonder why a folder is shaped the way it is. That's where the courses come in. They teach the WHY behind every folder choice, so you understand why the team is built like real humans operating on the ICOR methodology, not just another AI scaffold. More on that below.

What you get

A working knowledge system, fully assembled, that does this on day one:

• Organizes your life from a single daily journal. You write what happened. The team files the people, projects, decisions, and ideas where they belong. Connections between notes are made for you.
• Remembers unfinished work for you. When something can't finish in one turn, the team writes it down as a task in Team Knowledge/tasks/. Next session, Larry walks tasks/open/ and surfaces what's waiting. The team genuinely picks up where it left off.
• Carries learning forward. Each specialist keeps a journal of durable insights at Team/<Name>/journal/. When a task references one of their entries, they re-read their own past thinking before starting work.
• Runs in any LLM you already use. Claude Code (and Claude Cowork), Codex CLI, Gemini CLI, Cursor, ChatGPT, Obsidian with a chat plugin. The same scaffold, the same team, the same files. You change models. Your knowledge doesn't move. Session-log triggers (close session, keep this in mind, let's realign, etc.) work with any LLM that reads AGENTS.md — ChatGPT, Claude, Gemini, Cursor, Cline, Codex, and the rest. Not Claude-only.
• Stays in plain markdown. Every note is a .md file. You can read it without the AI. You can grep it. You can sync it with Dropbox or git. You can open it in Obsidian and keep working with no AI at all.
• Upgrades to SQLite when you outgrow plain files. Once your myPKA gets large, paste the prompt at Team Knowledge/SOPs/SOP-002-convert-mypka-to-sqlite.md into your LLM. Markdown stays canonical. SQLite becomes a fast lookup layer on top.
• Imports from any PKM tool. Drop your existing notes (Heptabase backup, Notion export, Obsidian vault, Roam graph, Logseq folder, Apple Notes export, Evernote dump, Tana via MCP, etc.) anywhere on disk, then ask your LLM something like "import my Notion export from ~/Downloads/notion.zip" or "how do I bring in my Heptabase backup?". The scaffold ships with [[Team Knowledge/Workstreams/WS-002-import-external-knowledge-base]] — the LLM follows it to extract entities (people, organizations, projects, goals, habits, topics, key elements, documents), normalize wikilinks to the slug form, copy attachments into PKM/Images/YYYY/MM/, and place files into the right folders, asking clarifying questions where needed and never overwriting your myPKA without explicit approval. Works with any LLM that reads AGENTS.md.

There is no lock-in. The whole system is text on your disk. It works in Obsidian today. It upgrades to SQLite when you want it. It runs on whichever model or LLM you prefer, and it keeps running when you switch.

Who this is for

• Knowledge workers who want a local folder setup instead of handing over their knowledge to Notion, Tana etc. and want an AI team that actually files things. Transparent and accessible.
• Founders and operators running multiple projects who need a knowledge system that thinks across People, Topics, Goals, Habits, and Key Elements without manual cross-linking.
• Parents and generalists with too many inputs (school stuff, health stuff, ideas, contacts) and no structure to hold it.
• AI tinkerers who want a real reference architecture for a multi-agent setup, not a toy demo.

If you've ever opened a blank Obsidian vault and didn't know where to put anything, this is for you. (Yes — myPKA is fully Obsidian-compatible. Open the folder as an Obsidian vault and everything just works.)

Meet the team

Six specialists ship pre-loaded. You only ever talk to Larry. Larry routes.