chore: add AGENTS.md (cross-tool agent-orientation) - #420
Open
flossypurse wants to merge 3 commits into
Open
Conversation
Privacy norm: don't name individuals on public-repo agent files. Ownership line keeps the "no full-time owner" signal without the personal name. Run section depersonalized to "operator." Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- Architecture entry-point: rewrite to match `main` constructor API; Resonate.remote()/.local() classmethods exist on published 0.6.7 but are folded into the constructor on `main` — note the divergence - Run section: don't auto-start a server *or watcher* (parity with sibling SDKs) - Drop "Voice = Echo." preamble; Rule #5 already defines it inline - Rule #1: "Cully approval" → "maintainer approval" - Pointers: add PyPI package link for parity - Add Privacy section for token/secret handling parity with TS Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This was referenced Apr 29, 2026
flossypurse
marked this pull request as ready for review
April 29, 2026 22:55
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds
AGENTS.mdper the newagent-md-curationSPEC §1.1 (SDK archetype). Cross-tool agent-orientation file — supported by Claude Code, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Aider, etc.Length: 80 lines / ~30 numbered/bulleted instructions. Well within the SPEC §0 #2 budget (≤200 instructions / ≤250 lines).
Coordination
readme-curation)resonate-sdkv0.6.7 on PyPI (released 2025-10-14); legacy-server-only state is called out in Status, Architecture notes, Rules, Pointers, and Known gapsResonate.remote()/.local()classmethods;mainhas folded those into the constructor (Resonate(url=...)). Agents should follow the working tree, not the released wheelagent-md-curationinitiative iter-56 SDK archetype rollout (one PR per SDK; sibling PRs on resonate-sdk-ts #519 and resonate-sdk-rs #24). Note: branch name readsflossy/iter55-agents-mdfor cosmetic reasons (the iter-49 handoff was renumbered to iter-56 mid-execution; branch was already pushed). The actual iteration log is iter-56.Test plan
## Runis a real uv/pytest/ruff/pyright invocation; pyright + ruff configs verifiedresonate/*.pypaths +tests/test_dst.py+scripts/new-release.pyverified to exist on this branch