Resume CRUD Operations Guide

Complete guide to managing resume data using CRUD (Create, Read, Update, Delete) operations.

Overview
Getting Started
Resume Duplication
Natural Language Commands
Script Reference
Common Use Cases
Troubleshooting

Overview

The Resume CRUD system provides granular control over every section of your resume through specialized command-line scripts. Instead of manually editing JSON files, you can use simple commands to update your resume data.

Key Benefits

Natural Language Friendly: Use resume names like "Ford" instead of UUIDs
AI Agent Integration: Works seamlessly with the AI agent for voice-like commands
Automatic Updates: Timestamps and indexes are automatically maintained
Data Validation: Built-in validation prevents errors
Consistent Interface: All scripts follow the same patterns

Architecture

src/crud/
├── __init__.py              # Shared utilities
├── basic_info.py            # Name, title, location, contact
├── summary.py               # Resume summary text
├── technical_skills.py      # Technical proficiencies by category
├── expertise.py             # Areas of expertise
├── achievements.py          # Achievements
├── education.py             # Education entries
├── certifications.py        # Certification entries
└── experience.py            # Work experience and bullets

Getting Started

Prerequisites

Python 3.8+
Resume data in data/resumes/ directory
Resume index at data/resumes/index.json

Basic Usage Pattern

All CRUD scripts follow this pattern:

python src/crud/{script}.py --resume "{resume_name}" {operation} {parameters}

Example:

python src/crud/expertise.py --resume "Master Resume" --list

Finding Your Resume

Scripts can find resumes by name (case-insensitive, partial match):

# These all work:
--resume "Master Resume"
--resume "master"
--resume "Ford"
--resume "Sidney_Jones_Senior_Software_Engineer_Ford"

# Or use UUID directly:
--resume-id "b3013a2a-349a-4080-802c-3bbe6714b576"

Resume Duplication

Before making granular updates with CRUD scripts, you often need to create a copy of an existing resume. The duplicate_resume.py script makes this easy.

Quick Start

# Duplicate by resume name
python src/duplicate_resume.py --resume "Ford" --new-name "Sidney_Jones_Engineering_Manager_Subscription_Billing"

# Duplicate master resume
python src/duplicate_resume.py --resume "Master Resume" --new-name "Sidney_Jones_Senior_Engineer_NewCo"

# Duplicate with description
python src/duplicate_resume.py --resume "Ford" --new-name "New Resume" --description "Tailored for X position"

# Duplicate by UUID
python src/duplicate_resume.py --resume-id "d474d761-18f2-48ab-99b5-9f30c54f75b2" --new-name "New Resume Name"

Parameters

Parameter	Required	Description
`--resume`	Yes*	Source resume name or company identifier (e.g., "Ford", "Master Resume")
`--resume-id`	Yes*	Alternative: Source resume UUID for direct lookup
`--new-name`	Yes	Name for the duplicated resume
`--description`	No	Optional description for the new resume
`--data-dir`	No	Data directory path (default: "data")

*Either --resume or --resume-id must be provided.

Natural Language Examples

The AI agent can translate natural language commands into duplication operations:

Natural Language	Command
"Using the Ford resume, create a new one for the Subscription Billing position"	`python src/duplicate_resume.py --resume "Ford" --new-name "Sidney_Jones_Engineering_Manager_Subscription_Billing"`
"Duplicate the Master Resume"	`python src/duplicate_resume.py --resume "Master Resume" --new-name "Sidney_Jones_Senior_Engineer_Copy"`
"Copy my Ford resume for a new company"	`python src/duplicate_resume.py --resume "Ford" --new-name "Sidney_Jones_Senior_Engineer_NewCo"`

Typical Workflow

Duplicate an existing resume (Master Resume or company-specific resume)
Update specific sections using CRUD scripts (optional)
Tailor the resume to a job description using tailor.py (optional)

Example:

# Step 1: Duplicate the Ford resume
python src/duplicate_resume.py --resume "Ford" --new-name "Sidney_Jones_Engineering_Manager_Subscription_Billing"

# Step 2: Update the title (optional)
python src/crud/basic_info.py --resume "Subscription_Billing" --update-title "Engineering Manager - Subscription Billing"

# Step 3: Tailor to job posting (optional)
python src/tailor.py --resume "Subscription_Billing" --jd "data/job_listings/subscription_billing.md" --out "out/subscription_billing.html" --format html

Natural Language Commands

The AI agent can translate natural language into CRUD commands:

Basic Info

Natural Language	Command
"Update my title to Principal Architect"	`python src/crud/basic_info.py --resume "Master Resume" --update-title "Principal Architect"`
"Change my email to new@email.com"	`python src/crud/basic_info.py --resume "Master Resume" --update-email "new@email.com"`
"Show my contact information"	`python src/crud/basic_info.py --resume "Master Resume" --show`

Technical Skills

Natural Language	Command
"Add Python to my programming languages"	`python src/crud/technical_skills.py --resume "Master Resume" --append-to-category "languages" "Python"`
"Update my cloud skills to include GCP"	`python src/crud/technical_skills.py --resume "Master Resume" --append-to-category "cloud" "GCP"`
"List my technical skills"	`python src/crud/technical_skills.py --resume "Master Resume" --list`

Expertise

Natural Language	Command
"Add AI/ML Engineering to my expertise"	`python src/crud/expertise.py --resume "Master Resume" --add "AI/ML Engineering"`
"Remove Legacy Systems from my expertise"	`python src/crud/expertise.py --resume "Master Resume" --delete "Legacy Systems"`
"List my areas of expertise"	`python src/crud/expertise.py --resume "Master Resume" --list`

Certifications

Natural Language	Command
"Add my AWS certification"	`python src/crud/certifications.py --resume "Master Resume" --add --name "AWS Solutions Architect" --issuer "Amazon" --date "Oct 2025"`
"Update my PSM I certification date"	`python src/crud/certifications.py --resume "Master Resume" --update --name "PSM I" --date "June 2023"`
"List my certifications"	`python src/crud/certifications.py --resume "Master Resume" --list`

Experience

Natural Language	Command
"Add a bullet to my Microsoft experience"	`python src/crud/experience.py --resume "Master Resume" --add-bullet --employer "Microsoft" --text "Led team of 10 engineers" --tags "Leadership"`
"List my work experience"	`python src/crud/experience.py --resume "Master Resume" --list`

Script Reference

1. Basic Info

Purpose: Manage name, title, location, and contact information

Operations:

# Update individual fields
--update-name "John Doe"
--update-title "Principal Software Architect"
--update-location "Remote"
--update-email "john@example.com"
--update-phone "(555) 123-4567"

# Show current info
--show

Example:

python src/crud/basic_info.py --resume "Ford" --update-title "Senior Solutions Architect"

2. Summary

Purpose: Manage resume summary text

Operations:

# Replace entire summary
--update "New summary text..."

# Append to existing summary
--append "Additional text."

# Load from file
--from-file "summary.txt"

# Show current summary
--show

Example:

python src/crud/summary.py --resume "Ford" --append "Extensive experience with Kubernetes and cloud-native technologies."

3. Technical Skills

Purpose: Manage technical proficiencies organized by category

Categories: ai, cloud, databases, devops, languages, opensource, os, security

Operations:

# Add new category
--add-category "security" "OAuth, JWT, SAML"

# Update category (replace)
--update-category "cloud" "Azure, AWS, GCP"

# Append to category
--append-to-category "languages" "Rust, Go"

# Delete category
--delete-category "security"

# List all categories
--list

# Show specific category
--show "cloud"

Example:

python src/crud/technical_skills.py --resume "Ford" --append-to-category "devops" "Kubernetes, Helm"

4. Areas of Expertise

Purpose: Manage areas of expertise (array of strings)

Operations:

# Add expertise area
--add "AI/ML Engineering"

# Update expertise area
--update "Old Text" "New Text"

# Delete expertise area
--delete "Text to remove"

# Clear all
--clear

# List all
--list

Example:

python src/crud/expertise.py --resume "Ford" --add "Cloud-Native Architecture"

5. Achievements

Purpose: Manage achievements (array of strings)

Operations: Same as expertise (--add, --update, --delete, --clear, --list)

Example:

python src/crud/achievements.py --resume "Ford" --add "AWS Certified Solutions Architect - Professional"

6. Education

Purpose: Manage education entries

Operations:

# Add education entry
--add --degree "Master of Science" --institution "MIT" --location "Cambridge, MA" --year "2020"

# Update by institution or index
--update --institution "MIT" --year "2021"
--update --index 0 --degree "Master of Computer Science"

# Delete by institution or index
--delete --institution "University of Phoenix"
--delete --index 0

# List all
--list

Example:

python src/crud/education.py --resume "Ford" --add --degree "Master of Science in Computer Science" --institution "Stanford University" --year "2015"

7. Certifications

Purpose: Manage certification entries

Operations:

# Add certification
--add --name "AWS Solutions Architect" --issuer "Amazon" --date "Oct 2025" --credential "ABC123"

# Update by name or index
--update --name "PSM I" --date "June 2023"
--update --index 0 --date "July 2023"

# Delete by name or index
--delete --name "PSM I"
--delete --index 0

# List all
--list

Example:

python src/crud/certifications.py --resume "Ford" --add --name "Certified Kubernetes Administrator" --issuer "CNCF" --date "November 2025"

8. Experience

Purpose: Manage work experience entries and bullets

Operations:

# Add experience entry
--add --employer "Microsoft" --role "Senior Engineer" --dates "2020-2023" --location "Remote"

# Add bullet to experience
--add-bullet --employer "Microsoft" --text "Led team of 10 engineers" --tags "Leadership,Management"

# Update bullet
--update-bullet --employer "Microsoft" --index 0 --text "New bullet text"

# Delete bullet
--delete-bullet --employer "Microsoft" --index 0

# Delete experience entry
--delete --employer "Microsoft"
--delete --index 0

# List all experience
--list

# Import from markdown
--from-markdown "experience.md" --replace

Example:

python src/crud/experience.py --resume "Ford" --add-bullet --employer "Edward Jones" --text "Architected microservices platform serving 13 teams" --tags "Architecture,Microservices,Leadership"

Common Use Cases

Updating Resume for New Job Application

# 1. Update title to match job posting
python src/crud/basic_info.py --resume "Ford" --update-title "Senior Cloud Architect"

# 2. Add relevant skills
python src/crud/technical_skills.py --resume "Ford" --append-to-category "cloud" "Google Cloud Platform"

# 3. Add relevant expertise
python src/crud/expertise.py --resume "Ford" --add "Multi-Cloud Architecture"

# 4. Update summary to emphasize cloud experience
python src/crud/summary.py --resume "Ford" --append "Extensive experience designing and implementing multi-cloud solutions."

Adding New Certification

python src/crud/certifications.py --resume "Master Resume" --add \
  --name "AWS Certified Solutions Architect - Professional" \
  --issuer "Amazon Web Services" \
  --date "November 2025" \
  --credential "AWS-PSA-12345"

Managing Experience Bullets

# List current experience to find employer
python src/crud/experience.py --resume "Master Resume" --list

# Add new bullet
python src/crud/experience.py --resume "Master Resume" --add-bullet \
  --employer "Edward Jones" \
  --text "Led migration of 50+ microservices to Kubernetes, reducing infrastructure costs by 40%" \
  --tags "Kubernetes,Cost Optimization,Migration,Leadership"

# Update existing bullet (index 0)
python src/crud/experience.py --resume "Master Resume" --update-bullet \
  --employer "Edward Jones" \
  --index 0 \
  --text "Spearheaded migration of 50+ microservices to Kubernetes, achieving 40% cost reduction"

Troubleshooting

Resume Not Found

Error: [ERROR] No resume found matching 'Ford'

Solution:

Check available resumes: python src/crud/expertise.py --resume "Master Resume" --list (any script works)
Use exact or partial name from the list
Or use --resume-id with UUID

Invalid Data

Error: [ERROR] Invalid email format: notanemail

Solution: Ensure data matches expected format (emails, phone numbers, etc.)

Permission Errors

Error: [ERROR] Could not save resume

Solution: Check file permissions on data/resumes/ directory

Import Errors

Error: ModuleNotFoundError: No module named 'crud'

Solution: Run scripts from repository root directory

Best Practices

Always use Master Resume as source of truth: Make changes to Master Resume, then duplicate for tailored versions
Use descriptive tags: Tag experience bullets with relevant keywords for better searchability
Keep backups: The system automatically backs up, but consider manual backups before major changes
Test with --list first: Before modifying, use --list to see current state
Use --show for verification: After updates, use --show to verify changes

Support

For issues or questions:

GitHub Issues: #17
Documentation: docs/

FilesExpand file tree

CRUD_OPERATIONS.md

Latest commit

History

CRUD_OPERATIONS.md

File metadata and controls

Resume CRUD Operations Guide

Table of Contents

Overview

Key Benefits

Architecture

Getting Started

Prerequisites

Basic Usage Pattern

Finding Your Resume

Resume Duplication

Quick Start

Parameters

Natural Language Examples

Typical Workflow

Natural Language Commands

Basic Info

Technical Skills

Expertise

Certifications

Experience

Script Reference

1. Basic Info

2. Summary

3. Technical Skills

4. Areas of Expertise

5. Achievements

6. Education

7. Certifications

8. Experience

Common Use Cases

Updating Resume for New Job Application

Adding New Certification

Managing Experience Bullets

Troubleshooting

Resume Not Found

Invalid Data

Permission Errors

Import Errors

Best Practices

Related Documentation

Support