chore(agents): remove all obsolete agent files#7191
Merged
fbeaudoincoveo merged 3 commits intomainfrom Mar 3, 2026
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR removes a large number of obsolete AI agent/instruction configuration files from the repository as part of a cleanup effort. The project has transitioned to using AGENTS.md files and dedicated Agent Skills, making these older artifacts redundant.
Changes:
- Removes all
.instructions.mdfiles from.github/instructions/(general, TypeScript, atomic, and Playwright-TypeScript guidelines), as their content has been redistributed into AGENTS.md or Agent Skills. - Removes multiple
.agent.mdfiles that are superseded, migration-related (Stencil→Lit migration is complete), or were unused community-sourced agents. - Removes the
creating-agents,creating-prompts, andcreating-instructionsClaude skills and their associated scripts/references from.claude/skills/. - Removes
internal-docs/opencode-setup.md, the OpenCode CLI setup guide.
Reviewed changes
Copilot reviewed 35 out of 35 changed files in this pull request and generated no comments.
Show a summary per file
| File | Description |
|---|---|
.github/instructions/general.instructions.md |
Removed: general coding principles |
.github/instructions/general.typescript.instructions.md |
Removed: TypeScript-specific type safety/module rules |
.github/instructions/atomic.instructions.md |
Removed: Lit component conventions for the Atomic package |
.github/instructions/playwright-typescript.instructions.md |
Removed: Playwright E2E test writing guidelines |
.github/agents/accessibility-v1.agent.md |
Removed: superseded by applying-wcag-guidelines Agent Skill |
.github/agents/prompt-engineer-v1.agent.md |
Removed: superseded by v2 / will become an Agent Skill |
.github/agents/refine-issue-v1.agent.md |
Removed: community-sourced, reportedly unused |
.github/agents/research-technical-spike-v1.agent.md |
Removed: community-sourced, reportedly unused |
.github/agents/review-component-migration-v1.agent.md |
Removed: Stencil→Lit migration is complete |
.github/agents/stencil-to-lit-migration-v1.agent.md |
Removed: Stencil→Lit migration is complete |
.github/agents/stencil-to-lit-migration-v2.agent.md |
Removed: Stencil→Lit migration is complete |
.github/agents/task-researcher-v1.agent.md |
Removed: community-sourced, reportedly unused |
.github/agents/typescript-mcp-expert-v1.agent.md |
Removed: superseded by creating-stories Agent Skill |
.claude/skills/creating-agents/ |
Removed: entire skill directory including scripts and references |
.claude/skills/creating-prompts/ |
Removed: entire skill directory including scripts and references |
.claude/skills/creating-instructions/ |
Removed: entire skill directory including scripts and references |
internal-docs/opencode-setup.md |
Removed: OpenCode CLI setup guide |
Comments suppressed due to low confidence (2)
internal-docs/opencode-setup.md:1
- Deleting
internal-docs/opencode-setup.mdleaves a dangling reference inREADME.md(line 113), which links to this file as the OpenCode setup guide. TheREADME.mdsection at lines 109–113 reads: "This repo includes configuration for the OpenCode CLI (including the Sisyphus agent). Setup guide: internal-docs/opencode-setup.md". After this deletion, that link will be broken. The README.md should be updated to remove or replace this reference.
.github/instructions/general.instructions.md:1 - The
opencode.jsonconfiguration file references both.github/instructions/general.instructions.mdand.github/instructions/general.typescript.instructions.mdin its"instructions"array (lines 6–7 ofopencode.json). Both of these files are being deleted by this PR, which means OpenCode will fail to load its configured instructions after this change. Theopencode.jsonshould either be updated to remove these references or point to wherever the content was relocated (e.g., an AGENTS.md file).
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.

Context
This PR is a follow up to:
What's Removed
.instructions.mdfiles - Reasoning: all useful instructions have been redistributed into AGENTS.md files or Agent Skillscreating-agentscreating-instructionscreating-prompts.agent.mdfiles:accessibility-v1- Reasoning: made obsolete by `applying-wcage-guidelines Agent Skillprompt-engineer-v1- Reasoning: made obsolete byprompt-engineer-v2; will be turned into an Agent Skillrefine-issue-v2- Reasoning: was grabbed from awesome-copilot and likely never usedresearch-technical-spike-v2- Reasoning: was grabbed from awesome-copilot and likely never usedreview-component-migration-v1- Reasoning: Stencil -> Lit component migration is overstencil-to-lit-migration(v1 and v2) - Reasoning: Stencil -> Lit component migration is overtask-researcher-v1- Reasoning: was grabbed from awesome-copilot and likely never usedtypescript-mcp-expert- Reasoning: made obsolete bycreating-storiesAgent SkillNext Steps
maintenance-v1.agent.mdinto Agent Skillprompt-engineer-v2.agent.mdinto Agent Skillremaining .agent.mdfiles.claudedirectory to.agentsand update configs / referenceshttps://coveord.atlassian.net/browse/KIT-5493