 ██╗  ██╗██╗   ██╗███╗   ███╗ █████╗ ███╗   ██╗
 ██║  ██║██║   ██║████╗ ████║██╔══██╗████╗  ██║
 ███████║██║   ██║██╔████╔██║███████║██╔██╗ ██║
 ██╔══██║██║   ██║██║╚██╔╝██║██╔══██║██║╚██╗██║
 ██║  ██║╚██████╔╝██║ ╚═╝ ██║██║  ██║██║ ╚████║
 ╚═╝  ╚═╝ ╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝

  ██████╗ ██████╗ ███╗   ███╗██████╗ ██╗██╗     ███████╗██████╗
 ██╔════╝██╔═══██╗████╗ ████║██╔══██╗██║██║     ██╔════╝██╔══██╗
 ██║     ██║   ██║██╔████╔██║██████╔╝██║██║     █████╗  ██████╔╝
 ██║     ██║   ██║██║╚██╔╝██║██╔═══╝ ██║██║     ██╔══╝  ██╔══██╗
 ╚██████╗╚██████╔╝██║ ╚═╝ ██║██║     ██║███████╗███████╗██║  ██║
  ╚═════╝ ╚═════╝ ╚═╝     ╚═╝╚═╝     ╚═╝╚══════╝╚══════╝╚═╝  ╚═╝

Compile humans into AI agents.

A Claude Code plugin that conducts deep behavioral interviews, reads work artifacts via MCP tools, and generates installable plugins that authentically embody a person's thinking, communication, and decision-making.

How It Works

                    ┌─────────────────────────────────┐
                    │         /compile-human           │
                    └──────────────┬──────────────────┘
                                   │
                    ┌──────────────▼──────────────────┐
                    │      8-Phase Deep Interview      │
                    │                                  │
                    │  1. Identity & Role               │
                    │  2. Communication Style           │
                    │  3. Decision-Making               │
                    │  4. Domain Expertise              │
                    │  5. Work Patterns                 │
                    │  6. Edge Cases                    │
                    │  7. Artifact Analysis (MCP)       │
                    │  8. Calibration & Corrections     │
                    └──────────────┬──────────────────┘
                                   │
                    ┌──────────────▼──────────────────┐
                    │   MCP Source Analysis             │
                    │                                  │
                    │   Notion ─── docs, meeting notes  │
                    │   Asana ──── tasks, projects      │
                    │   Chrome ─── web artifacts        │
                    │   Local ──── files, transcripts   │
                    └──────────────┬──────────────────┘
                                   │
                    ┌──────────────▼──────────────────┐
                    │     Behavioral Profile (YAML)    │
                    │                                  │
                    │   ~/.human-compiler/<name>/      │
                    │   ├── profile.yaml               │
                    │   ├── phases/                    │
                    │   └── artifacts/                 │
                    └──────────────┬──────────────────┘
                                   │
                    ┌──────────────▼──────────────────┐
                    │    Plugin Generator               │
                    │                                  │
                    │    Profile ──► Handlebars ──► Plugin│
                    └──────────────┬──────────────────┘
                                   │
                    ┌──────────────▼──────────────────┐
                    │   Installable Claude Code Plugin  │
                    │                                  │
                    │   <name>-autonomous  (acts)       │
                    │   <name>-advisory   (advises)     │
                    │   /ask-<name>       (consults)    │
                    └─────────────────────────────────┘

Quick Start

# 1. Install the plugin
claude --plugin-dir /path/to/HumanCompiler

# 2. Start the interview
/compile-human

# 3. After all 8 phases, install the generated agent
claude --plugin-dir ~/.human-compiler/<name>/output-plugin/<name>-agent

Features

Deep Behavioral Interview

8 structured phases covering identity, communication, decisions, expertise, workflows, edge cases
10-20 adaptive questions per phase with follow-up probes
Concrete examples over abstractions — captures real behavior, not aspirations

MCP-Powered Artifact Analysis

Reads Notion pages, meeting notes, strategy docs for communication style
Analyzes Asana tasks and projects for work patterns
Cross-references artifacts with interview answers for authenticity

Progressive & Resumable

Saves after every phase — never lose progress
/compile-human resume picks up where you left off
/compile-human status shows progress at a glance

Configurable Autonomy

Autonomous mode (acceptEdits): Agent acts, decides, and communicates as the person
Advisory mode (plan, read-only): Agent recommends in the person's style without acting

Marketplace-Ready Output

Generates a complete Claude Code plugin with manifest, agents, skills, CLAUDE.md
Install via --plugin-dir or distribute through plugin marketplace

Output Plugin Structure

<name>-agent/
├── .claude-plugin/
│   └── plugin.json              # Plugin manifest
├── agents/
│   ├── <name>-autonomous.md     # Full autonomy agent
│   └── <name>-advisory.md       # Advisory-only agent
├── skills/
│   ├── ask-<name>/
│   │   └── SKILL.md             # "What would <name> do?"
│   └── <domain>-advice-<name>/
│       └── SKILL.md             # Expertise-specific skill
└── CLAUDE.md                    # Agent documentation

Commands

| Command | Description | |---------|-------------| | /compile-human | Start a new interview | | /compile-human resume | Resume an interrupted interview | | /compile-human status | Check progress on all profiles | | /compile-human generate | Force-generate plugin from current profile |

Architecture

HumanCompiler/
├── .claude-plugin/plugin.json         # Plugin manifest
├── skills/compile-human/
│   ├── SKILL.md                       # Orchestrator skill
│   ├── interview-guide.md             # Interview methodology
│   └── phase-instructions/            # Per-phase question banks
│       ├── 01-identity.md
│       ├── 02-communication.md
│       ├── 03-decision-making.md
│       ├── 04-domain-expertise.md
│       ├── 05-work-patterns.md
│       ├── 06-edge-cases.md
│       ├── 07-artifact-analysis.md
│       └── 08-calibration.md
├── agents/interviewer.md              # Interview agent persona
├── scripts/
│   ├── profile-manager.ts             # Profile CRUD operations
│   ├── profile-manager-cli.ts         # CLI wrapper
│   ├── generate-plugin.ts             # Profile → Plugin generator
│   └── templates/                     # Handlebars templates
│       ├── plugin.json.hbs
│       ├── agent-autonomous.hbs
│       ├── agent-advisory.hbs
│       ├── skill-ask.hbs
│       ├── skill-task.hbs
│       └── claude-md.hbs
├── tests/                             # Full test suite
│   ├── profile-manager.test.ts
│   ├── template-render.test.ts
│   ├── generate-plugin.test.ts
│   └── e2e-interview-flow.test.ts
├── package.json
└── CLAUDE.md

Profile Schema

The behavioral profile captures:

| Section | What it records | |---------|----------------| | Identity | Role, org, team, responsibilities, goals | | Communication | Writing style, tone spectrum, patterns, vocabulary | | Decision-Making | Framework, prioritization, uncertainty handling, tradeoffs | | Expertise | Domains (with depth), technical skills, industry knowledge | | Work Patterns | Daily routine, tools, collaboration, meetings, task management | | Edge Cases | Conflict resolution, ambiguity, failure response, scenarios | | Artifacts | Analyzed documents, cross-artifact patterns | | Calibration | Corrections, additions, confidence score |

Development

# Install dependencies
bun install

# Run tests
bun test

# Run specific test suite
bun test profile-manager
bun test template-render
bun test generate-plugin
bun test e2e

# Generate a plugin from a profile
bun run scripts/generate-plugin.ts ~/.human-compiler/<name>/profile.yaml

How the Interview Works

Each phase follows a consistent pattern:

Read phase instructions — load the question bank and MCP guidance
Query MCP sources — search Notion, Asana, etc. for relevant artifacts
Conduct adaptive interview — ask questions, follow interesting threads
Cross-reference artifacts — validate answers against real work products
Record structured data — update the YAML profile
Save raw transcript — preserve the full conversation for reference
Summarize and confirm — present findings, ask for corrections
Transition — move to the next phase

The final calibration phase presents the complete profile for review and correction, ensuring the compiled agent is authentically representative.

License

MIT

HumanCompiler

Install / Use

README