Create OpenSpec proposal to add profile.md template and framework structure under src/ directory. - Add src/ directory for distributable framework files - Create profile.md template with all required sections - Add CLAUDE.md instructions for Claude Code integration - Ensure framework can be copied and used independently 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
3.0 KiB
3.0 KiB
Applicant Profile
ADDED Requirements
Requirement: Profile Storage
The system SHALL provide a markdown file (src/profile.md) in the distributable framework directory for storing applicant information.
Scenario: Profile file exists with template structure
- WHEN the framework is set up in
src/directory - THEN
src/profile.mdcontains template sections for Personal Information, Professional Summary, Work Experience, Education, Skills, Projects, Certifications, and Languages
Scenario: Profile sections are clearly documented
- WHEN user opens
src/profile.md - THEN each section includes helpful comments explaining what information to include and formatting guidance
Requirement: Profile Schema
The profile markdown SHALL include the following sections with structured information:
- Personal Information (name, email, phone, location, LinkedIn, GitHub)
- Professional Summary (2-3 sentence overview)
- Work Experience (company, position, dates, responsibilities, achievements)
- Education (institution, degree, field, dates, honors)
- Skills (categorized: technical, languages, tools, soft skills)
- Projects (name, description, technologies, link)
- Certifications (name, issuer, date)
- Languages (language, proficiency level)
Scenario: Work experience includes all necessary fields
- WHEN user adds a work experience entry
- THEN template provides fields for company, position, employment period, key responsibilities, and quantifiable achievements
Scenario: Skills are organized by category
- WHEN user lists their skills
- THEN template groups skills into categories (Technical Skills, Programming Languages, Tools & Technologies, Soft Skills)
Requirement: Claude Code Integration
The src/CLAUDE.md file SHALL instruct Claude Code to automatically read profile.md when the user requests help with job applications.
Scenario: Claude Code loads profile for application tasks
- WHEN user asks Claude Code to help with a job application (CV, cover letter, or email) in a directory containing the framework
- THEN Claude Code reads
profile.mdto access applicant information without asking the user to provide it again
Scenario: Profile is used as source of truth
- WHEN generating application documents
- THEN Claude Code uses only information from
profile.md, ensuring consistency across all applications and preventing hallucinations
Requirement: Framework Distribution
The framework SHALL be contained in a src/ directory separate from the development project files.
Scenario: Users can copy framework to use elsewhere
- WHEN user wants to use the job application framework
- THEN they can copy the entire
src/directory to any location and start using it immediately
Scenario: Development and usage are separated
- WHEN working on the framework itself
- THEN changes are made in this repository, and
src/contains only the distributable framework files