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,535 @@
1
+ # Medical Journal Writing Style Guide
2
+
3
+ Comprehensive writing guide for NEJM, Lancet, JAMA, BMJ, Annals of Internal Medicine, and other major medical journals.
4
+
5
+ **Last Updated**: 2024
6
+
7
+ ---
8
+
9
+ ## Overview
10
+
11
+ Medical journals prioritize **clinical relevance**, **patient outcomes**, and **evidence-based practice**. Writing must be precise, evidence-focused, and directly applicable to clinical decision-making.
12
+
13
+ ### Key Philosophy
14
+
15
+ > "Every sentence should help a clinician make better decisions for their patients."
16
+
17
+ **Primary Goal**: Communicate research findings that can improve patient care and clinical practice.
18
+
19
+ ---
20
+
21
+ ## Audience and Tone
22
+
23
+ ### Target Reader
24
+
25
+ - Practicing physicians and clinicians
26
+ - Clinical researchers
27
+ - Healthcare policymakers
28
+ - Medical educators
29
+ - Some public health and patient advocacy readers
30
+
31
+ ### Tone Characteristics
32
+
33
+ | Characteristic | Description |
34
+ |---------------|-------------|
35
+ | **Evidence-focused** | Appropriate hedging based on study design |
36
+ | **Patient-centered** | Focus on patient outcomes, not just biomarkers |
37
+ | **Clinical** | Emphasize practical applicability |
38
+ | **Precise** | Exact numbers, confidence intervals, NNT |
39
+ | **Measured** | Claims match evidence strength |
40
+
41
+ ### Voice
42
+
43
+ - **Passive voice common**: "Patients were randomized to..."
44
+ - **First person acceptable**: "We conducted a trial..."
45
+ - **Third person for patients**: "Patients" not "subjects"
46
+
47
+ ---
48
+
49
+ ## Abstract: Structured Format
50
+
51
+ ### Overview
52
+
53
+ Most major medical journals require **structured abstracts** with labeled sections. This is one of the few venues where structured abstracts are expected.
54
+
55
+ ### Standard Structure (IMRAD-based)
56
+
57
+ ```
58
+ Background: [Why this study was needed - 1-2 sentences]
59
+
60
+ Methods: [Study design, setting, participants, intervention,
61
+ main outcomes - 2-4 sentences]
62
+
63
+ Results: [Primary and key secondary outcomes with statistics -
64
+ 3-5 sentences]
65
+
66
+ Conclusions: [Clinical implications, with appropriate hedging -
67
+ 1-2 sentences]
68
+ ```
69
+
70
+ ### Word Limits by Journal
71
+
72
+ | Journal | Abstract Limit |
73
+ |---------|---------------|
74
+ | NEJM | 250 words |
75
+ | Lancet | 300 words |
76
+ | JAMA | 350 words |
77
+ | BMJ | 300 words |
78
+ | Annals | 325 words |
79
+
80
+ ### Example Structured Abstract (NEJM Style)
81
+
82
+ ```
83
+ BACKGROUND
84
+ Type 2 diabetes is associated with increased cardiovascular risk, but
85
+ the effects of intensive glucose control on cardiovascular outcomes
86
+ remain uncertain.
87
+
88
+ METHODS
89
+ We randomly assigned 10,251 patients with type 2 diabetes and established
90
+ cardiovascular disease to receive intensive glucose-lowering therapy
91
+ (target HbA1c <6.0%) or standard therapy (target HbA1c 7.0-7.9%). The
92
+ primary outcome was a composite of nonfatal myocardial infarction,
93
+ nonfatal stroke, or death from cardiovascular causes.
94
+
95
+ RESULTS
96
+ After a median follow-up of 3.5 years, the primary outcome occurred in
97
+ 352 patients (6.9%) in the intensive-therapy group and in 371 patients
98
+ (7.2%) in the standard-therapy group (hazard ratio, 0.90; 95% CI, 0.78
99
+ to 1.04; P=0.16). Severe hypoglycemia was more common with intensive
100
+ therapy (3.1% vs. 1.0%; P<0.001). All-cause mortality was similar
101
+ between groups (5.0% vs. 4.8%; hazard ratio, 1.04; 95% CI, 0.87 to 1.24).
102
+
103
+ CONCLUSIONS
104
+ In patients with type 2 diabetes and established cardiovascular disease,
105
+ intensive glucose lowering did not significantly reduce major
106
+ cardiovascular events compared with standard therapy and was associated
107
+ with increased severe hypoglycemia.
108
+ ```
109
+
110
+ ---
111
+
112
+ ## Evidence Language
113
+
114
+ ### The Cardinal Rule
115
+
116
+ **Match your language to your evidence strength.**
117
+
118
+ ### Language by Study Design
119
+
120
+ | Study Design | Appropriate Language |
121
+ |-------------|---------------------|
122
+ | **Meta-analysis of RCTs** | "Treatment X reduces mortality..." |
123
+ | **Large RCT** | "Treatment X reduced mortality in this trial..." |
124
+ | **Small RCT** | "Treatment X was associated with reduced mortality..." |
125
+ | **Cohort study** | "Treatment X was associated with lower mortality..." |
126
+ | **Case-control** | "Treatment X was associated with reduced odds of death..." |
127
+ | **Cross-sectional** | "Treatment X use was associated with lower mortality..." |
128
+ | **Case series** | "These cases suggest that treatment X may..." |
129
+ | **Case report** | "This case illustrates that treatment X can..." |
130
+
131
+ ### Causal Language Rules
132
+
133
+ ❌ **Never say** (unless RCT): "Treatment X prevents..." / "Treatment X causes..."
134
+
135
+ ✅ **Use for observational**: "Treatment X was associated with..." / "Treatment X was linked to..."
136
+
137
+ ✅ **Use for RCTs**: "Treatment X resulted in..." / "Treatment X reduced..."
138
+
139
+ ### Hedging Phrases
140
+
141
+ | Certainty Level | Phrases |
142
+ |----------------|---------|
143
+ | **High** | "demonstrates," "shows," "confirms" |
144
+ | **Moderate** | "suggests," "indicates," "supports" |
145
+ | **Low** | "may," "might," "could potentially" |
146
+ | **Speculative** | "it is possible that," "one interpretation is" |
147
+
148
+ ---
149
+
150
+ ## Reporting Numbers
151
+
152
+ ### Absolute vs. Relative Risk
153
+
154
+ **Always report both absolute and relative measures.**
155
+
156
+ ❌ **Incomplete**: "Treatment reduced mortality by 50%"
157
+
158
+ ✅ **Complete**: "Treatment reduced relative mortality by 50% (absolute risk reduction, 2.5 percentage points; number needed to treat, 40)"
159
+
160
+ ### Confidence Intervals
161
+
162
+ **Always include 95% confidence intervals.**
163
+
164
+ ❌ "The hazard ratio was 0.75"
165
+
166
+ ✅ "The hazard ratio was 0.75 (95% CI, 0.62 to 0.91)"
167
+
168
+ ### P-values
169
+
170
+ - Report exact P-values when possible: P=0.003
171
+ - Use P<0.001 for very small values
172
+ - Consider clinical significance alongside statistical significance
173
+
174
+ ### Number Needed to Treat (NNT)
175
+
176
+ Include NNT for clinically important outcomes:
177
+
178
+ ```
179
+ "The intervention prevented one additional death for every 40 patients
180
+ treated (NNT=40; 95% CI, 28 to 67)."
181
+ ```
182
+
183
+ ---
184
+
185
+ ## Introduction
186
+
187
+ ### Length and Structure
188
+
189
+ - **3-4 paragraphs** (500-700 words)
190
+ - Focus on clinical problem and rationale
191
+
192
+ ### Paragraph Structure
193
+
194
+ **Paragraph 1: Clinical Problem**
195
+ - Burden of disease (incidence, prevalence, mortality)
196
+ - Impact on patients and healthcare system
197
+ - Why this matters clinically
198
+
199
+ ```
200
+ "Type 2 diabetes affects more than 450 million adults worldwide and is
201
+ a leading cause of cardiovascular disease, renal failure, and premature
202
+ death. Despite advances in glucose-lowering therapies, patients with
203
+ diabetes continue to face a two- to four-fold increased risk of
204
+ cardiovascular events compared with the general population."
205
+ ```
206
+
207
+ **Paragraph 2: Current Knowledge and Limitations**
208
+ - What treatments/approaches exist
209
+ - What evidence gaps remain
210
+ - Why more research was needed
211
+
212
+ **Paragraph 3: Rationale and Objectives**
213
+ - Why this study was conducted
214
+ - Clear statement of objectives/hypothesis
215
+ - Primary outcome stated
216
+
217
+ ```
218
+ "We therefore conducted a randomized, controlled trial to evaluate
219
+ whether intensive glucose-lowering therapy, compared with standard
220
+ therapy, would reduce major cardiovascular events in patients with
221
+ type 2 diabetes and established cardiovascular disease."
222
+ ```
223
+
224
+ ---
225
+
226
+ ## Methods
227
+
228
+ ### Structure (CONSORT/STROBE Aligned)
229
+
230
+ Medical methods sections follow reporting guidelines:
231
+
232
+ ```
233
+ METHODS
234
+ ├── Study Design
235
+ ├── Setting and Participants
236
+ │ ├── Eligibility Criteria
237
+ │ └── Recruitment
238
+ ├── Randomization and Blinding (for RCTs)
239
+ ├── Interventions
240
+ ├── Outcomes
241
+ │ ├── Primary Outcome
242
+ │ └── Secondary Outcomes
243
+ ├── Sample Size Calculation
244
+ ├── Statistical Analysis
245
+ ├── Ethics Approval
246
+ └── Registration
247
+ ```
248
+
249
+ ### Key Elements
250
+
251
+ **Eligibility Criteria**
252
+ - List inclusion and exclusion criteria explicitly
253
+ - Be specific (age ranges, disease definitions, lab values)
254
+
255
+ **Primary Outcome**
256
+ - Define precisely, including timing of assessment
257
+ - State how it was measured
258
+
259
+ **Statistical Analysis**
260
+ - Pre-specified analysis plan
261
+ - Handling of missing data
262
+ - Subgroup analyses (pre-specified vs. exploratory)
263
+
264
+ ### Example Methods Paragraph
265
+
266
+ ```
267
+ We enrolled adults aged 40 years or older with type 2 diabetes (defined
268
+ as HbA1c ≥6.5% or use of glucose-lowering medication) and established
269
+ cardiovascular disease (previous myocardial infarction, stroke, or
270
+ revascularization procedure). Patients were excluded if they had an
271
+ HbA1c level below 7.5% or above 11.0%, estimated glomerular filtration
272
+ rate below 30 ml per minute per 1.73 m² of body-surface area, or a
273
+ cardiovascular event within the past 30 days.
274
+ ```
275
+
276
+ ---
277
+
278
+ ## Results
279
+
280
+ ### Structure
281
+
282
+ **Opening: Participant Flow**
283
+ - Screening, enrollment, randomization, follow-up, analysis
284
+ - Reference CONSORT flow diagram
285
+
286
+ **Baseline Characteristics**
287
+ - Table 1: Baseline demographics and clinical characteristics
288
+ - Note any imbalances
289
+
290
+ **Primary Outcome**
291
+ - Report first and prominently
292
+ - Include point estimate, CI, P-value
293
+ - State clinical significance
294
+
295
+ **Secondary Outcomes**
296
+ - Report all pre-specified secondary outcomes
297
+ - Be cautious about multiple comparisons
298
+
299
+ **Adverse Events**
300
+ - Report serious adverse events systematically
301
+ - Include deaths, hospitalizations, SAEs by category
302
+
303
+ ### Example Results Paragraph
304
+
305
+ ```
306
+ Of 12,537 patients assessed for eligibility, 10,251 underwent
307
+ randomization: 5,128 were assigned to intensive therapy and 5,123 to
308
+ standard therapy (Figure 1). Baseline characteristics were similar
309
+ between groups (Table 1). Median follow-up was 3.5 years (interquartile
310
+ range, 2.8 to 4.2), with vital status available for 99.2% of patients.
311
+
312
+ The primary outcome occurred in 352 patients (6.9%) in the intensive-
313
+ therapy group and 371 patients (7.2%) in the standard-therapy group
314
+ (hazard ratio, 0.90; 95% confidence interval [CI], 0.78 to 1.04;
315
+ P=0.16). The absolute difference was 0.3 percentage points (95% CI,
316
+ -0.7 to 1.4). Results were consistent across pre-specified subgroups
317
+ (Figure 3).
318
+ ```
319
+
320
+ ---
321
+
322
+ ## Discussion
323
+
324
+ ### Structure
325
+
326
+ **Paragraph 1: Summary of Main Findings**
327
+ - Restate primary outcome result
328
+ - State whether hypothesis was supported
329
+
330
+ **Paragraphs 2-3: Interpretation and Context**
331
+ - How do findings compare with prior evidence?
332
+ - What mechanisms might explain findings?
333
+ - Clinical interpretation
334
+
335
+ **Paragraph 4: Strengths**
336
+ - Study design features
337
+ - Generalizability
338
+ - Completeness of follow-up
339
+
340
+ **Paragraph 5: Limitations**
341
+ - Be specific and thoughtful
342
+ - Discuss how limitations might affect interpretation
343
+ - Avoid generic statements
344
+
345
+ **Final Paragraph: Conclusions and Implications**
346
+ - Clinical implications
347
+ - Policy implications
348
+ - Future research needs
349
+
350
+ ### Example Limitations Paragraph
351
+
352
+ ```
353
+ Our study has several limitations. First, despite randomization, we
354
+ cannot exclude residual confounding from unmeasured factors. Second,
355
+ the open-label design may have introduced bias in outcome assessment
356
+ for subjective endpoints, though the primary outcome of death was
357
+ objective. Third, our findings may not generalize to patients without
358
+ established cardiovascular disease or to healthcare settings with
359
+ different resources. Fourth, the 3.5-year follow-up may have been
360
+ insufficient to detect cardiovascular benefits that emerge over
361
+ longer periods.
362
+ ```
363
+
364
+ ---
365
+
366
+ ## Journal-Specific Requirements
367
+
368
+ ### NEJM (New England Journal of Medicine)
369
+
370
+ - **Word limit**: 2,700 words (excluding abstract, references)
371
+ - **Abstract**: 250 words, structured
372
+ - **References**: ~40-50 typical
373
+ - **Figures/Tables**: 4-5 combined
374
+ - **Style**: Definitive, authoritative
375
+ - **Emphasis**: Major clinical trials, transformative research
376
+
377
+ ### Lancet
378
+
379
+ - **Word limit**: 3,500 words for research articles
380
+ - **Abstract**: 300 words, structured
381
+ - **Summary box (Panel)**: Key messages highlighted
382
+ - **Research in Context**: Required section explaining contribution
383
+ - **Style**: Global health perspective valued
384
+
385
+ ### JAMA (Journal of the American Medical Association)
386
+
387
+ - **Word limit**: 3,000 words for original investigations
388
+ - **Abstract**: 350 words, structured
389
+ - **Key Points box**: Required summary
390
+ - **Visual abstract**: Encouraged
391
+ - **Style**: Policy-relevant, public health focus
392
+
393
+ ### BMJ (British Medical Journal)
394
+
395
+ - **Word limit**: 3,000 words for research
396
+ - **Abstract**: 300 words, structured
397
+ - **What this paper adds**: Required box
398
+ - **Strengths and limitations box**: Explicit section
399
+ - **Style**: Practical, evidence-based
400
+
401
+ ### Annals of Internal Medicine
402
+
403
+ - **Word limit**: 3,000 words
404
+ - **Abstract**: 325 words, structured
405
+ - **Style**: Focused on internal medicine practice
406
+ - **Clinical Trials and Meta-analyses**: Specialty
407
+
408
+ ---
409
+
410
+ ## Reporting Guidelines Compliance
411
+
412
+ ### CONSORT (RCTs)
413
+
414
+ **25-item checklist** including:
415
+ - Trial design, randomization, blinding
416
+ - Participant flow (diagram required)
417
+ - All outcomes with effect sizes and CIs
418
+ - Harms and adverse events
419
+
420
+ ### STROBE (Observational)
421
+
422
+ **22-item checklist** for:
423
+ - Cohort, case-control, cross-sectional studies
424
+ - Setting, participants, variables, data sources
425
+ - Bias assessment, sensitivity analyses
426
+
427
+ ### PRISMA (Systematic Reviews)
428
+
429
+ **27-item checklist** including:
430
+ - Search strategy
431
+ - Study selection process (diagram)
432
+ - Risk of bias assessment
433
+ - Synthesis methods
434
+
435
+ ### STARD (Diagnostic Studies)
436
+
437
+ **30 items** for diagnostic accuracy studies
438
+
439
+ ---
440
+
441
+ ## Tables and Figures
442
+
443
+ ### Table 1: Baseline Characteristics
444
+
445
+ Standard format:
446
+ ```
447
+ Intensive Therapy Standard Therapy
448
+ (N=5128) (N=5123)
449
+ Age — yr 63.4 ± 8.7 63.6 ± 8.5
450
+ Male sex — no. (%) 3389 (66.1) 3401 (66.4)
451
+ Body-mass index 32.1 ± 5.4 32.0 ± 5.3
452
+ HbA1c — % 8.3 ± 1.1 8.3 ± 1.0
453
+ Duration of diabetes — yr 10.2 ± 7.8 10.1 ± 7.6
454
+ Prior MI — no. (%) 2435 (47.5) 2411 (47.1)
455
+ ```
456
+
457
+ ### CONSORT Flow Diagram
458
+
459
+ Required for RCTs:
460
+ ```
461
+ Assessed for eligibility (n=12,537)
462
+
463
+ ├─► Excluded (n=2,286)
464
+ │ ├─ Not meeting criteria (n=1,854)
465
+ │ ├─ Declined to participate (n=389)
466
+ │ └─ Other reasons (n=43)
467
+
468
+ Randomized (n=10,251)
469
+
470
+ ├─► Intensive therapy (n=5,128)
471
+ │ ├─ Lost to follow-up (n=52)
472
+ │ └─ Analyzed (n=5,076)
473
+
474
+ └─► Standard therapy (n=5,123)
475
+ ├─ Lost to follow-up (n=48)
476
+ └─ Analyzed (n=5,075)
477
+ ```
478
+
479
+ ### Kaplan-Meier Curves
480
+
481
+ Standard presentation:
482
+ - Survival curves with shaded confidence bands
483
+ - Number at risk table below
484
+ - Hazard ratio with 95% CI
485
+ - Log-rank P-value
486
+
487
+ ---
488
+
489
+ ## Common Mistakes in Medical Writing
490
+
491
+ 1. **Overclaiming causation**: Using "caused" for observational data
492
+ 2. **Relative risk only**: Not reporting absolute measures
493
+ 3. **Missing CIs**: Reporting point estimates without uncertainty
494
+ 4. **Vague limitations**: "Our study has limitations" without specifics
495
+ 5. **Ignoring negative results**: Selective reporting of outcomes
496
+ 6. **Clinical significance confusion**: Statistically significant ≠ clinically meaningful
497
+ 7. **Subgroup fishing**: Post-hoc subgroup analyses presented as confirmatory
498
+ 8. **Missing CONSORT/STROBE items**: Incomplete reporting
499
+
500
+ ---
501
+
502
+ ## Pre-Submission Checklist
503
+
504
+ ### Required Elements
505
+ - [ ] Structured abstract (journal-specific format)
506
+ - [ ] Trial registration number (for RCTs)
507
+ - [ ] Ethics committee approval statement
508
+ - [ ] Conflict of interest disclosures
509
+ - [ ] CONSORT/STROBE checklist completed
510
+
511
+ ### Statistical Reporting
512
+ - [ ] Primary outcome reported with CI and P-value
513
+ - [ ] Absolute and relative measures included
514
+ - [ ] All pre-specified outcomes reported
515
+ - [ ] NNT calculated for significant clinical outcomes
516
+
517
+ ### Evidence Language
518
+ - [ ] Claims match study design
519
+ - [ ] Appropriate hedging used
520
+ - [ ] Causal language only for RCTs
521
+
522
+ ### Clinical Relevance
523
+ - [ ] Clinical implications stated
524
+ - [ ] Patient-centered outcomes emphasized
525
+ - [ ] Generalizability discussed
526
+
527
+ ---
528
+
529
+ ## See Also
530
+
531
+ - `venue_writing_styles.md` - Master style overview
532
+ - `journals_formatting.md` - Technical formatting requirements
533
+ - `reviewer_expectations.md` - What medical reviewers seek
534
+ - Reporting guideline resources: consort-statement.org, strobe-statement.org
535
+