solo-company is a Codex Skill for individual developers who want to turn a rough idea into a validated product step or a small MVP. It routes each request through one focused mode and one primary AI role instead of starting a large process for every task.
- Individual developers exploring and validating startup ideas
- Solo founders and small teams building or operating a product
- Developers who want one assistant to switch roles without losing project context
- Teams that need clear handoffs between planning, design, engineering, QA, and operations
- Product — scope the problem, priorities, user flow, and acceptance criteria.
- UX — clarify information hierarchy, states, labels, and interaction flow.
- Full-stack engineering — inspect and modify frontend, backend, data, permissions, and deployment surfaces.
- QA and release — test normal, error, permission, duplicate-submit, migration, and release paths.
- Operations and customer success — validate real customer workflows, collect feedback, and turn recurring issues into product work.
- Idea — generate and score up to three opportunities, then choose one experiment.
- Validate — test user pain, reachability, and payment behavior with a time-boxed plan.
- MVP — define the smallest useful flow, non-goals, and acceptance criteria.
- Build — implement a focused slice and report evidence and limitations.
- Operate — turn real feedback or metrics into the next product experiment.
Copy this folder into your Codex Skills directory:
<your-codex-home>/skills/solo-product-company
On a default Windows installation, that is commonly:
C:\Users\<your-user>\.codex\skills\solo-product-company
Invoke the skill explicitly with:
$solo-product-company
Then describe the product task. The skill selects a primary role, brings in other roles only when needed, and records what was verified locally versus what still needs real-device, cloud, or founder acceptance.
For ongoing projects, it can keep founder context in docs/founder/ (context.md, ideas.md, decisions.md, experiments.md, backlog.md, and metrics.md).
This is an operating model for a one-person company, not a fully autonomous company. The founder remains responsible for goals, scope, budget, priorities, external publication, production deployment, and final acceptance.
SKILL.md— core workflow and decision boundariesagents/openai.yaml— Codex display metadata and default promptreferences/idea-lab.md— idea scoring and seven-day validation experimentsreferences/output-templates.md— decision-ready artifacts for each modereferences/roles-and-handoffs.md— role contracts and conditional handoffs