.NET Developer Tools Experience

0.tools.md

.NET Developer Tools Experience

🧠 .NET Analyzers

What it does:

Identifies .NET guideline and pattern violations in both generated and custom code.

Responsible:

• Arthur
• Jesse

Team:

• Redmond .NET Team (client)
• Shanghai .NET Team (management)

Integrates with:

IDEs, linters, builds (including code generation and pipelines)

---

🧮 Azure TypeSpec Linter for .NET

What it does:

Detects problematic patterns in TypeSpec that would lead to guideline violations in generated code. Offers "lightbulb" suggestions during spec authoring.

Responsible:

Arthur

Team:

Shanghai .NET Team

Integrates with:

TypeSpec Linter

---

🤖 .NET Generator Agent

What it does:

Generates code and automatically fixes errors iteratively.

Responsible:

Jesse

Team:

Radhika

Integrates with:

dotnet tool, DevEx Agent (BOB), DevEx CLI

---

🧯 .NET Error Fixers

What it does:

Diagnoses and suggests fixes for .NET analyzer errors, generator errors, and API breaking changes.

Responsible:

• Jesse
• Arthur

Team:

• Radhika (client)
• Shanghai .NET Team (management)

Integrates with:

dotnet tool, DevEx Agent (BOB), DevEx CLI

---

🧪 Sample Generator Extension

What it does:

Enables the .NET code generator to decompose champion scenarios into real-world samples demonstrating end-to-end tasks.

Responsible:

• Jesse
• Arthur

Team:

• Josh, Jorge (infrastructure and client)
• Shanghai .NET Team (management)

Integrates with:

.NET code generator and agent

---

📘 API Documentation Generator Extension

What it does:

Transforms REST API documentation into client-appropriate formats using the .NET code generator.

Responsible:

Jesse

Team:

• Josh, Jorge (infrastructure and client)
• Shanghai .NET Team (management)

Integrates with:

.NET code generator and agent

1-integrations.md

🔗 Integration Points

🌐 REST API Pipeline

Open Questions

• How can the agent modify a client.tsp file during the pipeline execution?
• What mechanism allows the agent to push changes back to the specs repository?

🧠 DevEx Agent (BOB)

Open Questions

• How will BOB invoke a language-specific tool?
• How are parameters passed to the tool and how is output returned?
• What functions must a language tool support?
• What are the expected input and output formats for each function?

🧰 DevEx CLI

Open Questions

• What dis?
• How will it invoke a language-specific tool?
• How are parameters passed and output returned?
• What functions must a language tool support?
• What are the expected input and output formats for each function?