Skip to content

chore: move agent instructions to AGENTS.md and document issue workflow - #943

Merged
tdstein merged 5 commits into
mainfrom
chore/agent-skills-setup
Nov 10, 2026
Merged

tdstein merged 5 commits into
mainfrom
chore/agent-skills-setup

Conversation

@tdstein

@tdstein tdstein commented Nov 10, 2026 •

Copy link
Copy Markdown
Collaborator

I'm refreshing the agentic documentation to work across harnesses. I've also been leveraging https://github.com/mattpocock/skills, which is where the labels originate from. I've found those skills useful, as they map well onto my own workflow, but they are not required.


Moves the agent instructions to AGENTS.md, trims it to what every task needs, and adds tool-agnostic guidance under docs/agents/.

  • AGENTS.md holds the project instructions previously in CLAUDE.md, made agent-neutral and cut from ~200 to ~95 lines: overview, dev commands, code style, key patterns, testing, and pointers to the docs below. CLAUDE.md is now a one-line @AGENTS.md import (an import rather than a symlink, so it works on Windows checkouts).
  • Release steps now point to CONTRIBUTING.md, which already documents the full release PR flow. The old AGENTS.md summary skipped the release PR and would fail against the protected main branch.
  • docs/agents/architecture.md: module map, deployment targets, and the Connect deployment flow, checked against the code. It now covers shinyapps.io, Connect Cloud, Node.js, OAuth, preflight, and quickstart, and drops the incorrect claim that all API calls go through RSConnectClient.
  • docs/agents/issue-tracker.md: how to create, read, link, label, and close GitHub issues with gh.
  • docs/agents/triage-labels.md: the triage labels and what each means. The three that were missing (needs-triage, needs-info, ready-for-human) have been created on the repo.
  • docs/agents/domain.md: where project vocabulary lives, plus conventions for a future root GLOSSARY.md and docs/adr/.
  • mkdocs.yml excludes agents/ and adr/ so internal agent docs aren't published to the docs site. Verified with a local mkdocs build.
  • The duplicated App Modes list and CI details are removed; models.py and .github/workflows/main.yml are the sources of truth.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Nov 10, 2026 •

Copy link
Copy Markdown
PR Preview Action v1.8.2
Preview removed because the pull request was closed.
2026-11-10 16:30 UTC

CLAUDE.md now imports AGENTS.md so Claude Code and other agents share one source.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tdstein tdstein changed the title chore: configure agent skills for issue tracking and domain docs chore: move agent instructions to AGENTS.md and configure agent skills Nov 10, 2026
tdstein and others added 2 commits November 10, 2026 10:34
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tdstein tdstein changed the title chore: move agent instructions to AGENTS.md and configure agent skills chore: move agent instructions to AGENTS.md and document issue workflow Nov 10, 2026
@github-actions

github-actions Bot commented Nov 10, 2026 •

Copy link
Copy Markdown

☂️ Python Coverage

current status: ✅

Overall Coverage

Lines Covered Coverage Threshold Status
11190 9964 89% 0% 🟢

New Files

No new covered files...

Modified Files

No covered modified files...

updated for commit: 01720cb by action🐍

Release steps now defer to CONTRIBUTING.md, which already documents the
release PR flow. The architecture map is corrected against the code and
covers shinyapps.io, Connect Cloud, and Node.js.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@joshyam-k joshyam-k left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nice!

@tdstein
tdstein merged commit 2ea5fdd into main Nov 10, 2026
28 checks passed
@tdstein
tdstein deleted the chore/agent-skills-setup branch November 10, 2026 16:30
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.

2 participants