René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Add AGENTS.md and .github/copilot-instructions.md for AI agent onboarding","articleBody":"## Summary\n\nThis repository has no agent instruction files, which means every AI coding agent (Copilot, Codex, Cursor, etc.) starts from scratch each time — re-discovering build commands, testing patterns, project structure, and conventions.\n\n## Proposal\n\nAdd two complementary files:\n\n| File | Purpose | Read by |\n|---|---|---|\n| `AGENTS.md` | Agent-agnostic open standard ([agents.md spec](https://agents.md/)) | Copilot cloud agent, OpenAI Codex, Cursor, Amp, Jules, Gemini, and others |\n| `.github/copilot-instructions.md` | GitHub Copilot-specific instructions ([docs](https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions)) | Copilot Chat, code review, completions, cloud agent |\n\n## What to include\n\n- **Project overview**: Go CLI extension for managing stacked PRs\n- **Build / test / vet commands**: `go mod download`, `go build ./...`, `go test -race -count=1 ./...`, `go vet ./...`\n- **Project structure**: key packages (`cmd/`, `internal/git`, `internal/stack`, `internal/github`, etc.)\n- **Testing patterns**: `config.NewTestConfig()`, `git.SetOps(mock)`, `MockClient`, table-driven tests, `testify` assertions\n- **Error handling**: typed `ExitError` codes, `errors.As()` pattern\n- **Key interfaces**: `git.Ops`, `github.ClientOps`\n- **Coding conventions**: Cobra commands, bubbletea TUI, config injection hooks\n\n## Design considerations\n\n- `copilot-instructions.md` should stay under ~4,000 chars (Copilot code review limit)\n- `AGENTS.md` can be more detailed\n- Both should use natural language Markdown — no proprietary format\n- Content should be broadly applicable (not task-specific)\n\n## References\n\n- [GitHub docs: Repository custom instructions](https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions)\n- [AGENTS.md open standard](https://agents.md/)\n- [github/awesome-copilot instruction templates](https://github.com/github/awesome-copilot/tree/main/instructions)\n","author":{"url":"https://github.com/francisfuzz","@type":"Person","name":"francisfuzz"},"datePublished":"2026-06-17T02:31:27.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/132/gh-stack/issues/132"}