Skip to content

Read a project's AGENTS.md before posting to it - #968

Open
lewispb wants to merge 1 commit into
mainfrom
skill-project-agents-md
Open

lewispb wants to merge 1 commit into
mainfrom
skill-project-agents-md

Conversation

@lewispb

@lewispb lewispb commented Oct 26, 2026

Copy link
Copy Markdown
Member

Many projects keep standing instructions for agents in an AGENTS.md document in Docs & Files. These cover board meanings, routing, tone and authority. basecamp-connect already reads that document. The general basecamp skill didn't, so an agent posting outside the connector never saw it.

This adds a short section to skills/basecamp/SKILL.md. Before posting to a project, the agent finds AGENTS.md through the recording index (nested folders included), reads it once per session and follows it. Because any member can edit the document, it never overrides the user or the skill's rules.

Verified:

  • make check-skill-drift, make test-skill-drift and make check-eval-patterns pass, as do the Go tests in internal/commands, internal/connector and internal/harness. Full bin/ci stopped at lint because golangci-lint isn't installed locally.
  • On Agent Accessibility, the lookup command returns its AGENTS.md ([10266023968]). On Ops: On Call, which has no Docs & Files, it returns [].

🤖 Generated with Claude Code

The basecamp skill now looks for a document titled AGENTS.md in the
project's Docs & Files, nested folders included, and follows it, the way
basecamp-connect already does.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@lewispb
lewispb requested a review from a team as a code owner October 26, 2026 18:51
Copilot AI balanced review requested due to automatic review settings October 26, 2026 18:51
@github-actions github-actions Bot added the skills Agent skills label Oct 26, 2026

Copilot AI 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.

🟢 Approved

The focused documentation change uses supported commands and preserves instruction precedence, with no blocking issues identified.

No open issues 🎉

What changed in this PR

Updates the general Basecamp skill to read project-specific agent instructions before posting, matching the existing connector behavior.

Changes:

  • Adds commands to find AGENTS.md, including in nested folders, and read it once per session.
  • Clarifies that project instructions cannot override the user or the skill’s rules.

[!TIP]
If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.

File Description
skills/​basecamp/​SKILL.md Adds project instruction lookup, reading guidance, and precedence rules.

Review effort: Balanced

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

skills Agent skills

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants