Skip to content

audit: define genre handling when a page has no declaration #55

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

Draft
echo719 wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

audit: define genre handling when a page has no declaration #55

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 skills/hallmark/references/verbs/audit.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@ Audit *also* checks structural fingerprint: if the page uses the AI template (ce

**Genre-aware audit.** If the audited file's stamp names a genre (e.g. `genre: atmospheric`), apply the genre-scoped overrides from [`slop-test.md`](../slop-test.md) when grading. A radial-gradient background is a critical tell for editorial — but allowed for atmospheric. A pure-white paper is a tell for editorial — but allowed for modern-minimal. The audit verb must respect the genre the page declared.

**No genre declaration.** If neither a CSS stamp nor `design.md` declares a genre, infer it from the page's visible product and design signals using the Design flow's genre-detection table. State `Inferred genre: <genre> (no declaration; <evidence>)` before the findings. If two non-default genres have comparable evidence, state `Genre ambiguous: <a> vs <b>` and apply only universal gates; do not escalate a genre-scoped gate until the page declares one.

**`design.md` audit.** If the project root has a `design.md` (or `DESIGN.md`), read it before grading. Then check every audited page against the system:

- **Theme drift.** Page uses tokens / fonts / accent that don't match `design.md`'s declared system → flag as `critical: design-system drift`. Per-page theme picks are slop on a system-managed project even if each page is internally fine.
Expand Down