refactor(refs): condense frontend-agent references to local knowledge (W-PR3)#899
Merged
Conversation
… — typescript-frontend, ui-design, typescript-debugging 89:11 generic-to-local audit remediation, PR3 of 7. Merges and condenses; every agent keeps its references/ dir and at least one file. typescript-frontend: 17,247 -> 2,301 words (10 -> 3 files) ui-design: 9,628 -> 2,539 words (9 -> 3 files) Cut: React/TS tutorial material, composition-pattern catalog, component library implementations, WCAG restatement, default-Tailwind token boilerplate. Kept: React View Transitions gotchas + troubleshooting table; Next.js CVE-2025-29927, CVE-2025-55182, GHSA-rvpw-p7vw-wj3m with detection commands; TS hard-gate table, anti-rationalization, verification STOP blocks, death-loop limits; the non-obvious failure-mode table; ai-slop-detection.md untouched (operator taste); 2-to-3 motion rule; 6-state matrix; timing bounds; 5-second test. Defects fixed: - typescript-frontend-engineer.md declared not_for twice (duplicate YAML key) - design-tokens.md defaulted to Inter while ai-slop-detection.md names Inter as the tell of an absent typographic decision -> resolved for the operator's rule - ui-design-engineer.md listed typescript-frontend-engineer (an agent) under 'Companion Skills (invoke via Skill tool)'; that call fails -> moved to a Companion Agents table dispatched via the Agent tool - golang-general-engineer-compact.md listed go-patterns twice Repointed typescript-debugging-engineer cross-refs to engineering-rules.md. Pruned 3 deleted files from _KNOWN_OVERSIZED and refreshed 2 loading-table cases.
notque
force-pushed
the
track-w-3-frontend
branch
from
July 25, 2026 02:13
a5b8ac4 to
090a3d8
Compare
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
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.
Track W, PR3 of 7. Frontend domain. Merges and condenses per the mandate — every agent keeps its
references/dir and at least one file. No agent deleted.Measured
typescript-debugging-engineerwas left alone deliberately: already a single file, already at budget. Its stale cross-refs into deleted typescript-frontend files were repointed.Cut
React/TS tutorial material (hooks, discriminated unions,
satisfies, template literal types), the composition-pattern catalog, full component-library implementations (Button/Modal/Tabs/Card/Table/Badge), WCAG 2.1 restatement, and default-Tailwind token boilerplate. The composition file was 100% reconstructible and went entirely.Preserved
Both audits found no host incidents and no repo names in these two corpora — the asset here is operator taste plus version pins, and all of it survives:
keysemantics,flushSyncskipping animations, persistent-element snapshot capture), both CSS workarounds (text-morph raster artifacts, backdrop-filter flash), the duration budget, and the full 12-row troubleshooting table.ai-slop-detection.mduntouched. It is the operator taste, including every ripgrep detection command and the Japanese-indigo palette example.React.cacheObject.isargument equality, RSC reference-identity dedup breakage, Strict Mode remount,useEffectEventunstable identity,localStoragethrowing in private browsing.whileHover-without-focus accessibility trap.Defects fixed
typescript-frontend-engineer.mddeclarednot_for:twice — duplicate YAML key; the second silently won. Removed.design-tokens.mddefaulted--font-sanstoInter(andimplementation-patterns.mddid the same) whileai-slop-detection.mdnames Inter as the tell of an absent typographic decision — the corpus failed its own ripgrep check. Both token files are gone; the surviving rule lives inai-slop-detection.md, anddesign-conventions.mdnow states explicitly that a token set is not seeded with a default typeface.ui-design-engineer.mdlistedtypescript-frontend-engineer— an agent — under "Companion Skills (invoke via Skill tool)". That call fails. Moved to a separate Companion Agents table dispatched via the Agent tool.golang-general-engineer-compact.mdlistedgo-patternstwice (carried from PR2 review).Gates (local, ruff 0.15.12 matching CI)
ruff checkpass -ruff format --check583 files pass ---check-do-framingpass ---check-placeholderspass -validate_reference_loading_tables.pyexit 0 -pytest scripts/tests/ -q4707 passed, 1 skipped, 128 xfailed.--allstructure issues: 5 agents / 10 issues, unchanged from post-PR2 baseline and 0 missing files (the two dangling cross-refs this PR initially introduced are fixed). All residual flags areNO_CODE_EXAMPLESadvisories on agents this PR does not touch.Pruned 3 now-deleted entries from
_KNOWN_OVERSIZED(xfails 139 -> 128) and refreshed 2 reference-loading cases that named deleted files, per the same-PR rule.