Added Junie guidelines

Author: datacute

.github/copilot-instructions.md

@@ -3,28 +3,52 @@
 Purpose: Helper source files (embedded) for .NET incremental generators; keep output deterministic and public API stable.
 
 ## 1. Scope
-Chat = terse (summary + reason + minimal diff). Repo docs = rich (rationale, examples, edge cases, perf). Additive edits only.
+Chat = terse (summary + reason + minimal sample). Repo docs = rich (rationale, examples, edge cases, perf). Additive = new files/members only; no deletions, renames, or moves unless explicitly requested.
 
 ## 2. Platform & Stability
 netstandard2.0 / C# 7.3. No newer BCL APIs. Preserve public type & member names.
 
 ## 3. Guards
-Each helper file:
+Each helper file can be excluded from the build using a guard.
+Nest or document dependencies using guards, depending on how closely related the helper file is to the dependency.
+Closely related examples:
 ```
-#if !DATACUTE_EXCLUDE_<UPPERCASENAME>
+#if !DATACUTE_EXCLUDE_EQUATABLEIMMUTABLEARRAYEXTENSIONS // Feature: EquatableImmutableArrayExtensions
+#if !DATACUTE_EXCLUDE_EQUATABLEIMMUTABLEARRAY // Dependency: EquatableImmutableArray
 // contents
+#endif // !DATACUTE_EXCLUDE_EQUATABLEIMMUTABLEARRAY
+#endif // !DATACUTE_EXCLUDE_EQUATABLEIMMUTABLEARRAYEXTENSIONS
+```
+Not closely related examples:
+```
+#if !DATACUTE_EXCLUDE_ATTRIBUTECONTEXTANDDATA // Feature: AttributeContextAndData
+#if DATACUTE_EXCLUDE_TYPECONTEXT
+#error AttributeContextAndData requires TypeContext (remove DATACUTE_EXCLUDE_TYPECONTEXT or also exclude DATACUTE_EXCLUDE_ATTRIBUTECONTEXTANDDATA)
+#endif
+#if DATACUTE_EXCLUDE_EQUATABLEIMMUTABLEARRAY
+#error AttributeContextAndData requires EquatableImmutableArray (remove DATACUTE_EXCLUDE_EQUATABLEIMMUTABLEARRAY or also exclude DATACUTE_EXCLUDE_ATTRIBUTECONTEXTANDDATA)
 #endif
+// contents
+#endif // !DATACUTE_EXCLUDE_ATTRIBUTECONTEXTANDDATA
 ```
-Nest or document dependencies.
 
-## 4. Editing & Diffs
-Show only changed lines (≤3 lines context). Fenced blocks for multi‑line examples. Short reason (perf / determinism / clarity / bug fix). No change‑log comments. UK English.
+## 4. Editing & Samples
+Show only example code snippets (no diffs) with ≤3 lines of surrounding context when needed. Fenced blocks for multi‑line examples. Use code samples to illustrate changes; do not use diff syntax in chat. Use language tags: csharp for C# code, xml for XML docs, and text for plain text. Short reason (perf / determinism / clarity / bug fix). Keep commentary in the chat. Code changes must omit commentary. Resulting code must look like it was always written that way.
+
+When showing a change, prefer Before/After paired samples:
+- Before: the minimal original snippet required for context.
+- After: the revised snippet in full.
+
+## 5. Public API Doc Comments
+For every public type or member emit an XML doc summary (no placeholders). Include <param>/<typeparam>/<returns> when present; only add <remarks> if non-trivial behaviour (threading, allocation, ordering, invariants).
 
-## 5. Documentation
-XML doc first sentence = summary; follow with behaviour / perf / pitfalls if useful. READMEs may include: Overview, Why, Key APIs, Examples, Performance, Dependencies, Exclusion Flags, Instrumentation. Document public surface only (internal/private only if cross‑file contract). Chat brevity does not apply to repo docs.
+## 6. Documentation
+UK English. XML doc first sentence = summary; follow with behaviour / perf / pitfalls if useful. READMEs may include: Overview, Why, Key APIs, Examples, Performance, Dependencies, Exclusion Flags, Instrumentation. Document public surface only (internal/private only if cross‑file contract). Chat brevity does not apply to repo docs.
 
-## 6. Chat Response Format
-1. Summary (1–2 lines)  2. Diff (changed lines) OR fenced example  3. Optional next steps (label “Optional”).
+## 7. Chat Response Format
+1. Summary (1–2 lines)
+2. Example code snippet(s) only (no diff format)
+3. Optional next steps (label “Optional”).
 
-## 7. Assumptions
-If unspecified, state one reversible assumption and proceed.
+## 8. Assumptions
+If unspecified, state one reversible assumption in the chat and proceed.

.junie/guidelines.md

@@ -0,0 +1,54 @@
+# Internal Agent Instructions
+
+Purpose: Helper source files (embedded) for .NET incremental generators; keep output deterministic and public API stable.
+
+## 1. Scope
+Chat = terse (summary + reason + minimal sample). Repo docs = rich (rationale, examples, edge cases, perf). Additive = new files/members only; no deletions, renames, or moves unless explicitly requested.
+
+## 2. Platform & Stability
+netstandard2.0 / C# 7.3. No newer BCL APIs. Preserve public type & member names.
+
+## 3. Guards
+Each helper file can be excluded from the build using a guard.
+Nest or document dependencies using guards, depending on how closely related the helper file is to the dependency.
+Closely related examples:
+```
+#if !DATACUTE_EXCLUDE_EQUATABLEIMMUTABLEARRAYEXTENSIONS // Feature: EquatableImmutableArrayExtensions
+#if !DATACUTE_EXCLUDE_EQUATABLEIMMUTABLEARRAY // Dependency: EquatableImmutableArray
+// contents
+#endif // !DATACUTE_EXCLUDE_EQUATABLEIMMUTABLEARRAY
+#endif // !DATACUTE_EXCLUDE_EQUATABLEIMMUTABLEARRAYEXTENSIONS
+```
+Not closely related examples:
+```
+#if !DATACUTE_EXCLUDE_ATTRIBUTECONTEXTANDDATA // Feature: AttributeContextAndData
+#if DATACUTE_EXCLUDE_TYPECONTEXT
+#error AttributeContextAndData requires TypeContext (remove DATACUTE_EXCLUDE_TYPECONTEXT or also exclude DATACUTE_EXCLUDE_ATTRIBUTECONTEXTANDDATA)
+#endif
+#if DATACUTE_EXCLUDE_EQUATABLEIMMUTABLEARRAY
+#error AttributeContextAndData requires EquatableImmutableArray (remove DATACUTE_EXCLUDE_EQUATABLEIMMUTABLEARRAY or also exclude DATACUTE_EXCLUDE_ATTRIBUTECONTEXTANDDATA)
+#endif
+// contents
+#endif // !DATACUTE_EXCLUDE_ATTRIBUTECONTEXTANDDATA
+```
+
+## 4. Editing & Samples
+Show only example code snippets (no diffs) with ≤3 lines of surrounding context when needed. Fenced blocks for multi‑line examples. Use code samples to illustrate changes; do not use diff syntax in chat. Use language tags: csharp for C# code, xml for XML docs, and text for plain text. Short reason (perf / determinism / clarity / bug fix). Keep commentary in the chat. Code changes must omit commentary. Resulting code must look like it was always written that way.
+
+When showing a change, prefer Before/After paired samples:
+- Before: the minimal original snippet required for context.
+- After: the revised snippet in full.
+
+## 5. Public API Doc Comments
+For every public type or member emit an XML doc summary (no placeholders). Include <param>/<typeparam>/<returns> when present; only add <remarks> if non-trivial behaviour (threading, allocation, ordering, invariants).
+
+## 6. Documentation
+UK English. XML doc first sentence = summary; follow with behaviour / perf / pitfalls if useful. READMEs may include: Overview, Why, Key APIs, Examples, Performance, Dependencies, Exclusion Flags, Instrumentation. Document public surface only (internal/private only if cross‑file contract). Chat brevity does not apply to repo docs.
+
+## 7. Chat Response Format
+1. Summary (1–2 lines)
+2. Example code snippet(s) only (no diff format)
+3. Optional next steps (label “Optional”).
+
+## 8. Assumptions
+If unspecified, state one reversible assumption in the chat and proceed.

IncrementalGeneratorExtensions.sln

@@ -12,6 +12,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 		PACKAGE_README.md = PACKAGE_README.md
 		.github\copilot-instructions.md = .github\copilot-instructions.md
 		global.json = global.json
+		.junie\guidelines.md = .junie\guidelines.md
 	EndProjectSection
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "IncrementalGeneratorExtensions", "IncrementalGeneratorExtensions\IncrementalGeneratorExtensions.csproj", "{2DDE40FD-08D6-469C-948A-2AED9E0B2B49}"