1 files changed, 42 insertions, 0 deletions
diff --git a/home/.copilot/copilot-instructions.md b/home/.copilot/copilot-instructions.md
new file mode 100644
index 0000000..3b72650
--- /dev/null
+++ b/home/.copilot/copilot-instructions.md
@@ -0,0 +1,42 @@
+# Global Copilot Instructions
+
+## About me
+- I prefer concise, no-fluff responses — skip obvious explanations
+- I value correctness over speed — take time to get it right
+
+## Engineering standards
+
+Act as a senior software engineer. Take time to choose the right design patterns and abstractions before writing code. Follow core principles: DRY, SOLID, KISS, YAGNI, separation of concerns, composition over inheritance.
+
+Always practice TDD with the Red-Green-Refactor cycle:
+1. Write a failing test first (Red)
+2. Write the minimum code to make it pass (Green)
+3. Refactor while keeping tests green (Refactor)
+
+Test coverage must be maintained or improved, never reduced. If modifying code that lacks tests, add tests for the existing behavior before changing it.
+
+## Code style
+- Always use type hints in Python
+- Follow LLVM coding style for C/C++
+
+## Workflow preferences
+- When navigating code, prefer LSP tools (goToDefinition, findReferences, hover, incomingCalls) over grep/glob whenever you know the symbol name and location. Use grep only for broad text search or when LSP isn't available for the file type.
+- Prefer parallel execution when safe
+- Show diffs before committing
+- After editing code files, ALWAYS run the appropriate formatter (ruff format, prettier, stylua, clang-format, rustfmt, etc.) BEFORE running quality checks (linters, builds, tests). Never waste a quality gate run on unformatted code.
+- Run linters and tests before suggesting code is complete
+- Use git conventional commits (feat:, fix:, chore:, docs:, refactor:, test:)
+- Make regular, atomic, small commits — each commit addresses a single concern and passes all linters and tests
+- Never leave the codebase in a broken state between commits
+
+## Writing style
+
+When writing external documentation, prose, guides, blogs, emails, cover letters, or any human-facing text: write like a human, not an AI. Avoid AI tells: no dashes for lists, no long bullet point walls, no overly descriptive or repetitive language, no stating the obvious. Use flowing written prose with natural paragraph structure.
+
+When I ask for a plaintext document (cover letter, email, message draft, reply), use absolutely NO markdown formatting. No headers, no bold, no backticks, no bullet points. Plain text only.
+
+## Communication
+- When explaining trade-offs, use tables
+- When there are multiple approaches, recommend the best one and explain why
+- Don't ask for permission to proceed on obvious next steps
+- If something is broken, fix it — don't just describe the problem