# AGENTS.md

## Project

Goal: create a `Containerfile` for **Podman** that runs a CUPS print server. The repo is new — there is no application code and no build/test/lint config yet, so don't guess at tooling that isn't there.

- `HP-driver/` is the only content. Despite the folder name, `linux-brprinter-installer-2.2.6-0.gz` is a **Brother** driver installer, and `HP-driver/README.md` documents its usage (`gunzip` → `sudo su` → `bash linux-brprinter-installer-* <model>`).

## Version control

- Use **jujutsu (`jj`)** for all version-control mutations, not git. See the `jujutsu` skill (`.opencode/skills/jujutsu/SKILL.md`), which also covers recovery and workspaces.
- The directory is not a repo yet. Initialize with `jj git init` before making commits.

## OpenSpec workflow

- Planned work goes through OpenSpec: `/opsx-propose` → `/opsx-apply` → `/opsx-archive` (commands in `.opencode/commands/opsx-*.md`, skills in `.opencode/skills/openspec-*`).
- The `openspec` CLI (Homebrew, v1.14.x) is installed but **not initialized in this repo** — all opsx commands fail with "No OpenSpec root found" until `openspec init` has been run once.
- Specs live at `openspec/specs/<capability>/spec.md`; changes are scaffolded with `.openspec.yaml` in the resolved planning home.

## Environment

- `podman`, `podman-compose`, and CUPS are **not installed** on this machine (verified 2026-10-17). Confirm availability before assuming `podman build` works.
- Host is macOS; `openspec`, `jj`, and `git` are on PATH (Homebrew).