Skip to content

docs: add blog-artifact-check to the pre-publish gate #486

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
williamzujkowski merged 1 commit into from
Aug 19, 2026
Merged

docs: add blog-artifact-check to the pre-publish gate #486

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -168,6 +168,7 @@ The Layer-1 skills are author-local tooling in `~/.claude/skills/blog-*/`
│ blog-nda-check → contextual NDA-compliance │
│ blog-argument-shape → thesis + evidence + falsifiability │
│ blog-visuals → zine doodle, diagram a11y, tokens │
│ blog-artifact-check → gist provenance, keys vs upstream │
│ │
│ blog-deep-review (separate, deliberate, expensive): │
│ 4 parallel adversarial reviewers — reason-to-exist, │
Expand Down Expand Up @@ -219,6 +220,7 @@ The Layer-1 skills are author-local tooling in `~/.claude/skills/blog-*/`
| Topic overlap with prior posts | Layer 1 (`blog-overlap`) | Author decides refinement vs new arg |
| Thesis / evidence / falsifiability | Layer 1 (`blog-argument-shape`) | Author-time editorial judgment |
| Visual coverage, diagram a11y, design tokens | Layer 1 (`blog-visuals`) | The prose audits all pass on a wall of text |
| Linked artifacts: gist provenance, config keys, CLI flags | Layer 1 (`blog-artifact-check`) | Machine-generated config is *plausible* and parses clean, so no CI check can see an ignored key. Needs the tool's upstream schema fetched and compared key by key |
| Unanswered objections, uncited prior art, self-flattering arithmetic, claims that outlived their evidence | Layer 1 (`blog-deep-review`) | Needs adversarial judgment and a web search; too expensive per-commit. **Reviewers are confidently wrong — recompute every challenged number from raw inputs before accepting a correction.** |
| Build correctness | Layer 2 (pre-commit) | Fast, blocks bad commits |
| Astro design tokens | Layer 3 (`audits.yml`) | Per-commit, blocks broken design |
Expand Down