Files
skygqts/AGENTS.md
T
2026-09-14 13:19:41 -04:00

1.6 KiB

Agent Instructions

Read this file before making any changes.

CLAUDE.md and .agents/AGENTS.md are symlinks to this file. Do not treat them as separate copies.

Mandatory First Step — Always Present a Plan

Before making any change to this repository, you MUST present a short plan to the user and wait for their approval. This applies to every task, no matter how small.

Your plan must include:

  1. What you intend to change (files, options, packages)
  2. Why the change is needed
  3. How you will do it (which files you will edit, in what order)
  4. What you will NOT do (e.g., "I will not run any builds")

Only after the user approves the plan may you proceed with edits.

Hard Rules

Your job: Make correct edits to source files. The user validates and runs builds themselves.

Even if the user says "go ahead": Do NOT run builds, evals, or similar commands.

  • Keep comments short and plain. Prefer common words over jargon.
  • Minimize the use of var in type definitions. Always prefer explicit types where possible.
  • When setting up a new type via QtObject, avoid providing defaults unless there is a good reason.

When In Doubt

If you are unsure whether a command is safe, assume it is not and don't run it.

Describe what you would do and ask the user for permission.

Commit / Branch / Git Policy

  • Do not commit changes or create branches unless the user explicitly asks
  • Do not git add, git commit, or git push autonomously
  • Describe what you changed in your final message so the user can review before committing