This repository serves as a centralized location for AI-related resources, tools, prompts, and best practices for the Kiali project.
The ai-tools repository is designed to:
- Provide AI Prompts: Store commonly used AI prompts for development, documentation, testing, and other Kiali-related tasks
- Share AI Tools: Maintain scripts, utilities, and tools that leverage AI to assist with Kiali development workflows
- Document Best Practices: Capture proven approaches and guidelines for effectively using AI in the context of the Kiali project
- Enable Collaboration: Offer a shared space for team members to contribute and discover AI-powered solutions
ai-tools/
├── rules/ # Agnostic rules (work with both Cursor and Claude Code)
├── skills/ # Agnostic skills (work with both Cursor and Claude Code)
├── cursor/ # Cursor-specific resources (code-reviewer plugin, etc.)
├── claude/ # Claude Code-specific resources
└── ai-development-guide/
Agnostic rules live in rules/. Each file uses dual frontmatter compatible with both Cursor (alwaysApply, globs) and Claude Code (paths).
| Rule | Scope | Description |
|---|---|---|
build-test-commands |
Always | Standard build and test commands for the Kiali project |
code-quality |
Always | Code quality guidelines |
comments |
Always | Comment style guidance for generated code |
file-protection |
Always | Files and directories that should not be modified |
go |
*.go |
Go-specific conventions |
lint-gherkin |
*.feature |
Run Gherkin linting on feature files |
To use them in a Kiali repo, symlink or copy into the tool-specific directory:
# Cursor
ln -s /path/to/ai-tools/rules <kiali-repo>/.cursor/rules
# Claude Code
ln -s /path/to/ai-tools/rules <kiali-repo>/.claude/rulesAgnostic skills live in skills/, using the standard skill-name/SKILL.md layout. Both Cursor and Claude Code discover skills in this format.
| Skill | Description |
|---|---|
kiali-backstage-validate-deps |
Validate dependency update PRs for the Kiali Backstage workspace |
kiali-check-syntax |
Validate syntax of uncommitted files in the kiali.io repository |
kiali-cve |
Triage and review OSSM Jira CVE issues for the Kiali component |
kiali-delete |
Delete Kiali, Bookinfo, and Istio from Minikube |
kiali-start |
Start Kiali in Minikube with Istio and Bookinfo (sidecar or ambient mode) |
progress-report |
Generate a progress report for the current task |
regression-fix |
Investigate and fix a failing Cypress test from a GitHub issue |
regression-report |
Create a structured GitHub issue for a confirmed Cypress test failure |
regression-triage |
Analyze Jenkins nightly CI failures, classify them, and produce triage handoff blocks |