Skip to content

chore: introduce AGENTS.md#1594

Draft
volsa wants to merge 2 commits intomasterfrom
vosa/agents
Draft

chore: introduce AGENTS.md#1594
volsa wants to merge 2 commits intomasterfrom
vosa/agents

Conversation

@volsa
Copy link
Copy Markdown
Member

@volsa volsa commented Feb 11, 2026

No description provided.

Copy link
Copy Markdown
Collaborator

@ghaith ghaith left a comment

Choose a reason for hiding this comment

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

Just some ideas


## Code style
1. Do not eagerly add `#[derive(...)]` implementations like a `Debug` or `Clone`. Only add them when needed.
2. Try to keep line lengths at max 110 characters.
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.

better just run cargo fmt after the edit is done

cargo fmt --all && cargo clippy --workspace

test:
cargo test --workspace --no-fail-fast && ./scripts/build.sh --lit
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.

I often notice the agent running the tests twice because first it executes and then sees it's too much output to parse and then add a grep command. Let us also add the instructions to the agent on how to execute tests and see the failures in one go, by either piping the result or saving output files or grepping.

make lint # Run the formatter and linter
```

Use `make test` when fixing bugs or adding new features, `make lint` before committing changes.
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.

I think it makes sense to make it establish baselines before the start to avoid the issues where it thinks there are pre-existing failing tests.
Also I usually start my session with compare this branch to master so that if it's a continuation of an implementation or if it's addressing comments it gathers the context quiker.

lint:
cargo fmt --all && cargo clippy --workspace

test:
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.

should we add skills to let the agent test single lit files?

```

Use `make test` when fixing bugs or adding new features, `make lint` before committing changes.

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.

I would add instructions on how to debug in the project

  • run cargo r -- --help to see options
  • use --ast-lowered and --ast and --ir flags
  • use --check flag..
    I find myself often repeating these instructions

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.

2 participants