# building-adom-apps

The Adom developer skillpack: how to build software the **AI-first** way, so every app, CLI, and tool
an Adom user writes is a joy for an AI agent to drive.

The centerpiece is **hints**. The AI tends to never read skills all the way through, and skills get
compacted out of context. So your tool teaches the agent from its own output, at the moment of need:

```
ERROR: skill packages must include a SKILL.md at the package root.
Hint: Move your SKILL.md to the package root, then re-run.
Hint: Run `adom-wiki pkg lint` to see all blockers before publishing.
```

Every CLI returns `OK:` / `ERROR:` + `Hint:` lines (and a `{status, data, hints[]}` JSON envelope). Hints
carry what the agent cannot be expected to remember: the next command, how long a call takes and when it
times out, how to poll a long-running call, pitfalls, which folder to write files to, that an async
screenshot/recording will land later (watch with a Monitor), and the shape of what is coming back (e.g. a
screenshots[] array with parent and child windows).

Routes to the four pillars: **hints**, [`adom-cli-design`](https://wiki.adom.inc/adom/adom-cli-design),
[`app-creator`](https://wiki.adom.inc/adom/app-creator), and the UI design system +
[`adom-ui-linter`](https://wiki.adom.inc/adom/adom-ui-linter). Docs get skipped, so the pattern is also
**enforced** by the linter (CLI-02..05) and should be a publish gate.

## Install

```bash
adom-wiki pkg install adom/building-adom-apps
```

Installs to `~/.claude/skills/building-adom-apps/`. Ships in the `adom/core` baseline. See `SKILL.md`.