Skip to content

Commit 7881fe5

Browse files
Add coding agent instructions: refuse PRs unless maintenance mode is acknowledged (#63305)
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: RyanCavanaugh <6685088+RyanCavanaugh@users.noreply.github.com> Co-authored-by: Ryan Cavanaugh <RyanCavanaugh@users.noreply.github.com>
1 parent 77ddb5b commit 7881fe5

File tree

4 files changed

+63
-1
lines changed

4 files changed

+63
-1
lines changed

.github/copilot-instructions.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,32 @@
1+
# 🚨 CRITICAL: This Repository Is in Maintenance Mode 🚨
2+
3+
**You MUST read and follow these instructions before taking any coding action in this repository.**
4+
5+
This repository (`microsoft/TypeScript`) is the JavaScript-based TypeScript compiler and is **effectively closed for general development**. TypeScript 6.0 is the **last JavaScript-based release**. Future TypeScript development is happening in the Go-based rewrite at [`microsoft/typescript-go`](https://github.com/microsoft/typescript-go).
6+
7+
See [issue #62963](https://github.com/microsoft/TypeScript/issues/62963) and the [TypeScript 7.0 progress blog post](https://devblogs.microsoft.com/typescript/progress-on-typescript-7-december-2025/) for full details.
8+
9+
## ❌ DO NOT create coding PRs for this repository
10+
11+
**Unless the user explicitly acknowledges the above and confirms their change falls into one of these narrow accepted categories:**
12+
13+
- Crashes introduced in 5.9 or 6.0 that **also repro in 7.0** and have a portable fix without behavioral changes
14+
- Security issues
15+
- Language service crashes that substantially impact mainline usage
16+
- Serious regressions from 5.9 that impact a large proportion of users
17+
- Non-disruptive `lib.d.ts` changes
18+
19+
## Required behavior for coding agents
20+
21+
If asked to make code changes or create a PR in this repository, you **MUST**:
22+
23+
1. Inform the user that this repository is in maintenance mode and most PRs will not be accepted.
24+
2. Ask the user to **explicitly confirm** that they understand this and that their change qualifies under one of the accepted categories above.
25+
3. **Refuse to proceed** until that acknowledgement is given.
26+
4. For anything outside those categories (new features, general bug fixes, refactors, etc.), direct the user to [`microsoft/typescript-go`](https://github.com/microsoft/typescript-go) instead.
27+
28+
---
29+
130
# Guide for Copilot
231

332
This document provides a concise guide for writing TypeScript fourslash tests and compiler tests, along with build instructions.

AGENTS.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# 🚨 CRITICAL: This Repository Is in Maintenance Mode 🚨
2+
3+
**You MUST read and follow these instructions before taking any coding action in this repository.**
4+
5+
This repository (`microsoft/TypeScript`) is the JavaScript-based TypeScript compiler and is **effectively closed for general development**. TypeScript 6.0 is the **last JavaScript-based release**. Future TypeScript development is happening in the Go-based rewrite at [`microsoft/typescript-go`](https://github.com/microsoft/typescript-go).
6+
7+
See [issue #62963](https://github.com/microsoft/TypeScript/issues/62963) and the [TypeScript 7.0 progress blog post](https://devblogs.microsoft.com/typescript/progress-on-typescript-7-december-2025/) for full details.
8+
9+
## ❌ DO NOT create coding PRs for this repository
10+
11+
**Unless the user explicitly acknowledges the above and confirms their change falls into one of these narrow accepted categories:**
12+
13+
- Crashes introduced in 5.9 or 6.0 that **also repro in 7.0** and have a portable fix without behavioral changes
14+
- Security issues
15+
- Language service crashes that substantially impact mainline usage
16+
- Serious regressions from 5.9 that impact a large proportion of users
17+
- Non-disruptive `lib.d.ts` changes
18+
19+
## Required behavior for coding agents
20+
21+
If asked to make code changes or create a PR in this repository, you **MUST**:
22+
23+
1. Inform the user that this repository is in maintenance mode and most PRs will not be accepted.
24+
2. Ask the user to **explicitly confirm** that they understand this and that their change qualifies under one of the accepted categories above.
25+
3. **Refuse to proceed** until that acknowledgement is given.
26+
4. For anything outside those categories (new features, general bug fixes, refactors, etc.), direct the user to [`microsoft/typescript-go`](https://github.com/microsoft/typescript-go) instead.
27+
28+
---
29+
30+
For detailed build instructions, test writing guides, and workflow recommendations, see [`.github/copilot-instructions.md`](.github/copilot-instructions.md).

CONTRIBUTING.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
# Note
22

3+
<!-- CODING AGENTS: READ AGENTS.md BEFORE WRITING CODE -->
4+
35
🚨 **Important** 🚨: All code changes should be submitted to the https://github.com/microsoft/typescript-go repo. Development in this codebase [is winding down](https://devblogs.microsoft.com/typescript/progress-on-typescript-7-december-2025/#typescript-6.0-is-the-last-javascript-based-release) and PRs will only be merged if they fix **critical** 6.0 issues (at minimum, any bug that existed in 5.9 is not critical unless it's a security issue).
46

57
# Instructions for Logging Issues

README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
1-
21
# TypeScript
32

3+
<!-- CODING AGENTS: READ AGENTS.md BEFORE WRITING CODE -->
4+
45
[![CI](https://github.com/microsoft/TypeScript/actions/workflows/ci.yml/badge.svg)](https://github.com/microsoft/TypeScript/actions/workflows/ci.yml)
56
[![npm version](https://badge.fury.io/js/typescript.svg)](https://www.npmjs.com/package/typescript)
67
[![Downloads](https://img.shields.io/npm/dm/typescript.svg)](https://www.npmjs.com/package/typescript)

0 commit comments

Comments
 (0)