Skip to content

chore: Add AGENTS.md#235

Open
mpivchev wants to merge 3 commits into
mainfrom
agents-md
Open

chore: Add AGENTS.md#235
mpivchev wants to merge 3 commits into
mainfrom
agents-md

Conversation

@mpivchev

@mpivchev mpivchev commented Jul 20, 2026

Copy link
Copy Markdown
Collaborator

🤖 AI (if applicable)

  • The content of this PR was partly or fully generated using AI

Signed-off-by: Milen Pivchev <milen.pivchev@gmail.com>
@mpivchev
mpivchev marked this pull request as ready for review July 20, 2026 15:25
@mpivchev

Copy link
Copy Markdown
Collaborator Author

Suggestions to add to this are welcome

@i2h3 i2h3 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can also ask agents like Claude Code how to improve the AGENTS.md 😉

Comment thread AGENTS.md

# AGENTS.md

You are an experienced engineer specialized in Swift and familiar with the platform-specific details of Apple platforms.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This can also be moved under ## Your Role

Comment thread AGENTS.md
NextcloudKit is the official Swift library for communicating with Nextcloud servers. It is used by the Nextcloud Files, Notes and Talk apps on iOS as well as the Desktop client, and supports iOS, macOS, tvOS, watchOS and visionOS.
Networking is built on Alamofire; responses are parsed with SwiftyJSON and SwiftyXMLParser.

## Project Structure: AI Agent Handling Guidelines

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can instruct the agents with this file to automatically keep this table up to date.

Comment thread AGENTS.md
## Commit and Pull Request Guidelines

- **DCO sign-off (required)**: All commits must comply with the Developer Certificate of Origin (DCO) and include a `Signed-off-by: …` line in the commit message.
- **Commits**: Use a short imperative subject line summarizing what changed. *Example:* `Fix crash when parsing empty share response`.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If I am not wrong, most of Nextcloud GmbH projects use conventional commits. It might be good to adopt them here as well.

Comment thread AGENTS.md Outdated
@mpivchev

Copy link
Copy Markdown
Collaborator Author

You can also ask agents like Claude Code how to improve the AGENTS.md 😉

Already did :D
image

Co-authored-by: Iva Horn <iva.horn@icloud.com>
Signed-off-by: Milen Pivchev <milen.pivchev@gmail.com>
@mpivchev mpivchev changed the title Add AGENTS.md chore: Add AGENTS.md Jul 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants