Company Creator

Create agent company packages that conform to the Agent Companies specification.

Spec references:

• Normative spec: docs/companies/companies-spec.md (read this before generating files)
• Web spec: https://agentcompanies.io/specification
• Protocol site: https://agentcompanies.io/

Two Modes

Mode 1: Company From Scratch

The user describes what they want. Interview them to flesh out the vision, then generate the package.

Mode 2: Company From a Repo

The user provides a git repo URL, local path, or tweet. Analyze the repo, then create a company that wraps it.

See references/from-repo-guide.md for detailed repo analysis steps.

Process

Step 1: Gather Context

Determine which mode applies:

• From scratch: What kind of company or team? What domain? What should the agents do?
• From repo: Clone/read the repo. Scan for existing skills, agent configs, README, source structure.

Step 2: Interview (Use AskUserQuestion)

Do not skip this step. Use AskUserQuestion to align with the user before writing any files.

For from-scratch companies, ask about:

• Company purpose and domain (1-2 sentences is fine)
• What agents they need - propose a hiring plan based on what they described
• Whether this is a full company (needs a CEO) or a team/department (no CEO required)
• Any specific skills the agents should have
• How work flows through the organization (see "Workflow" below)
• Whether they want projects and starter tasks

For from-repo companies, present your analysis and ask:

• Confirm the agents you plan to create and their roles
• Whether to reference or vendor any discovered skills (default: reference)
• Any additional agents or skills beyond what the repo provides
• Company name and any customization
• Confirm the workflow you inferred from the repo (see "Workflow" below)

Workflow, how does work move through this company?