avoid-ai-writing/.ssot.yaml at main · conorbronsdon/avoid-ai-writing · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
# Which promo surfaces copy this repo's counts, and where the real number lives.
#
# There are two links in this chain and they are policed separately:
#
#   SKILL.md  ->  README.md          scripts/check-pattern-count.sh (every push)
#   README.md ->  promo surfaces     this manifest (.github/workflows/promo-drift.yml)
#
# The first link derives the count from the catalog, so the README cannot lie
# about SKILL.md. The second link is the one that actually rots: a release moves
# the number here, the four surfaces below sit still, and nothing in *their*
# repos changes — so no pre-commit hook over there can ever fire on it. That is
# why this check is a release/cron job and not a hook.
#
# Checked with https://github.com/conorbronsdon/ssot-check:
#   python3 ssot_check.py check          # from this repo root, siblings cloned at ../
#
# Adding a surface is two lines under `copies`. Do not add a surface that floors
# the number ("60+ pattern categories") — a floored number is a different,
# looser fact, and tracking it as a copy fires false drift on every release.
#
# conorbronsdon.com/builds is deliberately absent for exactly that reason: it
# floors both counts, so there is nothing to keep in sync. It is also the one
# private surface, and excluding it keeps this check free of any credential.

facts:
  - name: avoid-ai-pattern-count
    type: integer
    note: >
      The human-facing prose-catalog category count. Canonical is the README
      bullet, which check-pattern-count.sh derives from SKILL.md's `###` entries
      under "What to remove or fix". This is NOT the detector engine's `type`
      category count — that number is deliberately different and the mapping
      lives in detector/CATEGORIES.md. Never reconcile the two.
    canonical:
      file: README.md
      pattern: '\*\*(\d+) pattern categories\*\*'
    copies:
      - file: CLAUDE.md
        pattern: 'README "(\d+) pattern categories" bullet'
      - file: ../agent-skills/README.md
        pattern: '(\d+) pattern categories'
      - file: ../ai-tools-for-creators/README.md
        pattern: '(\d+) pattern categories'
      - file: ../conorbronsdon/README.md
        pattern: '(\d+) pattern categories'

  - name: avoid-ai-replacement-table
    type: integer
    note: >
      Word replacement table entry count (Tier 1 + 2 + 3 data rows; the Tier 3
      *phrases* table is counted separately in the README bullet and excluded
      here). Canonical is the README bullet, derived from SKILL.md by
      check-pattern-count.sh. agent-skills is absent below on purpose: it cites
      the pattern count but not this one.
    canonical:
      file: README.md
      pattern: '\*\*(\d+)-entry word replacement table'
    copies:
      - file: ../ai-tools-for-creators/README.md
        pattern: '(\d+)-entry replacement table'
      - file: ../conorbronsdon/README.md
        pattern: '(\d+)-entry replacement table'