gh-xj/rw-analyze

rw-analyze: Analysis Worker

Input

• Captured corpus files from literature/corpus/
• Q-NNN sub-questions to guide analysis focus

Output

• analysis/notes/S-NNN-{slug}.md — one per captured source (mandatory)
• analysis/comparisons/{topic}-v1.md — one per sub-question (3+ sources compared)

Responsibilities

1. Write analysis notes: Mandatory for every captured source. Sections: Key Findings, Methodology & Limitations, Relevance to Job-Hunter, References to Follow.
2. Write comparisons: At least one comparison per sub-question, comparing 3+ sources. Comparisons are the critical bridge artifact — every finding must trace to at least one.
3. Reference by S-NNN: All source references use S-NNN IDs from catalog.md. Never reference sources by title alone.
4. No web access: Analysis uses only local corpus files. Do not fetch any external content.
5. Focus on engineering feasibility: Assess practical implementability (not just theoretical correctness) — rate-limits, ToS risk, maintenance burden, UK-specific constraints.

Comparison Types

Match comparison type to the domain question:

• Platform-vs-platform: LinkedIn vs. Indeed vs. Reed scraping, API availability, rate limits, data richness
• Algorithm-vs-algorithm: MinHash vs. SimHash vs. BM25, accuracy trade-offs, throughput benchmarks
• Deployment-option-vs-option: Cloud providers (AWS vs. GCP vs. Railway), managed vs. self-hosted (Elasticsearch vs. Meilisearch)
• Legal-framework comparison: GDPR Article 6 lawful bases for job scraping, ICO guidance vs. case law
• Visa-detection approach: Keyword matching vs. NLP classification vs. sponsor register lookup

Self-Check (Level 1 Self-Correction)

Before completing, verify:

• [ ] Every captured source has analysis notes
• [ ] Every sub-question has at least one comparison
• [ ] All S-NNN references exist in catalog.md
• [ ] Notes contain all four required sections
• [ ] Comparisons compare 3+ sources each

Max 2 self-correction iterations. If self-check still fails after 2 retries, emit status-recommendation: blocked with a description of what failed.

Content Conventions

See references/analysis-conventions.md for:

• Notes format (Key Findings, Methodology & Limitations, Relevance to Job-Hunter, References to Follow)
• Critique format (Tier Assessment, Strengths, Weaknesses, Trust Level)
• Comparison format (Question, Source Positions table, Agreement, Disagreement, Gaps)