pyr0ball 0ba27c3939 docs: mkdocs wiki — installation, user guide, developer guide, reference

Adds a full MkDocs documentation site under docs/ with Material theme.

Getting Started: installation walkthrough, 7-step first-run wizard guide,
Docker Compose profile reference with GPU memory guidance and preflight.py
description.

User Guide: job discovery (search profiles, custom boards, enrichment),
job review (sorting, match scores, batch actions), apply workspace (cover
letter gen, PDF export, mark applied), interviews (kanban stages, company
research auto-trigger, survey assistant), email sync (IMAP, Gmail App
Password, classification labels, stage auto-updates), integrations (all 13
drivers with tier requirements), settings (every tab documented).

Developer Guide: contributing (dev env setup, code style, branch naming, PR
checklist), architecture (ASCII layer diagram, design decisions), adding
scrapers (full scrape() interface, registration, search profile config,
test patterns), adding integrations (IntegrationBase full interface, auto-
discovery, tier gating, test patterns), testing (patterns, fixtures, what
not to test).

Reference: tier system (full FEATURES table, can_use/tier_label API, dev
override, adding gates), LLM router (backend types, complete() signature,
fallback chains, vision routing, __auto__ resolution, adding backends),
config files (every file with field-level docs and gitignore status).

Also adds CONTRIBUTING.md at repo root pointing to the docs site.

2026-02-25 12:05:49 -08:00

3.8 KiB

Raw Blame History

Interviews

The Interviews page is a kanban board that tracks your progress through the interview pipeline after you have applied to a job.

Kanban Stages

Jobs move left to right through the pipeline:

applied → phone_screen → interviewing → offer → hired
                                                    ↓
                                              (any stage) → rejected

Stage	Description
`applied`	Pre-kanban holding area — job applied to but no response yet
`phone_screen`	Initial recruiter/HR screen scheduled or completed
`interviewing`	Active interview loop (first-round, technical, panel, etc.)
`offer`	Offer received; evaluating
`hired`	Offer accepted
`rejected`	Declined or ghosted at any stage (captures `rejection_stage`)

Moving Jobs Between Stages

Drag a job card to the target column, or use the stage-advance button on each card. Moving a job to phone_screen triggers an automatic company research task (see below).

Company Research (Auto-trigger)

When a job moves to phone_screen, Peregrine automatically queues a company research background task (scripts/company_research.py). The research brief is generated in three phases:

SearXNG web scrape — queries the SearXNG meta-search engine (running locally on port 8888) for company information from public sources
SearXNG news snippets — fetches recent news about the company
LLM synthesis — combines the scraped content into a structured brief

The brief includes:

Company overview (mission, size, funding stage)
CEO / leadership summary
Talking points tailored to your role
Optional: Inclusion and Accessibility section (ADA signals, WCAG, ERGs)
Optional: LGBTQIA+ inclusion section (non-discrimination policies, culture signals)

Both optional sections are controlled by candidate_accessibility_focus and candidate_lgbtq_focus booleans in config/user.yaml. They are for personal decision-making only and are never included in applications.

Interview Prep Page

Navigate to page 6 — Interview Prep for a job in the phone_screen or interviewing stage. This page provides:

The full company research brief (generated automatically when the job moved to phone_screen)
A live reference sheet you can keep open during a call
Practice Q&A — a back-and-forth interview simulation powered by your LLM backend

!!! note "Tier requirement" Interview prep is a Paid feature. See Tier System.

Survey Assistant

When a job moves to the survey stage (via the "Survey" button on an applied job), the Survey Assistant page (page 7) becomes active for that job. It helps you complete culture-fit surveys by:

Accepting pasted survey text
Accepting screenshot uploads (analysed by the Moondream2 vision service)
Generating suggested answers via your configured LLM backend

After completing the survey, move the job to phone_screen to continue the pipeline.

!!! note "Tier requirement" Survey assistant is a Paid feature.

Rejection Tracking

When you reject a job from the kanban (at any stage), Peregrine captures the rejection_stage — the stage at which the rejection occurred. This data is available for pipeline analytics.

Email-Driven Stage Updates

If email sync is configured (see Email Sync), Peregrine can automatically advance jobs based on incoming email:

Email classification	Stage action
`interview_request`	Moves job toward `phone_screen` if still `applied`
`rejection`	Moves job to `rejected` (captures `rejection_stage`)
`offer`	Flags job for review; moves toward `offer`
`survey_received`	Moves job to `survey` stage

3.8 KiB Raw Blame History