forked from Bos55/nix-config
meta: add AI agent rules and skills
Some checks failed
Build / build (Testing) (pull_request) Has been cancelled
Build / build (Development) (pull_request) Has been cancelled
Build / Determining hosts to build (pull_request) Failing after 10m10s
Build / Determining hosts to build (push) Failing after 11m10s
Build / build (Testing) (push) Failing after 13m36s
Build / build (Development) (push) Failing after 15m18s
Some checks failed
Build / build (Testing) (pull_request) Has been cancelled
Build / build (Development) (pull_request) Has been cancelled
Build / Determining hosts to build (pull_request) Failing after 10m10s
Build / Determining hosts to build (push) Failing after 11m10s
Build / build (Testing) (push) Failing after 13m36s
Build / build (Development) (push) Failing after 15m18s
Create a modular, context-aware style guide for AI code assistants. - Add nixos-architecture skill for .nix file generation and networking patterns - Add dns-management rule to enforce Bind9 SOA serial increments - Add cicd-networking rule for direct-IP runner authentication - Add git-workflow rule to enforce conventional and atomic commits
This commit is contained in:
parent
5a031b48ed
commit
3648b4d535
4 changed files with 95 additions and 0 deletions
13
.agent/rules/ci-cd-networking-constraints.md
Normal file
13
.agent/rules/ci-cd-networking-constraints.md
Normal file
|
|
@ -0,0 +1,13 @@
|
|||
---
|
||||
name: cicd-networking
|
||||
description: Networking constraints for CI/CD workflow files (Gitea/GitHub Actions).
|
||||
globs: [".github/workflows/.yml", ".github/workflows/.yaml", ".gitea/workflows/.yml", ".gitea/workflows/.yaml"]
|
||||
---
|
||||
|
||||
# Bos55 CI/CD Networking Constraints
|
||||
|
||||
When generating or modifying CI/CD workflows, strictly follow these networking practices:
|
||||
|
||||
1. **IP-Based Login for Reliability**
|
||||
- When CI runners (like Gitea Actions) need to interact with internal services for authentication or deployment, always use direct IP addresses (e.g., `192.168.0.25`) for machine-to-machine login steps.
|
||||
- **Why?** This bypasses potential DNS resolution issues or delays within the isolated runner environment, ensuring maximum robustness during automated CI/CD runs.
|
||||
14
.agent/rules/dns-management.md
Normal file
14
.agent/rules/dns-management.md
Normal file
|
|
@ -0,0 +1,14 @@
|
|||
---
|
||||
name: dns-management
|
||||
description: Hard constraints for modifying Bind9 DNS zone files.
|
||||
globs: ["db.", ".zone"]
|
||||
---
|
||||
|
||||
# Bos55 DNS Management Constraints
|
||||
|
||||
When modifying or generating Bind9 zone files, you MUST strictly adhere to the following rules:
|
||||
|
||||
1. **Serial Increment (CRITICAL)**
|
||||
- Every single time you modify a Bind9 zone file (e.g., `db.depeuter.dev`), you MUST increment the Serial number in the SOA record. Failure to do so will cause DNS propagation to fail.
|
||||
2. **Domain Name Specificity**
|
||||
- Prefer a single, well-defined explicit domain (e.g., `nix-cache.depeuter.dev`) instead of creating multiple aliases or using magic values. Keep records clean and explicit.
|
||||
21
.agent/rules/git-workflow.md
Normal file
21
.agent/rules/git-workflow.md
Normal file
|
|
@ -0,0 +1,21 @@
|
|||
---
|
||||
name: git-workflow
|
||||
description: Rules for generating Git commit messages and managing branch workflows.
|
||||
globs: ["COMMIT_EDITMSG", ".git/*"]
|
||||
---
|
||||
|
||||
# Git Workflow Constraints
|
||||
|
||||
When generating commit messages, reviewing code for a commit, or planning a branch workflow, strictly follow these standards:
|
||||
|
||||
1. **Commit Formatting**
|
||||
- **Conventional Commits**: You MUST format all commit messages using conventional prefixes: `feat:`, `fix:`, `docs:`, `refactor:`, `ci:`, `meta:`.
|
||||
- **Clarity**: Ensure the message clearly explains *what* changed and *why*.
|
||||
2. **Atomic Commits**
|
||||
- Group changes by a single logical concern.
|
||||
- NEVER mix documentation updates, core infrastructure code, and style guide changes in the same commit.
|
||||
- Ensure that the generated commit is easily revertible without breaking unrelated features.
|
||||
3. **Branching Workflow**
|
||||
- Always assume changes will be pushed to a feature branch to create a Pull Request.
|
||||
- Do not suggest or generate commands that push directly to the main branch.
|
||||
|
||||
Loading…
Add table
Add a link
Reference in a new issue