CV Knowledge Query

<when_to_activate> Activate when the user:

• Asks "What have I done with [technology/skill]?"
• Wants to find achievements for a specific theme
• Needs metrics for a particular company/period
• Asks "Show me my [type] experience"
• Wants to understand relationships between experiences

Trigger phrases: "find", "search", "what's my experience", "show me", "list achievements" </when_to_activate>

Knowledge Base Schema

Entities (content/knowledge/index.yaml)

entities:
  companies:
    - id: string       # anchorage, microsoft, etc.
      name: string
      period: string
      role: string
      domain: string

  themes:
    - id: string       # institutional-crypto, developer-experience
      label: string
      keywords: [string]

  skills:
    - id: string       # ethereum, api-design
      label: string
      category: string

Relationships

relationships:
  - from: achievement:id
    to: company:id | skill:id | theme:id
    type: achieved_at | demonstrates | belongs_to | contains | generated_from

Achievements (content/knowledge/achievements/*.yaml)

id: string
headline: string
metric:
  value: string
  unit: string
  context: string
situation: string
task: string
action: string
result: string
skills: [string]
themes: [string]
companies: [string]
years: [number]
good_for: [string]

Quick Search (Deterministic Script)

For keyword-based searches, USE THE SCRIPT FIRST — it's faster and consistent:

# Search by keywords
npm run search:evidence -- --terms "crypto,staking,institutional"

# With JSON output for processing
npm run search:evidence -- --terms "crypto,staking" --json

The script returns:

• Matching achievements and stories sorted by relevance
• Relevance scores (strong ≥70%, moderate 40-70%, weak <40%)
• Matched terms, skills, and themes
• Snippets for quick review

Use the script when:

• User asks about specific keywords
• Quick search without deep analysis needed
• Need alignment scoring for job fit

Use manual querying when:

• Deep relationship traversal needed
• Need full STAR narrative (situation, task, action, result)
• Complex cross-referencing across entities

Query Patterns

Query by Theme

User: "What's my institutional crypto experience?"

Script-first approach:

npm run search:evidence -- --terms "institutional,crypto,custody"

For deep dive:

1. Find theme

   institutional-crypto

   in index
2. Query relationships where

   to: theme:institutional-crypto

3. Load matching achievements
4. Return summary with metrics

Output Format:

## Institutional Crypto Experience

### Achievements:
1. **ETH Staking Zero Slashing** (Anchorage, 2024-25)
   - Zero slashing events, Galaxy + institutional clients
   - Skills: ethereum, staking, compliance

2. **L2 Protocol Integrations** (Anchorage, 2024-25)
   - 7+ protocols shipped, 40% faster integration
   - Skills: l2s, compliance

Query by Skill

User: "Show me my API design work"

Process:

1. Find skill

   api-design

   in index
2. Query achievements where

   skills

   includes

   api-design

3. Return with context and metrics

Query by Company

User: "What did I accomplish at Microsoft?"

Process:

1. Find company

   microsoft

   in index
2. Query achievements where

   companies

   includes

   microsoft

3. Include period and role context

Query by Keyword

User: "Find achievements related to revenue growth"

Script-first approach:

npm run search:evidence -- --terms "revenue,growth,ARR"

For manual search:

1. Search theme keywords for "revenue"
2. Search achievement headlines/results for "revenue"
3. Return ranked by relevance

Query for Role Fit

User: "What achievements fit a Platform PM role?"

Script-first approach:

npm run search:evidence -- --terms "platform,infrastructure,api,scale"

For deeper analysis:

1. Parse role keywords: platform, infrastructure, scale
2. Match themes: infrastructure, developer-experience
3. Match

   good_for

   arrays in achievements
4. Return ranked list with reasoning

Response Formats

Summary Format (default)

Found 3 achievements matching "[query]":

1. **[Headline]** ([Company], [Year])
   Metric: [value] [unit]
   Themes: [theme1], [theme2]

2. ...

Detail Format (on request)

## [Achievement Headline]

**Context**: [Company] | [Period] | [Role]
**Impact**: [metric.value] [metric.unit]

### Situation
[situation text]

### Task
[task text]

### Action
[action text]

### Result
[result text]

**Best for**: [good_for items]

Metrics Format (for comparisons)

| Achievement | Metric | Value | Company | Year |
|------------|--------|-------|---------|------|
| [headline] | [unit] | [value] | [company] | [year] |

Cross-Reference Queries

Find Related Achievements

User: "What else relates to the ETH staking work?"

Process:

1. Load

   eth-staking-zero-slashing

   achievement
2. Find shared themes:

   institutional-crypto

   ,

   infrastructure

3. Find shared skills:

   ethereum

   ,

   compliance

4. Query other achievements with overlap
5. Rank by relationship strength

Find Gaps

User: "What skills don't have strong achievements?"

Process:

1. List all skills in index
2. Count achievements per skill
3. Flag skills with <2 achievements
4. Suggest areas for content development

Query Shortcuts

<file_locations>

File Locations

content/knowledge/index.yaml

content/knowledge/achievements/*.yaml

content/knowledge/stories/*.yaml

content/knowledge/metrics/*.yaml

<skill_compositions>

Works Well With

• generate-variant — Query evidence before generating variants
• cv-content-generator — Find achievements for case studies
• generate-story-bank — Search for stories by category </skill_compositions>