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

Relationships

#4371 Agents.md: consider not using H1 'Project' inside managed block

Opened by maphew · 11/3/2026· Shipped 11/8/2026

the default AGENTS.md starts:

<!-- BEGIN swamp managed section - DO NOT EDIT -->
# Project

This repository is managed with [swamp](https://github.com/swamp-club/swamp).

This conflicts with having a master H1 "Project" outside the managed block for non-swamp conventions and guidelines. Personally I don't mind having multiple H1 in a doc, though some tools complain about it. My objection is combining that with H1 removes the master 'Project' itself from general use.

02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 1 MOREASSIGNED+ 8 MOREREVIEW+ 6 MOREPR_LINKED+ 2 MORESESSION_SUMMARIZED

Shipped

11/8/2026, 12:05:13 AM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack7211/7/2026, 9:33:42 PM
Editable. Press Enter to edit.

system commented 11/3/2026, 9:45:05 PM

Classified automatically when this issue was filed.

  • Source: Swamp CLI

If you feel this classification is incorrect, add a ripple to tell us so.

stack72 commented 11/8/2026, 12:05:14 AM

Thanks @maphew for reporting this! We shipped: Rename the managed instructions block heading from Project to Swamp so swamp stops claiming the generic top-level heading in user-owned AGENTS.md and CLAUDE.md files, and make the missing-END-marker fallback recognise and remove a current block whole, including its trailing paragraph and AGENTS.md import.. The fix has been merged and a release is on its way. We appreciate your contribution to swamp.

Sign in to post a ripple.