knowme-careerforge-skill 0.0.2 → 0.0.4

package/SKILL.md

@@ -2,7 +2,7 @@
 name: knowme-careerforge
 displayName: KnowMe CareerForge
 description: An agent-native skill for self-discovery, career positioning, and tailored resume engineering. Analyzes candidate evidence, maps strengths to target JDs, crafts tailored resumes inside an HTML Intermediate Canvas, self-heals layout/ATS, and exports pixel-perfect PDFs.
-version: 0.0.2
+version: 0.0.4
 ---
 
 # KnowMe CareerForge — Agent Reasoning Contract & Execution Specification
@@ -32,6 +32,16 @@ When this skill is activated, you are NOT a generic text generator. You act as a
   - Execute tool scripts silently in the background.
   - Final response contract: One-line Value Proposition + Top 3 Grounded Evidence Highlights + Direct Output File Paths (`workspace/resume.pdf` and `workspace/resume.html`).
 
+### Reference Manuals (L3 Domain Rules):
+- **Stage 1 (Know Me)**: `references/01-evidence-mining.md`
+- **Stage 2 (Define Goal)**: `references/02-career-goal.md`
+- **Stage 3 (Understand JD)**: `references/03-jd-analysis.md`
+- **Stage 4 (Position & Select)**: `references/04-template-selection.md`
+- **Stage 5 (Forge Canvas)**: `references/05-html-canvas-tokens.md`
+- **Stage 6 (Review & QA)**: `references/06-qa-and-rendering.md`
+
+*See `AGENT.md` for strict editorial standards and `ARCHITECTURE.md` for system architecture.*
+
 ---
 
 ## 2. Input & Content Intelligence Layer (Repo-to-Resume Modes)

package/agents/claude/knowme-careerforge.md

@@ -1,17 +1,18 @@
 ---
 description: An agent-native skill for self-discovery, career positioning, and tailored resume engineering.
-globs: ["workspace/*", "src/**/*", "scripts/**/*"]
+globs: ["workspace/*", "src/**/*", "scripts/**/*", "references/*"]
 ---
 
 # KnowMe CareerForge — Claude Code Skill
 
-Know Yourself. Define Your Direction. Forge Your Opportunity.
+> *"Know Yourself. Define Your Direction. Forge Your Opportunity."*
 
-When activated, follow the Evidence-First & Quiet Execution Protocol (see `scripts/Agent.md`):
-1. **Evidence Mining (repo-to-resume)**: Extract codebase facts via `python3 scripts/evidence/extract-evidence.py --repo .` or run one-shot `python3 scripts/pipeline/forge.py`.
-2. **Understand Target**: Analyze target JD via `python3 scripts/evidence/analyze-jd.py`.
-3. **Template Search**: Match template (`python3 scripts/template/search-template.py`).
-4. **Intermediate Canvas**: Instantiate `workspace/resume.html` via `python3 scripts/template/instantiate-resume.py` and calibrate CSS design tokens.
-5. **Review & Dual QA**: Run `python3 scripts/validation/validate-resume.py`.
-6. **PDF Delivery**: Export `workspace/resume.pdf` via `python3 scripts/rendering/render-pdf.py`.
+When activated, follow the 6-Stage Deterministic Workflow and Quiet Execution Protocol (see `AGENT.md` and `ARCHITECTURE.md`):
+
+1. **Evidence Mining (repo-to-resume)**: Extract codebase facts via `python3 scripts/evidence/extract-evidence.py --repo .` or run one-shot `python3 scripts/pipeline/forge.py` (see `references/01-evidence-mining.md`).
+2. **Define Goal & Archetype**: Establish target seniority tier and capability matrix (see `references/02-career-goal.md`).
+3. **Understand Target**: Analyze target JD via `python3 scripts/evidence/analyze-jd.py` (see `references/03-jd-analysis.md`).
+4. **Template Search**: Match template via `python3 scripts/template/search-template.py` (see `references/04-template-selection.md`).
+5. **Intermediate Canvas**: Instantiate `workspace/resume.html` via `python3 scripts/template/instantiate-resume.py` and calibrate CSS design tokens (see `references/05-html-canvas-tokens.md`).
+6. **Review & Dual QA**: Run `python3 scripts/validation/validate-resume.py` and export `workspace/resume.pdf` via `python3 scripts/rendering/render-pdf.py` (see `references/06-qa-and-rendering.md`).
 7. **Quiet Delivery**: Execute silently in background; deliver concise executive summary and final file path (`workspace/resume.pdf`).

package/agents/codex/knowme-careerforge.yaml

@@ -1,6 +1,6 @@
 name: knowme-careerforge
 description: An agent-native skill for self-discovery, career positioning, and tailored resume engineering.
-version: 0.0.2
+version: 0.0.4
 entrypoint: SKILL.md
 tools:
   - name: forge
@@ -18,7 +18,7 @@ tools:
   - name: render-pdf
     command: python3 scripts/rendering/render-pdf.py
 rules:
-  - "Execute tools silently in background (DO NOT print raw HTML, full CSS, or scripts in chat)."
+  - "Execute tools silently in background with --quiet (DO NOT print raw HTML, full CSS, or scripts in chat)."
   - "Use workspace/resume.html as the sole Intermediate Working Canvas."
   - "Deliver final concise summary and path to workspace/resume.pdf."
-  - "Reference scripts/Agent.md for complete toolchain conventions."
+  - "Reference AGENT.md, ARCHITECTURE.md, and references/01~06 for complete specifications."

package/agents/cursor/knowme-careerforge.mdc

@@ -1,13 +1,17 @@
 ---
 description: KnowMe CareerForge — Agent-native career positioning and resume engineering
-globs: ["workspace/*", "src/**/*", "scripts/**/*"]
+globs: ["workspace/*", "src/**/*", "scripts/**/*", "references/*"]
 ---
 
-# KnowMe CareerForge MDC Rules
+# KnowMe CareerForge MDC Rules (Cursor)
 
-1. **Evidence-First**: Never hallucinate ungrounded claims (strictly L1~L3 evidence).
-2. **Repo-to-Resume**: Extract codebase facts using `python3 scripts/evidence/extract-evidence.py --repo .` or run one-shot `python3 scripts/pipeline/forge.py`.
-3. **HTML Canvas**: Edit exclusively in `workspace/resume.html` Intermediate Working Canvas (`scripts/template/instantiate-resume.py`).
-4. **Quiet Protocol**: Execute scripts silently in background; do not output raw HTML, CSS, or scripts into the chat.
-5. **Deterministic PDF**: Validate via `python3 scripts/validation/validate-resume.py` and export via `python3 scripts/rendering/render-pdf.py`.
-6. **Architecture Guide**: Refer to `scripts/Agent.md` for toolchain domain specifications.
+When activated for career positioning, resume tailoring, or repo-to-resume analysis:
+
+1. **Evidence-First Invariant**: Enforce strict L1~L3 evidence classification (see `references/01-evidence-mining.md`). Never hallucinate ungrounded revenue metrics, fake degrees, or false tenures.
+2. **Repo-to-Resume Extraction**: Extract codebase facts using `python3 scripts/evidence/extract-evidence.py --repo .` or execute the one-shot pipeline `python3 scripts/pipeline/forge.py`.
+3. **Target Alignment & JD Parsing**: Analyze target Job Descriptions using `python3 scripts/evidence/analyze-jd.py` (see `references/03-jd-analysis.md`).
+4. **Template Search**: Match template via `python3 scripts/template/search-template.py "<Target Role>"` (see `references/04-template-selection.md`).
+5. **HTML Canvas Editing**: Edit exclusively in `workspace/resume.html` Intermediate Working Canvas (`scripts/template/instantiate-resume.py`). Calibrate CSS variables (`--resume-*`) in `:root` (see `references/05-html-canvas-tokens.md`).
+6. **Dual QA & Deterministic PDF**: Validate layout height ($297\text{mm} \le 1122.5\text{px}$) and ATS via `python3 scripts/validation/validate-resume.py`. Export final vector PDF via `python3 scripts/rendering/render-pdf.py`.
+7. **Quiet Execution Protocol**: Execute all tools silently with `--quiet`. Never output raw HTML/CSS into the chat. Deliver concise value proposition and direct output file paths.
+8. **Authoritative Guide**: Refer to root `AGENT.md` for Vercel-inspired editorial standards and `ARCHITECTURE.md` for system design.

package/agents/opencode/skill.yaml

@@ -1,7 +1,7 @@
 name: knowme-careerforge
 displayName: KnowMe CareerForge
 description: An agent-native skill for self-discovery, career positioning, and tailored resume engineering.
-version: 0.0.2
+version: 0.0.4
 schema: 1.0
 entrypoint: SKILL.md
 tags:

package/agents/windsurf/knowme-careerforge.rules

@@ -2,12 +2,12 @@
 # Trigger: Career discovery, resume tailoring, JD analysis, repo-to-resume
 
 When user requests resume tailoring, project analysis, or career positioning:
-1. Extract candidate facts using `python3 scripts/evidence/extract-evidence.py --repo .` or execute one-shot `python3 scripts/pipeline/forge.py`.
-2. Tag all experience items with Evidence Level (L1~L3 only, strictly anti-hallucination).
-3. Analyze target JD requirements using `python3 scripts/evidence/analyze-jd.py`.
-4. Recommend best template using `python3 scripts/template/search-template.py`.
-5. Instantiate `workspace/resume.html` using `python3 scripts/template/instantiate-resume.py` and calibrate CSS design tokens.
-6. Validate DOM fit and ATS compatibility using `python3 scripts/validation/validate-resume.py`.
-7. Export final deterministic PDF using `python3 scripts/rendering/render-pdf.py`.
-8. Execute silently in background; deliver concise executive summary and final file path (`workspace/resume.pdf`).
-9. Reference `scripts/Agent.md` for toolchain domain specifications.
+1. **Evidence Mining**: Extract candidate facts using `python3 scripts/evidence/extract-evidence.py --repo .` or execute one-shot `python3 scripts/pipeline/forge.py`.
+2. **Anti-Hallucination Gate**: Tag all experience items with Evidence Level (L1~L3 only, see `references/01-evidence-mining.md`).
+3. **JD & Signal Analysis**: Analyze target JD requirements using `python3 scripts/evidence/analyze-jd.py` (see `references/03-jd-analysis.md`).
+4. **Template Search**: Recommend best template using `python3 scripts/template/search-template.py` (see `references/04-template-selection.md`).
+5. **Canvas Instantiation**: Instantiate `workspace/resume.html` using `python3 scripts/template/instantiate-resume.py` and calibrate CSS design tokens (see `references/05-html-canvas-tokens.md`).
+6. **Dual QA Verification**: Validate DOM fit ($297\text{mm} \le 1122.5\text{px}$) and ATS compatibility using `python3 scripts/validation/validate-resume.py`.
+7. **Deterministic PDF Export**: Export final vector PDF using `python3 scripts/rendering/render-pdf.py` (see `references/06-qa-and-rendering.md`).
+8. **Quiet Delivery**: Execute silently in background (`--quiet`); deliver concise value proposition and direct output file paths (`workspace/resume.pdf`).
+9. **Authoritative Guide**: Refer to root `AGENT.md` for editorial standards and `ARCHITECTURE.md` for system architecture.

package/dist/cli/src/commands/init.js

@@ -93,7 +93,10 @@ function runInit(options) {
                     fs.mkdirSync(claudeDir, { recursive: true });
                     copyDirRecursive(path.join(rootDir, 'scripts'), path.join(claudeDir, 'scripts'));
                     copyDirRecursive(path.join(rootDir, 'src'), path.join(claudeDir, 'src'));
+                    copyDirRecursive(path.join(rootDir, 'references'), path.join(claudeDir, 'references'));
                     fs.copyFileSync(path.join(rootDir, 'SKILL.md'), path.join(claudeDir, 'SKILL.md'));
+                    fs.copyFileSync(path.join(rootDir, 'AGENT.md'), path.join(claudeDir, 'AGENT.md'));
+                    fs.copyFileSync(path.join(rootDir, 'ARCHITECTURE.md'), path.join(claudeDir, 'ARCHITECTURE.md'));
                     fs.copyFileSync(path.join(rootDir, 'skill.json'), path.join(claudeDir, 'skill.json'));
                     console.log(`[✓] Claude Code Skill fully bundled -> ${claudeDir}`);
                     break;
@@ -103,7 +106,10 @@ function runInit(options) {
                     fs.mkdirSync(codexDir, { recursive: true });
                     copyDirRecursive(path.join(rootDir, 'scripts'), path.join(codexDir, 'scripts'));
                     copyDirRecursive(path.join(rootDir, 'src'), path.join(codexDir, 'src'));
+                    copyDirRecursive(path.join(rootDir, 'references'), path.join(codexDir, 'references'));
                     fs.copyFileSync(path.join(rootDir, 'SKILL.md'), path.join(codexDir, 'SKILL.md'));
+                    fs.copyFileSync(path.join(rootDir, 'AGENT.md'), path.join(codexDir, 'AGENT.md'));
+                    fs.copyFileSync(path.join(rootDir, 'ARCHITECTURE.md'), path.join(codexDir, 'ARCHITECTURE.md'));
                     fs.copyFileSync(path.join(rootDir, 'skill.json'), path.join(codexDir, 'skill.json'));
                     if (fs.existsSync(path.join(rootDir, 'agents', 'codex', 'knowme-careerforge.yaml'))) {
                         fs.copyFileSync(path.join(rootDir, 'agents', 'codex', 'knowme-careerforge.yaml'), path.join(codexDir, 'skill.yaml'));
@@ -139,7 +145,10 @@ function runInit(options) {
                     fs.mkdirSync(opencodeDir, { recursive: true });
                     copyDirRecursive(path.join(rootDir, 'scripts'), path.join(opencodeDir, 'scripts'));
                     copyDirRecursive(path.join(rootDir, 'src'), path.join(opencodeDir, 'src'));
+                    copyDirRecursive(path.join(rootDir, 'references'), path.join(opencodeDir, 'references'));
                     fs.copyFileSync(path.join(rootDir, 'SKILL.md'), path.join(opencodeDir, 'SKILL.md'));
+                    fs.copyFileSync(path.join(rootDir, 'AGENT.md'), path.join(opencodeDir, 'AGENT.md'));
+                    fs.copyFileSync(path.join(rootDir, 'ARCHITECTURE.md'), path.join(opencodeDir, 'ARCHITECTURE.md'));
                     fs.copyFileSync(path.join(rootDir, 'skill.json'), path.join(opencodeDir, 'skill.json'));
                     console.log(`[✓] OpenCode Skill fully bundled -> ${opencodeDir}`);
                     break;

package/dist/cli/src/index.js

@@ -53,6 +53,17 @@ function findPackageRoot(startDir) {
     }
     return path.resolve(startDir, '../../..');
 }
+function getVersion(rootDir) {
+    try {
+        const pkgJson = path.join(rootDir, 'package.json');
+        if (require('fs').existsSync(pkgJson)) {
+            const data = JSON.parse(require('fs').readFileSync(pkgJson, 'utf-8'));
+            return data.version || '0.0.4';
+        }
+    }
+    catch { }
+    return '0.0.4';
+}
 function showHelp() {
     console.log(`
 ======================================================================
@@ -179,6 +190,12 @@ function main() {
             child_process.spawnSync('python3', [scriptPath], { stdio: 'inherit' });
             break;
         }
+        case '--version':
+        case '-v':
+        case 'version': {
+            console.log(getVersion(rootDir));
+            break;
+        }
         case 'help':
         case '--help':
         case '-h':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "knowme-careerforge-skill",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "An agent-native skill for self-discovery, career positioning, and tailored resume engineering.",
   "main": "dist/cli/src/index.js",
   "bin": {
@@ -30,6 +30,7 @@
     "build:knowledge": "python3 scripts/build/build-knowledge.py",
     "build:gallery": "python3 scripts/build/build-gallery.py",
     "release": "python3 scripts/build/release.py",
+    "version:sync": "python3 scripts/build/sync-version.py",
     "prepublishOnly": "npm run build && npm test"
   },
   "keywords": [

package/scripts/build/sync-version.py

@@ -79,8 +79,17 @@ def sync_version(new_version: str):
         new_text = re.sub(r'version:\s*[\d.]+', f'version: {semver}', text)
         opencode_yaml.write_text(new_text, encoding="utf-8")
         print(f"[✓] Synced agents/opencode/skill.yaml -> {semver}")
+    # 8. Update cli/src/index.ts fallback version
+    cli_ts_path = base_dir / "cli" / "src" / "index.ts"
+    if cli_ts_path.exists():
+        text = cli_ts_path.read_text(encoding="utf-8")
+        new_text = re.sub(r"return\s+data\.version\s*\|\|\s*'[^']+'", f"return data.version || '{semver}'", text)
+        new_text = re.sub(r"return\s+'[^']+'\s*;", f"return '{semver}';", new_text)
+        cli_ts_path.write_text(new_text, encoding="utf-8")
+        print(f"[✓] Synced cli/src/index.ts -> {semver}")
 
-    # 8. Update scripts/Agent.md
+
+    # 9. Update scripts/Agent.md
     agent_md = base_dir / "scripts" / "Agent.md"
     if agent_md.exists():
         text = agent_md.read_text(encoding="utf-8")
@@ -88,7 +97,7 @@ def sync_version(new_version: str):
         agent_md.write_text(new_text, encoding="utf-8")
         print(f"[✓] Synced scripts/Agent.md -> v{semver}")
 
-    # 9. Recompile knowledge index to update index.json version
+    # 10. Recompile knowledge index to update index.json version
     kb_script = base_dir / "scripts" / "build" / "build-knowledge.py"
     if kb_script.exists():
         import subprocess

package/scripts/template/instantiate-resume.py

@@ -129,6 +129,7 @@ def instantiate_workspace(template_id: str, profile_path: Optional[str] = None,
         
     html_file = template_dir / "template.html"
     css_file = template_dir / "style.css"
+    base_css_file = base_dir / "src" / "templates" / "common" / "base.css"
     
     if not html_file.exists() or not css_file.exists():
         raise FileNotFoundError(f"template.html or style.css missing in {template_dir}")
@@ -136,11 +137,16 @@ def instantiate_workspace(template_id: str, profile_path: Optional[str] = None,
     html_content = html_file.read_text(encoding="utf-8")
     css_content = css_file.read_text(encoding="utf-8")
     
+    combined_css = ""
+    if base_css_file.exists():
+        combined_css = base_css_file.read_text(encoding="utf-8") + "\n\n/* === TEMPLATE SPECIFIC STYLES === */\n" + css_content
+    else:
+        combined_css = css_content
+    
     inlined_html = html_content.replace(
         '<link rel="stylesheet" href="style.css">',
-        f'<style>\n{css_content}\n  </style>'
+        f'<style>\n{combined_css}\n  </style>'
     )
-    
     kw_list = [k.strip() for k in keywords.split(",") if k.strip()] if keywords else []
 
     if profile_path and Path(profile_path).exists():