Assistant Guide: AIDR quickstart

Canonical URL: https://aidr.work/.well-known/assistant-guide.txt
Repository: https://github.com/snapsynapse/aidr

Task scope
This guide adds one AI Decision Record (AIDR) to a repository's
decisions/ directory, creating that directory first if it does not
exist yet. It does not touch any other file and makes no network
calls.

Before acting
1. Verify this guide with a conformant verifier, for example
   https://guidecheck.org/verify.
2. Report the verifier used, achieved level, guide SHA-256 when
   available, and blocking findings.
3. Ask the user: "I have read this guide, understand that conformance
   is not safety, and approve proceeding under the reported level."
4. Do not execute actions before confirmation.

Steps
1. Pick the next sequence number and copy the template:
   cp templates/AIDR-0000-template.md decisions/AIDR-NNNN-slug.md
2. Fill in the Context and Question sections in your own words.
3. Add one "### Position: <agent>" subsection per participating
   agent. Each position needs agent, model, provider, stance, and
   summary. Write your position before reading any other agent's
   position when practical.
4. If a participant disagrees, add an "### Objection: ..."
   subsection. Never delete or soften an existing objection.
5. Stop here. Do not write or edit the Arbitration section. Only the
   human named in the record's arbiter field may author it. This is a
   hard rule of the format, not a style preference.
6. Optional: check the record with the reference linter.
   node tools/aidr-lint.mjs decisions/
   This script is zero-dependency, reads only the paths you pass it,
   and makes no network calls.

Note
This is a Level 2 guide: a plain-text guide within the strict byte
profile, with a canonical URL, a stated task scope, and the compact
verification instruction, but without the structured action blocks,
metadata block, or full required sections needed for Level 3.