starred/sharpcompress
1
0
Fork 0
mirror of https://github.com/adamhathcock/sharpcompress.git synced 2026-02-04 05:25:00 +00:00
Code Issues 975 Packages Projects Releases 20 Wiki Activity

[PR #1057] [MERGED] Agent instructions #1481

New Issue
Open
opened 2026-01-29 22:20:46 +00:00 by claunia · 0 comments
claunia commented 2026-01-29 22:20:46 +00:00
Owner
Copy Link

📋 Pull Request Information

Original PR: https://github.com/adamhathcock/sharpcompress/pull/1057
Author: @adamhathcock
Created: 11/30/2025
Status: ✅ Merged
Merged: 11/30/2025
Merged by: @adamhathcock

Base: master ← Head: adam/add-copilot-instructions

📝 Commits (4)

  • db8c6f4 first pass of instructions...consolidate?
  • 9c1c6ff Initial plan
  • 6a37c55 Consolidate agent instructions into AGENTS.md
  • b169652 Merge pull request #1058 from adamhathcock/copilot/sub-pr-1057

📊 Changes

1 file changed (+39 additions, -0 deletions)

View changed files

📝 AGENTS.md (+39 -0)

📄 Description

This pull request adds a new documentation file, .github/copilot-instructions.md, which provides comprehensive instructions and guidelines for AI agents (and developers) working on the SharpCompress project. The document covers project architecture, API design patterns, development workflow, code conventions, testing strategies, format-specific knowledge, and common pitfalls, serving as an in-depth onboarding and reference guide.

Key additions in the new documentation:

Project Architecture and API Design:

  • Explains the three-tier API structure (Archive, Reader, Writer), the factory pattern for format detection, and stream disposal rules, including recent changes and best practices.

Development Workflow and Code Conventions:

  • Details build, test, and formatting commands, VS Code tasks, debugging features, and enforces code style rules such as nullable reference types, async/await patterns, and naming conventions.

Testing and Format-Specific Guidance:

  • Outlines testing patterns, organization, and critical test areas; provides format-specific notes for Tar, Zip, Rar, and 7Zip, including limitations and edge cases.

Project Structure and Common Pitfalls:

  • Describes the directory structure and highlights common mistakes to avoid when working with the codebase, such as API misuse and stream handling errors.

Performance Tips and References:

  • Offers performance considerations and

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/adamhathcock/sharpcompress/pull/1057 **Author:** [@adamhathcock](https://github.com/adamhathcock) **Created:** 11/30/2025 **Status:** ✅ Merged **Merged:** 11/30/2025 **Merged by:** [@adamhathcock](https://github.com/adamhathcock) **Base:** `master` ← **Head:** `adam/add-copilot-instructions` --- ### 📝 Commits (4) - [`db8c6f4`](https://github.com/adamhathcock/sharpcompress/commit/db8c6f4bcb6016ebff90c9937c8b21ae0be7d510) first pass of instructions...consolidate? - [`9c1c6ff`](https://github.com/adamhathcock/sharpcompress/commit/9c1c6fff9f17f853e6ce8e97417085273a7fffa8) Initial plan - [`6a37c55`](https://github.com/adamhathcock/sharpcompress/commit/6a37c550859437519b20d8e49732f6bca891f28a) Consolidate agent instructions into AGENTS.md - [`b169652`](https://github.com/adamhathcock/sharpcompress/commit/b1696524b3ba564b63b1708f73e876be0091260f) Merge pull request #1058 from adamhathcock/copilot/sub-pr-1057 ### 📊 Changes **1 file changed** (+39 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `AGENTS.md` (+39 -0) </details> ### 📄 Description This pull request adds a new documentation file, `.github/copilot-instructions.md`, which provides comprehensive instructions and guidelines for AI agents (and developers) working on the SharpCompress project. The document covers project architecture, API design patterns, development workflow, code conventions, testing strategies, format-specific knowledge, and common pitfalls, serving as an in-depth onboarding and reference guide. Key additions in the new documentation: **Project Architecture and API Design:** - Explains the three-tier API structure (Archive, Reader, Writer), the factory pattern for format detection, and stream disposal rules, including recent changes and best practices. **Development Workflow and Code Conventions:** - Details build, test, and formatting commands, VS Code tasks, debugging features, and enforces code style rules such as nullable reference types, async/await patterns, and naming conventions. **Testing and Format-Specific Guidance:** - Outlines testing patterns, organization, and critical test areas; provides format-specific notes for Tar, Zip, Rar, and 7Zip, including limitations and edge cases. **Project Structure and Common Pitfalls:** - Describes the directory structure and highlights common mistakes to avoid when working with the codebase, such as API misuse and stream handling errors. **Performance Tips and References:** - Offers performance considerations and --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
claunia added the pull-request label 2026-01-29 22:20:46 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
duplicate
enhancement
feedback requested
not bug
pull-request
Mirrored from GitHub Pull Request
 question
up for grabs
wontfix
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
claunia
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/sharpcompress#1481
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?