@touchskyer/opc
v0.4.5
Published
OPC — One Person Company. Task pipeline with independent multi-role evaluation.
Maintainers
Readme
OPC — One Person Company
A full team in a single Claude Code skill. You're the CEO — OPC is everyone else.
11 specialist agents (PM, Designer, Security, Tester, and more) that review, analyze, build, and brainstorm your code — so you don't have to context-switch between hats.
Why not just ask Claude directly?
You can — and for code-level bugs, a single Claude prompt is often more thorough. We tested both on this repo:
| | Single Claude | OPC (3 agents) |
|---|:---:|:---:|
| Code bugs (variable shadowing, DRY violations, exit codes) | 14 found | 9 found |
| UX issues ("new user runs opc review in terminal expecting a CLI command") | 0 found | 5 found |
Single Claude found more code issues. OPC found different types of issues — things that require thinking from a specific persona's perspective. A security engineer looks for content exposure. A new user tries the install flow and gets confused. A DevOps engineer checks npm packaging. Claude won't switch to these mindsets unless you explicitly ask.
OPC's value isn't finding more bugs. It's finding bugs you wouldn't think to look for.
How It Works
One principle: the agent that does the work never evaluates it.
Task inference — OPC reads your request and picks the right pipeline: review, analysis, build, brainstorm, plan, or full pipeline. Every path ends with independent evaluation.
Parallel specialists — 2-5 role-specific agents run in parallel, each with domain expertise and anti-patterns (what NOT to flag). They don't see each other's output.
Verification gate — the orchestrator checks agent findings: verifies facts, challenges severity, dismisses false positives, and synthesizes a verdict (PASS / ITERATE / FAIL).
Iteration loop — if the verdict is FAIL or ITERATE, the implementer fixes or polishes, and the evaluator re-tests. Up to 10 rounds, with early exit on oscillation.
Quick Start
Install
npm install -g @touchskyer/opcSkill files are automatically copied to ~/.claude/skills/opc/. If the postinstall fails, run opc install manually.
Manual install (no npm)
git clone https://github.com/iamtouchskyer/opc.git
ln -s $(pwd)/opc ~/.claude/skills/opcNote: Symlink tracks the repo —
git pullupdates the skill immediately. Usecp -rinstead if you want a stable snapshot.
Use it
# Review a PR
/opc review the changes in this PR
# Analyze an architecture problem
/opc analyze why the API is slow
# Execute with a plan
/opc implement the migration plan in PLAN.md
# Brainstorm approaches
/opc what are our options for auth?
# Interactive mode — agents ask you questions first
/opc -i review the payment flow
# Explicit roles
/opc security compliance
# Open the report viewer
/opc replayTask Types
| Task type | When | Pipeline | |-----------|------|----------| | Review | PR review, audit, pre-launch | Context brief → multi-role evaluation → verification gate → report | | Analysis | Architecture, performance, diagnosis | Context brief → single deep-role evaluation → report | | Build | Direction is set, implement it | Plan → build → independent evaluation → iterate until PASS | | Brainstorm | Options, trade-offs, alternatives | Role perspectives → comparison table → evaluation → recommendation | | Plan | Scope, decompose, estimate | Task decomposition → evaluation → report | | Verification | QA, test, pre-release check | Context brief → multi-role evaluation (verification tags) → report | | Post-release | User test, onboarding check | Context brief → multi-role evaluation (post-release tags) → report | | Full pipeline | Complex or vague request | Design → Plan → Build → Evaluate → Deliver |
Built-in Roles
Product
| Role | Focus | |------|-------| | PM | Requirements, user value, scope, prioritization | | Designer | Interaction design, information architecture, visual system, accessibility |
User Lens
| Role | Focus | |------|-------| | New User | First impression, onboarding, setup friction, trust signals | | Active User | Workflow efficiency, power features, scale behavior, customization | | Churned User | Re-entry experience, change communication, win-back signals |
Engineering
| Role | Focus | |------|-------| | Frontend | Component architecture, framework patterns, performance, i18n, type safety | | Backend | API design, database, auth, input validation, data consistency | | DevOps | CI/CD, containers, deployment, secrets, monitoring, developer experience |
Quality
| Role | Focus | |------|-------| | Security | Vulnerabilities (OWASP), dependency audit, secrets, auth security, attack surface | | Tester | Boundary cases, state coverage, regression risk, integration points | | Compliance | GDPR/CCPA, WCAG accessibility, license compatibility, industry regulations |
Custom Roles
Add a .md file to roles/ following this format:
# Role Name
## Identity
One sentence: who you are and what you care about.
## Expertise
- **Area** — what you know about it
- **Area** — what you know about it
...
## When to Include
- Condition that triggers this role
- Condition that triggers this role
...The coordinator reads When to Include to decide whether to dispatch your role. It's available immediately — no configuration needed.
If a task needs expertise not covered by any role file, the coordinator creates a temporary role on-the-fly.
How Review Works
You: /opc review this PR
1. Triage → Task type: review
2. Roles → Frontend, Backend, Security (auto-selected from changed files)
3. Brief → Orchestrator builds context from git log, CLAUDE.md, specs
4. Dispatch → 3 role evaluators run in parallel, each with role expertise + context
5. Verify → Mechanical checks auto-reject incomplete outputs (no file:line, no VERDICT).
Orchestrator spot-checks facts, challenges severity, deduplicates.
6. Report → Curated findings with severity, file:line references, and fix suggestionsRequirements
- Claude Code (CLI, desktop app, or IDE extension)
- Node.js ≥ 18 (for npm install only — not needed if you install manually)
- That's it. No runtime dependencies, no build step, no MCP server. Just markdown files.
Works better with memex (optional)
OPC works standalone — but pair it with memex and it learns across sessions. Memex remembers which roles were useful, which findings were false positives, and your project-specific context. OPC doesn't need to know how memex works — memex drives itself.
npm install -g @touchskyer/memexVisualize reports (optional)
OPC saves structured reports to ~/.opc/reports/ after every run. Browse them in a web UI:
npx @touchskyer/opc-viewerOr use /opc replay in Claude Code to open the viewer automatically.
The viewer shows a Slack-like replay of your review team's conversation, plus a filterable summary of findings by severity.
License
MIT
