Skip to content

Point overlay /scaffold at Hugging Face AGENTS.md and library CI - #19

Merged
alex-16moro merged 1 commit into
mainfrom
cursor/overlay-library-ci-scaffold-3eed
Sep 20, 2026
Merged

alex-16moro merged 1 commit into
mainfrom
cursor/overlay-library-ci-scaffold-3eed

Conversation

@alex-16moro

Copy link
Copy Markdown
Owner

Summary

The overlay /scaffold recipe now tells the coding agent to read Hugging Face's own AGENTS.md / .ai/ (do not overwrite them) and to invoke the library's make style / make quality / check_copies / check_dummies / check_repo until they exit 0.

This is the remaining gap after PR #18: kit templates already pass those gates, but attach still shipped a fork command that said "those two files only." Live-demo and Prompt A now pick an unused $2 and register public API. File-scoped overlay gate stays; never convention_check.py --all on the library.

Inherited Hugging Face Actions that need private runners or size labels may still be red on this personal fork. That is hosting, not a reason to skip make quality.

Convention gate

Run make check and make test before requesting review.
Blocking items (auto-verified; still confirm you ran the commands):

  • Overlay /scaffold reads root AGENTS.md and invokes library CI
  • Attach overwrites .cursor/commands/scaffold.md from overlay/scaffold.md
  • Tests assert attached scaffold contains make quality, check_dummies.py, AGENTS.md, and not "those two files only"
  • Never convention_check.py --all on the library

Tests run

python3 -m py_compile tools/attach_library.py
PYTHONPATH= python3 -m unittest tests.test_tooling.TestAttachEmptyMcp tests.test_tooling.TestEngineerPromptScope tests.test_tooling.TestOverlayPrGate -v

7 tests OK.

Human judgment (not the gate)

  • Does not overwrite upstream AGENTS.md / .ai/
  • Does not disable inherited workflows
Open in Web Open in Cursor 

A new engineer on the fork should follow upstream AGENTS.md/.ai/ and
invoke make style / make quality / check_dummies, not the old two-files-only
recipe. Attach copies that overlay command; tests assert the attached
scaffold keeps those library gates.

Co-authored-by: ale93.moro <ale93.moro@gmail.com>
@alex-16moro
alex-16moro marked this pull request as ready for review September 20, 2026 17:12
@alex-16moro
alex-16moro merged commit cec9951 into main Sep 20, 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.

2 participants