Opera-Extensions/AGENTS.md

Agent Instructions

Project

This repository contains Opera extension projects. The active project is opera-cache-cleaner-extension, a Manifest V3 Chromium extension for clearing only the browser cache from an Opera toolbar popup.

Repository Rules

• Derive the repository owner and repository name from the target repository remote or CI repository context. Never reuse the owner from the repository kit remote.
• Keep application changes scoped to opera-cache-cleaner-extension/ unless repository-level workflows or agent documentation need updates.
• Preserve the plain Manifest V3 extension structure. Do not add a framework unless the user explicitly asks for it.
• Keep permissions minimal. The extension currently uses only browsingData, storage, and alarms.
• Do not add host permissions, network calls, cookie/history access, or broad browser permissions without documenting the reason.
• Do not create a release unless the user explicitly asks for one.
• Keep .codex/project.md and opera-cache-cleaner-extension/.codex/project.md aligned when commands, artifact paths, or release rules change.

Commands

Use these commands from the repository root:

node --check opera-cache-cleaner-extension/background.js
node --check opera-cache-cleaner-extension/popup/popup.js

To build a package from the repository root:

cd opera-cache-cleaner-extension
mkdir -p dist && zip -r dist/opera-cache-cleaner-extension.zip manifest.json background.js popup icons -x "*.DS_Store"

There is no package manager, dependency install, lint, or dependency audit command for the current project.

Artifacts

Expected release artifact:

opera-cache-cleaner-extension/dist/opera-cache-cleaner-extension.zip

Finish Checklist

• git diff --check passes.
• node --check opera-cache-cleaner-extension/background.js passes.
• node --check opera-cache-cleaner-extension/popup/popup.js passes.
• Gitea workflows are polled after pushed workflow-triggering commits.