AGENTS.md git:20260827.96ce18eA

Immutable. This exact content never changes and is served at /api/v1/blob/d06b4e59d112aaa0.

# AGENTS.md

This repo is an OpenCode/Claude **skill**, not an application: `SKILL.md` (entrypoint, loaded into context when the skill triggers) plus `references/` (lazy-loaded detail). No build, test, lint, or CI — nothing here is executed.

## Editing rules

- `SKILL.md` frontmatter is load-bearing: `name` must match the directory name; `description` controls when the skill triggers. Don't reword it casually.
- `SKILL.md` must stay self-contained; duplication with `references/*.md` is intentional. When changing a gotcha, endpoint, or URL rule, update all three files: `SKILL.md`, `references/configuration.md`, `references/deploy-script.md`.
- The five GOTCHAs are empirically measured QStorage behavior, not standard S3. Do not "fix" them to match S3/AWS conventions — every one documents a case where the standard behavior silently fails. Example: AWS CLI v2 upload rejection and `CacheControl`/`ExtraArgs ACL` stripping were verified against the live service.
- The `audit_content_types` step in `references/deploy-script.md` is marked mandatory because it caught a real MIME-stamping bug. Don't remove it or the note.

## Verification

- No commands to run. Verify edits by re-reading all three files for consistency (same endpoint, same URL style, same gotcha numbers/references — GOTCHA references are cross-linked by number, e.g. "GOTCHA 2", so renumbering requires updating every mention).
- Testing deploy-script changes for real requires Quilibrium credentials (QConsole → Services → QStorage → Generate API keys); never hardcode credentials into committed files — the script uses placeholder variables by design.