docs(AGENTS.md): add more global instructions, reformat

This commit is contained in:
Jone 2026-03-25 20:15:04 +01:00
parent dda5ebf86d
commit 0d7a194518
Signed by: Jone
GPG key ID: 0D98FD3896C39E90

View file

@ -17,7 +17,7 @@ Name: Ducky | Jone's AI assistant | https://ai.jone.foo/ai.txt
## Code & Implementation
**General:** CODE MUST be correct | KEEP minimal + clean | NO explanations in code; comments only if needed | RULES as comments (e.g., `# MUST do X`) | NO new features without permission
**Style:** FOLLOW existing code style | PREFER existing patterns/deps | NO new libs unless needed | USE PEP8 if no style guide | USE descriptive names | AVOID abbreviations
**Style:** FOLLOW existing code style | PREFER existing patterns/deps | NO new libs unless needed | USE PEP8 if no style guide | USE descriptive names | AVOID abbreviations | AVOID unnecessary apostrophes (e.g., use "dont" context words, not "don't" in formal writing)
**Language Choice:** USE python or rust when unspecified (if possible) | ALTERNATIVES: Java → Kotlin
**Editing:** READ context before editing | MAKE minimal changes | PREFER small diffs | NO full rewrites
**Quality:** ENSURE runnable + complete | HANDLE edge cases | DO NOT ignore errors | KEEP error handling simple | PREFER efficient solutions | ADD logs only if useful
@ -42,7 +42,15 @@ Name: Ducky | Jone's AI assistant | https://ai.jone.foo/ai.txt
**Copilot CLI:** `/fleet` (multi-agent) | `/research` (gather info) | `/review` (check before commit) | `/compact` (save tokens) | `/instructions` (toggle + reload AGENTS.md) | `!` (shell) | `Shift+Tab` (cycle) | `Ctrl+O/E` (expand) | `Ctrl+T` (reasoning) | `Ctrl+S` (run, preserve input)
**RTK - Rust Token Killer:** Always prefix shell commands with `rtk` to minimize token consumption. Usage: `rtk git status`, `rtk cargo test`, `rtk grep "pattern" src/`, etc. Meta: `rtk gain` (token savings) | `rtk gain --history` (with history) | `rtk discover` (find missed opportunities) | `rtk proxy <cmd>` (raw/debug). The `.github/hooks/rtk-rewrite.json` hook intercepts raw bash calls automatically.
**Shell Context:** Copilot CLI runs commands in **bash**, not zsh or other shells.
RC-file: `~/.bashrc` is used (not `~/.zprofile`). Only bash-specific syntax.
**RTK - Rust Token Killer:** Always prefix shell commands with `rtk` to minimize token consumption.
Usage: `rtk git status`, `rtk cargo test`, `rtk grep "pattern" src/`, etc.
Meta: `rtk gain` (token savings) | `rtk gain --history` (with history) | `rtk discover` (find missed opportunities) | `rtk proxy <cmd>` (raw/debug).
The `.github/hooks/rtk-rewrite.json` hook intercepts raw bash calls automatically.
**DO NOT** suggest MCP servers, aliases, or RC-file modifications for RTK — the hook handles everything.
Dont proactively mention RTK unless user asks about optimization.
**Pre-Start:** ✓ Clear instructions | ✓ ASK if unclear | ✓ Reason FIRST | ✓ CHECK security | ✓ USE `/review` | ✓ Small diffs | ✓ Check MUST/NEVER/ALWAYS rules | ✓ Maintain context | ✓ Consistency checks | ✓ Monitor Agents | ✓ Escalate if unresolved
@ -57,3 +65,4 @@ Name: Ducky | Jone's AI assistant | https://ai.jone.foo/ai.txt
**`/research` for investigation sessions:** "Improve X" or "Require Y" tasks? Use `/research` to gather info with GitHub search + web sources BEFORE coding.
**`/compact` proactively:** Don't wait until token crunch — after ~15 turns on a long task, run `/compact` to reset context and keep focus.
**`/delegate` for docs changes:** Even small AGENTS.md edits → prefer `/delegate` (PR flow) over direct main branch commits for review safety.