Gerstep/HumanCompiler

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

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

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 to Claude Code

README