feat: add AGENTS.colormath.md as a third vendored file - #18
Merged
Conversation
Consumers each carried their own agent docs, and the shared half had already drifted apart. Surveying four apps, the gate suite was documented four ways — sixteen gates, nine, nine, seven — and one repo named two disabled gates that were not the two its gates.yml actually disables. Each copy was right when written; nothing marks the ones that stopped being. AGENTS.colormath.md carries the half that is identical everywhere: what being a colormath app means, the sixteen gates with their local make mirrors and how to pass each, the preflight rhythm, the /colormath:ship pipeline, the layering and design-token and docstring conventions, the ADR practice, and the guardrails. It vendors and refreshes exactly like Makefile.colormath and eslint.config.colormath.mjs. Two things deliberately stay with the consumer: which gates it disables — that lives in gates.yml and COLORMATH_PREFLIGHT_SKIP, and prose about them is precisely what went stale — and where its design tokens live. The shared file states the rule and points at the local file for the value. Additive: nothing reads it in CI, and no gate, input or target changes. example/ carries the wiring as the reference consumer. Stamps both refs to v3.1.0 per LIFECYCLE.md. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016fYp58qmSaG5iYpDZouXTv
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds
AGENTS.colormath.md, a third vendored file alongsideMakefile.colormathandeslint.config.colormath.mjs, refreshed by the samemake colormath-update. Stamps both refs to v3.1.0.Why
Consumers each wrote their own agent docs, and the shared half had already drifted. Surveying four apps, the gate suite was documented four ways — sixteen gates, nine, nine, seven — and one repo's doc named two disabled gates that were not the two its
gates.ymlactually disables. Each copy was right when it was written, and nothing marks the ones that stopped being right.What's in the shared file
What being a colormath app means · the sixteen gates with their local
makemirrors and how to pass each · the preflight rhythm · the/colormath:shippipeline · layering, design-token and docstring conventions · the ADR practice · the guardrails (never hand-edit the vendored files, never push to the default branch, never touch.env, justify every CVE ignore).What deliberately stays with the consumer
gates.yml(enable-<gate>: false) andCOLORMATH_PREFLIGHT_SKIP— prose about them is exactly what went stale, so the shared file points at those two as the authority.Risk
Additive. Nothing reads the file in CI; no gate, workflow input or Makefile target changes. A consumer that never vendors it is unaffected; one that does gets it on its next
colormath-updateand wires up the@AGENTS.colormath.mdimport in that same PR. MINOR per LIFECYCLE.md.example/carries the wiring as the reference consumer.Verification
refs-lockstepchecked locally:gates.ymldefault andCOLORMATH_REFbothv3.1.0.CLAUDE.md→AGENTS.md→AGENTS.colormath.md), each answering questions only the shared file covers.🤖 Generated with Claude Code
https://claude.ai/code/session_016fYp58qmSaG5iYpDZouXTv