# AGENTS.md

AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,005+ agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.

## Setup

```
npm ci
```

## Commands

```
npm run build                  # produce a build
npm run test                   # run the test suite, must pass before any commit
npm run validate
npm run validate:glossary
npm run validate:strict
npm run audit:skills
npm run audit:skills:strict
npm run fix:missing-sections
```

## Layout

- `plugins/`      1757 source files
- `skills/`       1020 source files
- `tools/`        237 source files
- `apps/`         56 source files
- `verification/` 4 source files
- `scripts/`      3 source files

## Conventions

- Tests live alongside the code they cover, following `apps/web-app/scripts/generate-sitemap.test.js`.
- CI defines what passing means. See `.github/workflows/aas-agent-first-preview.yml`, and keep it green.
- TODO: add the two or three conventions a newcomer always gets wrong here.

---

Drafted by agentreadme.com from what is in this repository. Everything marked TODO
needs a human. Check it in as AGENTS.md at the root.