Rewrite AGENTS.md for integration subpackage architecture#2068
Draft
Rewrite AGENTS.md for integration subpackage architecture#2068
Conversation
Replaces the old AGENT_CONFIG dict-based 7-step process with documentation reflecting the integration subpackage architecture shipped in #1924. Removed: Supported Agents table, old step-by-step guide referencing AGENT_CONFIG/release scripts/case statements, Agent Categories lists, Directory Conventions section, Important Design Decisions section. Kept: About Spec Kit and Specify, Command File Formats, Argument Patterns, Devcontainer section. Added: Architecture overview, decision tree for base class selection, configure/register/scripts/test/override steps with real code examples from existing integrations (Windsurf, Gemini, Codex, Copilot). Agent-Logs-Url: https://github.com/github/spec-kit/sessions/71b25c53-7d0c-492a-9503-f40a437d5ece Co-authored-by: mnriem <15701806+mnriem@users.noreply.github.com>
Agent-Logs-Url: https://github.com/github/spec-kit/sessions/71b25c53-7d0c-492a-9503-f40a437d5ece Co-authored-by: mnriem <15701806+mnriem@users.noreply.github.com>
Copilot
AI
changed the title
[WIP] Update AGENTS.md for integration subpackage architecture
Rewrite AGENTS.md for integration subpackage architecture
Apr 2, 2026
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.
AGENTS.md documented the old
AGENT_CONFIGdict-based process (edit dict, update help text, modify release scripts, add case statements). Since #1924 shipped the integration subpackage architecture, AI agents following this guide produce incorrect changes.Removed
AGENT_CONFIG, release ZIP scripts,--ai-skillsflag, case statements — all gonerequires_cliandregistrar_config.diron each classAdded
integrations/<key>/subpackage structure,INTEGRATION_REGISTRYas single source of truthMarkdownIntegration/TomlIntegration/SkillsIntegration/IntegrationBaseKept unchanged
A minimal new integration now looks like:
Plus one import +
_register()call in_register_builtins()and two thin wrapper scripts.