From 0d7a194518aae6cbf90cfe235668f5b589ce8635 Mon Sep 17 00:00:00 2001 From: Jone Date: Wed, 25 Mar 2026 20:15:04 +0100 Subject: [PATCH] docs(AGENTS.md): add more global instructions, reformat --- AGENTS.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index d5ebf37..efb33ab 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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 ` (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 ` (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 @@ -56,4 +64,5 @@ Name: Ducky | Jone's AI assistant | https://ai.jone.foo/ai.txt **`@mention` files for instant context:** Use `@filename` in prompts to include file content upfront — saves round-trips when agents need to understand current state. **`/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. \ No newline at end of file +**`/delegate` for docs changes:** Even small AGENTS.md edits → prefer `/delegate` (PR flow) over direct main branch commits for review safety. +