docs(agents): add AGENTS.md with template-drift sync reference#167
Conversation
Create AGENTS.md documenting the canonical template-drift workflow: how drift-scan.yml detects/auto-closes drift issues, how scripts/sync-template.sh reconciles a consumer's .github/ tree, and the universal-core dependabot scoping that avoids dependency_file_not_found. Migrated from project memory during the 2026-06-03 memory cleanup. Signed-off-by: Sebastian Mendel <sebastian.mendel@netresearch.de>
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request introduces a new AGENTS.md file, which serves as an Agent Guide explaining the organization's community health files, reusable GitHub Actions workflows, and Go repository templates. Feedback suggests improving the Markdown formatting in AGENTS.md by wrapping the issue title template in backticks instead of using backslash escapes to ensure consistent rendering across different Markdown parsers.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
There was a problem hiding this comment.
Pull request overview
Adds an AGENTS.md guide for this repository describing how template drift is detected and reconciled for consumer repositories, plus how Dependabot configuration is scoped to avoid dependency_file_not_found failures.
Changes:
- Introduces
AGENTS.mdwith a repo-level overview of whatnetresearch/.githubcontains. - Documents the template-drift workflow (
drift-scan.ymlissue lifecycle +scripts/sync-template.shremediation). - Documents Dependabot ecosystem scoping/opt-in guidance for consumers.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
…le rendering Address review feedback on the new AGENTS.md template-drift section: - Scope: clarify the per-template Dependabot baseline. go-lib baselines gomod + github-actions; go-app adds docker (every go-app repo ships a Dockerfile). npm, devcontainers, and docker-for-go-lib are opt-in. The previous text implied docker was opt-in for both, misstating the go-app baseline. - Use the full .github/template.yaml path to match sync-template.sh and drift-scan.yml instead of the bare template.yaml. - Wrap the auto-opened issue title in backticks instead of backslash-escaped angle brackets for consistent Markdown rendering. Signed-off-by: Sebastian Mendel <sebastian.mendel@netresearch.de>
|
Create the repo's first AGENTS.md with a brief header and a Template-drift sync section documenting the durable, repo-specific workflow:
drift-scan.yml(weekly Mon 06:00 UTC +workflow_dispatchwithrepos:input) auto-opens and auto-closes template-drift issues.scripts/sync-template.sh <go-app|go-lib> netresearch/<repo>reconciles a consumer's.github/tree (signed + DCO, opens a PR), never overwritingtemplate.yaml.dependency_file_not_found.Verified against the live scripts/workflows in this repo. Migrated from project memory as part of the 2026-06-03 memory cleanup.