# AGENTS.md: Solnix agent skills You are an agent working with **Solnix**: illumos (the open descendant of OpenSolaris) whose whole system is built, configured and upgraded with Nix and the NixOS module system. This file is the map of this repository and its rules. Read it, then load the one skill the task needs. CC0-1.0. Source of truth: . Mirror: . Served over MCP at `https://solnix.io/mcp` (`find_skill`, `get_skill`, SEP-2640 `skills/list`). ## Pick a skill | you are | load | |---|---| | using a Solnix desktop or shell; installing software | [`solnix/user`](solnix/user/SKILL.md) | | running machines: SMF, ZFS, boot environments, zones, networking, FMA, RBAC, DTrace | [`solnix/sysadmin`](solnix/sysadmin/SKILL.md) | | porting or packaging software; a build or binary fails on illumos | [`solnix/porter`](solnix/porter/SKILL.md) | | writing Nix for Solnix (derivations, modules, recipe rows) | [`solnix/nix-dev`](solnix/nix-dev/SKILL.md) (draft) | | changing illumos-gate itself | [`solnix/illumos-dev`](solnix/illumos-dev/SKILL.md) (stub) | | sending a patch, a bug or a security report | [`solnix/contributor`](solnix/contributor/SKILL.md) | | running a builder; the binary cache, queue, votes | [`solnix/builder`](solnix/builder/SKILL.md) (draft) | Not sure? Call `find_skill {task}` on the MCP server, or read [`CATALOG.md`](CATALOG.md). Personas are short maps. The detail lives in the shared rule library [`solnix/rules/`](solnix/rules/SKILL.md): one rule per file, each with the antipattern, the Solnix way, the illumos way, the difference, a check command, and its sources. ## Always on Keep [`steering/`](steering/README.md) loaded: `honesty-over-hype`, `query-first`, `solnix-is-not-upstream-illumos`, `confirm-destructive`, `voice`, `privacy`. ## Rules for every task - **Query, then answer.** Your training data does not know Solnix. Ask the MCP server (`package_status`, `translate_command`, `search_manpages`, `search_handbook`) and cite what it returns. - **Solnix way first, then illumos, then the difference.** Upstream illumos advice is right about illumos and wrong about what Nix replaced (IPS, hand-imported SMF manifests, `useradd`, `crle`). - **Confirm before destroying.** The list is in `steering/confirm-destructive.md`. - **Say what is not built.** "Planned" is a fine answer; a wrong "it works" is not. - **The human sends.** No mail, no upstream PRs or issues; prepare them and hand over. ## Contributing to this repository - One rule per file under `solnix/rules/-.md`, following [`_template.md`](solnix/rules/_template.md). Every factual statement cites a source you read: an illumos man page (`https://solnix.io/docs/man/...`), the handbook, a Solnix OS repo commit, an infra handoff, the illumos books or docs, or the OpenIndiana docs. Mark anything you could not verify under **Unverified**. - Licences: illumos man pages (CDDL), the illumos books and Developer's Guide (PDL), illumos docs (MPL-2.0) and OpenIndiana docs (PDL) may be quoted briefly with attribution. Oracle Solaris documentation and *Solaris Internals* are link-only. Everything here is original text, CC0. - Before a commit: `python3 tools/check.py && python3 tools/catalog.py && python3 tools/manifest.py`. A release tag is signed by infra (`tools/sign-manifest`, the key is not in this repo); a commit after a signature changes manifest.json, so its old `manifest.json.sig` no longer verifies until the next release. - Every change to a rule or a persona goes through an independent review against its cited sources before it ships (see `workflows/review-a-rule.md`).