flonat-research 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (285) hide show
  1. package/.claude/agents/domain-reviewer.md +336 -0
  2. package/.claude/agents/fixer.md +226 -0
  3. package/.claude/agents/paper-critic.md +370 -0
  4. package/.claude/agents/peer-reviewer.md +289 -0
  5. package/.claude/agents/proposal-reviewer.md +215 -0
  6. package/.claude/agents/referee2-reviewer.md +367 -0
  7. package/.claude/agents/references/journal-referee-profiles.md +354 -0
  8. package/.claude/agents/references/paper-critic/council-personas.md +77 -0
  9. package/.claude/agents/references/paper-critic/council-prompts.md +198 -0
  10. package/.claude/agents/references/peer-reviewer/report-template.md +199 -0
  11. package/.claude/agents/references/peer-reviewer/sa-prompts.md +260 -0
  12. package/.claude/agents/references/peer-reviewer/security-scan.md +188 -0
  13. package/.claude/agents/references/proposal-reviewer/report-template.md +144 -0
  14. package/.claude/agents/references/proposal-reviewer/sa-prompts.md +149 -0
  15. package/.claude/agents/references/referee-config.md +114 -0
  16. package/.claude/agents/references/referee2-reviewer/audit-checklists.md +287 -0
  17. package/.claude/agents/references/referee2-reviewer/report-template.md +334 -0
  18. package/.claude/rules/design-before-results.md +52 -0
  19. package/.claude/rules/ignore-agents-md.md +17 -0
  20. package/.claude/rules/ignore-gemini-md.md +17 -0
  21. package/.claude/rules/lean-claude-md.md +45 -0
  22. package/.claude/rules/learn-tags.md +99 -0
  23. package/.claude/rules/overleaf-separation.md +67 -0
  24. package/.claude/rules/plan-first.md +175 -0
  25. package/.claude/rules/read-docs-first.md +50 -0
  26. package/.claude/rules/scope-discipline.md +28 -0
  27. package/.claude/settings.json +125 -0
  28. package/.context/current-focus.md +33 -0
  29. package/.context/preferences/priorities.md +36 -0
  30. package/.context/preferences/task-naming.md +28 -0
  31. package/.context/profile.md +29 -0
  32. package/.context/projects/_index.md +41 -0
  33. package/.context/projects/papers/nudge-exp.md +22 -0
  34. package/.context/projects/papers/uncertainty.md +31 -0
  35. package/.context/resources/claude-scientific-writer-review.md +48 -0
  36. package/.context/resources/cunningham-multi-analyst-agents.md +104 -0
  37. package/.context/resources/cunningham-multilang-code-audit.md +62 -0
  38. package/.context/resources/google-ai-co-scientist-review.md +72 -0
  39. package/.context/resources/karpathy-llm-council-review.md +58 -0
  40. package/.context/resources/multi-coder-reliability-protocol.md +175 -0
  41. package/.context/resources/pedro-santanna-takeaways.md +96 -0
  42. package/.context/resources/venue-rankings/abs_ajg_2024.csv +1823 -0
  43. package/.context/resources/venue-rankings/abs_ajg_2024_econ.csv +356 -0
  44. package/.context/resources/venue-rankings/cabs_4_4star_theory.csv +40 -0
  45. package/.context/resources/venue-rankings/core_2026.csv +801 -0
  46. package/.context/resources/venue-rankings.md +147 -0
  47. package/.context/workflows/README.md +69 -0
  48. package/.context/workflows/daily-review.md +91 -0
  49. package/.context/workflows/meeting-actions.md +108 -0
  50. package/.context/workflows/replication-protocol.md +155 -0
  51. package/.context/workflows/weekly-review.md +113 -0
  52. package/.mcp-server-biblio/formatters.py +158 -0
  53. package/.mcp-server-biblio/pyproject.toml +11 -0
  54. package/.mcp-server-biblio/server.py +678 -0
  55. package/.mcp-server-biblio/sources/__init__.py +14 -0
  56. package/.mcp-server-biblio/sources/base.py +73 -0
  57. package/.mcp-server-biblio/sources/formatters.py +83 -0
  58. package/.mcp-server-biblio/sources/models.py +22 -0
  59. package/.mcp-server-biblio/sources/multi_source.py +243 -0
  60. package/.mcp-server-biblio/sources/openalex_source.py +183 -0
  61. package/.mcp-server-biblio/sources/scopus_source.py +309 -0
  62. package/.mcp-server-biblio/sources/wos_source.py +508 -0
  63. package/.mcp-server-biblio/uv.lock +896 -0
  64. package/.scripts/README.md +161 -0
  65. package/.scripts/ai_pattern_density.py +446 -0
  66. package/.scripts/conf +445 -0
  67. package/.scripts/config.py +122 -0
  68. package/.scripts/count_inventory.py +275 -0
  69. package/.scripts/daily_digest.py +288 -0
  70. package/.scripts/done +177 -0
  71. package/.scripts/extract_meeting_actions.py +223 -0
  72. package/.scripts/focus +176 -0
  73. package/.scripts/generate-codex-agents-md.py +217 -0
  74. package/.scripts/inbox +194 -0
  75. package/.scripts/notion_helpers.py +325 -0
  76. package/.scripts/openalex/query_helpers.py +306 -0
  77. package/.scripts/papers +227 -0
  78. package/.scripts/query +223 -0
  79. package/.scripts/session-history.py +201 -0
  80. package/.scripts/skill-health.py +516 -0
  81. package/.scripts/skill-log-miner.py +273 -0
  82. package/.scripts/sync-to-codex.sh +252 -0
  83. package/.scripts/task +213 -0
  84. package/.scripts/tasks +190 -0
  85. package/.scripts/week +206 -0
  86. package/CLAUDE.md +197 -0
  87. package/LICENSE +21 -0
  88. package/MEMORY.md +38 -0
  89. package/README.md +269 -0
  90. package/docs/agents.md +44 -0
  91. package/docs/bibliography-setup.md +55 -0
  92. package/docs/council-mode.md +36 -0
  93. package/docs/getting-started.md +245 -0
  94. package/docs/hooks.md +38 -0
  95. package/docs/mcp-servers.md +82 -0
  96. package/docs/notion-setup.md +109 -0
  97. package/docs/rules.md +33 -0
  98. package/docs/scripts.md +303 -0
  99. package/docs/setup-overview/setup-overview.pdf +0 -0
  100. package/docs/skills.md +70 -0
  101. package/docs/system.md +159 -0
  102. package/hooks/block-destructive-git.sh +66 -0
  103. package/hooks/context-monitor.py +114 -0
  104. package/hooks/postcompact-restore.py +157 -0
  105. package/hooks/precompact-autosave.py +181 -0
  106. package/hooks/promise-checker.sh +124 -0
  107. package/hooks/protect-source-files.sh +81 -0
  108. package/hooks/resume-context-loader.sh +53 -0
  109. package/hooks/startup-context-loader.sh +102 -0
  110. package/package.json +51 -0
  111. package/packages/cli-council/.github/workflows/claude-code-review.yml +44 -0
  112. package/packages/cli-council/.github/workflows/claude.yml +50 -0
  113. package/packages/cli-council/README.md +100 -0
  114. package/packages/cli-council/pyproject.toml +43 -0
  115. package/packages/cli-council/src/cli_council/__init__.py +19 -0
  116. package/packages/cli-council/src/cli_council/__main__.py +185 -0
  117. package/packages/cli-council/src/cli_council/backends/__init__.py +8 -0
  118. package/packages/cli-council/src/cli_council/backends/base.py +81 -0
  119. package/packages/cli-council/src/cli_council/backends/claude.py +25 -0
  120. package/packages/cli-council/src/cli_council/backends/codex.py +27 -0
  121. package/packages/cli-council/src/cli_council/backends/gemini.py +26 -0
  122. package/packages/cli-council/src/cli_council/checkpoint.py +212 -0
  123. package/packages/cli-council/src/cli_council/config.py +51 -0
  124. package/packages/cli-council/src/cli_council/council.py +391 -0
  125. package/packages/cli-council/src/cli_council/models.py +46 -0
  126. package/packages/llm-council/.github/workflows/claude-code-review.yml +44 -0
  127. package/packages/llm-council/.github/workflows/claude.yml +50 -0
  128. package/packages/llm-council/README.md +453 -0
  129. package/packages/llm-council/pyproject.toml +42 -0
  130. package/packages/llm-council/src/llm_council/__init__.py +23 -0
  131. package/packages/llm-council/src/llm_council/__main__.py +259 -0
  132. package/packages/llm-council/src/llm_council/checkpoint.py +193 -0
  133. package/packages/llm-council/src/llm_council/client.py +253 -0
  134. package/packages/llm-council/src/llm_council/config.py +232 -0
  135. package/packages/llm-council/src/llm_council/council.py +482 -0
  136. package/packages/llm-council/src/llm_council/models.py +46 -0
  137. package/packages/mcp-bibliography/MEMORY.md +31 -0
  138. package/packages/mcp-bibliography/_app.py +226 -0
  139. package/packages/mcp-bibliography/formatters.py +158 -0
  140. package/packages/mcp-bibliography/log/2026-03-13-2100.md +35 -0
  141. package/packages/mcp-bibliography/pyproject.toml +15 -0
  142. package/packages/mcp-bibliography/run.sh +20 -0
  143. package/packages/mcp-bibliography/scholarly_formatters.py +83 -0
  144. package/packages/mcp-bibliography/server.py +1857 -0
  145. package/packages/mcp-bibliography/tools/__init__.py +28 -0
  146. package/packages/mcp-bibliography/tools/_registry.py +19 -0
  147. package/packages/mcp-bibliography/tools/altmetric.py +107 -0
  148. package/packages/mcp-bibliography/tools/core.py +92 -0
  149. package/packages/mcp-bibliography/tools/dblp.py +52 -0
  150. package/packages/mcp-bibliography/tools/openalex.py +296 -0
  151. package/packages/mcp-bibliography/tools/opencitations.py +102 -0
  152. package/packages/mcp-bibliography/tools/openreview.py +179 -0
  153. package/packages/mcp-bibliography/tools/orcid.py +131 -0
  154. package/packages/mcp-bibliography/tools/scholarly.py +575 -0
  155. package/packages/mcp-bibliography/tools/unpaywall.py +63 -0
  156. package/packages/mcp-bibliography/tools/zenodo.py +123 -0
  157. package/packages/mcp-bibliography/uv.lock +711 -0
  158. package/scripts/setup.sh +143 -0
  159. package/skills/beamer-deck/SKILL.md +199 -0
  160. package/skills/beamer-deck/references/quality-rubric.md +54 -0
  161. package/skills/beamer-deck/references/review-prompts.md +106 -0
  162. package/skills/bib-validate/SKILL.md +261 -0
  163. package/skills/bib-validate/references/council-mode.md +34 -0
  164. package/skills/bib-validate/references/deep-verify.md +79 -0
  165. package/skills/bib-validate/references/fix-mode.md +36 -0
  166. package/skills/bib-validate/references/openalex-verification.md +45 -0
  167. package/skills/bib-validate/references/preprint-check.md +31 -0
  168. package/skills/bib-validate/references/ref-manager-crossref.md +41 -0
  169. package/skills/bib-validate/references/report-template.md +82 -0
  170. package/skills/code-archaeology/SKILL.md +141 -0
  171. package/skills/code-review/SKILL.md +265 -0
  172. package/skills/code-review/references/quality-rubric.md +67 -0
  173. package/skills/consolidate-memory/SKILL.md +208 -0
  174. package/skills/context-status/SKILL.md +126 -0
  175. package/skills/creation-guard/SKILL.md +230 -0
  176. package/skills/devils-advocate/SKILL.md +130 -0
  177. package/skills/devils-advocate/references/competing-hypotheses.md +83 -0
  178. package/skills/init-project/SKILL.md +115 -0
  179. package/skills/init-project-course/references/memory-and-settings.md +92 -0
  180. package/skills/init-project-course/references/organise-templates.md +94 -0
  181. package/skills/init-project-course/skill.md +147 -0
  182. package/skills/init-project-light/skill.md +139 -0
  183. package/skills/init-project-research/SKILL.md +368 -0
  184. package/skills/init-project-research/references/atlas-pipeline-sync.md +70 -0
  185. package/skills/init-project-research/references/atlas-schema.md +81 -0
  186. package/skills/init-project-research/references/confirmation-report.md +39 -0
  187. package/skills/init-project-research/references/domain-profile-template.md +104 -0
  188. package/skills/init-project-research/references/interview-round3.md +34 -0
  189. package/skills/init-project-research/references/literature-discovery.md +43 -0
  190. package/skills/init-project-research/references/scaffold-details.md +197 -0
  191. package/skills/init-project-research/templates/field-calibration.md +60 -0
  192. package/skills/init-project-research/templates/pipeline-manifest.md +63 -0
  193. package/skills/init-project-research/templates/run-all.sh +116 -0
  194. package/skills/init-project-research/templates/seed-files.md +337 -0
  195. package/skills/insights-deck/SKILL.md +151 -0
  196. package/skills/interview-me/SKILL.md +157 -0
  197. package/skills/latex/SKILL.md +141 -0
  198. package/skills/latex/references/latex-configs.md +183 -0
  199. package/skills/latex-autofix/SKILL.md +230 -0
  200. package/skills/latex-autofix/references/known-errors.md +183 -0
  201. package/skills/latex-autofix/references/quality-rubric.md +50 -0
  202. package/skills/latex-health-check/SKILL.md +161 -0
  203. package/skills/learn/SKILL.md +220 -0
  204. package/skills/learn/scripts/validate_skill.py +265 -0
  205. package/skills/lessons-learned/SKILL.md +201 -0
  206. package/skills/literature/SKILL.md +335 -0
  207. package/skills/literature/references/agent-templates.md +393 -0
  208. package/skills/literature/references/bibliometric-apis.md +44 -0
  209. package/skills/literature/references/cli-council-search.md +79 -0
  210. package/skills/literature/references/openalex-api-guide.md +371 -0
  211. package/skills/literature/references/openalex-common-queries.md +381 -0
  212. package/skills/literature/references/openalex-workflows.md +248 -0
  213. package/skills/literature/references/reference-manager-sync.md +36 -0
  214. package/skills/literature/references/scopus-api-guide.md +208 -0
  215. package/skills/literature/references/wos-api-guide.md +308 -0
  216. package/skills/multi-perspective/SKILL.md +311 -0
  217. package/skills/multi-perspective/references/computational-many-analysts.md +77 -0
  218. package/skills/pipeline-manifest/SKILL.md +226 -0
  219. package/skills/pre-submission-report/SKILL.md +153 -0
  220. package/skills/process-reviews/SKILL.md +244 -0
  221. package/skills/process-reviews/references/rr-routing.md +101 -0
  222. package/skills/project-deck/SKILL.md +87 -0
  223. package/skills/project-safety/SKILL.md +135 -0
  224. package/skills/proofread/SKILL.md +254 -0
  225. package/skills/proofread/references/quality-rubric.md +104 -0
  226. package/skills/python-env/SKILL.md +57 -0
  227. package/skills/quarto-deck/SKILL.md +226 -0
  228. package/skills/quarto-deck/references/markdown-format.md +143 -0
  229. package/skills/quarto-deck/references/quality-rubric.md +54 -0
  230. package/skills/save-context/SKILL.md +174 -0
  231. package/skills/session-log/SKILL.md +98 -0
  232. package/skills/shared/concept-validation-gate.md +161 -0
  233. package/skills/shared/council-protocol.md +265 -0
  234. package/skills/shared/distribution-diagnostics.md +164 -0
  235. package/skills/shared/engagement-stratified-sampling.md +218 -0
  236. package/skills/shared/escalation-protocol.md +74 -0
  237. package/skills/shared/external-audit-protocol.md +205 -0
  238. package/skills/shared/intercoder-reliability.md +256 -0
  239. package/skills/shared/mcp-degradation.md +81 -0
  240. package/skills/shared/method-probing-questions.md +163 -0
  241. package/skills/shared/multi-language-conventions.md +143 -0
  242. package/skills/shared/paid-api-safety.md +174 -0
  243. package/skills/shared/palettes.md +90 -0
  244. package/skills/shared/progressive-disclosure.md +92 -0
  245. package/skills/shared/project-documentation-content.md +443 -0
  246. package/skills/shared/project-documentation-format.md +281 -0
  247. package/skills/shared/project-documentation.md +100 -0
  248. package/skills/shared/publication-output.md +138 -0
  249. package/skills/shared/quality-scoring.md +70 -0
  250. package/skills/shared/reference-resolution.md +77 -0
  251. package/skills/shared/research-quality-rubric.md +165 -0
  252. package/skills/shared/rhetoric-principles.md +54 -0
  253. package/skills/shared/skill-design-patterns.md +272 -0
  254. package/skills/shared/skill-index.md +240 -0
  255. package/skills/shared/system-documentation.md +334 -0
  256. package/skills/shared/tikz-rules.md +402 -0
  257. package/skills/shared/validation-tiers.md +121 -0
  258. package/skills/shared/venue-guides/README.md +46 -0
  259. package/skills/shared/venue-guides/cell_press_style.md +483 -0
  260. package/skills/shared/venue-guides/conferences_formatting.md +564 -0
  261. package/skills/shared/venue-guides/cs_conference_style.md +463 -0
  262. package/skills/shared/venue-guides/examples/cell_summary_example.md +247 -0
  263. package/skills/shared/venue-guides/examples/medical_structured_abstract.md +313 -0
  264. package/skills/shared/venue-guides/examples/nature_abstract_examples.md +213 -0
  265. package/skills/shared/venue-guides/examples/neurips_introduction_example.md +245 -0
  266. package/skills/shared/venue-guides/journals_formatting.md +486 -0
  267. package/skills/shared/venue-guides/medical_journal_styles.md +535 -0
  268. package/skills/shared/venue-guides/ml_conference_style.md +556 -0
  269. package/skills/shared/venue-guides/nature_science_style.md +405 -0
  270. package/skills/shared/venue-guides/reviewer_expectations.md +417 -0
  271. package/skills/shared/venue-guides/venue_writing_styles.md +321 -0
  272. package/skills/split-pdf/SKILL.md +172 -0
  273. package/skills/split-pdf/methodology.md +48 -0
  274. package/skills/sync-notion/SKILL.md +93 -0
  275. package/skills/system-audit/SKILL.md +157 -0
  276. package/skills/system-audit/references/sub-agent-prompts.md +294 -0
  277. package/skills/task-management/SKILL.md +131 -0
  278. package/skills/update-focus/SKILL.md +204 -0
  279. package/skills/update-project-doc/SKILL.md +194 -0
  280. package/skills/validate-bib/SKILL.md +242 -0
  281. package/skills/validate-bib/references/council-mode.md +34 -0
  282. package/skills/validate-bib/references/deep-verify.md +71 -0
  283. package/skills/validate-bib/references/openalex-verification.md +45 -0
  284. package/skills/validate-bib/references/preprint-check.md +31 -0
  285. package/skills/validate-bib/references/report-template.md +62 -0
@@ -0,0 +1,463 @@
1
+ # CS Conference Writing Style Guide
2
+
3
+ Comprehensive writing guide for ACL, EMNLP, NAACL (NLP), CHI, CSCW (HCI), SIGKDD, WWW, SIGIR (data mining/IR), and other major CS conferences.
4
+
5
+ **Last Updated**: 2024
6
+
7
+ ---
8
+
9
+ ## Overview
10
+
11
+ CS conferences span diverse subfields with distinct writing cultures. This guide covers NLP, HCI, and data mining/IR venues, each with unique expectations and evaluation criteria.
12
+
13
+ ---
14
+
15
+ # Part 1: NLP Conferences (ACL, EMNLP, NAACL)
16
+
17
+ ## NLP Writing Philosophy
18
+
19
+ > "Strong empirical results on standard benchmarks with insightful analysis."
20
+
21
+ NLP papers balance empirical rigor with linguistic insight. Human evaluation is increasingly important alongside automatic metrics.
22
+
23
+ ## Audience and Tone
24
+
25
+ ### Target Reader
26
+ - NLP researchers and computational linguists
27
+ - Familiar with transformer architectures, standard benchmarks
28
+ - Expect reproducible results and error analysis
29
+
30
+ ### Tone Characteristics
31
+ | Characteristic | Description |
32
+ |---------------|-------------|
33
+ | **Task-focused** | Clear problem definition |
34
+ | **Benchmark-oriented** | Standard datasets emphasized |
35
+ | **Analysis-rich** | Error analysis, qualitative examples |
36
+ | **Reproducible** | Full implementation details |
37
+
38
+ ## Abstract (NLP Style)
39
+
40
+ ### Structure
41
+ - **Task/problem** (1 sentence)
42
+ - **Limitation of prior work** (1 sentence)
43
+ - **Your approach** (1-2 sentences)
44
+ - **Results on benchmarks** (2 sentences)
45
+ - **Analysis finding** (optional, 1 sentence)
46
+
47
+ ### Example Abstract
48
+
49
+ ```
50
+ Coreference resolution remains challenging for pronouns with distant or
51
+ ambiguous antecedents. Prior neural approaches struggle with these
52
+ difficult cases due to limited context modeling. We introduce
53
+ LongContext-Coref, a retrieval-augmented coreference model that
54
+ dynamically retrieves relevant context from document history. On the
55
+ OntoNotes 5.0 benchmark, LongContext-Coref achieves 83.4 F1, improving
56
+ over the previous state-of-the-art by 1.2 points. On the challenging
57
+ WinoBias dataset, we reduce gender bias by 34% while maintaining
58
+ accuracy. Qualitative analysis reveals that our model successfully
59
+ resolves pronouns requiring world knowledge, a known weakness of
60
+ prior approaches.
61
+ ```
62
+
63
+ ## NLP Paper Structure
64
+
65
+ ```
66
+ ├── Introduction
67
+ │ ├── Task motivation
68
+ │ ├── Prior work limitations
69
+ │ ├── Your contribution
70
+ │ └── Contribution bullets
71
+ ├── Related Work
72
+ ├── Method
73
+ │ ├── Problem formulation
74
+ │ ├── Model architecture
75
+ │ └── Training procedure
76
+ ├── Experiments
77
+ │ ├── Datasets (with statistics)
78
+ │ ├── Baselines
79
+ │ ├── Main results
80
+ │ ├── Analysis
81
+ │ │ ├── Error analysis
82
+ │ │ ├── Ablation study
83
+ │ │ └── Qualitative examples
84
+ │ └── Human evaluation (if applicable)
85
+ ├── Discussion / Limitations
86
+ └── Conclusion
87
+ ```
88
+
89
+ ## NLP-Specific Requirements
90
+
91
+ ### Datasets
92
+ - Use **standard benchmarks**: GLUE, SQuAD, CoNLL, OntoNotes
93
+ - Report **dataset statistics**: train/dev/test sizes
94
+ - **Data preprocessing**: Document all steps
95
+
96
+ ### Evaluation Metrics
97
+ - **Task-appropriate metrics**: F1, BLEU, ROUGE, accuracy
98
+ - **Statistical significance**: Paired bootstrap, p-values
99
+ - **Multiple runs**: Report mean ± std across seeds
100
+
101
+ ### Human Evaluation
102
+ Increasingly expected for generation tasks:
103
+ - **Annotator details**: Number, qualifications, agreement
104
+ - **Evaluation protocol**: Guidelines, interface, payment
105
+ - **Inter-annotator agreement**: Cohen's κ or Krippendorff's α
106
+
107
+ ### Example Human Evaluation Table
108
+
109
+ ```
110
+ Table 3: Human Evaluation Results (100 samples, 3 annotators)
111
+ ─────────────────────────────────────────────────────────────
112
+ Method | Fluency | Coherence | Factuality | Overall
113
+ ─────────────────────────────────────────────────────────────
114
+ Baseline | 3.8 | 3.2 | 3.5 | 3.5
115
+ GPT-3.5 | 4.2 | 4.0 | 3.7 | 4.0
116
+ Our Method | 4.4 | 4.3 | 4.1 | 4.3
117
+ ─────────────────────────────────────────────────────────────
118
+ Inter-annotator κ = 0.72. Scale: 1-5 (higher is better).
119
+ ```
120
+
121
+ ## ACL-Specific Notes
122
+
123
+ - **ARR (ACL Rolling Review)**: Shared review system across ACL venues
124
+ - **Responsible NLP checklist**: Ethics, limitations, risks
125
+ - **Long (8 pages) vs. Short (4 pages)**: Different expectations
126
+ - **Findings papers**: Lower-tier acceptance track
127
+
128
+ ---
129
+
130
+ # Part 2: HCI Conferences (CHI, CSCW, UIST)
131
+
132
+ ## HCI Writing Philosophy
133
+
134
+ > "Technology in service of humans—understand users first, then design and evaluate."
135
+
136
+ HCI papers are fundamentally **user-centered**. Technology novelty alone is insufficient; understanding human needs and demonstrating user benefit is essential.
137
+
138
+ ## Audience and Tone
139
+
140
+ ### Target Reader
141
+ - HCI researchers and practitioners
142
+ - UX designers and product developers
143
+ - Interdisciplinary (CS, psychology, design, social science)
144
+
145
+ ### Tone Characteristics
146
+ | Characteristic | Description |
147
+ |---------------|-------------|
148
+ | **User-centered** | Focus on people, not technology |
149
+ | **Design-informed** | Grounded in design thinking |
150
+ | **Empirical** | User studies provide evidence |
151
+ | **Reflective** | Consider broader implications |
152
+
153
+ ## HCI Abstract
154
+
155
+ ### Focus on Users and Impact
156
+
157
+ ```
158
+ Video calling has become essential for remote collaboration, yet
159
+ current interfaces poorly support the peripheral awareness that makes
160
+ in-person work effective. Through formative interviews with 24 remote
161
+ workers, we identified three key challenges: difficulty gauging
162
+ colleague availability, lack of ambient presence cues, and interruption
163
+ anxiety. We designed AmbientOffice, a peripheral display system that
164
+ conveys teammate presence through subtle ambient visualizations. In a
165
+ two-week deployment study with 18 participants across three distributed
166
+ teams, AmbientOffice increased spontaneous collaboration by 40% and
167
+ reduced perceived isolation (p<0.01). Participants valued the system's
168
+ non-intrusive nature and reported feeling more connected to remote
169
+ colleagues. We discuss implications for designing ambient awareness
170
+ systems and the tension between visibility and privacy in remote work.
171
+ ```
172
+
173
+ ## HCI Paper Structure
174
+
175
+ ### Research Through Design / Systems Papers
176
+
177
+ ```
178
+ ├── Introduction
179
+ │ ├── Problem in human terms
180
+ │ ├── Why technology can help
181
+ │ └── Contribution summary
182
+ ├── Related Work
183
+ │ ├── Domain background
184
+ │ ├── Prior systems
185
+ │ └── Theoretical frameworks
186
+ ├── Formative Work (often)
187
+ │ ├── Interviews / observations
188
+ │ └── Design requirements
189
+ ├── System Design
190
+ │ ├── Design rationale
191
+ │ ├── Implementation
192
+ │ └── Interface walkthrough
193
+ ├── Evaluation
194
+ │ ├── Study design
195
+ │ ├── Participants
196
+ │ ├── Procedure
197
+ │ ├── Findings (quant + qual)
198
+ │ └── Limitations
199
+ ├── Discussion
200
+ │ ├── Design implications
201
+ │ ├── Generalizability
202
+ │ └── Future work
203
+ └── Conclusion
204
+ ```
205
+
206
+ ### Qualitative / Interview Studies
207
+
208
+ ```
209
+ ├── Introduction
210
+ ├── Related Work
211
+ ├── Methods
212
+ │ ├── Participants
213
+ │ ├── Procedure
214
+ │ ├── Data collection
215
+ │ └── Analysis method (thematic, grounded theory, etc.)
216
+ ├── Findings
217
+ │ ├── Theme 1 (with quotes)
218
+ │ ├── Theme 2 (with quotes)
219
+ │ └── Theme 3 (with quotes)
220
+ ├── Discussion
221
+ │ ├── Implications for design
222
+ │ ├── Implications for research
223
+ │ └── Limitations
224
+ └── Conclusion
225
+ ```
226
+
227
+ ## HCI-Specific Requirements
228
+
229
+ ### Participant Reporting
230
+ - **Demographics**: Age, gender, relevant experience
231
+ - **Recruitment**: How and where recruited
232
+ - **Compensation**: Payment amount and type
233
+ - **IRB approval**: Ethics board statement
234
+
235
+ ### Quotes in Findings
236
+ Use direct quotes to ground findings:
237
+ ```
238
+ Participants valued the ambient nature of the display. As P7 described:
239
+ "It's like having a window to my teammate's office. I don't need to
240
+ actively check it, but I know they're there." This passive awareness
241
+ reduced the barrier to initiating contact.
242
+ ```
243
+
244
+ ### Design Implications Section
245
+ Translate findings into actionable guidance:
246
+ ```
247
+ **Implication 1: Support peripheral awareness without demanding attention.**
248
+ Ambient displays should be visible in peripheral vision but not require
249
+ active monitoring. Designers should consider calm technology principles.
250
+
251
+ **Implication 2: Balance visibility with privacy.**
252
+ Users want to share presence but fear surveillance. Systems should
253
+ provide granular controls and make visibility mutual.
254
+ ```
255
+
256
+ ## CHI-Specific Notes
257
+
258
+ - **Contribution types**: Empirical, artifact, methodological, theoretical
259
+ - **ACM format**: `acmart` document class with `sigchi` option
260
+ - **Accessibility**: Alt text, inclusive language expected
261
+ - **Contribution statement**: Required per-author contributions
262
+
263
+ ---
264
+
265
+ # Part 3: Data Mining & IR (SIGKDD, WWW, SIGIR)
266
+
267
+ ## Data Mining Writing Philosophy
268
+
269
+ > "Scalable methods for real-world data with demonstrated practical impact."
270
+
271
+ Data mining papers emphasize **scalability**, **real-world applicability**, and **solid experimental methodology**.
272
+
273
+ ## Audience and Tone
274
+
275
+ ### Target Reader
276
+ - Data scientists and ML engineers
277
+ - Industry researchers
278
+ - Applied ML practitioners
279
+
280
+ ### Tone Characteristics
281
+ | Characteristic | Description |
282
+ |---------------|-------------|
283
+ | **Scalable** | Handle large datasets |
284
+ | **Practical** | Real-world applications |
285
+ | **Reproducible** | Datasets and code shared |
286
+ | **Industrial** | Industry datasets valued |
287
+
288
+ ## KDD Abstract
289
+
290
+ ### Emphasize Scale and Application
291
+
292
+ ```
293
+ Fraud detection in e-commerce requires processing millions of
294
+ transactions in real-time while adapting to evolving attack patterns.
295
+ We present FraudShield, a graph neural network framework for real-time
296
+ fraud detection that scales to billion-edge transaction graphs. Unlike
297
+ prior methods that require full graph access, FraudShield uses
298
+ incremental updates with O(1) inference cost per transaction. On a
299
+ proprietary dataset of 2.3 billion transactions from a major e-commerce
300
+ platform, FraudShield achieves 94.2% precision at 80% recall,
301
+ outperforming production baselines by 12%. The system has been deployed
302
+ at [Company], processing 50K transactions per second and preventing
303
+ an estimated $400M in annual fraud losses. We release an anonymized
304
+ benchmark dataset and code.
305
+ ```
306
+
307
+ ## KDD Paper Structure
308
+
309
+ ```
310
+ ├── Introduction
311
+ │ ├── Problem and impact
312
+ │ ├── Technical challenges
313
+ │ ├── Your approach
314
+ │ └── Contributions
315
+ ├── Related Work
316
+ ├── Preliminaries
317
+ │ ├── Problem definition
318
+ │ └── Notation
319
+ ├── Method
320
+ │ ├── Overview
321
+ │ ├── Technical components
322
+ │ └── Complexity analysis
323
+ ├── Experiments
324
+ │ ├── Datasets (with scale statistics)
325
+ │ ├── Baselines
326
+ │ ├── Main results
327
+ │ ├── Scalability experiments
328
+ │ ├── Ablation study
329
+ │ └── Case study / deployment
330
+ └── Conclusion
331
+ ```
332
+
333
+ ## KDD-Specific Requirements
334
+
335
+ ### Scalability
336
+ - **Dataset sizes**: Report number of nodes, edges, samples
337
+ - **Runtime analysis**: Wall-clock time comparisons
338
+ - **Complexity**: Time and space complexity stated
339
+ - **Scaling experiments**: Show performance vs. data size
340
+
341
+ ### Industrial Deployment
342
+ - **Case studies**: Real-world deployment stories
343
+ - **A/B tests**: Online evaluation results (if applicable)
344
+ - **Production metrics**: Business impact (if shareable)
345
+
346
+ ### Example Scalability Table
347
+
348
+ ```
349
+ Table 4: Scalability Comparison (runtime in seconds)
350
+ ──────────────────────────────────────────────────────
351
+ Dataset | Nodes | Edges | GCN | GraphSAGE | Ours
352
+ ──────────────────────────────────────────────────────
353
+ Cora | 2.7K | 5.4K | 0.3 | 0.2 | 0.1
354
+ Citeseer | 3.3K | 4.7K | 0.4 | 0.3 | 0.1
355
+ PubMed | 19.7K | 44.3K | 1.2 | 0.8 | 0.3
356
+ ogbn-arxiv | 169K | 1.17M | 8.4 | 4.2 | 1.6
357
+ ogbn-papers | 111M | 1.6B | OOM | OOM | 42.3
358
+ ──────────────────────────────────────────────────────
359
+ ```
360
+
361
+ ---
362
+
363
+ # Part 4: Common Elements Across CS Venues
364
+
365
+ ## Writing Quality
366
+
367
+ ### Clarity
368
+ - **One idea per sentence**
369
+ - **Define terms before use**
370
+ - **Use consistent notation**
371
+
372
+ ### Precision
373
+ - **Exact numbers**: "23.4%" not "about 20%"
374
+ - **Clear claims**: Avoid hedging unless necessary
375
+ - **Specific comparisons**: Name the baseline
376
+
377
+ ## Contribution Bullets
378
+
379
+ Used across all CS venues:
380
+ ```
381
+ Our contributions are:
382
+ • We identify [problem/insight]
383
+ • We propose [method name] that [key innovation]
384
+ • We demonstrate [results] on [benchmarks]
385
+ • We release [code/data] at [URL]
386
+ ```
387
+
388
+ ## Reproducibility Standards
389
+
390
+ All CS venues increasingly expect:
391
+ - **Code availability**: GitHub link (anonymous for review)
392
+ - **Data availability**: Public datasets or release plans
393
+ - **Full hyperparameters**: Training details complete
394
+ - **Random seeds**: Exact values for reproduction
395
+
396
+ ## Ethics and Broader Impact
397
+
398
+ ### NLP (ACL/EMNLP)
399
+ - **Limitations section**: Required
400
+ - **Responsible NLP checklist**: Ethical considerations
401
+ - **Bias analysis**: For models affecting people
402
+
403
+ ### HCI (CHI)
404
+ - **IRB/Ethics approval**: Required for human subjects
405
+ - **Informed consent**: Procedure described
406
+ - **Privacy considerations**: Data handling
407
+
408
+ ### KDD/WWW
409
+ - **Societal impact**: Consider misuse potential
410
+ - **Privacy preservation**: For sensitive data
411
+ - **Fairness analysis**: When applicable
412
+
413
+ ---
414
+
415
+ ## Venue Comparison Table
416
+
417
+ | Aspect | ACL/EMNLP | CHI | KDD/WWW | SIGIR |
418
+ |--------|-----------|-----|---------|-------|
419
+ | **Focus** | NLP tasks | User studies | Scalable ML | IR/search |
420
+ | **Evaluation** | Benchmarks + human | User studies | Large-scale exp | Datasets |
421
+ | **Theory weight** | Moderate | Low | Moderate | Moderate |
422
+ | **Industry value** | High | Medium | Very high | High |
423
+ | **Page limit** | 8 long / 4 short | 10 + refs | 9 + refs | 10 + refs |
424
+ | **Review style** | ARR | Direct | Direct | Direct |
425
+
426
+ ---
427
+
428
+ ## Pre-Submission Checklist
429
+
430
+ ### All CS Venues
431
+ - [ ] Clear contribution statement
432
+ - [ ] Strong baselines
433
+ - [ ] Reproducibility information complete
434
+ - [ ] Correct venue template
435
+ - [ ] Anonymized (if double-blind)
436
+
437
+ ### NLP-Specific
438
+ - [ ] Standard benchmark results
439
+ - [ ] Error analysis included
440
+ - [ ] Human evaluation (for generation)
441
+ - [ ] Responsible NLP checklist
442
+
443
+ ### HCI-Specific
444
+ - [ ] IRB approval stated
445
+ - [ ] Participant demographics
446
+ - [ ] Direct quotes in findings
447
+ - [ ] Design implications
448
+
449
+ ### Data Mining-Specific
450
+ - [ ] Scalability experiments
451
+ - [ ] Dataset size statistics
452
+ - [ ] Runtime comparisons
453
+ - [ ] Complexity analysis
454
+
455
+ ---
456
+
457
+ ## See Also
458
+
459
+ - `venue_writing_styles.md` - Master style overview
460
+ - `ml_conference_style.md` - NeurIPS/ICML style guide
461
+ - `conferences_formatting.md` - Technical formatting requirements
462
+ - `reviewer_expectations.md` - What CS reviewers seek
463
+
@@ -0,0 +1,247 @@
1
+ # Cell Press Summary, Highlights, and eTOC Examples
2
+
3
+ Examples of Cell Press-specific elements including Summary (abstract), Highlights, and eTOC blurb.
4
+
5
+ ---
6
+
7
+ ## Complete Example 1: Senescence and Aging
8
+
9
+ ### Summary (150 words max)
10
+
11
+ ```
12
+ Cellular senescence is a stress response that prevents damaged cell
13
+ proliferation but can drive tissue dysfunction through the senescence-
14
+ associated secretory phenotype (SASP). How senescent cells resist
15
+ apoptosis despite expressing pro-apoptotic p53 has remained unclear.
16
+ Here, we identify FOXO4 as a pivotal mediator of senescent cell viability.
17
+ FOXO4 is highly expressed in senescent cells and directly interacts with
18
+ p53, retaining it in the nucleus and preventing p53-mediated apoptosis.
19
+ A cell-permeable peptide that disrupts FOXO4-p53 interaction selectively
20
+ induces p53 nuclear exclusion and apoptosis in senescent cells without
21
+ affecting proliferating cells. In vivo, this FOXO4 peptide neutralizes
22
+ doxorubicin-induced senescent cells and restores fitness, fur density,
23
+ and renal function in naturally aged mice. These findings establish
24
+ FOXO4-mediated p53 sequestration as a senescence-specific survival
25
+ pathway and demonstrate the therapeutic potential of targeted senescent
26
+ cell elimination.
27
+ ```
28
+
29
+ ### Highlights (≤85 characters each)
30
+
31
+ ```
32
+ • FOXO4 is selectively upregulated in senescent cells and binds p53
33
+
34
+ • FOXO4-p53 interaction retains p53 in the nucleus, preventing apoptosis
35
+
36
+ • A FOXO4-targeting peptide induces apoptosis specifically in senescent cells
37
+
38
+ • FOXO4 peptide treatment restores fitness and organ function in aged mice
39
+ ```
40
+
41
+ ### eTOC Blurb (30-50 words)
42
+
43
+ ```
44
+ Baar et al. identify FOXO4 as a critical mediator of senescent cell survival
45
+ through p53 sequestration. A peptide disrupting FOXO4-p53 interaction
46
+ selectively eliminates senescent cells and restores tissue function in
47
+ aged mice, establishing proof-of-concept for targeted senolytic therapy.
48
+ ```
49
+
50
+ ### In Brief (1 sentence)
51
+
52
+ ```
53
+ A FOXO4-targeting peptide selectively eliminates senescent cells by
54
+ releasing p53, restoring tissue function in aged mice.
55
+ ```
56
+
57
+ ---
58
+
59
+ ## Complete Example 2: Genome Organization
60
+
61
+ ### Summary (150 words max)
62
+
63
+ ```
64
+ The three-dimensional organization of chromosomes within the nucleus
65
+ influences gene expression, DNA replication, and genome stability.
66
+ Phase separation has emerged as a potential mechanism for organizing
67
+ nuclear contents, but whether condensates can shape chromosome
68
+ structure in vivo remains unknown. Here, we show that the transcriptional
69
+ coactivator BRD4 forms liquid-like condensates at super-enhancers that
70
+ organize associated chromatin into hub structures. Optogenetic induction
71
+ of BRD4 condensates is sufficient to remodel chromosome topology and
72
+ activate transcription within minutes. Conversely, disruption of BRD4
73
+ condensates with the small molecule JQ1 dissolves chromatin hubs and
74
+ rapidly silences super-enhancer-controlled genes. Single-molecule
75
+ tracking reveals that condensate formation increases the local
76
+ concentration of transcription machinery 100-fold, explaining the
77
+ transcriptional potency of super-enhancers. These results establish
78
+ phase separation as a mechanism for chromatin organization and
79
+ transcriptional control with implications for understanding and
80
+ targeting oncogenic super-enhancers.
81
+ ```
82
+
83
+ ### Highlights
84
+
85
+ ```
86
+ • BRD4 forms liquid condensates at super-enhancers in living cells
87
+
88
+ • BRD4 condensates organize chromatin into transcriptionally active hubs
89
+
90
+ • Optogenetic condensate induction rapidly remodels chromatin topology
91
+
92
+ • Condensates concentrate transcription machinery 100-fold locally
93
+ ```
94
+
95
+ ### eTOC Blurb
96
+
97
+ ```
98
+ Sabari et al. demonstrate that BRD4 forms phase-separated condensates
99
+ at super-enhancers that organize chromatin into hub structures and
100
+ concentrate transcription machinery. Optogenetic manipulation reveals
101
+ that condensate formation directly drives chromatin remodeling and
102
+ transcriptional activation.
103
+ ```
104
+
105
+ ---
106
+
107
+ ## Complete Example 3: Metabolism and Immunity
108
+
109
+ ### Summary (150 words max)
110
+
111
+ ```
112
+ Immune cells undergo dramatic metabolic reprogramming upon activation,
113
+ switching from oxidative phosphorylation to aerobic glycolysis. This
114
+ metabolic shift is thought to support the biosynthetic demands of
115
+ rapid proliferation, but whether specific metabolites directly regulate
116
+ immune cell function remains largely unexplored. Here, we show that
117
+ the glycolytic metabolite phosphoenolpyruvate (PEP) sustains T cell
118
+ receptor signaling by inhibiting sarco/endoplasmic reticulum Ca²⁺-ATPase
119
+ (SERCA) activity. PEP accumulates in activated T cells and directly
120
+ binds SERCA, preventing calcium reuptake and prolonging store-operated
121
+ calcium entry. Genetic or pharmacological enhancement of PEP levels
122
+ augments T cell effector function and anti-tumor immunity in vivo.
123
+ Conversely, tumor-derived lactate suppresses PEP levels and impairs
124
+ T cell calcium signaling, contributing to tumor immune evasion. These
125
+ findings reveal an unexpected signaling role for a glycolytic
126
+ intermediate and suggest metabolic strategies to enhance T cell
127
+ responses in cancer immunotherapy.
128
+ ```
129
+
130
+ ### Highlights
131
+
132
+ ```
133
+ • Phosphoenolpyruvate (PEP) accumulates during T cell activation
134
+
135
+ • PEP directly binds and inhibits SERCA to sustain calcium signaling
136
+
137
+ • Enhancing PEP levels augments anti-tumor T cell immunity
138
+
139
+ • Tumor lactate suppresses T cell PEP levels and calcium signaling
140
+ ```
141
+
142
+ ### eTOC Blurb
143
+
144
+ ```
145
+ Ho et al. discover that the glycolytic metabolite phosphoenolpyruvate
146
+ directly regulates T cell calcium signaling by inhibiting SERCA. This
147
+ metabolic-signaling link is exploited by tumors through lactate
148
+ secretion and offers new targets for cancer immunotherapy.
149
+ ```
150
+
151
+ ---
152
+
153
+ ## Graphical Abstract Description Examples
154
+
155
+ ### For Senescence Paper
156
+
157
+ ```
158
+ "Graphical abstract for Cell paper on FOXO4 and senescence:
159
+
160
+ Left panel: Senescent cell (enlarged, irregular shape) with FOXO4 (blue
161
+ oval) binding p53 (green oval) in nucleus, preventing apoptosis. Label:
162
+ 'FOXO4 sequesters p53 → Senescent cell survival'
163
+
164
+ Center panel: Same senescent cell with FOXO4 peptide (red wedge)
165
+ disrupting FOXO4-p53 interaction. p53 moves to mitochondria (orange
166
+ organelles). Label: 'FOXO4 peptide disrupts interaction'
167
+
168
+ Right panel: Senescent cell undergoing apoptosis (fragmenting). Label:
169
+ 'Selective senescent cell death'
170
+
171
+ Bottom: Aged mouse (grey, hunched) → Treatment arrow → Rejuvenated mouse
172
+ (brown, active). Label: 'Restored fitness in aged mice'
173
+
174
+ Color scheme: Blue for FOXO4, green for p53, red for peptide, grey
175
+ background for cells."
176
+ ```
177
+
178
+ ### For Chromatin Paper
179
+
180
+ ```
181
+ "Graphical abstract for Cell paper on BRD4 condensates:
182
+
183
+ Top row: Diagram showing BRD4 molecules (purple dots) clustering at
184
+ super-enhancer (yellow region on DNA strand), forming condensate
185
+ (purple droplet). Transcription factors (orange, green, blue small
186
+ circles) accumulate inside condensate.
187
+
188
+ Middle: Chromatin fibers (grey) being pulled into hub structure around
189
+ condensate. Arrow showing '100× local concentration increase'
190
+
191
+ Bottom: Two panels - Left shows 'JQ1' treatment dissolving condensate
192
+ and chromatin hub dispersing. Right shows 'Optogenetic activation'
193
+ creating new condensate with chromatin reorganization. Gene expression
194
+ indicators (up arrow, down arrow) for each condition."
195
+ ```
196
+
197
+ ---
198
+
199
+ ## Writing Tips for Cell Elements
200
+
201
+ ### Summary Tips
202
+
203
+ 1. **First sentence**: Establish the biological context
204
+ 2. **Second sentence**: State what was unknown (the gap)
205
+ 3. **"Here, we show/identify/demonstrate"**: Clear transition to your work
206
+ 4. **Middle sentences**: Key findings with mechanism
207
+ 5. **Final sentence**: Significance and implications
208
+
209
+ ### Highlights Tips
210
+
211
+ - **Start with a noun or verb**: "FOXO4 forms..." or "Activation of..."
212
+ - **One finding per bullet**: Don't combine multiple points
213
+ - **Be specific**: Include the protein/gene/pathway name
214
+ - **Check character count**: Strictly ≤85 characters including spaces
215
+ - **Cover different findings**: Don't repeat the same point
216
+
217
+ ### eTOC Blurb Tips
218
+
219
+ - **Start with author names**: "Smith et al. show that..."
220
+ - **One or two sentences only**: Keep it punchy
221
+ - **Include the key mechanism**: Not just the finding
222
+ - **End with significance**: Why readers should care
223
+
224
+ ---
225
+
226
+ ## Character Counting for Highlights
227
+
228
+ Use this to check your highlights:
229
+
230
+ ```
231
+ • This highlight is exactly 52 characters long including sp
232
+ ↑ Count: 52 characters ✓ (under 85)
233
+
234
+ • This highlight is getting close to the maximum allowed character limit
235
+ ↑ Count: 73 characters ✓ (under 85)
236
+
237
+ • This highlight demonstrates what happens when you try to include way too much info
238
+ ↑ Count: 88 characters ✗ (over 85 - need to shorten)
239
+ ```
240
+
241
+ ---
242
+
243
+ ## See Also
244
+
245
+ - `cell_press_style.md` - Comprehensive Cell Press writing guide
246
+ - `nature_abstract_examples.md` - Compare with Nature abstract style
247
+