paper-reading-field-map

# Field Map Use this skill to run a complete Field Map Workflow: define the field boundary, collect seed papers, expand the literature set, extract paper position records, cluster the field, identify research opportunity candidates, and produce a static HTML report. The goal is not to fully summarize every paper. The goal is to build a durable map of the field: what problems exist, what method routes exist, which assumptions they rely on, how they are evaluated, where papers agree or conflict, and what gaps remain. ## Output Root Set `{workspace-root}` before creating, scanning, or updating artifacts: - Default `{workspace-root}` to `workspace` (the repo-local `workspace/` directory). - If the user specifies a workspace root, use that path exactly and do not add another `workspace/` layer. - If the user provides an existing artifact or workflow path, infer `{workspace-root}` from that path and keep related artifacts under the same root. - Do not create new generated workflow directories directly at the repository root. If the user points to an existing root-level legacy workspace, inspect or update only that existing path. ## Core Workflow 1. Draft a Proposed Field Boundary from the user's initial direction. 2. Revise the boundary with the user until they explicitly confirm it. 3. Create a Field Map Workspace at `{workspace-root}/field-maps/{field-slug}/`. 4. Write `field_boundary.md`. 5. Discover an 8-12 paper Seed Set and ask the user to confirm it. 6. After confirmation, create one Paper Position Record per seed paper in `seed_papers/`. 7. Use the seed papers to draft `search_strategy.md`, including candidate discovery directions and selection criteria. 8. Ask the user to confirm the search strategy. 9. Build a Candidate Pool, select roughly 25-35 expansion papers, and create Paper Position Records in `all_papers/`. 10. Cluster all read papers into no more than 10 Research Clusters and write `research_clusters.md`. 11. Derive evidence-backed Research Opportunity Candidates and write `research_opportunities.md`. 12. Create a zero-build static `index.html` report that links to the markdown artifacts. ## Hard Confirmation Gates Do not skip these gates: 1. **Field Boundary confirmed**: do not discover seed papers until the user confirms the field boundary. 2. **Seed Set confirmed**: do not create seed paper records until the user confirms the proposed Seed Set. 3. **Search Strategy confirmed**: do not expand to the full paper set until the user confirms the search strategy. If the user gives corrections at any gate, revise the artifact or proposal and ask for confirmation again. ## Field Boundary Rules Start by drafting a Proposed Field Boundary instead of asking the user to fill out a blank questionnaire. The proposed boundary must include: 1. Research Target 2. In Scope 3. Out of Scope 4. Time / Venue Boundary 5. User Goal 6. Stop Condition Ask the user what is inaccurate, missing, or too broad. Continue revising until they confirm. Then write the confirmed boundary to `field_boundary.md` using `references/field-boundary-template.md`. ## Paper Discovery Rules If the user directly uploads or links papers, prioritize those User-Provided Papers. If the user does not directly provide papers, use Network Discovery by default. Search online sources such as survey bibliographies, citation trails, benchmark pages, conference proceedings, leaderboards, and academic search engines. For every paper, record: - Resource - Source Verified - Discovery Source If network access is unavailable, do not pretend discovery is complete. Tell the user what could not be searched and ask for paper links or permission to continue when network access is available. ## Seed Set Rules The Seed Set should contain roughly 8-12 papers. Prefer coverage over exact count: - 1-2 survey, tutorial, or overview papers - 2-3 classic or foundational papers - 2-3 recent high-impact papers - 1-2 benchmark, dataset, or evaluation papers - 1-2 system or application papers If a category is absent in the field, record that absence in `search_strategy.md`; it may indicate an Evaluation Gap or System Gap. Before reading seed papers, present the proposed Seed Set with a short reason for each paper and wait for confirmation. ## Reading Depth Use Position-Oriented Reading. Read only deeply enough to complete the Paper Position Record and place the paper in the field. Default reading order: 1. Title / Abstract / Introduction 2. Related Work 3. Method overview 4. Experiment setup and main results 5. Limitations / Discussion 6. Conclusion Read methods, formulas, appendices, or experiments more deeply only when the paper is foundational, defines a benchmark, or determines a cluster boundary. ## Expansion Rules After seed paper records are complete, draft `search_strategy.md` before reading expansion papers. The strategy must include: - Search Directions - Selection Criteria - Exclusion Criteria - Citation Chasing Sources - Keyword Queries - Why These Papers - Known Blind Spots Use a Candidate Pool first, then select roughly 25-35 papers as the Selected Expansion Set. Create one Paper Position Record per selected paper in `all_papers/`. ## Clustering Rules Cluster all read papers into no more than 10 Research Clusters. Each paper must have exactly one Primary Research Cluster and may have zero or more Secondary Research Clusters. If more than 10 clusters appear necessary, merge them into higher-level clusters and record the boundary tradeoff. ## Research Opportunity Rules Do not list unsupported speculation as a Research Opportunity Candidate. Each opportunity must be backed by links to specific paper records and must be phrased so it can become a possible research question. Use these gap types: - Conceptual gap - Method gap - Evaluation gap - System gap - Theoretical gap ## HTML Report Rules Create a zero-build static `index.html` inside the Field Map Workspace. It should be readable by opening the file directly and should link to the markdown artifacts. Do not introduce a frontend framework, build step, or external runtime for the report. ## Required Templates Use the reference templates in this directory: - `references/workspace-structure.md` - `references/field-boundary-template.md` - `references/paper-position-record-template.md` - `references/search-strategy-template.md` - `references/research-clusters-template.md` - `references/research-opportunities-template.md` - `references/html-report-template.md` ## Stop Condition Stop when the user can explain: - the confirmed field boundary, - the main research clusters, - representative papers for each cluster, - the assumptions and evaluation patterns across the field, - saturated areas, - unclear areas, - and evidence-backed research opportunity candidates.