Skip to content

Separate orchestration SOP (AGENTS.md) from package-specific context (CONTEXT.md)#48

Draft
Copilot wants to merge 4 commits intomainfrom
copilot/refactor-agents-md-structure
Draft

Separate orchestration SOP (AGENTS.md) from package-specific context (CONTEXT.md)#48
Copilot wants to merge 4 commits intomainfrom
copilot/refactor-agents-md-structure

Conversation

Copy link
Contributor

Copilot AI commented Feb 24, 2026

CONTEXT.md contained orchestration info (monorepo, turborepo, cloudflare deploy) that belongs in AGENTS.md as shared SOP. .github/copilot-instructions.md was a plain text file pointing at CONTEXT.md instead of making its content directly available to Copilot.

CONTEXT.md — scoped to package-specific info only

  • Removed monorepo/turborepo/cloudflare/pnpm-filter references
  • Retained only apps/web tech stack (React 19, Vite 7, Tailwind CSS 4, shadcn/ui, ESLint 9) and path alias

AGENTS.md — added missing orchestration details

.github/copilot-instructions.md → symlink

  • Replaced static text file with symlink to ../CONTEXT.md so Copilot gets package context directly (Copilot reads AGENTS.md natively but has no import mechanism for other files)
AGENTS.md                         ← shared SOP: workspace, orchestration, deploy, PR rules
CONTEXT.md                        ← agent-maintained: per-package tech stack, discovery log
.github/copilot-instructions.md   → ../CONTEXT.md (symlink)

🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.

- Add read-only notice and CONTEXT.md maintenance instruction to AGENTS.md
- Remove repo-specific references (Vite, pnpm --filter web dev) from AGENTS.md
- Create CONTEXT.md with architecture, tech stack, and discovery log
- Create .github/copilot-instructions.md linking Copilot to CONTEXT.md

Co-authored-by: IntranetFactory <7462342+IntranetFactory@users.noreply.github.com>
Copilot AI changed the title [WIP] Refactor and restructure AGENTS.md for standard SOP Refactor AGENTS.md into reusable SOP + repo-specific CONTEXT.md Feb 24, 2026
…uctions.md

- Remove orchestration info (monorepo, turborepo, cloudflare) from CONTEXT.md
- Keep only apps/web package tech stack (React, Vite, Tailwind, shadcn/ui)
- Replace .github/copilot-instructions.md with symlink to ../CONTEXT.md

Co-authored-by: IntranetFactory <7462342+IntranetFactory@users.noreply.github.com>
Copilot AI changed the title Refactor AGENTS.md into reusable SOP + repo-specific CONTEXT.md Split AGENTS.md into reusable SOP + repo-specific CONTEXT.md Feb 24, 2026
…quirement to AGENTS.md

Co-authored-by: IntranetFactory <7462342+IntranetFactory@users.noreply.github.com>
Copilot AI changed the title Split AGENTS.md into reusable SOP + repo-specific CONTEXT.md Separate orchestration SOP (AGENTS.md) from package-specific context (CONTEXT.md) Feb 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants