Skip to content

[WIP] feat: add AGENTS.md and CLAUDE.md#3149

Draft
csviri wants to merge 1 commit intooperator-framework:mainfrom
csviri:agent-md
Draft

[WIP] feat: add AGENTS.md and CLAUDE.md#3149
csviri wants to merge 1 commit intooperator-framework:mainfrom
csviri:agent-md

Conversation

@csviri
Copy link
Collaborator

@csviri csviri commented Feb 3, 2026

Signed-off-by: Attila Mészáros a_meszaros@apple.com

@openshift-ci openshift-ci bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Feb 3, 2026
@csviri csviri linked an issue Feb 3, 2026 that may be closed by this pull request
@csviri
Copy link
Collaborator Author

csviri commented Feb 3, 2026

@metacosm
Copy link
Collaborator

metacosm commented Feb 3, 2026

I'd rather we spend efforts on maintaining documentation for actual users than spending time having to maintain another document for "agents".

@csviri
Copy link
Collaborator Author

csviri commented Feb 3, 2026

I'd rather we spend efforts on maintaining documentation for actual users than spending time having to maintain another document for "agents".

Hi @metacosm , this is WIP, will probably change fundamentally. Those two are not solving the same problem, this is guidline for AI when writing / helping to write code.

@csviri csviri changed the title feat: add AGENTS.md and CLAUDE.md [WIP] feat: add AGENTS.md and CLAUDE.md Feb 3, 2026
@metacosm
Copy link
Collaborator

metacosm commented Feb 3, 2026

I'd rather we spend efforts on maintaining documentation for actual users than spending time having to maintain another document for "agents".

Hi @metacosm , this is WIP, will probably change fundamentally. Those two are not solving the same problem, this is guidline for AI when writing / helping to write code.

I know what this is for but this looks like documentation and, for all purposes and intents, it is. So that's yet another thing that would need to be updated when we already struggle with the "regular" documentation.

Signed-off-by: Attila Mészáros <a_meszaros@apple.com>

### Unit Tests

- Use JUnit 5
Copy link
Collaborator

Choose a reason for hiding this comment

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

This is false.


### Integration Tests

- Use `LocallyRunOperatorExtension` or `OperatorExtension` from `operator-framework-junit5`
Copy link
Collaborator

Choose a reason for hiding this comment

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

This won't stay true for much longer…

### Integration Tests

- Use `LocallyRunOperatorExtension` or `OperatorExtension` from `operator-framework-junit5`
- Test against real Kubernetes API (typically via test cluster or mock server)
Copy link
Collaborator

Choose a reason for hiding this comment

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

IMO, preferred way should be to use Testcontainers…

### PR Guidelines

- Keep changes focused and atomic
- Write clear commit messages (imperative mood: "Add feature" not "Added feature")
Copy link
Collaborator

Choose a reason for hiding this comment

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

Should use conventional commit messages

@csviri
Copy link
Collaborator Author

csviri commented Feb 6, 2026

@metacosm I did not have the time to get back on this properly yes, next week will do so.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add AGENTS.md

2 participants