Skip to content

docs: add AGENTS.md for AI coding agent guidance - #247

Merged
osanderson merged 1 commit into
mainfrom
docs/agents-md
Sep 1, 2026
Merged

docs: add AGENTS.md for AI coding agent guidance#247
osanderson merged 1 commit into
mainfrom
docs/agents-md

Conversation

@osanderson

Copy link
Copy Markdown
Collaborator

Summary

  • Adds AGENTS.md — process notes for AI coding agents working in this repo (branch/PR/merge discipline, when it's safe to sync main, release-please's version-cut flow), plus pointers into the existing conformance-suite READMEs rather than duplicating their content.
  • Documents the new -ciba-approval-ui-token//ciba-approve feature (feat: add token-gated manual CIBA approve/deny UI #245) at the level future agents actually need: why it exists (no hosted equivalent of automated_ciba_approval_url), where to look for detail.
  • Records the client alias naming convention settled on this session (fapigo-{family}-{axis1}-{axis2}) as precedent for anyone registering new conformance-testing clients.
  • Deliberately excludes anything operational (no live server details, no secrets) — this file is git-committed, codebase guidance only.

Test plan

  • Docs-only change — no code touched, go build/go test unaffected.

🤖 Generated with Claude Code

https://claude.ai/code/session_01KWEP7ddZm9T8pVotywwFfF

Agent-specific process notes (branch/PR/merge discipline, when to
sync main) plus pointers into the conformance-suite READMEs and the
new CIBA approval UI feature, so future agent sessions don't
re-derive hard-won knowledge this session already worked out.
@codecov

codecov Bot commented Sep 1, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@sonarqubecloud

sonarqubecloud Bot commented Sep 1, 2026

Copy link
Copy Markdown

@osanderson
osanderson merged commit cb6ce3c into main Sep 1, 2026
9 checks passed
@osanderson
osanderson deleted the docs/agents-md branch September 1, 2026 23:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant