career ops
- Repo stars 48,511
- License MIT
- Author repo career-ops
- Domain
- AI
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 94 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @santifer · MIT
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Write / modify
- Shell exec
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# career-ops -- Router
## Mode Routing
Determine the mode from `$mode`:
| Input | Mode |
|-------|------|
| (empty / no args) | `discovery` -- Show command menu |
| JD text or URL (no sub-command) | **`auto-pipeline`** |
| `oferta` | `oferta` |
| `ofertas` | `ofertas` |
| `contacto` | `contacto` |
| `deep` | `deep` |
| `interview-prep` | `interview-prep` |
| `pdf` | `pdf` |
| `training` | `training` |
| `project` | `project` |
| `tracker` | `tracker` |
| `pipeline` | `pipeline` |
| `apply` | `apply` |
| `scan` | `scan` |
| `batch` | `batch` |
| `patterns` | `patterns` |
| `followup` | `followup` |
| `update` | `update` |
**Auto-pipeline detection:** If `$mode` is not a known sub-command AND contains JD text (keywords: "responsibilities", "requirements", "qualifications", "about the role", "we're looking for", company name + role) or a URL to a JD, execute `auto-pipeline`.
If `$mode` is not a sub-command AND doesn't look like a JD, show discovery.
---
## Discovery Mode (no arguments)
Show this menu:
```
career-ops -- Command Center
Available commands:
/career-ops {JD} → AUTO-PIPELINE: evaluate + report + PDF + tracker (paste text or URL)
/career-ops pipeline → Process pending URLs from inbox (data/pipeline.md)
/career-ops oferta → Evaluation only A-F (no auto PDF)
/career-ops ofertas → Compare and rank multiple offers
/career-ops contacto → LinkedIn power move: find contacts + draft message
/career-ops deep → Deep research prompt about company
/career-ops interview-prep → Generate company-specific interview prep doc
/career-ops pdf → PDF only, ATS-optimized CV
/career-ops training → Evaluate course/cert against North Star
/career-ops project → Evaluate portfolio project idea
/career-ops tracker → Application status overview
/career-ops apply → Live application assistant (reads form + generates answers)
/career-ops scan → Scan portals and discover new offers
/career-ops batch → Batch processing with parallel workers
/career-ops patterns → Analyze rejection patterns and improve targeting
/career-ops followup → Follow-up cadence tracker: flag overdue, generate drafts
/career-ops update → Update career-ops system files with diff preview + compat check
Inbox: add URLs to data/pipeline.md → /career-ops pipeline
Or paste a JD directly to run the full pipeline.
```
---
## Context Loading by Mode
After determining the mode, load the necessary files before executing:
### Modes that require `_shared.md` + their mode file:
Read `modes/_shared.md` + `modes/{mode}.md`
Applies to: `auto-pipeline`, `oferta`, `ofertas`, `pdf`, `contacto`, `apply`, `pipeline`, `scan`, `batch`
### Standalone modes (only their mode file):
Read `modes/{mode}.md`
Applies to: `tracker`, `deep`, `interview-prep`, `training`, `project`, `patterns`, `followup`
### Modes delegated to subagent:
For `scan`, `apply` (with Playwright), and `pipeline` (3+ URLs): launch as Agent with the content of `_shared.md` + `modes/{mode}.md` injected into the subagent prompt.
```
Agent(
subagent_type="general-purpose",
prompt="[content of modes/_shared.md]\n\n[content of modes/{mode}.md]\n\n[invocation-specific data]",
description="career-ops {mode}"
)
```
Execute the instructions from the loaded mode file.
Sections and files
Listed in source order.
sections -> Mode Routing → Discovery Mode (no arguments) → Context Loading by Mode → Modes that require shared.md + their mode file: → Standalone modes (only their mode file): → Modes delegated to subagent:
terms -> auto-pipeline · Auto-pipeline detection · If $mode is not a sub-command AND doesn't look like a JD, show discovery. · Inbox: add URLs to data/pipeline.md → /career-ops pipeline Or paste a JD directly to run the full pipeline. · Execute the instructions from the loaded mode file.
files/cmd -> $mode · discovery · auto-pipeline · oferta · ofertas · contacto · deep · interview-prep
body sha256 -> 9c24cd0ebc9e
Mode Routing
Determine the mode from
$mode: Input · Mode (empty / no args) ·discovery-- Show command menu JD text or URL (no sub-command) ·auto-pipelineoferta·ofertaDiscovery Mode (no arguments)
Show this menu:
Context Loading by Mode
After determining the mode, load the necessary files before executing:
Modes that require shared.md + their mode file:
Read
modes/_shared.md+modes/{mode}.mdApplies to:auto-pipeline,oferta,ofertas,pdf,contacto,apply,pipeline,scan,batchStandalone modes (only their mode file):
Read
modes/{mode}.mdApplies to:tracker,deep,interview-prep,training,project,patterns,followup