Skip to main content
← Back to list
01Issue
FeatureShippedSwamp CLIPublic
Assigneesstack72

Relationships

#1971 Support agent-neutral repository instructions without duplicating Claude configuration

Opened by stack72 · 9/2/2026· Shipped 9/3/2026

Problem

The repository is predominantly configured for Claude Code. CLAUDE.md is the canonical project guidance and bundled skill sources live under .claude/skills/. Agent-based harnesses such as Codex and OpenCode do not universally discover those paths, while duplicating the full guidance and skills into every harness-specific location would create stale, conflicting copies.

Some current wording also treats Claude-specific runtime paths as universal, including the statement that skills live in .claude/skills/ and references to Claude Code worktrees.

Proposed Minimum Change

Keep the existing Claude setup intact and make instruction discovery portable without copying its contents:

  • Keep CLAUDE.md as the canonical source of repository instructions.
  • Add a concise AGENTS.md entrypoint that directs compatible agent harnesses to read and follow CLAUDE.md; it must not duplicate the canonical content.
  • Clarify in CLAUDE.md that .claude/skills/ is the source-repository location for bundled skills, while installed agents discover skills through their own native/global skill directories.
  • Update only bundled-skill prose that incorrectly assumes a Claude Code worktree or CLAUDE.md is the only possible instruction-discovery path.

Out Of Scope

  • Do not change verification workflows, review runners, reports, attestation format, CI gates, or authentication.
  • Do not move or duplicate the .claude/skills/ source tree.
  • Do not change the existing Claude Code behavior.

Acceptance Criteria

  • Claude Code continues to load the current CLAUDE.md and skills unchanged.
  • A harness that discovers AGENTS.md can reach the same canonical guidance without a copied CLAUDE.md or .claude/ directory.
  • The repository has one authoritative copy of its project rules and each bundled skill.
  • Documentation distinguishes source-layout paths from agent runtime discovery paths.
  • Existing skill and repo-init verification remains green.
02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 6 MOREREVIEW+ 11 MOREPR_MERGED+ 2 MORESESSION_SUMMARIZED

Shipped

9/3/2026, 3:47:50 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack729/2/2026, 11:15:58 PM

Sign in to post a ripple.