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
code
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
- •Read the target file user wants to modify
- •Identify which knowledge base entities it draws from
- •Query
content/knowledge/index.yamlfor 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
- •Edit the source file in
content/knowledge/achievements/orstories/ - •Update
content/knowledge/index.yamlif relationships changed - •Regenerate affected presentation files
For Presentation-Only Updates
- •Read current file
- •Apply targeted edits (preserve structure)
- •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:
code
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:
code
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:
code
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:
code
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
bash
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:
- •Show the diff (what changed)
- •List all files updated
- •Note if knowledge base was modified
- •Suggest running validation
Example output:
code
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