feat: Add resume update system and cleanup docs

- Add RESUME-STANDARDS.md (constitution), RESUME-UPDATE-RULES.md (entry point) - Add resume sync automation and Kiro steering - Update resume: add Vuetify, Cypress, VueUse; mention Artemis Clinics - Archive old specs and cleanup docs/ folder - Single entry point for AI-agnostic resume updates
2026-09-28 02:21:41 +03:30 · 2025-12-04 13:07:18 +03:30
parent 0076910a32
commit 193e2b6e6d
14 changed files with 1072 additions and 1267 deletions
@@ -0,0 +1,207 @@
+# Resume Sync Steering Rules
+
+This steering file guides Kiro (and other AI agents) on how to handle resume updates and portfolio-resume synchronization.
+
+## Core Reference
+
+**Primary Documentation:** `docs/RESUME-STANDARDS.md`
+
+All resume updates MUST follow the standards documented there. This includes:
+- Content writing rules
+- ATS optimization requirements
+- Portfolio → Resume sync decision matrix
+- Pre-commit checklist
+
+## When User Requests Resume Updates
+
+### Automatic Actions
+
+1. **Read Standards First**
+   - Load `docs/RESUME-STANDARDS.md` into context
+   - Review Core Principles and Content Writing Rules
+   - Check Portfolio → Resume Sync Rules
+
+2. **Analyze Current State**
+   - Read `app/data/resume.en.ts` (current resume)
+   - Read `app/data/portfolio.en.ts` (portfolio data)
+   - Identify differences
+
+3. **Apply Decision Matrix**
+   - For each portfolio item not in resume, determine:
+     - Should it be included? (Use Decision Matrix from RESUME-STANDARDS.md)
+     - Where should it go? (Summary, Work, Skills, Projects)
+     - How should it be phrased? (Apply content transformation rules)
+
+4. **Generate Suggestions**
+   - Write achievement-focused bullets with quantifiable metrics
+   - Ensure AI tools are mentioned with context
+   - Follow action verb guidelines
+   - Avoid all clichés
+
+5. **Validate Before Presenting**
+   - Run through Pre-Commit Checklist
+   - Verify no common mistakes
+   - Ensure 2-page limit maintained
+
+### User Commands
+
+When user says any of these, trigger resume sync workflow:
+
+- "Update my resume"
+- "Sync portfolio to resume"
+- "Add [project/skill/job] to resume"
+- "Review my resume"
+- "Check if resume is up to date"
+
+### Workflow Steps
+
+```
+1. User requests resume update
+   ↓
+2. Load docs/RESUME-STANDARDS.md
+   ↓
+3. Read app/data/resume.en.ts and app/data/portfolio.en.ts
+   ↓
+4. Run scripts/sync-portfolio-to-resume.ts (or manual analysis)
+   ↓
+5. Apply Decision Matrix for each difference
+   ↓
+6. Generate suggestions following Content Writing Rules
+   ↓
+7. Validate against Pre-Commit Checklist
+   ↓
+8. Present suggestions to user
+   ↓
+9. Apply approved changes
+   ↓
+10. Confirm completion
+```
+
+## Key Rules for AI Agents
+
+### Always Do
+
+✅ Read `RESUME-STANDARDS.md` before making suggestions
+✅ Quantify every achievement with metrics
+✅ Mention AI tools with specific context and results
+✅ Use strong action verbs (not "responsible for" or "worked on")
+✅ Follow the 3-line Professional Summary formula
+✅ Group skills into logical categories
+✅ Validate against Pre-Commit Checklist
+
+### Never Do
+
+❌ Use clichés ("results-driven", "team player", "passionate")
+❌ Write generic bullets without metrics
+❌ Add content that exceeds 2-page limit
+❌ Suggest changes without reading standards first
+❌ Include portfolio items that don't meet Decision Matrix criteria
+❌ Use weak action verbs or passive voice
+
+## Sync Script Usage
+
+The project includes `scripts/sync-portfolio-to-resume.ts` for automated analysis.
+
+**To run manually:**
+```bash
+npm run sync-resume
+# or
+node scripts/sync-portfolio-to-resume.ts
+```
+
+**What it does:**
+- Compares portfolio.en.ts with resume.en.ts
+- Identifies new projects, skills, or changes
+- Applies RESUME-STANDARDS.md decision matrix
+- Generates suggestions for updates
+- Provides actionable next steps
+
+**When to suggest running it:**
+- User mentions adding new project to portfolio
+- User asks to update resume
+- User wants to check if resume is current
+
+## Example Interactions
+
+### Example 1: User adds new project to portfolio
+
+**User:** "I just added a new project to my portfolio. Should I add it to my resume?"
+
+**Kiro Response:**
+```
+Let me analyze this for you.
+
+[Reads portfolio.en.ts and resume.en.ts]
+[Applies Decision Matrix from RESUME-STANDARDS.md]
+
+I found a new project: "[Project Name]"
+
+Based on the Decision Matrix:
+✅ This is a client-facing, production project
+✅ It demonstrates relevant skills
+✅ It has measurable impact
+
+Recommendation: YES, add to resume.
+
+Suggested entry for Projects section:
+
+**[Project Name]**
+• [Achievement 1 with metric]
+• [Achievement 2 with metric]
+• [Achievement 3 with technology/impact]
+
+Keywords: [Relevant technologies]
+
+Would you like me to add this to your resume?
+```
+
+### Example 2: User wants to update resume
+
+**User:** "Update my resume with latest portfolio changes"
+
+**Kiro Response:**
+```
+Running portfolio-resume sync analysis...
+
+[Executes sync-portfolio-to-resume.ts logic]
+
+Found 2 items to add:
+
+1. [PROJECT] New Medical Tourism Platform
+   - Suggestion: Add to Work Experience highlights
+   - Reason: Major production project with international impact
+
+2. [SKILL] Cursor AI
+   - Suggestion: Add to "AI-Assisted Development" skills
+   - Reason: Used across multiple projects
+
+Would you like me to:
+a) Add both items
+b) Review each individually
+c) Show me the formatted suggestions first
+```
+
+## Integration with BMad Workflows
+
+This steering file works alongside BMad workflows:
+
+- **BMad Analyst:** Can review resume for market fit
+- **BMad Architect:** Can suggest technical skill emphasis
+- **BMad Tech Writer:** Can refine content clarity
+- **BMad Dev:** Can validate data structure
+
+When in Party Mode or using BMad agents, they should also reference `RESUME-STANDARDS.md` for consistency.
+
+## File References
+
+- **Standards:** `docs/RESUME-STANDARDS.md` (primary reference)
+- **Research:** `docs/research/resume-research-2025.md` (full analysis)
+- **AI Skills:** `docs/research/mension-ai-skills-in-resume-report.md` (AI importance)
+- **Quick Guide:** `docs/resume-content-guide.md` (quick lookup)
+- **Resume Data:** `app/data/resume.en.ts` (live data)
+- **Portfolio Data:** `app/data/portfolio.en.ts` (source data)
+- **Sync Script:** `scripts/sync-portfolio-to-resume.ts` (automation)
+
+---
+
+**Remember:** The goal is to make resume updates effortless, consistent, and standards-compliant, regardless of which AI agent or tool is being used.