Bewerbungszauberer/openspec/changes/add-application-management/specs/application-management/spec.md

Application Management

ADDED Requirements

Requirement: Application Initialization Command

The system SHALL provide a /new-application slash command that creates a new application workspace with proper folder structure.

Scenario: Create new application with minimal info

• WHEN user runs /new-application "TechCorp - Senior Developer"
• THEN system creates folder src/applications/pending/2025-11-02-TechCorp-Senior-Developer/ with application.md template and empty input/ folder

Scenario: Create application with date prefix

• WHEN application folder is created
• THEN folder name is prefixed with current date in YYYY-MM-DD format for chronological sorting

Scenario: Handle special characters in folder names

• WHEN organization name or job title contains special characters (/, , :, etc.)
• THEN system sanitizes the folder name by replacing invalid characters with hyphens or removing them

Scenario: Application template is created

• WHEN new application is initialized
• THEN application.md file is created with template sections (Organization, Job Title, Research, Match Strategy, Key Messages, Tone, etc.)

Scenario: Input folder is created automatically

• WHEN new application is initialized
• THEN input/ subfolder is created for storing job-related documents

Requirement: Application Structure

Each application workspace SHALL contain a standardized folder structure and files.

Scenario: Folder hierarchy is consistent

• WHEN application is created
• THEN structure is: src/applications/pending/[date-org-title]/application.md and src/applications/pending/[date-org-title]/input/

Scenario: Application template has required sections

• WHEN application.md is created
• THEN it includes sections for: Organization Name, Job Title, Job Description Summary, Research Notes, Match Strategy, Key Messages, Tone of Voice, and Document Checklist

Scenario: Template provides guidance

• WHEN user opens newly created application.md
• THEN each section includes helpful comments explaining what information to include

Requirement: Document Population Command

The system SHALL provide a /populate-application slash command that analyzes input documents and populates application.md.

Scenario: Populate from current directory

• WHEN user runs /populate-application from within an application folder
• THEN system reads all files in input/ subfolder and extracts relevant information

Scenario: Analyze job advertisement

• WHEN input/ contains a job advertisement (PDF, DOCX, TXT, MD)
• THEN system extracts: company name, job title, requirements, responsibilities, keywords, and company culture indicators

Scenario: Analyze email communications

• WHEN input/ contains email files or text
• THEN system extracts: recruiter name, company context, timeline, special instructions, and tone expectations

Scenario: Update application.md with findings

• WHEN input analysis is complete
• THEN system updates relevant sections of application.md with extracted information while preserving any existing manual entries

Scenario: Ask user for missing information

• WHEN critical information cannot be extracted from input files (e.g., no clear job title)
• THEN system prompts user to provide missing details before completing population

Scenario: Handle empty input folder

• WHEN /populate-application is run and input/ folder is empty or doesn't exist
• THEN system informs user to add job-related documents first and explains what types of files are helpful

Requirement: Profile Integration

The application management system SHALL integrate with the existing profile system.

Scenario: Reference profile during population

• WHEN /populate-application runs
• THEN system reads src/profile.md to understand applicant's background for match strategy analysis

Scenario: Profile validation is preserved

• WHEN working with applications
• THEN the existing /validate-profile requirement remains enforced before document generation (to be implemented in future proposal)

Scenario: Match applicant to job requirements

• WHEN populating application
• THEN system identifies which experiences, skills, and projects from profile.md best match the job requirements

Requirement: Claude Code Workflow Instructions

The src/CLAUDE.md file SHALL include instructions for the application management workflow.

Scenario: Instructions explain application lifecycle

• WHEN Claude Code is helping with applications
• THEN it understands the workflow: initialize → add input files → populate → [future: generate documents]

Scenario: Commands are documented

• WHEN user asks how to create an application
• THEN Claude Code can explain /new-application and /populate-application commands

Scenario: Input file guidance is provided

• WHEN user asks what files to add to input folder
• THEN Claude Code suggests: job postings (PDF/DOCX/text), recruiter emails, company research notes, or any relevant context

Requirement: File Format Support

The population command SHALL support multiple input file formats.

Scenario: Read PDF files

• WHEN input/ contains PDF files
• THEN system extracts text content for analysis (Note: Claude Code has built-in PDF reading capability)

Scenario: Read text-based formats

• WHEN input/ contains TXT, MD, or copied text files
• THEN system reads and analyzes content directly

Scenario: Read email formats

• WHEN input/ contains .eml or plain text email content
• THEN system parses sender, subject, body and extracts relevant application context

Scenario: Handle unsupported formats gracefully

• WHEN input/ contains unsupported file types (e.g., images, videos)
• THEN system skips these files with a warning and processes supported formats