Version: 1.1 Last Updated: 2026-01-19 Purpose: Single source of truth for all terminology used across documentation and code
Definition: The complete, append-only professional history of an individual.
Analogy: Blockchain ledger — immutable, comprehensive, chronological.
Usage: The CV is the source of truth from which all derived views are generated.
Location: packages/schema/src/cv.ts, packages/schema/src/curriculum-vitae.ts
Definition: A context-specific, filtered snapshot derived from the CV. Analogy: Light client or state snapshot — optimized for a particular moment or audience. Usage: Generated by applying a Mask to the CV data. Key Insight: Multiple résumés can exist for the same CV, each filtered differently.
Definition: The primary container for a user’s professional identity data.
Contains: Identity information, experiences, education, projects, skills, credentials.
Location: packages/schema/src/profile.ts
API: GET /profiles/:id
Definition: The unique, persistent, verifiable core of a professional persona.
Contains: DID, wallet address, ENS name, external IDs (LinkedIn, GitHub, ORCID).
Invariants: Core thesis, values, and competencies that remain constant across all Masks.
Location: packages/schema/src/identity.ts
Definition: Core attributes that remain unchanged regardless of which Mask is applied. Examples: Professional thesis, ethical boundaries, fundamental competencies. Purpose: Ensures all résumé variations truthfully represent the same person.
The system uses theatrical terminology to describe professional identity presentation. This is non-negotiable — all implementations must honor this covenant.
Definition: A context-specific identity filter that transforms how the CV is presented.
Not: A lie or deception — a perspective on the same underlying truth.
Function: Filters content, adjusts tone, reweights priorities based on context.
Location: packages/schema/src/mask.ts
Cognitive Masks (How you think): | Mask | Function | |——|———-| | Analyst | Data-driven, metrics-focused, empirical reasoning | | Synthesist | Pattern-finding, connecting, systems-thinking | | Observer | Reflective, metacognitive, quality-aware | | Strategist | Forward-looking, goal-oriented, tactical | | Speculator | Creative, hypothetical, exploratory | | Interpreter | Meaning-maker, communicator, translator |
Expressive Masks (How you express): | Mask | Function | |——|———-| | Artisan | Quality-obsessed, process-driven, detail-oriented | | Architect | Design-focused, abstraction-oriented, structural | | Narrator | Story-driven, context-aware, explanatory | | Provoker | Provocative, challenging, opinion-driven | | Mediator | Diplomatic, consensus-seeking, bridge-building |
Operational Masks (How you execute): | Mask | Function | |——|———-| | Executor | Fast, decisive, action-oriented | | Steward | Caring, responsible, ethical | | Integrator | Holistic, connecting silos, coherent | | Custodian | Protective, preserving, maintaining | | Calibrator | Balancing, optimizing, fine-tuning |
Definition: A meaningful temporal period in professional evolution.
Purpose: Divides career into narrative arcs, not just chronological segments.
Location: packages/schema/src/epoch.ts
| Epoch | Description |
|---|---|
| Initiation | Entry, foundational skills, first exposure |
| Emergence | Early growth, finding direction |
| Consolidation | Integration, signature voice development |
| Divergence | Branching experimentation, exploring new paths |
| Mastery | Peak specialization, expert-level proficiency |
| Reinvention | Identity transformation, major pivots |
| Transmission | Teaching, mentoring, sharing knowledge |
| Legacy | Long-term impact, codification of contributions |
Definition: Theatrical contexts/stages that determine which Masks are appropriate.
Latin Origin: “scaenae” = stages (plural of scaena).
Purpose: Different contexts demand different identity presentations.
Location: packages/schema/src/scaenae.ts
| Stage | Context | Typical Masks |
|---|---|---|
| Academica | Educational, research-driven | Analyst, Interpreter |
| Technica | Technical, engineering-focused | Architect, Executor |
| Artistica | Creative, expressive | Artisan, Narrator |
| Civica | Public, civic engagement | Mediator, Steward |
| Domestica | Personal, intimate | Observer, Custodian |
| Occulta | Private, hidden (fully redacted) | N/A |
Definition: Distinct phases of work activity that complement theatrical Scaenae.
Purpose: Describes what kind of work is being done, while Scaenae describe where/for whom.
Relationship to Scaenae: Scaenae = audience context; Activity Frames = work mode.
Location: Referenced in mask-stage affinity matrices (packages/content-model/src/mask-selection.ts)
| Activity Frame | Description | Primary Masks |
|---|---|---|
| Inquiry | Research, exploration, question-formation | Analyst, Observer |
| Design | Ideation, architectural thinking | Architect, Synthesist |
| Construction | Production, implementation | Executor, Artisan |
| Calibration | Testing, refinement, verification | Calibrator, Analyst |
| Transmission | Publishing, dissemination | Narrator, Interpreter |
| Reflection | Retrospective analysis | Observer, Synthesist |
| Negotiation | Alignment, stakeholder engagement | Mediator, Strategist |
| Archival | Documentation, versioning | Custodian, Steward |
Note: Activity Frames and Scaenae are orthogonal dimensions:
Definition: The complete registry of all available Masks for a profile.
Latin Origin: “tabula personarum” = table/list of characters (dramatis personae).
Contains: Mask definitions, activation rules, visibility settings per stage.
Location: packages/schema/src/tabula-personarum.ts
Definition: The interactive timeline showing professional evolution through Epochs.
Latin Origin: “aetas” = age, period, era.
Implementation: D3.js-based visualization in web frontend.
Related Component: apps/web/src/components/AetasTimeline.tsx
Definition: A weighted unit of content generated for a specific Mask/context.
Contains: Content, relevance weight, epoch association, tags.
Purpose: Enables ranking and filtering of CV content for different audiences.
Location: packages/schema/src/narrative.ts
The system uses blockchain concepts as architectural metaphors:
| Blockchain Concept | CV System Equivalent | Meaning |
|---|---|---|
| Ledger | CV (full history) | Complete, append-only record |
| State Snapshot | Résumé | Derived view at a point in time |
| Block | Experience/Project entry | Timestamped, immutable record |
| Consensus | Verification layer | Agreement on claim validity |
| Signature | VC cryptographic proof | Non-repudiable attestation |
| DID | Professional identity | Unique, persistent identifier |
| Zero-Knowledge Proof | Selective disclosure | Prove claims without revealing all data |
| Light Client | Filtered résumé | Minimal view with proof of completeness |
| Soulbound Token | Career milestone badge | Non-transferable achievement record |
Definition: A W3C standard for unique, persistent, verifiable digital identifiers.
Format: did:ethr:0x... or did:web:example.com
Purpose: Enables cryptographic proof of identity ownership.
Standard: W3C DID Core
Definition: A W3C standard for cryptographically signed attestations.
Purpose: Third-party verification of claims (employment, degrees, certifications).
Components: Issuer, Subject, Claims, Proof.
Standard: W3C VC Data Model
Location: packages/schema/src/verification.ts
Definition: A non-transferable blockchain token representing achievements. Purpose: Permanent, verifiable record of career milestones. Difference from NFT: Cannot be sold or transferred — bound to identity.
Definition: A formal verification of a claim by a third party. Examples: Employer confirming employment dates, university confirming degree. Stored As: AttestationLink connecting VC to CV entity.
Definition: An architectural pattern separating core logic from external concerns. Layers:
Benefit: Core logic can be tested independently of HTTP framework or database.
Location: apps/api/src/ follows this pattern
Definition: All data models defined as Zod schemas before any implementation.
Location: packages/schema/ is the single source of truth.
Benefit: Type safety, runtime validation, and auto-generated TypeScript types.
Rule: Never modify data structures without updating schema package first.
Definition: Abstract data access behind interfaces.
Implementation: Dual implementations — MemoryRepository (testing) and PostgresRepository (production).
Location: apps/api/src/db/, apps/orchestrator/src/db/
Definition: Single repository containing multiple packages and applications.
Manager: pnpm with workspaces
Build: Turborepo for dependency graph awareness
Structure: apps/ (deployable), packages/ (shared libraries)
Definition: Rules governing which packages can import from which. Allowed:
content-model, core → schemaForbidden:
schema → any other package (foundational)Definition: The multi-agent workflow coordination service.
Location: apps/orchestrator/
Port: 3002
Functions: Task queue, worker dispatch, GitHub webhook handling, LLM execution.
Definition: Autonomous job search and application automation system. Components:
Location: packages/schema/src/hunter-protocol.ts, docs/HUNTER-PROTOCOL.md
| Role | Responsibility | Constraint |
|---|---|---|
| Architect | Strategic planning, task decomposition | Cannot write code |
| Implementer | Code writing, feature development | Cannot merge own PRs |
| Reviewer | Static analysis, style enforcement | Cannot modify code |
| Tester | Test generation, coverage improvement | Cannot modify production code |
| Maintainer | Final approval, quality gates | Cannot bypass gates |
Definition: The formal “genome” defining repository constraints and growth objectives. Contains: Architecture rules, coding standards, quality gates, agent access policies. Location: Repository root Authority: Human-only modifications; AI cannot change this file.
Definition: Abstract measure of development effort, deliberately NOT time-based. Purpose: Avoids calendar pressure, focuses on capacity investment. Usage: “This feature requires 5 EU” — exact duration depends on velocity. Note: 1 EU is intentionally undefined in hours/days to maintain flexibility.
Definition: A collection of related work items grouped by theme. Current Phases (from roadmap): | Phase | Focus | EU | |——-|——-|—–| | 0 | Philosophical (Hunter + UI) | 12 | | 1 | Monetization (Stripe, billing) | 21 | | 2 | Deployment (Vercel, CI/CD) | 18 | | 3 | Portfolio (docs, demo) | 30 | | 4 | Stabilization (polish, analytics) | 28 | | 5 | Community (content, beta) | 16 | | 6 | Launch (Product Hunt, iteration) | 15 |
Definition: A parallelizable work track within a phase. Example: Phase 0 has Stream 0A (Hunter Protocol) and Stream 0B (Theatrical UI). Purpose: Enables multiple AI assistants to work in parallel without conflicts.
Definition: A work position entry in the CV.
Fields: Role title, organization, dates, description, highlights, skills used.
Location: packages/schema/src/curriculum-vitae.ts
Definition: An educational credential entry. Fields: Institution, degree, field of study, dates, thesis title.
Definition: A portfolio item or significant work output. Fields: Name, role, dates, URL, media gallery, description, skills used.
Definition: A discrete competency with proficiency level. Fields: Name, category, level (beginner/intermediate/advanced/expert), years of experience.
Definition: A formal certification or qualification. Fields: Name, issuing organization, date issued, expiration, credential ID.
Definition: A published work (paper, article, book, etc.). Fields: Title, venue, date, authors, DOI/URL.
Definition: A recognition or honor received. Fields: Title, issuer, date, description.
Definition: Reference data endpoints for Masks, Epochs, and Stages. Purpose: Provide canonical lists for UI dropdowns and validation. Endpoints:
GET /taxonomy/masks — All available masksGET /taxonomy/epochs — All epoch definitionsGET /taxonomy/stages — All scaenae stagesDefinition: Endpoints for generating filtered CV views. Purpose: Transform profile data through mask filters. Endpoints:
POST /profiles/:id/narrative — Generate weighted narrative blocksPOST /profiles/:id/masks/select — Select active mask contextDefinition: Endpoints for generating external formats. Formats:
GET /profiles/:id/export/jsonld — Semantic web format (Schema.org)GET /profiles/:id/export/vc — Verifiable Credential formatGET /profiles/:id/export/pdf — PDF résuméDefinition: Standard observability endpoints. Endpoints:
GET /health — Basic liveness check ({ status: "ok" })GET /ready — Dependency readiness checkGET /metrics — Prometheus-format metrics| Acronym | Full Term |
|---|---|
| ADR | Architecture Decision Record |
| BFF | Backend for Frontend |
| BPMN | Business Process Model and Notation |
| CI/CD | Continuous Integration / Continuous Deployment |
| CRUD | Create, Read, Update, Delete |
| DID | Decentralized Identifier |
| EU | Energy Unit |
| LLM | Large Language Model |
| ORM | Object-Relational Mapping |
| SBT | Soulbound Token |
| VC | Verifiable Credential |
| WAF | Web Application Firewall |
Document Authority: This glossary is the canonical reference for all terminology. When terms are used inconsistently elsewhere, this document takes precedence.