Personal Corp OS

Personal Corp is a way to run a one-person company through AI agents: tasks out of your head, departments instead of one person's memory, a weekly retro instead of "I'll sort it out someday".

This repo holds everything you need for that: the story of how the system works, templates for the HQ and a department, and the open skills for Claude Code and Codex.

By Ris — AI development & vibecoding.

Русская версия: README.ru.md.

Not because you work too little. Because strategy, memory, coordination, execution, and acceptance all sit in one pile — inside your head. While that is true, your department's throughput equals yours.

Hiring does not fix it: a new person takes the work but not the context, so you keep explaining. AI alone does not fix it either: an agent without context is the same new hire, except it does not remember yesterday.

The issue is not model strength. The issue is that context never leaves your head.

Agent rules are a plain text file sitting in a folder. No magic: text you read with your eyes and edit by hand.

Such a file lives in every folder, and its content differs.

Opening a folder, the agent learns three things from that file.

Those three answers replace a long prompt. The agent gets them from the folder instead of your message, so you stop explaining the same thing every time.

Start the agent from the HQ and it reads the HQ rules and sees the map of the whole system. Start it from a department and it reads the department rules and sees that domain, its tasks, and its skills. Same model, different view, set by the folder rather than by a long prompt.

Everything else follows from that: for this to work, context has to leave your head into files, and those files have to sit in folders that carry rules.

A department is a folder that owns one domain and accumulates experience about it. Inside it has its own rules, its own tasks, and its own skills.

I run about thirty. These are the usual first ones:

A department exists for repetition. Work that happened once is fine living in the HQ.

A skill is a written-down way of working that can be repeated. You walk the work by hand once, write the steps down, and from then on the agent runs them.

A subagent lives only in the operations layer: it does not write truth about the system and does not accept results.

One test for any file: is this truth about the system, or is it the result of work? Truth sits in the folder from day one. Results are created by skills once there is something to record. That is why the templates ship no empty files for future reports, decisions, or glossaries.

graph LR
    A["Task<br/>owner + criteria"] --> B["Execution<br/>human or agent"]
    B --> C["Acceptance<br/>good enough or not"]
    C --> D["Pattern<br/>what worked"]
    D --> E["Department memory<br/>rules and decisions"]
    E --> F["Priority<br/>next week"]
    F --> A
    style A fill:#8b5cf6,color:#fff
    style C fill:#f59e0b,color:#fff
    style E fill:#10b981,color:#fff

1. Writing the task down. A thought becomes a task once it has an owner, done criteria, and a place to live. Before that it lives in you. After that both a human and an agent can pick it up.

2. Experience accumulating in departments. Artifacts and decisions settle in a department — a separate folder for its own domain. Next time the agent reads the department instead of reading you.

3. Retro with the agent. Once a week you look at what worked and promote it into rules. Whatever you corrected twice becomes a written rule and stops needing you.

Three links on their own are a feature list. The rhythm turns them into a system.

graph LR
    R["retro<br/>what worked"] --> P["planning<br/>priorities of the week"]
    P --> D["daily<br/>living full-week view"]
    D --> T["tasks<br/>into departments"]
    T --> E["execution<br/>the trace goes back into the task"]
    E --> R
    style R fill:#f59e0b,color:#fff
    style P fill:#3b82f6,color:#fff
    style D fill:#64748b,color:#fff
    style T fill:#8b5cf6,color:#fff
    style E fill:#10b981,color:#fff

The rhythm answers the question that usually stays unanswered: when exactly does experience turn into a rule. Answer: at the retro, once a week, not "someday".

The same word gives a different result depending on the folder: "retro" inside a department means a slice of that department, "retro" in the HQ means a slice of the whole system. Folder rules win over general ones.

Each generated department also includes a local daily skill. It refreshes the living WNN-plan.html: the whole ISO week stays visible, past days keep their facts, today is highlighted, future days remain the plan, and browser-only Wealth habits persist locally.

Departments sit next to the HQ, not inside it. Every template file opens with a line stating why it is there and which layer it belongs to.

1. Copy templates/hq to your machine and fill in me.md.
2. Open the agent from that folder and ask it to read AGENTS.md.
3. Create your first department from templates/department next to the HQ and put one real task into it.
4. Install the plugin (see Install) — it brings the weekly-rhythm skills.
5. Run the retro at the end of the week and planning at the start of the next one.

After two such weeks the department has its own memory, and part of the decisions stop going through you.

Your job shrinks to three moves: set the goal, pick the next move, accept the result.

Glossary — CONTEXT.md. Accepted architectural decisions — docs/adr/.

Terminal:

claude plugin marketplace add serejaris/personal-corp-os
claude plugin install personal-corp-os@personal-corp-os
claude plugin details personal-corp-os

Claude Code Desktop or interactive /plugin flow:

1. Open Plugins or /plugin.
2. Add marketplace: serejaris/personal-corp-os.
3. Install personal-corp-os.

This repo includes a Codex plugin manifest at .codex-plugin/plugin.json. Add the marketplace from GitHub, then install the plugin:

codex plugin marketplace add serejaris/personal-corp-os
codex plugin add personal-corp-os@personal-corp-os

After installation, start a new Codex thread and try:

Use Personal Corp skills to plan my week.

The repository was named personal-corp-skills until 2026-08-06. GitHub redirects the old links. The plugin identifier was renamed along with the repository, so remove the installed personal-corp-skills plugin via /plugin in Claude Code and install the new one using the instructions above.

Use this when you want one skill folder instead of the whole plugin:

Install this skill: https://github.com/serejaris/personal-corp-os/tree/main/skills/cc-analytics

Replace cc-analytics with any skill name from the table below.

Custom statusline showing costs, context usage, and git branch with color-coded indicators.

Archived skills are preserved for reference and are not part of the active plugin skill set.

Skills are plain folders. Copy the whole skill directory so optional references and examples are preserved:

cp -r skills/<name> ~/.claude/skills/

• Telegram: @ris_ai — AI development & vibecoding
• YouTube: @serejaris
• vibecoding.phd

MIT

Please report secrets, private data exposure, or exploitable behavior privately. See SECURITY.md.