Files
Resume-Matcher/docs/agent/20-workflow.md
srbhr 1ccdebb6c4 docs: add comprehensive documentation for new features
- Introduced JD Match feature documentation detailing how tailored resumes match job descriptions.
- Added Resume Template Settings documentation outlining template types and formatting controls.
- Created LLM Integration Guide for multi-provider AI support, JSON handling, and prompt guidelines.
- Compiled Agent Documentation Index for modular documentation on AI agents working with Resume Matcher.
- Developed Maintainer Guide for the resume editor, covering architecture, types, and PDF handling.
- Established a Code Review & Technical Debt TODO document to track critical issues and improvements.
2026-01-05 23:36:27 +05:30

1.8 KiB

Workflow: Commits, PRs, and Testing

Git workflow, testing guidelines, and PR conventions.

Commit Guidelines

  • Use concise, sentence-style subjects (e.g., Add custom funding link to FUNDING.yml)
  • Keep messages short
  • If using prefixes, stick to type: summary in the imperative
  • Reference issues with Fixes #123

Examples

Add resume enrichment wizard component
Fix PDF generation timeout on large resumes
Refactor LLM provider configuration

Pull Request Guidelines

  1. Reference issues: Fixes #123 in the description
  2. Call out schema or prompt changes so reviewers can smoke-test downstream agents
  3. List local verification commands you ran
  4. Attach screenshots for UI or API changes

Testing Guidelines

Frontend Testing

  • All contributions must pass npm run lint
  • Add Jest or Playwright suites beneath apps/frontend/__tests__/
  • Name test files *.test.tsx
# Run linter
npm run lint

# Format code
npm run format

Backend Testing

  • Tests belong in apps/backend/tests/
  • Use test_*.py naming convention
  • Seed anonymized resume/job fixtures
# Run tests
cd apps/backend
uv run pytest

Definition of Done

Before marking a PR as ready:

  • Code compiles without errors
  • npm run lint passes
  • New features have tests (or documented reason why not)
  • UI changes follow Swiss International Style
  • Schema/prompt changes are called out in PR description
  • Screenshots attached for UI changes
  • Verified locally with commands listed in PR

Code Review Checklist

  • Type hints on all Python functions
  • Proper error handling (generic to clients, detailed in logs)
  • No exposed secrets or API keys
  • Follows existing patterns in the codebase
  • Documentation updated if needed