Skip to content

Clarify writing voice for finished analyses - #90

Merged
MaxGhenis merged 1 commit into
mainfrom
max/writing-voice-guidance-20260913
Sep 13, 2026
Merged

MaxGhenis merged 1 commit into
mainfrom
max/writing-voice-guidance-20260913

Conversation

@MaxGhenis

Copy link
Copy Markdown
Contributor

PolicyEngine’s writing guidance now tells authors to introduce finished analyses without draft, review, or repair history. It names the sentence patterns to remove: self-referential glosses, argument pointers, empty contrasts, vague references, and unintroduced roles.

The guidance keeps scientific assumptions, uncertainty, limitations, and forecast-registration evidence with the claims they qualify. Corrections, changelogs, PR descriptions, and release records continue to describe changes when those changes are their subject. Authors check mechanism claims against primary sources and reread the whole document after a reviewer flags a recurring pattern.

Validation: 178 tests passed with the policy-calculation example suite excluded; the Claude wrapper built successfully and contains the exact source skill; the skill validator and git diff --check passed. No executable examples, bundles, package versions, or calculations changed.

@MaxGhenis
MaxGhenis merged commit 7d17b67 into main Sep 13, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant