# 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:

```bash
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:

```bash
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:

```text
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.