Academic Research
This is the Codex entry router for the vendored research suite under ars/.
Defaults
- Domain default: geography, human geography, GIScience, and health geography.
- Chinese default: Simplified Chinese. Use Traditional Chinese only when the user explicitly asks for it.
- NORA is not an installed skill here. Use
../shared/field-context/ only as a local reference pack when domain grounding is needed.
- Read
../shared/research-calibration.md for analysis planning, experiment
execution, question evaluation, or manuscript-readiness decisions. When the
user is developing an analysis or manuscript and gives no stage, default to
first-draft + proportionate rigor + incremental-allowed contribution + balanced compute.
- Do not import submission, formal peer-review, systematic-review, or
reviewer-response standards into first-draft analysis unless a named validity
risk makes them immediately necessary.
- For reading, outlining, drafting, or revision, read
references/selective-quality-control.md. Check load-bearing claims first,
accept bounded PDF/manuscript reading scopes, use claim skeletons before
uncertain prose, and prefer local patches over whole-section rewrites.
- For question framing, analysis planning, paper architecture, Results,
Discussion, or revision, also read
../shared/advantage-led-research-narrative.md. Build author-side work around
the leading advantage, winning arena, and decisive evidence; surface only
material constraints that change the claim or route.
Use the Research Continuity record in
../shared/advantage-led-research-narrative.md: preserve question, advantage
state, fair comparison, claim/experiment IDs, evidence version, and retellable
sentence across stages. Update only fields affected by the current task; reuse
project records rather than starting another ledger.
Execution scope
Read execution and approval scope when
using internal workflows. Phase completion returns control to the main agent;
continue the authorized task while preserving applicable explicit approvals.
First rule
Do not load the whole suite by default. Start from one workflow entry file and then load only the needed agent, reference, or template files.
Routing boundaries
- Use
good-question when the main decision is whether a question is important,
tractable, falsifiable, or worth pursuing.
- Use
good-story when results or manuscript materials already exist and the
main task is to organize them into an evidence-supported narrative.
- Use
academic-advisor for proposal diagnosis, pre-submission assessment, and
journal targeting.
- Use
peer-review for a formal external-reviewer report.
- Keep the internal question-refinement and reviewer workflows available only
when the user explicitly invokes this skill or needs an end-to-end pipeline.
Workflow router
- Deep research, literature review, systematic review, meta-analysis, research question refinement:
ars/deep-research/WORKFLOW.md
- Academic paper writing, outline, abstract, revision, citation formatting, disclosure, formatting guidance:
ars/academic-paper/WORKFLOW.md
- Peer review, reviewer simulation, editorial decision, re-review:
ars/academic-paper-reviewer/WORKFLOW.md
- End-to-end research-to-paper pipeline:
ars/academic-pipeline/WORKFLOW.md
- Experiment planning, statistical interpretation, reproducibility, human study protocol:
ars/experiment-agent/WORKFLOW.md
Mode routing
Prefer /academic-research mode=<mode> or the equivalent natural-language
request. Supported modes include:
plan
outline
abstract
lit-review
citation-check
disclosure
format-convert
revision-coach
revision
full
Legacy ars-* tokens may be interpreted as these internal modes when supplied
after /academic-research; they are not separate slash-callable skills.
If the user only has a broad topic or tentative title but no clear research
question, use good-question first unless the user explicitly requests the
end-to-end academic-research pipeline.
Codex mapping
- Treat upstream Claude/agent dispatch wording as phase prompts to execute inline.
- Do not install or run Claude hooks.
- Treat
WORKFLOW.md files as the actual internal entrypoints.
- Use
../shared/field-context/geography-publication-readiness.md for geography-specific contribution, method-fit, theory, argument, and title checks.
- Apply
../shared/research-calibration.md before interpreting contribution
magnitude, deciding robustness scope, or scheduling expensive analysis.
- Use
references/selective-quality-control.md for impact-first review,
bounded novelty language, evidence-led Introduction recalibration, and
advisory claim-drift checks.
- Use
../shared/advantage-led-research-narrative.md to prevent reviewer-first
drafting, experiment accumulation without an argument job, and project-diary
Results structures.
- Use
../shared/field-context/academic-writing.md, spatial-methods.md, geoai-domain.md, environmental-health.md, and journal-templates/ only when relevant.
- For projects that use dynamic greenspace exposure and Space-Time Constraints,
read
references/space-time-greenspace-terminology.md before drafting,
revising, or auditing terminology. Treat it as a project/domain calibration
reference, not a universal replacement for field-standard wording.
1---2name: academic-research3description: Academic research, literature review, research design, paper drafting, manuscript revision, research-to-paper workflow routing, and experiment planning for geography, human geography, GIScience, and health geography. Use when the user asks for literature review, systematic review, paper outlining, geography-specific title design, abstract writing, revision, citation or integrity checks, full pipeline support, or experiment/study planning. Use good-question when research-question quality is the primary task, peer-review for a formal referee report, good-story for an evidence-led manuscript story, and academic-advisor for submission strategy.4---56# Academic Research78This is the Codex entry router for the vendored research suite under `ars/`.910## Defaults1112- Domain default: geography, human geography, GIScience, and health geography.13- Chinese default: Simplified Chinese. Use Traditional Chinese only when the user explicitly asks for it.14- NORA is not an installed skill here. Use `../shared/field-context/` only as a local reference pack when domain grounding is needed.15- Read `../shared/research-calibration.md` for analysis planning, experiment16 execution, question evaluation, or manuscript-readiness decisions. When the17 user is developing an analysis or manuscript and gives no stage, default to18 `first-draft + proportionate rigor + incremental-allowed contribution +19 balanced compute`.20- Do not import submission, formal peer-review, systematic-review, or21 reviewer-response standards into first-draft analysis unless a named validity22 risk makes them immediately necessary.23- For reading, outlining, drafting, or revision, read24 `references/selective-quality-control.md`. Check load-bearing claims first,25 accept bounded PDF/manuscript reading scopes, use claim skeletons before26 uncertain prose, and prefer local patches over whole-section rewrites.27- For question framing, analysis planning, paper architecture, Results,28 Discussion, or revision, also read29 `../shared/advantage-led-research-narrative.md`. Build author-side work around30 the leading advantage, winning arena, and decisive evidence; surface only31 material constraints that change the claim or route.3233Use the Research Continuity record in34`../shared/advantage-led-research-narrative.md`: preserve question, advantage35state, fair comparison, claim/experiment IDs, evidence version, and retellable36sentence across stages. Update only fields affected by the current task; reuse37project records rather than starting another ledger.3839## Execution scope4041Read [execution and approval scope](references/execution-and-approval.md) when42using internal workflows. Phase completion returns control to the main agent;43continue the authorized task while preserving applicable explicit approvals.4445## First rule4647Do not load the whole suite by default. Start from one workflow entry file and then load only the needed agent, reference, or template files.4849## Routing boundaries5051- Use `good-question` when the main decision is whether a question is important,52 tractable, falsifiable, or worth pursuing.53- Use `good-story` when results or manuscript materials already exist and the54 main task is to organize them into an evidence-supported narrative.55- Use `academic-advisor` for proposal diagnosis, pre-submission assessment, and56 journal targeting.57- Use `peer-review` for a formal external-reviewer report.58- Keep the internal question-refinement and reviewer workflows available only59 when the user explicitly invokes this skill or needs an end-to-end pipeline.6061## Workflow router6263- Deep research, literature review, systematic review, meta-analysis, research question refinement:64 `ars/deep-research/WORKFLOW.md`65- Academic paper writing, outline, abstract, revision, citation formatting, disclosure, formatting guidance:66 `ars/academic-paper/WORKFLOW.md`67- Peer review, reviewer simulation, editorial decision, re-review:68 `ars/academic-paper-reviewer/WORKFLOW.md`69- End-to-end research-to-paper pipeline:70 `ars/academic-pipeline/WORKFLOW.md`71- Experiment planning, statistical interpretation, reproducibility, human study protocol:72 `ars/experiment-agent/WORKFLOW.md`7374## Mode routing7576Prefer `/academic-research mode=<mode>` or the equivalent natural-language77request. Supported modes include:7879- `plan`80- `outline`81- `abstract`82- `lit-review`83- `citation-check`84- `disclosure`85- `format-convert`86- `revision-coach`87- `revision`88- `full`8990Legacy `ars-*` tokens may be interpreted as these internal modes when supplied91after `/academic-research`; they are not separate slash-callable skills.9293If the user only has a broad topic or tentative title but no clear research94question, use `good-question` first unless the user explicitly requests the95end-to-end academic-research pipeline.9697## Codex mapping9899- Treat upstream Claude/agent dispatch wording as phase prompts to execute inline.100- Do not install or run Claude hooks.101- Treat `WORKFLOW.md` files as the actual internal entrypoints.102- Use `../shared/field-context/geography-publication-readiness.md` for geography-specific contribution, method-fit, theory, argument, and title checks.103- Apply `../shared/research-calibration.md` before interpreting contribution104 magnitude, deciding robustness scope, or scheduling expensive analysis.105- Use `references/selective-quality-control.md` for impact-first review,106 bounded novelty language, evidence-led Introduction recalibration, and107 advisory claim-drift checks.108- Use `../shared/advantage-led-research-narrative.md` to prevent reviewer-first109 drafting, experiment accumulation without an argument job, and project-diary110 Results structures.111- Use `../shared/field-context/academic-writing.md`, `spatial-methods.md`, `geoai-domain.md`, `environmental-health.md`, and `journal-templates/` only when relevant.112- For projects that use dynamic greenspace exposure and Space-Time Constraints,113 read `references/space-time-greenspace-terminology.md` before drafting,114 revising, or auditing terminology. Treat it as a project/domain calibration115 reference, not a universal replacement for field-standard wording.