mirror of
https://github.com/fleetdm/fleet
synced 2026-04-21 13:37:30 +00:00
Add fleet-gitops slash command for Claude Code (#42326)
## Summary - Adds `.claude/commands/fleet-gitops.md`, a new slash command (`/fleet-gitops`) for Claude Code users working in the `it-and-security` folder - Mirrors the existing Kilocode skill (`/.kilocode/skills/fleet-gitops/SKILL.md`) with the same validation rules for osquery queries, configuration profiles (Apple/Windows/Android), software management, DDM declarations, and CVE remediation - Command is explicitly invoked only — does not auto-trigger, so it has zero impact on the engineering team's normal Claude usage ## Test plan - [ ] Verify `/fleet-gitops` is available as a slash command in Claude Code when opened in this repo - [ ] Confirm the command correctly sets context for GitOps work (queries, profiles, software, DDM) - [ ] Confirm no change to existing engineering commands (`/review-pr`, `/test`, `/fix-ci`, etc.)
This commit is contained in:
parent
5e54b86796
commit
a1860a9185
1 changed files with 43 additions and 0 deletions
43
.claude/commands/fleet-gitops.md
Normal file
43
.claude/commands/fleet-gitops.md
Normal file
|
|
@ -0,0 +1,43 @@
|
|||
You are helping with Fleet GitOps configuration files: $ARGUMENTS
|
||||
|
||||
Focus on the `it-and-security` folder. Apply the following constraints for all work in this session.
|
||||
|
||||
## Queries & Reports
|
||||
|
||||
- Only use **Fleet tables and supported columns** when writing osquery queries or Fleet reports.
|
||||
- Do not reference tables or columns that are not present in the Fleet schema for the target platform.
|
||||
- Validate table and column names against the Fleet schema before including them in a query:
|
||||
- https://github.com/fleetdm/fleet/tree/main/schema
|
||||
|
||||
## Configuration Profiles
|
||||
|
||||
When generating or modifying configuration profiles:
|
||||
|
||||
- **First-party Apple payloads** (`.mobileconfig`) — validate payload keys, types, and allowed values against the Apple Device Management reference:
|
||||
- https://github.com/apple/device-management/tree/release/mdm/profiles
|
||||
- **Third-party Apple payloads** (`.mobileconfig`) — validate against the ProfileManifests community reference:
|
||||
- https://github.com/ProfileManifests/ProfileManifests
|
||||
- **Windows CSPs** (`.xml`) — validate CSP paths, formats, and allowed values against Microsoft's MDM protocol reference:
|
||||
- https://learn.microsoft.com/en-us/windows/client-management/mdm/
|
||||
- **Android profiles** (`.json`) — validate keys and values against the Android Management API `enterprises.policies` reference:
|
||||
- https://developers.google.com/android/management/reference/rest/v1/enterprises.policies
|
||||
|
||||
## Software
|
||||
|
||||
- When adding software for macOS or Windows hosts, **always check the Fleet-maintained app catalog first** before using a custom package:
|
||||
- https://github.com/fleetdm/fleet/tree/main/ee/maintained-apps
|
||||
- In GitOps YAML, use the `fleet_maintained_apps` key with the app's `slug` to reference a Fleet-maintained app.
|
||||
- When remediating a CVE, use Fleet's built-in vulnerability detection to identify affected software, then follow the Software section above to deploy a fix — preferring a Fleet-maintained app update where available, otherwise a custom package.
|
||||
|
||||
## Declarative Device Management (DDM)
|
||||
|
||||
When generating or modifying DDM declarations:
|
||||
|
||||
- Validate declaration types, keys, and values against the Apple DDM reference:
|
||||
- https://github.com/apple/device-management/tree/release/declarative/declarations
|
||||
- Ensure the `Type` identifier matches a supported declaration type from the reference.
|
||||
|
||||
## References
|
||||
|
||||
- Fleet GitOps documentation: https://fleetdm.com/docs/configuration/yaml-files
|
||||
- Fleet API documentation: https://fleetdm.com/docs/rest-api/rest-api
|
||||
Loading…
Reference in a new issue