electricessence

Copilot Instructions: TypeScript Style and Design Guide

This file guides AI and human contributors in writing clean, modern TypeScript code. It reflects best practices as of 2025, aligned with our team’s priorities.

🧠 Core Principles

Readability above all else: Code must be easy to follow, even by new contributors or AI tools.
Concise and clean: Prefer clarity over cleverness. Avoid unnecessary abstraction.

.NET/C# AI Coding Guidelines

Purpose: Comprehensive, non-project-specific guide for AI-assisted .NET development.

🎯 CRITICAL RULES (Always Follow)

Test-Driven Development: Interface → Test → Implementation
LINE BREAKS AFTER CLOSING BRACES - AI models frequently break this rule!

BenchmarkDotNet=v0.13.1, OS=Windows 10.0.19043.1237 (21H1/May2021Update)
Intel Core i7-7500U CPU 2.70GHz (Kaby Lake), 1 CPU, 4 logical and 2 physical cores
.NET SDK=6.0.100-rc.1.21463.6
  [Host]     : .NET 6.0.0 (6.0.21.45113), X64 RyuJIT  [AttachedDebugger]
  Job-CKZXSH : .NET 6.0.0 (6.0.21.45113), X64 RyuJIT

InvocationCount=1  UnrollFactor=1


	function Git-Worktree-List {
	git worktree list
	}

	function Copy-UntrackedFiles {
	param (
	[string]$SourcePath,
	[string]$TargetPath
	)

	using System;
	using System.Collections.Generic;
	using System.Linq;
	using System.Text;
	using System.Web;
	using System.Collections.Specialized;
	using System.Diagnostics.Contracts;
	using System.Threading;
	using Utilities.Threading;

	using System;
	using System.Buffers;
	using System.IO;
	using System.Security.Cryptography;
	using System.Text.Json;
	using System.Threading;
	using System.Threading.Tasks;

	public static class SymmetricAlgorithmExtensions
	{

	using System;
	using System.Buffers;
	using System.Collections.Generic;
	using System.Diagnostics;
	using System.IO;
	using System.Linq;
	using System.Text;
	using System.Threading.Tasks;

	public static class TextReaderExtensions


	class Queue
	{
	constructor()
	{
	this.count = 0;
	this.tail = this.root = {
	next:null
	};
	}