AGENTS

AGENTS.md

Purpose: Help AI coding agents make clean, minimal edits in this markdown-only wiki.

Repository Type

• Personal knowledge wiki, not application source code.
• Content is markdown docs only.
• No build, test, lint, package manager, or CI pipeline in this repo.

Edit Scope

• Only create or edit .md files (plus image links when needed).
• Keep edits focused on user ask. No speculative restructuring.
• Preserve existing voice and practical, hands-on style.

Directory Intent

• repo_docs/: stable reference docs for repo/workflow conventions.
• misc/: curated lists and miscellaneous references.
• Home.md: top-level hub and index.

Note: Troubleshooting_guides/ was removed 2026-08-26 — all 20 guides migrated to the Notion AI Knowledgebase (Note database, page 873e47a7-c6fe-8256-a6fe-017e2c1eff07). Do not recreate this directory; new problem -> diagnosis -> fix guides go to the Notion KB instead (see notion-kb-sync skill), not this wiki.

File Naming

• Prefer PascalCase-with-hyphens.md for new pages.
• Keep names specific to symptom/topic, not generic titles.

Markdown Conventions

• One # title per file, then clear ## sections.
• Use fenced code blocks with language labels (for example bash, json).
• Explain command intent briefly, not just command text.
• Keep steps actionable and verifiable.

Link, Do Not Duplicate

Prefer linking to existing docs over copying large sections:

• Home
• Dotfile-management
• KDE-shortcuts
• tui-favorites

Navigation Updates

• If you add a new guide, add a link from Home.md in relevant section.
• Keep relative links valid from file location.

Safety

• Do not invent results from commands not run.
• Avoid destructive recommendations unless user explicitly asks.
• Keep hardware/distro specifics explicit when relevant (for example CachyOS, ThinkPad T570, Raspberry Pi).