CV Content Editor

<purpose> Edit existing portfolio content by cross-referencing the knowledge base to ensure consistency and accuracy. Maintains the source of truth in `content/knowledge/` while updating presentation-layer files. </purpose>

<when_to_activate> Activate when the user:

• Wants to update an existing case study
• Needs to modify experience highlights
• Wants to refine a variant's messaging
• Asks to improve or expand existing content
• Needs to sync content with knowledge base updates

Trigger phrases: "update", "edit", "modify", "change", "improve", "fix [content]" </when_to_activate>

Two-Way Sync Philosophy

Knowledge Base (Source of Truth)     Presentation Layer (Output)
─────────────────────────────────    ──────────────────────────
content/knowledge/                   content/case-studies/
├── achievements/                    content/experience/
├── stories/                         content/variants/
└── metrics/                         content/blog/
         ↓ generates                         ↑ informs
         ↓                                   ↑
    [EDITING FLOW: Update knowledge → Regenerate presentation]

Content Editing Workflow

Step 1: Identify What to Edit

1. Read the target file user wants to modify
2. Identify which knowledge base entities it draws from
3. Query content/knowledge/index.yaml for relationships

Step 2: Determine Edit Scope

| Edit Type | Scope | Files to Update | |-----------|-------|-----------------| | Factual correction | Knowledge base | Achievement/story → regenerate presentation | | Messaging refinement | Presentation only | Case study/variant directly | | New achievement | Knowledge base first | New achievement → update case study | | Metric update | Knowledge base | Achievement metric → sync to presentation |

Step 3: Execute Edit

For Knowledge Base Updates

1. Edit the source file in content/knowledge/achievements/ or stories/
2. Update content/knowledge/index.yaml if relationships changed
3. Regenerate affected presentation files

For Presentation-Only Updates

1. Read current file
2. Apply targeted edits (preserve structure)
3. Validate against schema

Step 4: Validate Consistency

• Knowledge base and presentation should not contradict
• Metrics should match across files
• Tags/themes should align with index

Edit Patterns

Pattern 1: Update Achievement Metric

User: "Update the Ankr revenue to $2.5M ARR"

Workflow:

1. Edit: content/knowledge/achievements/ankr-15x-revenue.yaml
   - Update metric.value and result section

2. Sync: content/case-studies/04-ankr-rpc.md
   - Update hook.impactMetric
   - Update Results section

3. Sync: content/experience/index.yaml
   - Update Ankr highlights if affected

Pattern 2: Improve Case Study Narrative

User: "Make the ETH staking case study more compelling"

Workflow:

1. Read: content/knowledge/stories/galaxy-compliance-win.yaml
   - Understand the core narrative

2. Read: content/case-studies/01-eth-staking.md
   - Identify weak sections

3. Edit: Case study directly
   - Strengthen hook
   - Add concrete details from story
   - Improve key quote

4. Consider: Backport improvements to story if substantial

Pattern 3: Update Variant for New Role

User: "Update the Bloomberg variant with new achievements"

Workflow:

1. Read: content/knowledge/achievements/*.yaml
   - Find new relevant achievements

2. Read: content/variants/bloomberg-technical-product-manager.yaml
   - Understand current positioning

3. Edit: Variant YAML
   - Add new achievements to relevant sections
   - Update relevance scores
   - Regenerate JSON

4. Validate: Test variant URL still works

Pattern 4: Add New Experience Highlight

User: "Add a highlight about shipping 3 protocols in parallel"

Workflow:

1. Check: Does achievement exist?
   - If not, create in content/knowledge/achievements/

2. Edit: content/experience/index.yaml
   - Add highlight to appropriate company

3. Consider: Update related case study if relevant

Content Validation

After any edit, verify:

Schema Validation

npm run validate

Cross-Reference Check

• [ ] Achievement metrics match case study metrics
• [ ] Experience highlights reflect achievements
• [ ] Variant relevance scores are justified
• [ ] Index relationships are current

Consistency Check

• [ ] Same achievement = same numbers everywhere
• [ ] Company names consistent
• [ ] Dates/periods consistent
• [ ] Tags match knowledge base themes

Common Edit Commands

| User Says | Action | |-----------|--------| | "Update the numbers" | Edit achievement → sync presentation | | "Make it more compelling" | Edit presentation narrative | | "Add this achievement" | Create achievement → update presentation | | "Fix inconsistency" | Identify source of truth → sync all | | "Improve this section" | Targeted presentation edit |

Output Format

When editing, always:

1. Show the diff (what changed)
2. List all files updated
3. Note if knowledge base was modified
4. Suggest running validation

Example output:

Updated files:
- content/knowledge/achievements/ankr-15x-revenue.yaml (metric update)
- content/case-studies/04-ankr-rpc.md (synced metric)

Knowledge base updated: Yes
Run validation: npm run validate