samtrion · Nov 11, 2026 · Nov 11, 2026
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
@@ -10,15 +10,3 @@ description: 'This file contains instructions for AI coding assistants, redirect
 * MUST follow all instructions defined in the root-level document [`AGENTS.md`](../AGENTS.md).
 * MUST treat [`AGENTS.md`](../AGENTS.md) as the authoritative source for all AI assistant guidelines.
 * MUST apply all directives from [`AGENTS.md`](../AGENTS.md) when implementing code, reviewing code, suggesting improvements, debugging issues, or providing any form of technical assistance.
-
-## Decision References
-
-* MUST read and apply all "accepted" decisions from [`decisions/`](../decisions/) folder before implementing architectural changes.
-* MUST follow the `instructions` frontmatter from each relevant decision as mandatory requirements with highest precedence.
-* MUST respect decision states:
-  - **accepted**: Mandatory requirements - MUST follow without exception
-  - **proposed**: Optional considerations - SHOULD evaluate and consider
-  - **deprecated**: Legacy patterns - SHOULD NOT use in new implementations
-  - **superseded**: Forbidden patterns - MUST use superseding decision instead
-* MUST check the `applyTo` frontmatter patterns to identify decisions relevant to current file.
-* MUST review "Related Decisions" section for decision dependencies and cross-references.
diff --git a/.github/instructions/blazor.instructions.md b/.github/instructions/blazor.instructions.md
@@ -11,7 +11,7 @@ description: This file contains instructions for Blazor development. It includes
 * MUST write idiomatic and efficient Blazor and C# code.
 * MUST follow .NET and Blazor conventions and best practices.
 * MUST use Razor Components appropriately for component-based UI development.
-* MUST use the latest version C#, currently C# 13 features like record types, pattern matching, and global usings (see [.NET 10 and C# 13 Adoption](../../decisions/2025-07-11-dotnet-10-csharp-13-adoption.md)).
+* MUST use the latest version C#, currently C# 13 features like record types, pattern matching, and global usings.
 * MUST use async/await where applicable to ensure non-blocking UI operations.
 
 ## Code Style and Structure

diff --git a/.github/instructions/decisions.instructions.md b/.github/instructions/decisions.instructions.md
diff --git a/.github/instructions/wording.instructions.md b/.github/instructions/wording.instructions.md
@@ -1,7 +1,6 @@
 ---
-applyTo: '.github/copilot-instructions.md, .github/instructions/*.instructions.md, decisions/**/*.md'
-
-description: 'This file contains instructions for wording and writing style. It includes guidelines for creating and modifying instruction files, decision documents, and Copilot instructions. Ensure to follow the practices outlined in this file to maintain consistency and clarity in documentation.'
+applyTo: '.github/copilot-instructions.md, .github/instructions/*.instructions.md'
+description: 'This file contains instructions for wording and writing style. It includes guidelines for creating and modifying instruction files and Copilot instructions. Ensure to follow the practices outlined in this file to maintain consistency and clarity in documentation.'
 ---
 
 # Wording and Writing Style Instructions
@@ -34,21 +33,13 @@ description: 'This file contains instructions for wording and writing style. It
 * MUST use code formatting (backticks) for code, file names, and technical terms.
 * MUST include both general principles and specific implementation details.
 
-## Decision Documents
-
-* MUST follow the established ADR (Architecture Decision Record) format.
-* MUST include all required frontmatter fields: authors, applyTo, created, lastModified, state.
-* MUST provide clear context and problem statements.
-* MUST explicitly state the decision and its implications.
-* MUST use consistent terminology when referring to technical concepts.
-
 ## Copilot Instructions
 
 * MUST structure guidance as imperative statements.
 * MUST group related instructions under appropriate section headings.
 * MUST explicitly state constraints and limitations.
 * MUST reference specific file paths, folders, or patterns when applicable.
-* MUST include cross-references to related decisions or instruction files when appropriate.
+* MUST include cross-references to related instruction files when appropriate.
 
 ## Examples and References
 

diff --git a/.github/prompts/create-architectural-decision-record.prompt.md b/.github/prompts/create-architectural-decision-record.prompt.md
diff --git a/.github/prompts/csharp-docs.prompt.md b/.github/prompts/csharp-docs.prompt.md
@@ -121,7 +121,7 @@ description: 'Ensure that C# types are documented with XML comments following Mi
 * MUST use `NotNullAttribute` and related nullable attributes in public API documentation when appropriate.
 * MUST use `nameof()` operator in examples instead of string literals when referring to member names.
 * MUST ensure that documentation examples properly demonstrate null-checking patterns using `is null` and `is not null`.
-* SHOULD reference related decisions or architectural guidelines when relevant to the API's design or usage.
+* SHOULD reference related architectural guidelines when relevant to the API's design or usage.
 
 ## Accessibility and Localization
 

diff --git a/AGENTS.md b/AGENTS.md
@@ -18,17 +18,6 @@ Use AI coding assistants, such as GitHub Copilot, to enhance productivity and ma
 * MUST consider the impact on existing workflows and user experience.
 * MUST evaluate the cost-benefit ratio of proposed changes or new implementations.
 
-## Decision References
-
-* MUST document all decisions in `decisions/` folder using `templates/adr.md` format.
-* MUST treat "accepted" decisions as mandatory requirements with highest precedence.
-* MUST respect decision states:
-  - **accepted**: mandatory requirements
-  - **proposed**: optional considerations
-  - **deprecated**: avoid in new implementations
-  - **superseded**: forbidden, follow superseding decision instead
-* MUST use the `instructions` frontmatter property as primary AI guidance for each decision.
-
 ## Configuration Files
 
 These files control project-wide settings and should remain unchanged unless specifically requested.
@@ -48,4 +37,4 @@ These files control project-wide settings and should remain unchanged unless spe
 * MUST always review AI-generated code for correctness, security, and performance.
 * MUST provide constructive feedback and suggestions for improvement.
 * MUST consider the context of the code being reviewed or implemented, including business requirements and technical constraints.
-* MUST apply all relevant instructions and guidelines from `.github/instructions/*.instructions.md` files during both code review and implementation.
+* MUST apply all relevant instructions and guidelines from `.github/instructions/*.instructions.md` files during both code review and implementation.
diff --git a/README.md b/README.md
@@ -186,7 +186,6 @@ src/
 tests/
 └── NetEvolve.Arguments.Tests.Unit/                 # Comprehensive unit tests
 
-decisions/                                          # Architecture Decision Records (ADRs)
 templates/                                          # Documentation templates
 ```
 
@@ -199,16 +198,6 @@ This library follows a polyfill architecture pattern:
 - **Zero-overhead abstraction**: On modern frameworks, the polyfills compile to simple pass-through calls or are eliminated entirely
 - **Backward compatibility**: Ensures older frameworks receive functionally equivalent implementations
 
-For detailed architectural decisions, see:
-
-- [Centralized Package Version Management](https://github.com/dailydevops/arguments/blob/main/decisions/2025-07-10-centralized-package-version-management.md)
-- [Conventional Commits](https://github.com/dailydevops/arguments/blob/main/decisions/2025-07-10-conventional-commits.md)
-- [GitVersion for Automated Semantic Versioning](https://github.com/dailydevops/arguments/blob/main/decisions/2025-07-10-gitversion-automated-semantic-versioning.md)
-- [.NET 10 and C# 13 Adoption](https://github.com/dailydevops/arguments/blob/main/decisions/2025-07-11-dotnet-10-csharp-13-adoption.md)
-- [English as Project Language](https://github.com/dailydevops/arguments/blob/main/decisions/2025-07-11-english-as-project-language.md)
-- [DateTimeOffset and TimeProvider Usage](https://github.com/dailydevops/arguments/blob/main/decisions/2026-01-21-datetimeoffset-and-timeprovider-usage.md)
-- [All Architecture Decision Records](https://github.com/dailydevops/arguments/tree/main/decisions/)
-
 ## Contributing
 
 We welcome contributions from the community! Please read our [Contributing Guidelines](https://github.com/dailydevops/arguments/blob/main/CONTRIBUTING.md) before submitting a pull request.
@@ -227,7 +216,6 @@ This project adheres to the Contributor Covenant [Code of Conduct](https://githu
 
 ### Documentation
 
-- **[Architecture Decision Records](https://github.com/dailydevops/arguments/tree/main/decisions/)** - Detailed architectural decisions and rationale
 - **[Contributing Guidelines](https://github.com/dailydevops/arguments/blob/main/CONTRIBUTING.md)** - How to contribute to this project
 - **[Code of Conduct](https://github.com/dailydevops/arguments/blob/main/CODE_OF_CONDUCT.md)** - Community standards and expectations
 - **[License](https://github.com/dailydevops/arguments/blob/main/LICENSE)** - Project licensing information (MIT License)
@@ -241,8 +229,6 @@ This project uses [GitVersion](https://gitversion.net/) for automated semantic v
 - **Minor version** (1.0.0 → 1.1.0): New features added via `feat:` commits
 - **Patch version** (1.0.0 → 1.0.1): Bug fixes and maintenance via `fix:`, `chore:`, `docs:`, etc.
 
-For more details, see [GitVersion for Automated Semantic Versioning](https://github.com/dailydevops/arguments/blob/main/decisions/2025-07-10-gitversion-automated-semantic-versioning.md).
-
 ### Support
 
 - **Issues**: Report bugs or request features on [GitHub Issues](https://github.com/dailydevops/arguments/issues)