Skip to content

Add AI md files and claude commands#679

Open
eshulman2 wants to merge 1 commit intok-orc:mainfrom
eshulman2:claude-commands
Open

Add AI md files and claude commands#679
eshulman2 wants to merge 1 commit intok-orc:mainfrom
eshulman2:claude-commands

Conversation

@eshulman2
Copy link
Contributor

@eshulman2 eshulman2 commented Feb 9, 2026

Add CLAUDE.md with project-specific instructions for AI-assisted
development of ORC controllers, including project structure, key
patterns, and references to detailed documentation.

Add Claude Code skills for common development workflows:

  • /new-controller: Scaffold and implement new ORC controllers
  • /update-controller: Modify existing controllers (add fields, tags, etc.)
  • /add-dependency: Add resource dependencies to controllers
  • /proposal: Write enhancement proposals following the template
  • /testing: Run unit tests, linting, and E2E tests

Skills follow Claude Code best practices:

  • YAML frontmatter with name, description, disable-model-invocation
  • Shared patterns.md reference for implementation principles
  • Cross-references using https://github.com/path imports

Tested locally and compared with already proposed controller (loadbalancer), did a great job mostly similar to what I did with some possible improvements!

@github-actions github-actions bot added the semver:patch No API change label Feb 9, 2026
@eshulman2
Copy link
Contributor Author

/retest

@winiciusallan
Copy link
Contributor

Now we have a fix for the problem with pkg_resources. Could you re-run the jobs? They should now pass without problems.

openstack/devstack@1dee5d0

Add CLAUDE.md with project-specific instructions for AI-assisted
development of ORC controllers, including project structure, key
patterns, and references to detailed documentation.

Add Claude Code skills for common development workflows:
- /new-controller: Scaffold and implement new ORC controllers
- /update-controller: Modify existing controllers (add fields, tags, etc.)
- /add-dependency: Add resource dependencies to controllers
- /proposal: Write enhancement proposals following the template
- /testing: Run unit tests, linting, and E2E tests

Skills follow Claude Code best practices:
- YAML frontmatter with name, description, disable-model-invocation
- Shared patterns.md reference for implementation principles
- Cross-references using @path imports
@eshulman2
Copy link
Contributor Author

@winiciusallan done

Copy link
Collaborator

@mandre mandre left a comment

Choose a reason for hiding this comment

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

This is great, thanks @eshulman2. This has been on my TODO list for a while to add AGENTS.md and a good set of skills for the project, I'm glad you took care of it.

I just have a ask: can we try to respect the standards so that more agents can benefit from it?

I'd like the AGENTS.md file to be the source of truth. Likewise, I'd like skills to be located in a .agents/skills directory.

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

Choose a reason for hiding this comment

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

I'd prefer it the other way around: let's have a generic AGENTS.md, and create a CLAUDE.md symlink to it since Anthropic decided to ignore the standard.

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

Labels

semver:patch No API change

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants