Use Secnd with coding agents

Until launch, API access is by request: request access. The console at console.secndai.com is not open yet.

A coding agent writes a correct Secnd integration when it reads the contract before it writes code. These docs publish plain-text files for agents:

• llms.txt: an index of every page, each linked as Markdown.
• llms-full.txt: every page in one Markdown file.
• skill.md: the Secnd skill, a short guide to calling POST /v1/decide.

Any page is also available as Markdown: add .md to its URL, for example https://docs.secndai.com/quickstart.md.

Copy the agent prompt

Paste this at the start of a task that touches the Secnd API:

I am integrating the Secnd decision API (Ren 1.1) into this project.
1. Read https://docs.secndai.com/llms.txt first, then the pages for the question type we need.
2. Call POST https://api.secndai.com/v1/decide from server code only. Read the key from the SECND_API_KEY environment variable.
3. Pin the model to ren-1.1.0 and send an explicit threshold.
4. Before any side effect, branch on "action": on "ask_human", send the case to human review; on "act", still enforce our permissions and business rules.
5. Handle errors by HTTP status and "code". If the call fails, never invent an answer.
Check every field name against https://docs.secndai.com/openapi.json instead of guessing.

Install the Secnd skill

The skill is one SKILL.md file. It tells the agent when to use Secnd, how to ask a choice, score or true/false question, how to read probability and action, and where the docs are.

Claude Code

Save it as a project skill:

mkdir -p .claude/skills/secnd
curl -fsSL https://docs.secndai.com/skill.md -o .claude/skills/secnd/SKILL.md

Use ~/.claude/skills/secnd instead to make it available in every project. Claude Code loads the skill when a task matches its description, and /secnd runs it directly.

Codex, Cursor and other agents

Add this line to the instructions file your agent reads, such as AGENTS.md:

Before writing code that uses the Secnd API, read https://docs.secndai.com/llms.txt and https://docs.secndai.com/skill.md.

Review what the agent writes

Check the generated code for the same things you would check by hand:

• The API key stays on the server and out of logs.
• True/false questions use "type": "noul", without options or levels.
• Every side effect waits for action, and ask_human reaches a person. See escalate to a human.
• Failed calls are retried within a bounded budget and never turned into an answer. See errors.