Files
Bewerbungszauberer/openspec/changes/add-profile-template/specs/applicant-profile/spec.md
T

69 lines
3.0 KiB
Markdown
Raw Normal View History

# 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.md` contains 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:
1. Personal Information (name, email, phone, location, LinkedIn, GitHub)
2. Professional Summary (2-3 sentence overview)
3. Work Experience (company, position, dates, responsibilities, achievements)
4. Education (institution, degree, field, dates, honors)
5. Skills (categorized: technical, languages, tools, soft skills)
6. Projects (name, description, technologies, link)
7. Certifications (name, issuer, date)
8. 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.md` to 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