feat: add Ankra CLI cursor rules for Kubernetes cluster management

[CodeStaple]

Summary

This PR adds a cursor rule file for the Ankra CLI — a Kubernetes cluster management platform.

What is Ankra?

Ankra is a platform for managing Kubernetes clusters and their associated resources. Its CLI (ankra) provides a unified interface to manage:

• Organisations and team members
• Cluster lifecycle (provision, deprovision, reconcile)
• Add-ons and application stacks
• Helm releases and chart registries
• Cloud provider integrations (Hetzner, OVH, UpCloud)
• Credentials and API tokens
• In-cluster agent management

What the rule covers

The rules-new/ankra-cli.mdc file provides:

• Authentication and configuration best practices
• Command reference for all major CLI subsystems
• Scripting and CI/CD automation tips
• Common end-to-end workflows (provisioning, deploying stacks, rotating credentials)
• Global flags and environment variable reference

The rule is scoped to shell scripts, YAML/Kubernetes manifests, Makefiles, and Markdown files — the typical files where Ankra CLI commands appear.

Summary by CodeRabbit

• Documentation
  • Added Ankra CLI best practices guide covering authentication, organization, and cluster management workflows
  • Included operational guardrails, credential handling, and add-ons management
  • Documented stacks, Helm releases, and cluster agent operations
  • Provided example workflows for cluster provisioning, stack deployment, and token rotation
  • Updated README with documentation reference

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: b2809a1d-e46b-4da8-91fa-2255793470c8

📥 Commits

Reviewing files that changed from the base of the PR and between fc2ce04 and 433deae.

📒 Files selected for processing (2)

• README.md
• rules-new/ankra-cli.mdc

---

📝 Walkthrough

Walkthrough

Two documentation files were added: a new CLI best practices guide for Ankra CLI in rules-new/ankra-cli.mdc covering authentication, organization management, cluster lifecycle operations, add-ons, stacks workflows, and operational guardrails, with the README updated to reference this new documentation.

Changes

Cohort / File(s)	Summary
Documentation Additions README.md, rules-new/ankra-cli.mdc	Added CLI best practices guidance for Ankra CLI covering authentication, configuration, organization/cluster management, add-ons, stacks, manifests, cluster agents, Helm integration, credential handling, global flags, scripting tips, and example workflows. Updated README with link to new documentation.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Poem

🐰 A documentation hop so fine,
CLI rules in perfect line,
Best practices, clear and bright,
Making workflows feel just right! 📋✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title 'feat: add Ankra CLI cursor rules for Kubernetes cluster management' accurately summarizes the main change: adding documentation and cursor rules for Ankra CLI development. The title is concise, specific, and directly reflects the primary changeset across both README.md and ankra-cli.mdc files.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}