chant with a coding agent

For a team that hands infrastructure work to a coding agent: one prompt sets chant up, and the project carries the playbooks and tools the agent reads.

Works

• A copy-paste setup prompt on Agents Start Here, which installs a lexicon and scaffolds the project
• chant init writes a skills/ directory of playbooks from each lexicon and a .mcp.json that registers the chant MCP server
• A page that describes a task can carry a prompt for the agent under its title, and llms.txt lists every page
• chant audit --agents checks the agent setup on the machine: instruction files, MCP servers, skills, plugins and tool permissions

Differs

By forge

GitHub

• --generate github writes the pull-request workflow under .github/workflows/, run on pull_request and on push to the target branch.
• Both jobs use the job's own github.token. On a pull request from a fork that token is read-only, so the plan note and the status are not posted.

GitLab

• --generate gitlab writes .gitlab-ci.yml, and apply runs one at a time per environment through resource_group.
• A CI job token cannot write merge request notes, so set a project access token with the api scope as the masked variable CHANT_FORGE_TOKEN.

Forgejo

• --generate forgejo writes the GitHub workflow in the Forgejo dialect under .forgejo/workflows/: the runner label, action references by URL, and no permissions block.
• Forgejo workflows are GitHub-dialect, so chant audit applies its GitHub rules to them.

First step

Or paste the prompt from Agents Start Here and let the agent pick the lexicon.

npm install --save-dev @intentius/chant-lexicon-aws
npx chant init . --lexicon aws

Agents Start Here

Or hand this step to your coding agentIt stops at a pull request or a report.

Set up chant in this repository.
Read https://intentius.io/chant/llms.txt first, then
https://intentius.io/chant/agents/ and follow it.
Stop when `npx chant build` and `npx chant lint` pass, and open a pull request with the result.
Never deploy to a real cloud account or shared environment (with `chant run`, `chant components` or a platform's own CLI), approve (a pull request review, `chant approve` or `chant run approve`), override a policy denial (`chant approve policy-override`), or merge; never cut or publish a release (`chant release cut --yes` or `chant release publish`), push or delete a `ci/*` tag (`chant ci tick` pushes them), or change the value of an existing flag; never touch `.chant/allowed_signers` or `chant/lifecycle`.

Show the whole prompt

Set up chant in this repository.
Read https://intentius.io/chant/llms.txt first, then
https://intentius.io/chant/agents/ and follow it.
Stop when `npx chant build` and `npx chant lint` pass, and open a pull request with the result.
Never deploy to a real cloud account or shared environment (with `chant run`, `chant components` or a platform's own CLI), approve (a pull request review, `chant approve` or `chant run approve`), override a policy denial (`chant approve policy-override`), or merge; never cut or publish a release (`chant release cut --yes` or `chant release publish`), push or delete a `ci/*` tag (`chant ci tick` pushes them), or change the value of an existing flag; never touch `.chant/allowed_signers` or `chant/lifecycle`.

Copy promptCopy link

Proof

Example projects in the chant repository for this room, each with a README that has the commands to run it.

Example	Where
getting-started	examples/getting-started
alert-triage	examples/alert-triage

Then read

Tasks

Agents Start Here

Background

Agent IntegrationOps as Teammates

Reference

chant serve mcpchant audit