Skip to content

aalmada/Stationary / .agents/skills/dotnet-pipelines

dotnet-pipelines

Verified

Design, implement, debug, test, and review high-throughput byte-stream processing with System.IO.Pipelines. USE FOR: Pipe, PipeReader, PipeWriter, ReadResult, FlushResult, ReadOnlySequence, SequenceReader, buffer lifecycle, AdvanceTo, GetMemory, Advance, FlushAsync, stream and socket adapters, framing protocols, incremental parsing, backpressure, cancellation, and Pipes-to-Channels handoff. DO NOT USE FOR: item-level producer-consumer queues, durable/distributed messaging, ordinary small file I/O with no measured bottleneck, generic Stream APIs with no buffer-management concern, or ASP.NET middleware pipelines unrelated to System.IO.Pipelines.

references/sources.md

View on GitHub
# Sources

## Source Precedence

1. Target framework reference assembly and current .NET runtime source.
2. Current Microsoft Learn conceptual and API documentation.
3. Official .NET samples and tests.
4. Practitioner articles for measured architecture examples, not API authority.

## Reference Links

| Source | Use |
| --- | --- |
| [System.IO.Pipelines](https://learn.microsoft.com/dotnet/standard/io/pipelines) | Primary API contract, lifecycle, parsing patterns, cancellation, and documented failure modes |
| [System.IO.Pipelines API](https://learn.microsoft.com/dotnet/api/system.io.pipelines) | Type signatures, options, exceptions, and target-framework availability |
| [System.Buffers API](https://learn.microsoft.com/dotnet/api/system.buffers) | `ReadOnlySequence`, `SequenceReader`, and memory sequence behavior |
| [Pipelines and Channels performance example](https://dev.to/joni2nja/use-system-io-pipelines-and-system-threading-channels-apis-to-boost-performance-2nj5) | File parsing plus bounded concurrent work example; benchmark is workload-specific and from .NET 5 |
| [Large-file processing article](https://www.linkedin.com/pulse/processando-grandes-arquivos-com-o-systemiopipelines-angelo-belchior/) | Supplied supplementary reading; content requires LinkedIn sign-in and was not independently verified |

- Verify the installed target framework before relying on new overloads or implementation details.
- `System.IO.Pipelines` is part of the shared framework on modern .NET; avoid adding a package reference unless the target framework requires it.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall