AGENTS.md · git:20260710.b0db241 · 2026-07-10 · sha256 eaf5005e86e3f424
AGENTS.md git:20260710.b0db241A
Immutable. This exact content never changes and is served at /api/v1/blob/eaf5005e86e3f424.
# AGENTS.md ## Project Overview - Resume-Agent monorepo with `frontend/` and `backend/` - Backend is FastAPI served from `backend/main.py` - Frontend is React + TypeScript + Vite in `frontend/` ## Knowledge Base - Design specs and plans: `knowledge-base/` (committed, version controlled) - Specs: `knowledge-base/specs/YYYY-MM-DD-<topic>-design.md` - Plans: `knowledge-base/plans/YYYY-MM-DD-<feature>.md` - `knowledge/` is local-only and ignored by Git (legacy) - Design docs, plans, reviews, and operation records go in `knowledge-base/` - Exception — domain docs live in place and are committed: root `CONTEXT.md` (glossary), `docs/adr/` (architecture decision records), `docs/agents/` (engineering-skill config). See CLAUDE.md §4.0/§4.4 ## Architecture Notes - Backend agent (`backend/agent/`) was merged back from `resume-agent-core` on 2026-03-23 - No separate agent service on port 9100; agent runs in-process with main backend - `AGENT_BACKEND_BASE_URL` is commented out in `.env` - Active design: natural language resume refactor (see `knowledge-base/specs/2026-03-23-nl-resume-refactor-design.md`) - Active plan: `knowledge-base/plans/2026-03-24-nl-resume-refactor.md` ## Setup - Backend dependencies: `uv pip install -r requirements.txt` - Frontend dependencies: `cd frontend && npm install` ## Run - Backend: `python -m uvicorn backend.main:app --host 127.0.0.1 --port 9000` - Frontend: `cd frontend && npm run dev` ## Testing - Frontend verification: `cd frontend && npm run build` - Backend verification: run targeted checks first; use `pytest` when tests exist or are added ## Deployment - Deploy = `git push origin main`; a server cron auto-pulls, rebuilds (frontend + web), and restarts pm2. - **Before pushing to main, update the `CHANGELOG` array in `frontend/src/data/changelog.ts`:** - Bump `version` (patch +0.0.1, e.g. `2.4.1` → `2.4.2`; larger features +0.1.0) - Set `date` to today, **date only (`YYYY-MM-DD`), never include time**; write `added` / `fixed` as short user-facing Chinese (no tech/ops details) - **Multiple deploys on the same day merge into ONE entry** (fold new items into today's entry and raise its version; do not append another entry) - Commit the changelog together with the release code, then push - Users see a「有什么新变化」modal (`ChangelogModal`) on first visit after each version bump. ## Conventions - Prefer minimal diffs - Do not modify unrelated files - Read existing files and follow existing patterns before editing - Preserve user changes already present in the worktree - Do not move or rename files unless the user asked for it ## Repository Notes - Main app API runs on port `9000` - Root `README.md` is ignored in this repository; do not rely on Git status alone to judge doc changes - `docs/` is not the primary knowledge storage location for local project notes