Simplify agent governance and unify AI instructions - #80
Merged
Conversation
Move large copy-paste reference material out of SKILL.md into dedicated reference files and add a frontend page/UI conventions reference. Added backend templates: references/templates.md (under .agents, .claude, and agent-skills). Added frontend page/UI conventions: references/page-ui-conventions.md (under .agents, .claude, and agent-skills). Updated SKILL.md files to link to the new references and removed the inlined template/content, and trimmed AGENTS.md entries to point readers to the new skill references. Also consolidated some historical ADR notes in backend/AGENTS.md. This keeps SKILL.md concise and centralizes reusable templates/conventions for backend and frontend work.
Promote .agents/skills as the single editable skill source and remove legacy instruction copies and tool-specific reviewer files. Add a lightweight GitHub Copilot bridge (.github/copilot-instructions.md), a frontend exploratory QA skill, and tighten CLAUDE/.gitignore handling for local agent state. Update scripts and tests to use .agents/skills (sync/check), adjust governance checks, CI job description, docs (AGENTS.md/CLAUDE.md/ADR refs), and many SKILL.md texts to the new paths and wording. Misc: README/monorepo docs tweaks and prettierignore cleanup. Ensures a single canonical workflow for agents and CI guards detect regressions.
|
Important Review skippedToo many files! This PR contains 145 files, which is 45 over the limit of 100. To get a review, reduce the PR to 100 files or fewer by splitting it into smaller PRs or changing its base branch. Upgrade to a paid plan to raise the limit. This review couldn't start because sufficient usage credits or metered capacity aren't available. Add credits or update usage-based reviews in the billing tab, then retry. ⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Plus Run ID: 📒 Files selected for processing (145)
You can disable this status message by setting the Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
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 changed
.agents/skills/the canonical skill source and synchronizes it to.claude/skills/CLAUDE.mdfiles to thin imports of the correspondingAGENTS.mdWhy
The repository had several overlapping Markdown instruction layers, duplicated skills, and stale implementation details. That increased context usage and could give Codex, Claude Code, and GitHub Copilot conflicting guidance.
Impact
Agents now share one durable instruction hierarchy while loading specialized workflows only when relevant. Tool-local state is ignored, removed Graphify content is guarded against reintroduction, and CI validates the cross-agent layout.
Validation
python scripts/sync_agent_skills.py --checkpython scripts/check_agent_governance.pypython scripts/architecture_guard.pydotnet build backend/AdminBackend.slnxdotnet test backend/AdminBackend.slnx