paperlint 3.2.0 → 4.0.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 (312) hide show
  1. package/CLAUDE.md +2 -2
  2. package/dist/adapters/banal/failure.d.ts +1 -7
  3. package/dist/adapters/banal/failure.d.ts.map +1 -1
  4. package/dist/adapters/banal/failure.js +5 -7
  5. package/dist/adapters/banal/failure.js.map +1 -1
  6. package/dist/adapters/banal/index.d.ts.map +1 -1
  7. package/dist/adapters/banal/index.js +8 -11
  8. package/dist/adapters/banal/index.js.map +1 -1
  9. package/dist/adapters/banal/install.d.ts.map +1 -1
  10. package/dist/adapters/banal/install.js +4 -3
  11. package/dist/adapters/banal/install.js.map +1 -1
  12. package/dist/adapters/banal/invocation.d.ts +9 -4
  13. package/dist/adapters/banal/invocation.d.ts.map +1 -1
  14. package/dist/adapters/banal/invocation.js +13 -1
  15. package/dist/adapters/banal/invocation.js.map +1 -1
  16. package/dist/adapters/banal/locate.d.ts +12 -9
  17. package/dist/adapters/banal/locate.d.ts.map +1 -1
  18. package/dist/adapters/banal/locate.js +19 -12
  19. package/dist/adapters/banal/locate.js.map +1 -1
  20. package/dist/adapters/banal/run.d.ts +10 -1
  21. package/dist/adapters/banal/run.d.ts.map +1 -1
  22. package/dist/adapters/banal/run.js +8 -4
  23. package/dist/adapters/banal/run.js.map +1 -1
  24. package/dist/adapters/banal/settings.d.ts +1 -1
  25. package/dist/adapters/banal/settings.d.ts.map +1 -1
  26. package/dist/adapters/banal/settings.js +2 -1
  27. package/dist/adapters/banal/settings.js.map +1 -1
  28. package/dist/adapters/memory/index.d.ts.map +1 -1
  29. package/dist/adapters/memory/index.js +8 -2
  30. package/dist/adapters/memory/index.js.map +1 -1
  31. package/dist/adapters/node/process.io.d.ts +6 -3
  32. package/dist/adapters/node/process.io.d.ts.map +1 -1
  33. package/dist/adapters/node/process.io.js.map +1 -1
  34. package/dist/adapters/node/workspace.io.d.ts.map +1 -1
  35. package/dist/adapters/node/workspace.io.js +4 -2
  36. package/dist/adapters/node/workspace.io.js.map +1 -1
  37. package/dist/adapters/references/index.d.ts.map +1 -1
  38. package/dist/adapters/references/index.js +4 -2
  39. package/dist/adapters/references/index.js.map +1 -1
  40. package/dist/build-engine.d.ts +1 -1
  41. package/dist/build-engine.d.ts.map +1 -1
  42. package/dist/build-engine.js +8 -1
  43. package/dist/build-engine.js.map +1 -1
  44. package/dist/build.d.ts +2 -3
  45. package/dist/build.d.ts.map +1 -1
  46. package/dist/build.js +5 -6
  47. package/dist/build.js.map +1 -1
  48. package/dist/caller-path.d.ts +3 -0
  49. package/dist/caller-path.d.ts.map +1 -0
  50. package/dist/caller-path.js +13 -0
  51. package/dist/caller-path.js.map +1 -0
  52. package/dist/cli.d.ts +10 -17
  53. package/dist/cli.d.ts.map +1 -1
  54. package/dist/cli.js +62 -12
  55. package/dist/cli.js.map +1 -1
  56. package/dist/doctor.d.ts +12 -3
  57. package/dist/doctor.d.ts.map +1 -1
  58. package/dist/doctor.js +2 -1
  59. package/dist/doctor.js.map +1 -1
  60. package/dist/domain/paths.d.ts +8 -2
  61. package/dist/domain/paths.d.ts.map +1 -1
  62. package/dist/domain/paths.js +12 -1
  63. package/dist/domain/paths.js.map +1 -1
  64. package/dist/domain/ready.d.ts +24 -0
  65. package/dist/domain/ready.d.ts.map +1 -0
  66. package/dist/domain/ready.js +11 -0
  67. package/dist/domain/ready.js.map +1 -0
  68. package/dist/domain/record.d.ts +8 -0
  69. package/dist/domain/record.d.ts.map +1 -0
  70. package/dist/domain/record.js +8 -0
  71. package/dist/domain/record.js.map +1 -0
  72. package/dist/domain/sha256.d.ts.map +1 -1
  73. package/dist/domain/sha256.js +4 -2
  74. package/dist/domain/sha256.js.map +1 -1
  75. package/dist/engine.d.ts +23 -22
  76. package/dist/engine.d.ts.map +1 -1
  77. package/dist/engine.js.map +1 -1
  78. package/dist/eslint-rules/bib-reachable-entry.d.ts +1 -1
  79. package/dist/eslint-rules/bib-reachable-entry.js.map +1 -1
  80. package/dist/eslint-rules/install-path-literals.d.ts +2 -2
  81. package/dist/eslint-rules/install-path-literals.js.map +1 -1
  82. package/dist/eslint-rules/paper-research-question.d.ts +1 -1
  83. package/dist/eslint-rules/paper-research-question.js.map +1 -1
  84. package/dist/eslint-rules/paper-stages.d.ts +2 -2
  85. package/dist/eslint-rules/paper-stages.js.map +1 -1
  86. package/dist/eslint-rules/paper-typography.d.ts +6 -6
  87. package/dist/eslint-rules/paper-typography.js.map +1 -1
  88. package/dist/eslint-rules/pdf-last-page-balance.d.ts +1 -1
  89. package/dist/eslint-rules/pdf-last-page-balance.js.map +1 -1
  90. package/dist/eslint-rules/review-frontmatter.d.ts +2 -2
  91. package/dist/eslint-rules/review-frontmatter.js.map +1 -1
  92. package/dist/eslint-rules/sibling-frontmatter.d.ts +1 -1
  93. package/dist/eslint-rules/sibling-frontmatter.d.ts.map +1 -1
  94. package/dist/eslint-rules/temp-root-realpath.d.ts +1 -1
  95. package/dist/eslint-rules/temp-root-realpath.js.map +1 -1
  96. package/dist/eslint-rules/tex-build.d.ts +2 -2
  97. package/dist/eslint-rules/tex-build.js.map +1 -1
  98. package/dist/facts-file.d.ts.map +1 -1
  99. package/dist/facts-file.js +29 -26
  100. package/dist/facts-file.js.map +1 -1
  101. package/dist/hooks-settings.d.ts.map +1 -1
  102. package/dist/hooks-settings.js +17 -2
  103. package/dist/hooks-settings.js.map +1 -1
  104. package/dist/init.d.ts +3 -4
  105. package/dist/init.d.ts.map +1 -1
  106. package/dist/init.js +18 -8
  107. package/dist/init.js.map +1 -1
  108. package/dist/lib/paper-config.d.ts.map +1 -1
  109. package/dist/lib/paper-config.js +1 -5
  110. package/dist/lib/paper-config.js.map +1 -1
  111. package/dist/new-paper.d.ts.map +1 -1
  112. package/dist/new-paper.js +5 -1
  113. package/dist/new-paper.js.map +1 -1
  114. package/dist/paper-files.d.ts +4 -4
  115. package/dist/paper-files.d.ts.map +1 -1
  116. package/dist/paper-files.js +6 -6
  117. package/dist/paper-files.js.map +1 -1
  118. package/dist/paper-settings.js +3 -3
  119. package/dist/paper-settings.js.map +1 -1
  120. package/dist/pdf-facts.d.ts +51 -1
  121. package/dist/pdf-facts.d.ts.map +1 -1
  122. package/dist/pdf-facts.js +23 -15
  123. package/dist/pdf-facts.js.map +1 -1
  124. package/dist/pdf-geometry.d.ts.map +1 -1
  125. package/dist/pdf-geometry.js +2 -3
  126. package/dist/pdf-geometry.js.map +1 -1
  127. package/dist/ports/tool-installer.d.ts +2 -14
  128. package/dist/ports/tool-installer.d.ts.map +1 -1
  129. package/dist/presets.d.ts.map +1 -1
  130. package/dist/presets.js +16 -4
  131. package/dist/presets.js.map +1 -1
  132. package/dist/references.d.ts.map +1 -1
  133. package/dist/references.js +4 -4
  134. package/dist/references.js.map +1 -1
  135. package/dist/rules-config.d.ts +26 -1
  136. package/dist/rules-config.d.ts.map +1 -1
  137. package/dist/rules-config.js +9 -9
  138. package/dist/rules-config.js.map +1 -1
  139. package/dist/tex-requirements.d.ts +4 -0
  140. package/dist/tex-requirements.d.ts.map +1 -1
  141. package/dist/tex-requirements.js +14 -2
  142. package/dist/tex-requirements.js.map +1 -1
  143. package/dist/types.d.ts +5 -3
  144. package/dist/types.d.ts.map +1 -1
  145. package/dist/venue-rules.d.ts.map +1 -1
  146. package/dist/venue-rules.js +20 -7
  147. package/dist/venue-rules.js.map +1 -1
  148. package/docs/configuration.md +2 -2
  149. package/eslint-rules/bib-reachable-entry.ts +1 -1
  150. package/eslint-rules/install-path-literals.ts +2 -2
  151. package/eslint-rules/paper-research-question.ts +1 -1
  152. package/eslint-rules/paper-stages.ts +2 -2
  153. package/eslint-rules/paper-typography.ts +2 -2
  154. package/eslint-rules/pdf-last-page-balance.ts +1 -1
  155. package/eslint-rules/review-frontmatter.ts +1 -1
  156. package/eslint-rules/temp-root-realpath.ts +1 -1
  157. package/eslint-rules/tex-build.ts +2 -2
  158. package/eslint.config.mjs +7 -0
  159. package/fixtures/install-path-literals/clean.fixture.mjs +1 -1
  160. package/fixtures/install-path-literals/clean.md +2 -2
  161. package/fixtures/install-path-literals/defect.fixture.mjs +1 -1
  162. package/fixtures/install-path-literals/defect.md +2 -2
  163. package/hooks/paper-status-gates.sh +9 -19
  164. package/lib/paper-config.harness.mjs +1 -1
  165. package/lib/paper-config.ts +1 -5
  166. package/lib/skill-checks.mjs +24 -381
  167. package/lib/skill-checks.test.mjs +63 -115
  168. package/lib/skill-corpus.mjs +10 -251
  169. package/lib/skill-corpus.test.mjs +2 -13
  170. package/lib/skill-trigger-cases.mjs +1 -1
  171. package/package.json +1 -1
  172. package/scripts/coverage-config.test.ts +0 -1
  173. package/scripts/harness-api.frozen.json +0 -1
  174. package/skills/analyze-sibling-paper/SKILL.md +1 -39
  175. package/skills/analyze-sibling-paper/SKILL.md.spec.ts +0 -38
  176. package/skills/argument-arc/SKILL.md +2 -36
  177. package/skills/argument-arc/SKILL.md.spec.ts +1 -43
  178. package/skills/build-benchmark/SKILL.md +1 -41
  179. package/skills/build-benchmark/SKILL.md.spec.ts +0 -40
  180. package/skills/camera-ready/SKILL.md +1 -34
  181. package/skills/camera-ready/SKILL.md.spec.ts +0 -33
  182. package/skills/cold-read-diff/SKILL.md +1 -35
  183. package/skills/cold-read-diff/SKILL.md.spec.ts +0 -34
  184. package/skills/draft-paper/SKILL.md +2 -41
  185. package/skills/draft-paper/SKILL.md.spec.ts +1 -50
  186. package/skills/extend-paper/SKILL.md +2 -33
  187. package/skills/extend-paper/SKILL.md.spec.ts +1 -42
  188. package/skills/find-venue/SKILL.md +2 -38
  189. package/skills/find-venue/SKILL.md.spec.ts +1 -47
  190. package/skills/grade-paper-writing/SKILL.md +3 -38
  191. package/skills/grade-paper-writing/SKILL.md.spec.ts +2 -47
  192. package/skills/grade-paper-writing/prose-lint.mjs +2 -3
  193. package/skills/grade-paper-writing/prose-lint.test.ts +1 -1
  194. package/skills/harden-paper/SKILL.md +1 -39
  195. package/skills/harden-paper/SKILL.md.spec.ts +0 -38
  196. package/skills/map-prior-work/SKILL.md +1 -35
  197. package/skills/map-prior-work/SKILL.md.spec.ts +0 -34
  198. package/skills/osf-artifact-upload/osf-artifact-upload.harness.ts +3 -4
  199. package/skills/paper-adversarial-review/SKILL.md +2 -35
  200. package/skills/paper-adversarial-review/SKILL.md.spec.ts +1 -43
  201. package/skills/paper-pipeline/SKILL.md +2 -28
  202. package/skills/paper-pipeline/SKILL.md.spec.ts +1 -27
  203. package/skills/paper-pipeline/grade-paper-writing-ablation.eval.mjs +1 -1
  204. package/skills/paper-pipeline/paper-pipeline.harness.mjs +25 -40
  205. package/skills/paper-pipeline/references/acceptance-gate.md +1 -6
  206. package/skills/paper-pipeline/references/pipeline-status-template.md +8 -35
  207. package/skills/paper-pipeline/scripts/README.md +30 -225
  208. package/skills/paper-pipeline/scripts/artifact-coverage.harness.mjs +4 -8
  209. package/skills/paper-pipeline/scripts/consumer.harness.mjs +6 -104
  210. package/skills/paper-pipeline/scripts/consumer.mjs +23 -104
  211. package/skills/paper-pipeline/scripts/generated-code.harness.mjs +2 -3
  212. package/skills/paper-pipeline/scripts/population-map.harness.mjs +3 -3
  213. package/skills/paper-status/SKILL.md +2 -42
  214. package/skills/paper-status/SKILL.md.spec.ts +1 -41
  215. package/skills/pc-panel-review/SKILL.md +2 -46
  216. package/skills/pc-panel-review/SKILL.md.spec.ts +1 -45
  217. package/skills/plan-paper-timeline/SKILL.md +2 -36
  218. package/skills/plan-paper-timeline/SKILL.md.spec.ts +0 -36
  219. package/skills/render-paper/SKILL.md +1 -37
  220. package/skills/render-paper/SKILL.md.spec.ts +0 -36
  221. package/skills/research-ideate/SKILL.md +2 -39
  222. package/skills/research-ideate/SKILL.md.spec.ts +1 -47
  223. package/skills/study-accepted-papers/SKILL.md +1 -34
  224. package/skills/study-accepted-papers/SKILL.md.spec.ts +0 -33
  225. package/skills/submit-paper/SKILL.md +1 -33
  226. package/skills/submit-paper/SKILL.md.spec.ts +0 -32
  227. package/skills/sweep-design-space/SKILL.md +1 -38
  228. package/skills/sweep-design-space/SKILL.md.spec.ts +0 -37
  229. package/skills/tighten-paper/SKILL.md +2 -39
  230. package/skills/tighten-paper/SKILL.md.spec.ts +1 -47
  231. package/skills/tighten-paper/structure.mjs +4 -11
  232. package/skills/verify-citations/SKILL.md +2 -38
  233. package/skills/verify-citations/SKILL.md.spec.ts +1 -37
  234. package/src/adapters/banal/failure.ts +9 -10
  235. package/src/adapters/banal/index.test.ts +2 -2
  236. package/src/adapters/banal/index.ts +8 -10
  237. package/src/adapters/banal/install.ts +9 -4
  238. package/src/adapters/banal/invocation.test.ts +20 -8
  239. package/src/adapters/banal/invocation.ts +23 -8
  240. package/src/adapters/banal/locate.test.ts +2 -2
  241. package/src/adapters/banal/locate.ts +27 -21
  242. package/src/adapters/banal/run.test.ts +2 -2
  243. package/src/adapters/banal/run.ts +16 -10
  244. package/src/adapters/banal/settings.ts +2 -2
  245. package/src/adapters/curl/download.test.ts +4 -4
  246. package/src/adapters/memory/index.ts +4 -3
  247. package/src/adapters/node/files.test.ts +5 -3
  248. package/src/adapters/node/process.io.ts +9 -2
  249. package/src/adapters/node/process.test.ts +4 -4
  250. package/src/adapters/node/workspace.io.ts +9 -4
  251. package/src/adapters/references/index.ts +7 -2
  252. package/src/build-engine.test.ts +11 -6
  253. package/src/build-engine.ts +10 -5
  254. package/src/build.test.ts +10 -11
  255. package/src/build.ts +8 -9
  256. package/src/caller-path.ts +13 -0
  257. package/src/cli.harness.mjs +0 -2
  258. package/src/cli.test.ts +19 -8
  259. package/src/cli.ts +82 -25
  260. package/src/doctor.test.ts +1 -1
  261. package/src/doctor.ts +14 -5
  262. package/src/domain/paths.test.ts +15 -0
  263. package/src/domain/paths.ts +20 -1
  264. package/src/domain/ready.ts +31 -0
  265. package/src/domain/record.test.ts +20 -0
  266. package/src/domain/record.ts +12 -0
  267. package/src/domain/sha256.ts +5 -3
  268. package/src/engine.ts +30 -2
  269. package/src/facts-file.ts +43 -28
  270. package/src/hooks-settings.harness.ts +17 -0
  271. package/src/hooks-settings.ts +28 -4
  272. package/src/init.test.ts +25 -5
  273. package/src/init.ts +26 -12
  274. package/src/new-paper.harness.mjs +7 -23
  275. package/src/new-paper.ts +7 -3
  276. package/src/paper-files.test.ts +22 -19
  277. package/src/paper-files.ts +16 -27
  278. package/src/paper-settings.test.ts +2 -2
  279. package/src/paper-settings.ts +5 -5
  280. package/src/pdf-facts.test.ts +16 -5
  281. package/src/pdf-facts.ts +79 -22
  282. package/src/pdf-geometry.ts +5 -3
  283. package/src/ports/tool-installer.ts +2 -17
  284. package/src/presets.ts +28 -14
  285. package/src/references.test.ts +25 -19
  286. package/src/references.ts +4 -5
  287. package/src/rules-config.ts +40 -11
  288. package/src/tex-requirements.test.ts +21 -0
  289. package/src/tex-requirements.ts +29 -6
  290. package/src/toolchain.test.ts +9 -5
  291. package/src/toolchain.ts +2 -2
  292. package/src/types.ts +5 -3
  293. package/src/venue-rules.test.ts +8 -4
  294. package/src/venue-rules.ts +21 -11
  295. package/skills/paper-pipeline/scripts/announce.mjs +0 -67
  296. package/skills/paper-pipeline/scripts/announce.test.mjs +0 -102
  297. package/skills/paper-pipeline/scripts/fixtures/clean/PIPELINE-STATUS.md +0 -51
  298. package/skills/paper-pipeline/scripts/fixtures/dirty/PIPELINE-STATUS.md +0 -52
  299. package/skills/paper-pipeline/scripts/fixtures/dirty/paper.md +0 -6
  300. package/skills/paper-pipeline/scripts/fixtures/scorecard.ts +0 -100
  301. package/skills/paper-pipeline/scripts/ledger.cli.test.mjs +0 -302
  302. package/skills/paper-pipeline/scripts/ledger.mjs +0 -623
  303. package/skills/paper-pipeline/scripts/ledger.test.mjs +0 -254
  304. package/skills/paper-pipeline/scripts/pipeline-check.cli.test.mjs +0 -474
  305. package/skills/paper-pipeline/scripts/pipeline-check.harness.mjs +0 -328
  306. package/skills/paper-pipeline/scripts/pipeline-check.mjs +0 -750
  307. package/skills/paper-pipeline/scripts/pipeline-edges.mjs +0 -169
  308. package/skills/paper-pipeline/scripts/pipeline-edges.test.mjs +0 -73
  309. package/skills/paper-pipeline/scripts/run-mechanical.mjs +0 -648
  310. package/skills/paper-pipeline/scripts/run-mechanical.test.mjs +0 -468
  311. package/skills/paper-pipeline/scripts/status.mjs +0 -295
  312. package/skills/paper-pipeline/scripts/status.test.mjs +0 -232
@@ -24,20 +24,6 @@ export default experimental_skill({
24
24
  body: `
25
25
  # analyze-sibling-paper — settle "isn't this just X?" before a reviewer does
26
26
 
27
- ## Run me
28
-
29
- 🔴 FIRST, before any other step:
30
-
31
- \`\`\`
32
- node .claude/skills/paper-pipeline/scripts/announce.mjs analyze-sibling-paper <paper-dir>
33
- \`\`\`
34
-
35
- An advisory pass cannot be observed failing — silence is both its error state and its normal
36
- state — so starting is an event, and events get written down.
37
-
38
- The \`<paper-dir>\` argument is **your** paper, not the sibling — the row belongs to the paper being
39
- defended. The sibling is named by \`<report-path>\` when the verdict is recorded.
40
-
41
27
  When a paper close to yours surfaces, the wrong move is to cite it from its abstract and move on — that
42
28
  leaves a scoop risk you can't see and a reviewer can. This skill reads the *actual* competitor, judges
43
29
  whether your contribution genuinely differs, and produces a saved analysis with concrete action points
@@ -129,30 +115,6 @@ and the action points (with the exact clause text to add/replace). Per the save-
129
115
  analysis that lives only in a chat is lost the moment the session ends — and it's exactly what you'll need
130
116
  again at rebuttal. **A close sibling with no file in \`<paper-dir>/siblings/\` is an unfinished analysis.**
131
117
 
132
- ## Record the verdict
133
-
134
- 🔴 LAST step, once the deliverable exists:
135
-
136
- \`\`\`
137
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record analyze-sibling-paper <paper-dir> FINDING <count> <report-path>
138
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record analyze-sibling-paper <paper-dir> ABSTAINED <reason> "<one line>"
139
- \`\`\`
140
-
141
- **FINDING** — \`<count>\` is the number of action points the card produced (positioning clauses plus
142
- *MUST CITE* entries), \`<report-path>\` is the saved card, which names the sibling. Add \`--blocking\`
143
- for a genuine scoop, which the skill already treats as an escalation rather than a clause.
144
- **ABSTAINED** — \`no-witness\`: the sibling was read in full and the delta needs no text to change.
145
- \`blocked\`: the sibling's full text could not be obtained, so only its abstract was seen — which is
146
- explicitly not an analysis and must never be recorded as one.
147
-
148
- 🔴 **There is no PASS.** "The delta is real" read identically whether the sibling had been read
149
- whole or skimmed, and this skill's own first rule is that an abstract-only delta is not a verdict.
150
- \`no-witness\` and \`blocked\` now say which happened.
151
-
152
- One row per sibling analysed, filed under its own \`--check=<sibling-slug>\`; several finding rows
153
- against one paper is the normal shape here, not a check that keeps failing. Before 2026-08-10 they
154
- would have overwritten one another.
155
-
156
118
  ## Rules
157
119
  - **Read the paper, not the abstract.** An abstract-only "delta" is not a verdict — and the card must
158
120
  say so: \`read: abstract\` in its frontmatter, and which parts in its \`**Read:**\` line.
@@ -1,10 +1,10 @@
1
1
  ---
2
2
  name: argument-arc
3
3
  description: Build or repair the paper's argument architecture — the one-sentence-per-section outline, the bottom-up inevitability pass, and the name/number budget. Run it when the reader says the paper throws ideas at them, when a structural objection repeats, or before any large rewrite. Not a prose or length skill.
4
- allowed-tools: [Read, Write, Grep, Glob, Agent, Bash(node .claude/skills/paper-pipeline/scripts/announce.mjs:*), Bash(node .claude/skills/paper-pipeline/scripts/ledger.mjs:*)]
4
+ allowed-tools: [Read, Write, Grep, Glob, Agent]
5
5
  ---
6
6
 
7
- <!-- vigiles:sha256:05a1eaa79bb596d5 compiled from skills/argument-arc/SKILL.md.spec.ts -->
7
+ <!-- vigiles:sha256:66be3161e5bde916 compiled from skills/argument-arc/SKILL.md.spec.ts -->
8
8
 
9
9
  # argument-arc — does the paper carry the reader to one conclusion
10
10
 
@@ -14,17 +14,6 @@ allowed-tools: [Read, Write, Grep, Glob, Agent, Bash(node .claude/skills/paper-p
14
14
  > whether the argument exists. Run it *before* them — cutting words inside a broken arc is how a
15
15
  > session burns a day and ships the same paper.
16
16
 
17
- ## Run me
18
-
19
- 🔴 FIRST, before any other step:
20
-
21
- ```
22
- node .claude/skills/paper-pipeline/scripts/announce.mjs argument-arc <paper-dir>
23
- ```
24
-
25
- An advisory pass cannot be observed failing — silence is both its error state and its normal
26
- state — so starting is an event, and events get written down.
27
-
28
17
  The failure it exists to catch has a signature: every paragraph is defensible, every number is real,
29
18
  and the reader still finishes the section unable to say what it was for. That is not a prose problem
30
19
  and no amount of rewriting sentences fixes it.
@@ -48,7 +37,6 @@ came out — which is how a run gets thrown away. That is not hypothetical: it w
48
37
  data is collected costs the data. Costs a paragraph; saves a study.**
49
38
 
50
39
  `build-benchmark` reads this paragraph before designing, and refuses to proceed if `frame` is empty.
51
- `pipeline-check.mjs` reports a study that ran with no stated claim.
52
40
 
53
41
  *Added 2026-08-03 alongside the replacement of the numbered stage list — this skill previously existed
54
42
  only as a repair, which meant nobody stated the claim while stating it was still cheap.*
@@ -125,28 +113,6 @@ most needs help. This skill does:
125
113
  the calendar against it is a category error.
126
114
  - **Rebuild produces a new outline through steps 1–4 above, and it too gets shown before editing.**
127
115
 
128
- ## Record the verdict
129
-
130
- 🔴 LAST step, once the deliverable exists:
131
-
132
- ```
133
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record argument-arc <paper-dir> FINDING <count> <report-path>
134
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record argument-arc <paper-dir> ABSTAINED <reason> "<one line>"
135
- ```
136
-
137
- 🔴 **There is no PASS.** "The arc carries the reader" is not a value this pass can write down; it is
138
- what a reader may conclude from the absence of findings, and the concluding is theirs.
139
-
140
- **FINDING** — the arc is broken; `<count>` is the number of sections the new outline moves, merges
141
- or deletes, and `<report-path>` is that outline. Add `--blocking` when there is no conclusion
142
- sentence to build an arc from: that refusal is a finding about the draft, not an aborted run, and
143
- `<report-path>` is the one-line statement of what is missing.
144
- **ABSTAINED** — `no-witness`: the outline was read end to end and nothing moved. `blocked`: there
145
- was no outline to read at all.
146
-
147
- An `ABSTAINED no-witness` on a draft the author has twice called a pile is a missed finding, and
148
- `status.mjs` will start asking about a check that has only ever abstained.
149
-
150
116
  ## Rules
151
117
 
152
118
  - **The arc is judged on the outline, never on the draft.** If you find yourself rereading paragraphs
@@ -10,15 +10,7 @@ export default experimental_skill({
10
10
  name: "argument-arc",
11
11
  description:
12
12
  "Build or repair the paper's argument architecture — the one-sentence-per-section outline, the bottom-up inevitability pass, and the name/number budget. Run it when the reader says the paper throws ideas at them, when a structural objection repeats, or before any large rewrite. Not a prose or length skill.",
13
- tools: [
14
- "Read",
15
- "Write",
16
- "Grep",
17
- "Glob",
18
- "Agent",
19
- "Bash(node .claude/skills/paper-pipeline/scripts/announce.mjs:*)",
20
- "Bash(node .claude/skills/paper-pipeline/scripts/ledger.mjs:*)",
21
- ],
13
+ tools: ["Read", "Write", "Grep", "Glob", "Agent"],
22
14
  body: `
23
15
  # argument-arc — does the paper carry the reader to one conclusion
24
16
 
@@ -28,17 +20,6 @@ export default experimental_skill({
28
20
  > whether the argument exists. Run it *before* them — cutting words inside a broken arc is how a
29
21
  > session burns a day and ships the same paper.
30
22
 
31
- ## Run me
32
-
33
- 🔴 FIRST, before any other step:
34
-
35
- \`\`\`
36
- node .claude/skills/paper-pipeline/scripts/announce.mjs argument-arc <paper-dir>
37
- \`\`\`
38
-
39
- An advisory pass cannot be observed failing — silence is both its error state and its normal
40
- state — so starting is an event, and events get written down.
41
-
42
23
  The failure it exists to catch has a signature: every paragraph is defensible, every number is real,
43
24
  and the reader still finishes the section unable to say what it was for. That is not a prose problem
44
25
  and no amount of rewriting sentences fixes it.
@@ -62,7 +43,6 @@ came out — which is how a run gets thrown away. That is not hypothetical: it w
62
43
  data is collected costs the data. Costs a paragraph; saves a study.**
63
44
 
64
45
  \`build-benchmark\` reads this paragraph before designing, and refuses to proceed if \`frame\` is empty.
65
- \`pipeline-check.mjs\` reports a study that ran with no stated claim.
66
46
 
67
47
  *Added 2026-08-03 alongside the replacement of the numbered stage list — this skill previously existed
68
48
  only as a repair, which meant nobody stated the claim while stating it was still cheap.*
@@ -139,28 +119,6 @@ most needs help. This skill does:
139
119
  the calendar against it is a category error.
140
120
  - **Rebuild produces a new outline through steps 1–4 above, and it too gets shown before editing.**
141
121
 
142
- ## Record the verdict
143
-
144
- 🔴 LAST step, once the deliverable exists:
145
-
146
- \`\`\`
147
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record argument-arc <paper-dir> FINDING <count> <report-path>
148
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record argument-arc <paper-dir> ABSTAINED <reason> "<one line>"
149
- \`\`\`
150
-
151
- 🔴 **There is no PASS.** "The arc carries the reader" is not a value this pass can write down; it is
152
- what a reader may conclude from the absence of findings, and the concluding is theirs.
153
-
154
- **FINDING** — the arc is broken; \`<count>\` is the number of sections the new outline moves, merges
155
- or deletes, and \`<report-path>\` is that outline. Add \`--blocking\` when there is no conclusion
156
- sentence to build an arc from: that refusal is a finding about the draft, not an aborted run, and
157
- \`<report-path>\` is the one-line statement of what is missing.
158
- **ABSTAINED** — \`no-witness\`: the outline was read end to end and nothing moved. \`blocked\`: there
159
- was no outline to read at all.
160
-
161
- An \`ABSTAINED no-witness\` on a draft the author has twice called a pile is a missed finding, and
162
- \`status.mjs\` will start asking about a check that has only ever abstained.
163
-
164
122
  ## Rules
165
123
 
166
124
  - **The arc is judged on the outline, never on the draft.** If you find yourself rereading paragraphs
@@ -5,21 +5,10 @@ context: fork
5
5
  allowed-tools: [Read, Write, Edit, Grep, Glob, Bash, Agent]
6
6
  ---
7
7
 
8
- <!-- vigiles:sha256:067ada6f8aa44d5b compiled from skills/build-benchmark/SKILL.md.spec.ts -->
8
+ <!-- vigiles:sha256:0b91129ca6a6b2a3 compiled from skills/build-benchmark/SKILL.md.spec.ts -->
9
9
 
10
10
  # build-benchmark — the study + the artifact reviewers can run
11
11
 
12
- ## Run me
13
-
14
- 🔴 FIRST, before any other step:
15
-
16
- ```
17
- node .claude/skills/paper-pipeline/scripts/announce.mjs build-benchmark <paper-dir>
18
- ```
19
-
20
- An advisory pass cannot be observed failing — silence is both its error state and its normal
21
- state — so starting is an event, and events get written down.
22
-
23
12
  A measurement paper is only as strong as the artifact a reviewer can `cd` into and re-run. This skill
24
13
  covers both halves: the study design that makes the finding true, and the self-checking artifact that
25
14
  makes it *verifiable*. The contribution is the **method**, not the one tool you happened to test — build
@@ -163,35 +152,6 @@ real-code-through-real-contract execution reveals it.
163
152
  Before submitting, verify the artifact you built with the reviewer-side reproduction protocol:
164
153
  **`references/adversarial-cold-repro.md`** (cold re-run, three-way reconcile, robustness attacks).
165
154
 
166
- ## Record the verdict
167
-
168
- 🔴 LAST step, once the deliverable exists:
169
-
170
- ```
171
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record build-benchmark <paper-dir> FINDING <count> <report-path>
172
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record build-benchmark <paper-dir> ABSTAINED <reason> "<one line>"
173
- ```
174
-
175
- 🔴 **There is no PASS.** An artifact that recomputes every headline number and exits 0 has produced
176
- no finding; it has not certified the study. Record the absence, do not name it a success.
177
-
178
- **FINDING** — `<count>` numbers did not reproduce, or reproduce only with caveats; `<report-path>`
179
- is the artifact output. Add `--blocking` for the §0 refusal: `frame` is empty, so the study was not
180
- designed.
181
- **ABSTAINED** — `no-witness`: the artifact ran and every number reproduced. `input-missing`: the
182
- raw data is not in the repo. `crashed`: the harness itself died.
183
-
184
- 🔴 That §0 refusal is a **finding, not an aborted run** — it is a fact about the work, so it is a
185
- FINDING and not an abstention. Record it and stop. A study that was never designed leaves exactly
186
- the same silence as one that is still running, and the difference costs a week to rediscover.
187
-
188
- 🔴 **THREE MECHANICAL CHECKS FILE UNDER THIS SKILL** and each has its own ledger row:
189
- `build-benchmark/check-provenance`, `build-benchmark/arm-permutation`,
190
- `build-benchmark/delivered-pdf` (see `.claude/skills/paper-pipeline/scripts/run-mechanical.mjs`). Until 2026-08-10 the
191
- ledger keyed on the SKILL, so a clean run of one erased a finding of another from every derived
192
- view — which is why two of the three sat unwired. This block records the JUDGEMENT pass, under the
193
- bare key `build-benchmark`; never file a mechanical result here.
194
-
195
155
  ## Compose with
196
156
  - **argument-arc (frame mode)** — 🔴 **hard input.** Owns row `frame`, the stated claim. No `frame`, no study.
197
157
  - **research-ideate** (upstream) — supplies the contribution and the pitfall to invert; this skill turns
@@ -15,17 +15,6 @@ export default experimental_skill({
15
15
  body: `
16
16
  # build-benchmark — the study + the artifact reviewers can run
17
17
 
18
- ## Run me
19
-
20
- 🔴 FIRST, before any other step:
21
-
22
- \`\`\`
23
- node .claude/skills/paper-pipeline/scripts/announce.mjs build-benchmark <paper-dir>
24
- \`\`\`
25
-
26
- An advisory pass cannot be observed failing — silence is both its error state and its normal
27
- state — so starting is an event, and events get written down.
28
-
29
18
  A measurement paper is only as strong as the artifact a reviewer can \`cd\` into and re-run. This skill
30
19
  covers both halves: the study design that makes the finding true, and the self-checking artifact that
31
20
  makes it *verifiable*. The contribution is the **method**, not the one tool you happened to test — build
@@ -169,35 +158,6 @@ real-code-through-real-contract execution reveals it.
169
158
  Before submitting, verify the artifact you built with the reviewer-side reproduction protocol:
170
159
  **\`references/adversarial-cold-repro.md\`** (cold re-run, three-way reconcile, robustness attacks).
171
160
 
172
- ## Record the verdict
173
-
174
- 🔴 LAST step, once the deliverable exists:
175
-
176
- \`\`\`
177
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record build-benchmark <paper-dir> FINDING <count> <report-path>
178
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record build-benchmark <paper-dir> ABSTAINED <reason> "<one line>"
179
- \`\`\`
180
-
181
- 🔴 **There is no PASS.** An artifact that recomputes every headline number and exits 0 has produced
182
- no finding; it has not certified the study. Record the absence, do not name it a success.
183
-
184
- **FINDING** — \`<count>\` numbers did not reproduce, or reproduce only with caveats; \`<report-path>\`
185
- is the artifact output. Add \`--blocking\` for the §0 refusal: \`frame\` is empty, so the study was not
186
- designed.
187
- **ABSTAINED** — \`no-witness\`: the artifact ran and every number reproduced. \`input-missing\`: the
188
- raw data is not in the repo. \`crashed\`: the harness itself died.
189
-
190
- 🔴 That §0 refusal is a **finding, not an aborted run** — it is a fact about the work, so it is a
191
- FINDING and not an abstention. Record it and stop. A study that was never designed leaves exactly
192
- the same silence as one that is still running, and the difference costs a week to rediscover.
193
-
194
- 🔴 **THREE MECHANICAL CHECKS FILE UNDER THIS SKILL** and each has its own ledger row:
195
- \`build-benchmark/check-provenance\`, \`build-benchmark/arm-permutation\`,
196
- \`build-benchmark/delivered-pdf\` (see \`.claude/skills/paper-pipeline/scripts/run-mechanical.mjs\`). Until 2026-08-10 the
197
- ledger keyed on the SKILL, so a clean run of one erased a finding of another from every derived
198
- view — which is why two of the three sat unwired. This block records the JUDGEMENT pass, under the
199
- bare key \`build-benchmark\`; never file a mechanical result here.
200
-
201
161
  ## Compose with
202
162
  - **argument-arc (frame mode)** — 🔴 **hard input.** Owns row \`frame\`, the stated claim. No \`frame\`, no study.
203
163
  - **research-ideate** (upstream) — supplies the contribution and the pitfall to invert; this skill turns
@@ -4,21 +4,10 @@ description: On acceptance, turn the anonymized-for-review paper into the de-ano
4
4
  allowed-tools: [Read, Write, Edit, Grep, Glob, Bash, WebSearch, WebFetch]
5
5
  ---
6
6
 
7
- <!-- vigiles:sha256:8fa0190054cc5314 compiled from skills/camera-ready/SKILL.md.spec.ts -->
7
+ <!-- vigiles:sha256:5c85ef4004c31956 compiled from skills/camera-ready/SKILL.md.spec.ts -->
8
8
 
9
9
  # camera-ready — de-anonymize an accepted paper into the final proceedings version
10
10
 
11
- ## Run me
12
-
13
- 🔴 FIRST, before any other step:
14
-
15
- ```
16
- node .claude/skills/paper-pipeline/scripts/announce.mjs camera-ready <paper-dir>
17
- ```
18
-
19
- An advisory pass cannot be observed failing — silence is both its error state and its normal
20
- state — so starting is an event, and events get written down.
21
-
22
11
  The reviewed PDF was anonymized on purpose. Acceptance flips that: the camera-ready carries your
23
12
  real name, your real repo, and an archival DOI — and it's the version that gets indexed, so it's the
24
13
  actual authorship evidence. This skill is the reverse of the anonymization you did at
@@ -113,28 +102,6 @@ If tight, ACM allows references to spill into the reference-only extra pages.
113
102
  - Record the paper's DOI, the artifact DOI, and the ORCID in the paper's HANDOFF — those three IDs are
114
103
  the authorship evidence and the anchor the extension (`extend-paper`) builds on.
115
104
 
116
- ## 6. Record the verdict
117
-
118
- 🔴 LAST step, once the deliverable exists:
119
-
120
- ```
121
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record camera-ready <paper-dir> FINDING <count> <report-path>
122
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record camera-ready <paper-dir> ABSTAINED <reason> "<one line>"
123
- ```
124
-
125
- **FINDING** — `<count>` residual items still open; `<report-path>` names them. Add `--blocking` for
126
- anything that must not be pushed past: anonymization residue, a dead artifact link, or — on a
127
- security paper — disclosure not yet complete.
128
- **ABSTAINED** — `no-witness`: shipped, de-anonymized, DOI live, page limit re-checked, with the DOI
129
- in the note. `blocked`: the acceptance notice has not arrived, so there is nothing to make ready.
130
-
131
- 🔴 That blocking finding is the only one in this pipeline whose consequence is **irreversible**. The
132
- public de-anonymized repo is Google-findable the moment it is pushed, so record it before, not after.
133
-
134
- 🔴 **There is no PASS**, and on this skill that is not a formality: a stored "shipped" would have
135
- been the one row in the pipeline that could be true of a repo nobody had looked at. The DOI in the
136
- note is the witness. Without it there is nothing to check the row against.
137
-
138
105
  ## Compose with
139
106
  - **submit-paper** (upstream — this reverses what it anonymized).
140
107
  - **paper-pipeline/references/anonymization.md** — the canonical list of anonymization moves; undo each.
@@ -23,17 +23,6 @@ export default experimental_skill({
23
23
  body: `
24
24
  # camera-ready — de-anonymize an accepted paper into the final proceedings version
25
25
 
26
- ## Run me
27
-
28
- 🔴 FIRST, before any other step:
29
-
30
- \`\`\`
31
- node .claude/skills/paper-pipeline/scripts/announce.mjs camera-ready <paper-dir>
32
- \`\`\`
33
-
34
- An advisory pass cannot be observed failing — silence is both its error state and its normal
35
- state — so starting is an event, and events get written down.
36
-
37
26
  The reviewed PDF was anonymized on purpose. Acceptance flips that: the camera-ready carries your
38
27
  real name, your real repo, and an archival DOI — and it's the version that gets indexed, so it's the
39
28
  actual authorship evidence. This skill is the reverse of the anonymization you did at
@@ -128,28 +117,6 @@ If tight, ACM allows references to spill into the reference-only extra pages.
128
117
  - Record the paper's DOI, the artifact DOI, and the ORCID in the paper's HANDOFF — those three IDs are
129
118
  the authorship evidence and the anchor the extension (\`extend-paper\`) builds on.
130
119
 
131
- ## 6. Record the verdict
132
-
133
- 🔴 LAST step, once the deliverable exists:
134
-
135
- \`\`\`
136
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record camera-ready <paper-dir> FINDING <count> <report-path>
137
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record camera-ready <paper-dir> ABSTAINED <reason> "<one line>"
138
- \`\`\`
139
-
140
- **FINDING** — \`<count>\` residual items still open; \`<report-path>\` names them. Add \`--blocking\` for
141
- anything that must not be pushed past: anonymization residue, a dead artifact link, or — on a
142
- security paper — disclosure not yet complete.
143
- **ABSTAINED** — \`no-witness\`: shipped, de-anonymized, DOI live, page limit re-checked, with the DOI
144
- in the note. \`blocked\`: the acceptance notice has not arrived, so there is nothing to make ready.
145
-
146
- 🔴 That blocking finding is the only one in this pipeline whose consequence is **irreversible**. The
147
- public de-anonymized repo is Google-findable the moment it is pushed, so record it before, not after.
148
-
149
- 🔴 **There is no PASS**, and on this skill that is not a formality: a stored "shipped" would have
150
- been the one row in the pipeline that could be true of a repo nobody had looked at. The DOI in the
151
- note is the witness. Without it there is nothing to check the row against.
152
-
153
120
  ## Compose with
154
121
  - **submit-paper** (upstream — this reverses what it anonymized).
155
122
  - **paper-pipeline/references/anonymization.md** — the canonical list of anonymization moves; undo each.
@@ -5,20 +5,11 @@ context: fork
5
5
  allowed-tools: [Bash, Read, Agent]
6
6
  ---
7
7
 
8
- <!-- vigiles:sha256:596fbd7e2eb85252 compiled from skills/cold-read-diff/SKILL.md.spec.ts -->
8
+ <!-- vigiles:sha256:e45391841e689aa9 compiled from skills/cold-read-diff/SKILL.md.spec.ts -->
9
9
 
10
10
  # cold-read-diff — the reader who cannot fake understanding
11
11
 
12
- ## Run me
13
12
 
14
- 🔴 FIRST, before any other step:
15
-
16
- ```
17
- node .claude/skills/paper-pipeline/scripts/announce.mjs cold-read-diff <paper-dir>
18
- ```
19
-
20
- An advisory pass cannot be observed failing — silence is both its error state and its normal
21
- state — so starting is an event, and events get written down.
22
13
 
23
14
  ## The failure this exists for
24
15
 
@@ -120,25 +111,6 @@ findings:
120
111
  ---
121
112
  ```
122
113
 
123
- ## Record the verdict
124
-
125
- 🔴 LAST step, once the deliverable exists:
126
-
127
- ```
128
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record cold-read-diff <paper-dir> FINDING <count> <report-path>
129
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record cold-read-diff <paper-dir> ABSTAINED <reason> "<one line>"
130
- ```
131
-
132
- **FINDING** — `<count>` is the number of changed sentences the cold reader could not restate (every
133
- `CANNOT PARSE` counts), `<report-path>` is the `reviews/*cold-read*.md` file.
134
- **ABSTAINED** — `no-witness`: every changed sentence came back restated correctly.
135
- `input-missing`: the diff held no prose to read.
136
-
137
- 🔴 These two are different answers and the difference is the whole reason the vocabulary is closed:
138
- one says a reader read it and found nothing, the other says there was nothing to hand a reader.
139
- Prose collapses them and the old `PASS`/`ABSENT` pair only half-separated them, because `PASS` also
140
- got recorded when nobody had run a reader at all. There is no `PASS` now; the reason is the answer.
141
-
142
114
  ## Rules
143
115
 
144
116
  - 🔴 **No context in the prompt. Ever.** Not the title, not the abstract, not "this is a paper about
@@ -158,12 +130,6 @@ got recorded when nobody had run a reader at all. There is no `PASS` now; the re
158
130
  - **Run it on your own fixes too.** The author is the least qualified judge of whether his repair
159
131
  reads, and that is exactly when he feels most certain.
160
132
 
161
- ## Enforcement
162
-
163
- `pipeline-check.mjs` raises `stale-cold-read` when the newest `reviews/*cold-read*.md` is older than
164
- the paper source, and `no-cold-read` when none exists. The date comparison is the whole mechanism:
165
- a cold read that predates the current text describes prose that no longer exists.
166
-
167
133
  ## Compose with
168
134
 
169
135
  - `grade-paper-writing` — the batch readability gate; this is its continuous counterpart. That one
@@ -14,16 +14,7 @@ export default experimental_skill({
14
14
  body: `
15
15
  # cold-read-diff — the reader who cannot fake understanding
16
16
 
17
- ## Run me
18
17
 
19
- 🔴 FIRST, before any other step:
20
-
21
- \`\`\`
22
- node .claude/skills/paper-pipeline/scripts/announce.mjs cold-read-diff <paper-dir>
23
- \`\`\`
24
-
25
- An advisory pass cannot be observed failing — silence is both its error state and its normal
26
- state — so starting is an event, and events get written down.
27
18
 
28
19
  ## The failure this exists for
29
20
 
@@ -125,25 +116,6 @@ findings:
125
116
  ---
126
117
  \`\`\`
127
118
 
128
- ## Record the verdict
129
-
130
- 🔴 LAST step, once the deliverable exists:
131
-
132
- \`\`\`
133
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record cold-read-diff <paper-dir> FINDING <count> <report-path>
134
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record cold-read-diff <paper-dir> ABSTAINED <reason> "<one line>"
135
- \`\`\`
136
-
137
- **FINDING** — \`<count>\` is the number of changed sentences the cold reader could not restate (every
138
- \`CANNOT PARSE\` counts), \`<report-path>\` is the \`reviews/*cold-read*.md\` file.
139
- **ABSTAINED** — \`no-witness\`: every changed sentence came back restated correctly.
140
- \`input-missing\`: the diff held no prose to read.
141
-
142
- 🔴 These two are different answers and the difference is the whole reason the vocabulary is closed:
143
- one says a reader read it and found nothing, the other says there was nothing to hand a reader.
144
- Prose collapses them and the old \`PASS\`/\`ABSENT\` pair only half-separated them, because \`PASS\` also
145
- got recorded when nobody had run a reader at all. There is no \`PASS\` now; the reason is the answer.
146
-
147
119
  ## Rules
148
120
 
149
121
  - 🔴 **No context in the prompt. Ever.** Not the title, not the abstract, not "this is a paper about
@@ -163,12 +135,6 @@ got recorded when nobody had run a reader at all. There is no \`PASS\` now; the
163
135
  - **Run it on your own fixes too.** The author is the least qualified judge of whether his repair
164
136
  reads, and that is exactly when he feels most certain.
165
137
 
166
- ## Enforcement
167
-
168
- \`pipeline-check.mjs\` raises \`stale-cold-read\` when the newest \`reviews/*cold-read*.md\` is older than
169
- the paper source, and \`no-cold-read\` when none exists. The date comparison is the whole mechanism:
170
- a cold read that predates the current text describes prose that no longer exists.
171
-
172
138
  ## Compose with
173
139
 
174
140
  - \`grade-paper-writing\` — the batch readability gate; this is its continuous counterpart. That one
@@ -1,24 +1,13 @@
1
1
  ---
2
2
  name: draft-paper
3
3
  description: Use when the numbers exist and it's time to WRITE the paper — "draft the paper", "turn these findings into a submission", "write the abstract/intro/threats". Gives the section skeleton of a measurement/benchmark paper plus what gets it accepted AND cited — precise claim-sizing (including an explicit "what we do NOT claim"), a construct-validity frame, an honest threats-to-validity section that turns limitations in your favor, and one memorable stat that travels. Encodes the two theses that carried real measurement papers ("measuring the wrong number", "safety theater"). NOT for grading finished prose (grade-paper-writing) or structural editing (tighten-paper) — this is the generative counterpart. Compose with build-benchmark (numbers), grade-paper-writing (prose QA), render-paper, verify-citations, then the review skills.
4
- allowed-tools: [Read, Write, Edit, Grep, Glob, Agent, Skill, Bash(node .claude/skills/paper-pipeline/scripts/announce.mjs:*), Bash(node .claude/skills/paper-pipeline/scripts/ledger.mjs:*)]
4
+ allowed-tools: [Read, Write, Edit, Grep, Glob, Agent, Skill]
5
5
  ---
6
6
 
7
- <!-- vigiles:sha256:1b6a7bdc0ea402ec compiled from skills/draft-paper/SKILL.md.spec.ts -->
7
+ <!-- vigiles:sha256:46bb85bfaa45e595 compiled from skills/draft-paper/SKILL.md.spec.ts -->
8
8
 
9
9
  # draft-paper — prose that survives review and gets cited
10
10
 
11
- ## Run me
12
-
13
- 🔴 FIRST, before any other step:
14
-
15
- ```
16
- node .claude/skills/paper-pipeline/scripts/announce.mjs draft-paper <paper-dir>
17
- ```
18
-
19
- An advisory pass cannot be observed failing — silence is both its error state and its normal
20
- state — so starting is an event, and events get written down.
21
-
22
11
  A measurement paper lives or dies on two things reviewers actually reward: a **reusable method/norm**
23
12
  they can apply to the next system, and **claim-sizing so precise it can't be attacked**. Numbers alone
24
13
  are a blog post. This skill turns `build-benchmark`'s output into that kind of draft.
@@ -101,34 +90,6 @@ For papers they duplicate — and are superseded by — `grade-paper-writing` +
101
90
  pass (the blog skills lack the persona fix, so they under-fire on paper prose). Never route paper
102
91
  prose QA to them.
103
92
 
104
- ## Record the verdict
105
-
106
- 🔴 LAST step, once the deliverable exists:
107
-
108
- ```
109
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record draft-paper <paper-dir> FINDING <count> <report-path>
110
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record draft-paper <paper-dir> ABSTAINED <reason> "<one line>"
111
- ```
112
-
113
- This skill generates rather than judges, so what it records is about the run, not about the paper.
114
-
115
- **FINDING** — it declined to draft because a required input was missing: no numbers from
116
- `build-benchmark`, or an empty `frame` paragraph from `argument-arc`. `--blocking`, always, because
117
- drafting past it produces prose about numbers that do not exist.
118
- **ABSTAINED** — `no-witness`: sections were written and the generator has nothing to report about
119
- the paper. Put the drafted sections in the note; they are the deliverable, not evidence of a defect.
120
-
121
- 🔴 **Design smell, stated plainly: this gate will almost always record an abstention**, and
122
- `status.mjs` will flag it as one that has never returned a finding. Leave the flag standing — it is
123
- telling the truth. A generator is not a gate, and the only honest negative it can produce is the
124
- refusal above. If a run ever ends with prose written from numbers that do not exist, that is a
125
- `FINDING --blocking` and must be recorded as one rather than quietly upgraded.
126
-
127
- 🔴 Deleting `PASS` did not fix this skill and was never going to: the old vocabulary let it write
128
- down "I produced sections" as though that were an answer about the manuscript, and the new one
129
- simply refuses to. The generator is still not a gate. `draft-paper/population-map` — a real check —
130
- is the row that can say no about this skill's output.
131
-
132
93
  ## Compose with
133
94
  - **`build-benchmark`** — its numbers/CIs are the Results section's raw material; never hand-type a
134
95
  number that isn't in its output (that's how paper↔artifact mismatches get born).
@@ -10,31 +10,10 @@ export default experimental_skill({
10
10
  name: "draft-paper",
11
11
  description:
12
12
  'Use when the numbers exist and it\'s time to WRITE the paper — "draft the paper", "turn these findings into a submission", "write the abstract/intro/threats". Gives the section skeleton of a measurement/benchmark paper plus what gets it accepted AND cited — precise claim-sizing (including an explicit "what we do NOT claim"), a construct-validity frame, an honest threats-to-validity section that turns limitations in your favor, and one memorable stat that travels. Encodes the two theses that carried real measurement papers ("measuring the wrong number", "safety theater"). NOT for grading finished prose (grade-paper-writing) or structural editing (tighten-paper) — this is the generative counterpart. Compose with build-benchmark (numbers), grade-paper-writing (prose QA), render-paper, verify-citations, then the review skills.',
13
- tools: [
14
- "Read",
15
- "Write",
16
- "Edit",
17
- "Grep",
18
- "Glob",
19
- "Agent",
20
- "Skill",
21
- "Bash(node .claude/skills/paper-pipeline/scripts/announce.mjs:*)",
22
- "Bash(node .claude/skills/paper-pipeline/scripts/ledger.mjs:*)",
23
- ],
13
+ tools: ["Read", "Write", "Edit", "Grep", "Glob", "Agent", "Skill"],
24
14
  body: `
25
15
  # draft-paper — prose that survives review and gets cited
26
16
 
27
- ## Run me
28
-
29
- 🔴 FIRST, before any other step:
30
-
31
- \`\`\`
32
- node .claude/skills/paper-pipeline/scripts/announce.mjs draft-paper <paper-dir>
33
- \`\`\`
34
-
35
- An advisory pass cannot be observed failing — silence is both its error state and its normal
36
- state — so starting is an event, and events get written down.
37
-
38
17
  A measurement paper lives or dies on two things reviewers actually reward: a **reusable method/norm**
39
18
  they can apply to the next system, and **claim-sizing so precise it can't be attacked**. Numbers alone
40
19
  are a blog post. This skill turns \`build-benchmark\`'s output into that kind of draft.
@@ -117,34 +96,6 @@ For papers they duplicate — and are superseded by — \`grade-paper-writing\`
117
96
  pass (the blog skills lack the persona fix, so they under-fire on paper prose). Never route paper
118
97
  prose QA to them.
119
98
 
120
- ## Record the verdict
121
-
122
- 🔴 LAST step, once the deliverable exists:
123
-
124
- \`\`\`
125
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record draft-paper <paper-dir> FINDING <count> <report-path>
126
- node .claude/skills/paper-pipeline/scripts/ledger.mjs record draft-paper <paper-dir> ABSTAINED <reason> "<one line>"
127
- \`\`\`
128
-
129
- This skill generates rather than judges, so what it records is about the run, not about the paper.
130
-
131
- **FINDING** — it declined to draft because a required input was missing: no numbers from
132
- \`build-benchmark\`, or an empty \`frame\` paragraph from \`argument-arc\`. \`--blocking\`, always, because
133
- drafting past it produces prose about numbers that do not exist.
134
- **ABSTAINED** — \`no-witness\`: sections were written and the generator has nothing to report about
135
- the paper. Put the drafted sections in the note; they are the deliverable, not evidence of a defect.
136
-
137
- 🔴 **Design smell, stated plainly: this gate will almost always record an abstention**, and
138
- \`status.mjs\` will flag it as one that has never returned a finding. Leave the flag standing — it is
139
- telling the truth. A generator is not a gate, and the only honest negative it can produce is the
140
- refusal above. If a run ever ends with prose written from numbers that do not exist, that is a
141
- \`FINDING --blocking\` and must be recorded as one rather than quietly upgraded.
142
-
143
- 🔴 Deleting \`PASS\` did not fix this skill and was never going to: the old vocabulary let it write
144
- down "I produced sections" as though that were an answer about the manuscript, and the new one
145
- simply refuses to. The generator is still not a gate. \`draft-paper/population-map\` — a real check —
146
- is the row that can say no about this skill's output.
147
-
148
99
  ## Compose with
149
100
  - **\`build-benchmark\`** — its numbers/CIs are the Results section's raw material; never hand-type a
150
101
  number that isn't in its output (that's how paper↔artifact mismatches get born).