agentslisted

# AGENTS.md Guidance for AI coding agents working on the **adeptability** (`adept`) codebase. Humans: see [README.md](README.md) for usage and [CONTRIBUTING.md](CONTRIBUTING.md) for the contributor workflow. ## Project Overview `adept` is a single-binary Go CLI for **cross-harness AI skill portability**: you author a skill once in a canonical format and `adept` renders it accurately into every AI coding harness in your project — Claude Code, Cursor, Codex, GitHub Copilot, OpenCode, and any config-driven adapter you register — then keeps the two sides in sync in both directions. - **Language:** Go 1.25, [Cobra](https://github.com/spf13/cobra) command surface. - **Module:** `github.com/itaywol/adeptability`. Binary: `adept` (entrypoint `cmd/adept`). - **No runtime services.** Everything is local filesystem + `git` + optional network (GitHub API, skills.sh, an LLM provider for the optional intent pass). - **Source of truth is the filesystem.** Content hashes — not version numbers — drive every sync decision. There is no central database. ## Commands User-facing CLI (five verbs + three subcommand groups): | Command | Description | | --- | --- | | `adept init [--from <url>] [--ref <branch>] [--name <local>] [--mode symlink\|copy]` | Scaffold `.adeptability/`, optionally clone a library, adopt existing harness files | | `adept status` | Project state at a glance: init, libraries, harnesses, drift | | `adept sync [--harness <id>] [--force] [--dry-run]` | Push canonical sk