Skip to content

feat(PROJ-000): add context + link checks to CI - #5

Merged
HenryCordes merged 3 commits into
mainfrom
henry/PROJ-000-context-guardrails
Jul 16, 2026
Merged

feat(PROJ-000): add context + link checks to CI#5
HenryCordes merged 3 commits into
mainfrom
henry/PROJ-000-context-guardrails

Conversation

@HenryCordes

@HenryCordes HenryCordes commented Jul 16, 2026

Copy link
Copy Markdown
Owner

Summary

Makes the repo's "small always-loaded context, maintained like code" claim falsifiable: CI now fails when the always-on context outgrows its budget or a context file points at a moved/deleted file.

Changes

  • scripts/check-context-budget.mjs — word budgets for CLAUDE.md (120) and AGENTS.md (400), char budget (400) per skill description; failure messages point to the fix (move content on-demand)
  • scripts/check-links.mjs — validates every relative link in tracked markdown
  • pnpm check:context / pnpm check:links + two CI steps
  • scripts/ scoped out of app ESLint (per the existing harness-scripts lesson)
  • README section explaining the guardrails

Testing

  • Both checks pass on the current tree (CLAUDE.md 82/120, AGENTS.md 285/400, descriptions ≤255/400)
  • Failure paths verified: planted broken link and over-budget file both exit 1

Related

PROJ-000

Checklist

  • pnpm lint:fix && pnpm typecheck && pnpm test pass locally
  • Tests added/updated — the scripts are the tests; failure paths exercised manually
  • Screenshots — N/A: CI tooling
  • Branch name follows {username}/{TICKET}-{description}

Henry Cordes added 3 commits July 16, 2026 16:18
check-context-budget fails CI when always-loaded context (CLAUDE.md,
AGENTS.md, skill descriptions) outgrows its budget; check-links fails
on broken relative markdown links. Makes the small-context claim
falsifiable instead of stated.
Prettier-format the two check scripts that failed CI, teach
lint-staged about js/mjs/cjs so pre-commit catches this class of
miss, and log the lesson in the commit skill.
@HenryCordes
HenryCordes merged commit 93b16fc into main Jul 16, 2026
1 check 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