Skip to content

feat: add AGENTS.md and CLAUDE.md#543

Open
thibault-martinez wants to merge 1 commit intodevelopfrom
feat/agents-claude
Open

feat: add AGENTS.md and CLAUDE.md#543
thibault-martinez wants to merge 1 commit intodevelopfrom
feat/agents-claude

Conversation

@thibault-martinez
Copy link
Copy Markdown
Member

No description provided.

@thibault-martinez thibault-martinez requested a review from a team as a code owner January 29, 2026 09:02
└── iota-sdk-ffi/ # FFI for language bindings (not published)

bindings/
├── go/ # Go bindings with examples
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

probably shouldn't mention that only for Go

Suggested change
├── go/ # Go bindings with examples
├── go/ # Go bindings

```rust
use iota_sdk::graphql_client::Client;

let client = Client::devnet();
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Claude, why come up with wrong method names?

Suggested change
let client = Client::devnet();
let client = Client::new_devnet();

make clippy

# Format code (requires nightly)
make fmt
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Should maybe also have the fmt for bindings and examples here?

Comment on lines +34 to +42
## Crate Responsibilities

| Crate | Purpose |
| ------------------------------ | --------------------------------------------------------------------------- |
| `iota-sdk` | Umbrella crate that re-exports all functionality via feature flags |
| `iota-sdk-types` | Core types: Address, ObjectId, Transaction, Checkpoint, etc. BCS-compatible |
| `iota-sdk-crypto` | Signing traits (`IotaSigner`, `IotaVerifier`) and implementations |
| `iota-sdk-graphql-client` | Type-safe GraphQL client using `cynic` for schema-derived types |
| `iota-sdk-transaction-builder` | Fluent API for building transactions (online/offline modes) |
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Almost the same as Repository Structure, should probably merge them

@Thoralf-M Thoralf-M requested a review from Copilot January 29, 2026 09:11
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR introduces documentation files to help AI agents understand and work with the IOTA Rust SDK repository structure, conventions, and workflows.

Changes:

  • Adds comprehensive AI agent documentation covering project structure, build commands, code conventions, and common development tasks
  • Creates a reference file pointing to the main agent documentation

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
AGENTS.md Comprehensive guide for AI agents with repository structure, code conventions, testing patterns, and common development workflows
CLAUDE.md Reference file containing only "AGENTS.md" text

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@@ -0,0 +1 @@
AGENTS.md No newline at end of file
Copy link

Copilot AI Jan 29, 2026

Choose a reason for hiding this comment

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

The CLAUDE.md file contains only the text 'AGENTS.md' without any context or explanation. Consider adding a brief description of its purpose, such as a redirect notice or explanation that this file references AGENTS.md for Claude-specific agent guidance.

Suggested change
AGENTS.md
# Claude agent guidance
This file serves as a redirect for Claude-specific agent instructions.
For detailed guidance on how Claude should behave in this repository,
please see [AGENTS.md](AGENTS.md).

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

@copilot It's a symlink, it's on purpose

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

When actually it doesn't seems to be a symlink, not sure what happened, I'll fix

Copy link
Copy Markdown
Contributor

Copilot AI commented Jan 29, 2026

@thibault-martinez I've opened a new pull request, #544, to work on those changes. Once the pull request is ready, I'll request review from you.

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.

4 participants