AGENTS.md · git:20261005.316713e · 2026-10-05 · sha256 8b610ade903d0401

AGENTS.md git:20261005.316713eA

Immutable. This exact content never changes and is served at /api/v1/blob/8b610ade903d0401.

# Full Stack HQ repository instructions

This repository is a configuration and documentation kit. It has no application
runtime, package manager, or production service to deploy.

## Source of truth

- `core/rules/common.md` contains host-neutral engineering policy.
- `adapters/<host>/rules.md` contains only host-specific integration guidance.
- `agents/` contains canonical Markdown agent bodies.
- `skills/` contains canonical Agent Skills.
- `workflows/` contains canonical workflow bodies and the Antigravity legacy bridge.
- `plugin.json` packages the existing canonical skills for plugin-aware hosts.
- `.claude-plugin/` and `hooks/hooks.json` expose the canonical agents, skills,
  workflows, and shared rules as a Claude Code plugin marketplace.
- `bootstrap.*` fetch a temporary checkout and run the matching installer.
- `llms.txt` and `docs/FAQ.md` summarize the project for AI assistants and
  people; keep their counts, commands, and links in sync with the source.
- `scripts/build-adapters.*` renders Codex TOML agents and workflow-to-skill adapters.

Do not create separate copies of shared agent or skill instructions for each
host. Put shared behavior behind the smallest useful interface and keep host
differences in an adapter.

## Verification

Run the platform-native validator before proposing a release:

```text
PowerShell: .\scripts\validate.ps1
Bash:       bash scripts/validate.sh
```

The validator must pass on Windows and Linux. Installers should be tested with
their dry-run option and with the isolated smoke tests. The doctor is
read-only; it may report missing host installations as warnings. These checks
must not push, create branches, or deploy.

## Change discipline

- Keep the existing top-level `agents/`, `skills/`, and `workflows/` paths for
  compatibility.
- Update README, setup/customization docs, and `CHANGELOG.md` when behavior or
  supported hosts change.
- Do not put host-specific tool names, paths, or commands in canonical agent
  and skill bodies unless the example is explicitly about that host.
- Prefer additive migration bridges over deleting legacy installation paths.