Skip to content

(PATCH): Add AGENTS.md, CLAUDE.md symlink and /implement-unblocked - #125

Merged
PaulTrampert merged 3 commits into
mainfrom
agents-md
Oct 1, 2026
Merged

(PATCH): Add AGENTS.md, CLAUDE.md symlink and /implement-unblocked#125
PaulTrampert merged 3 commits into
mainfrom
agents-md

Conversation

@PaulTrampert

@PaulTrampert PaulTrampert commented Oct 1, 2026 •
edited
Loading

Copy link
Copy Markdown
Owner

Summary

Adds AGENTS.md, a guide for coding agents working in this repository, and CLAUDE.md as a symlink to it, so Claude Code and other agents read the same file. Also adds the /implement-unblocked slash command, adapted from PacmanManager.

AGENTS.md

  • Layout: each project, its target framework, and why PTrampert.SimplePatch.OpenApi targets net10.0 only.
  • How it works: runtime code generation with CodeDom and Roslyn, the static cache and PatchClassBuilder.Instance, the public-types-only constraint, how attributes carry over, and why the OpenAPI schema is built from the source model.
  • Build, test and docs commands, plus CI.
  • Conventions:
    • The required (MAJOR)/(MINOR)/(PATCH) PR title prefix and PR description style.
    • Additive public API changes, with [Obsolete] before removal.
    • XML doc comments and NUnit Assert.That style.
    • Branch naming and one issue per PR.
    • Agents never merge a PR unless asked.
  • Worktrees: where they go, top-level agents vs. sub-agents, and how a fanning agent provisions them.

/implement-unblocked

Picks up every open, unassigned issue that has no open blocker, no open PR that will close it, and no needs decision or Breaking Change label. It assigns each one to the gh user and moves it to In Progress on any project board. It then creates one worktree per issue under .claude/worktrees/ and launches one sub-agent per issue to implement it and open a PR. --dry-run lists the issues without changing anything.

Differences from PacmanManager's version:

  • It also skips Breaking Change issues, since they have to wait for a major version. Sub-agents stop and report if an issue turns out to need a breaking change.
  • E2E and Docker steps are dropped. This repo has neither.
  • The claude-autofix label is dropped. This repo has no autofix workflows.
  • Branches are bugfix/<n>-<slug> for bugs and feature/<n>-<slug> otherwise.

I ran the issue-filter query against this repo. It currently selects #91 and #95. It excludes #75 and #76 (Breaking Change) and #96 and #102 (open PR or open blocker).

Documentation and tooling only. No code changes. dotnet test passes on main.

🤖 Generated with Claude Code

@PaulTrampert @claude
(PATCH): Add AGENTS.md with CLAUDE.md symlinked to it
2f9b1ce 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@PaulTrampert PaulTrampert changed the title (PATCH): Add AGENTS.md with CLAUDE.md symlinked to it (PATCH): Add AGENTS.md, CLAUDE.md symlink and /implement-unblocked Oct 1, 2026
PaulTrampert and others added 2 commits October 1, 2026 11:07
@PaulTrampert @claude
(PATCH): Add the /implement-unblocked command
c7a726a 
Adapted from PacmanManager. It also skips issues labelled Breaking Change, which must wait for a
major version, and drops PacmanManager's E2E and claude-autofix steps, which don't apply here.
AGENTS.md gains the worktree rules the command relies on.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@PaulTrampert @claude
(PATCH): Use bugfix/ as the branch prefix for bugs
c572d4d 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Oct 1, 2026

Copy link
Copy Markdown

✅ PR Title Formatted Correctly

The title of this PR has been updated to match the correct format. Thank you!

1 similar comment
@github-actions

github-actions Bot commented Oct 1, 2026

Copy link
Copy Markdown

✅ PR Title Formatted Correctly

The title of this PR has been updated to match the correct format. Thank you!

@PaulTrampert
PaulTrampert enabled auto-merge (squash) October 1, 2026 15:10
@PaulTrampert
PaulTrampert merged commit fd2c439 into main Oct 1, 2026
9 checks passed
@PaulTrampert
PaulTrampert deleted the agents-md branch October 1, 2026 15:11
This was referenced Oct 1, 2026
Closed
Merged
PaulTrampert pushed a commit to PaulTrampert/PacmanManager that referenced this pull request Oct 6, 2026
@dependabot
(PATCH) Bump the nuget group with 2 updates (#179)
5f576f8 
Updated
[PTrampert.SimplePatch](https://github.com/PaulTrampert/PTrampert.SimplePatch)
from 1.3.6 to 2.0.3.

<details>
<summary>Release notes</summary>

_Sourced from [PTrampert.SimplePatch's
releases](https://github.com/PaulTrampert/PTrampert.SimplePatch/releases)._

## 2.0.3

## Changes

- (PATCH): Drop the Roslyn patch class builder's own cache
([#​154](PaulTrampert/PTrampert.SimplePatch#154))



## 2.0.2

## Changes

- (PATCH): Route PatchClassBuilder.Instance through
CachingPatchClassBuilder
([#​155](PaulTrampert/PTrampert.SimplePatch#155))



## 2.0.1

## Changes

- (PATCH): Add an internal CachingPatchClassBuilder decorator
([#​153](PaulTrampert/PTrampert.SimplePatch#153))
- (PATCH): Document the release PR format for staged release branches
([#​152](PaulTrampert/PTrampert.SimplePatch#152))



## 2.0.0

## Changes

- (MAJOR): Release 2.0
([#​147](PaulTrampert/PTrampert.SimplePatch#147))
- (PATCH): Build PRs into release/** branches and document the release
flow
([#​146](PaulTrampert/PTrampert.SimplePatch#146))



## 1.5.0

## What's Changed
* (MINOR): Add PatchClassBuilder.UseExperimentalDynamicClassBuilder by
@​PaulTrampert in
PaulTrampert/PTrampert.SimplePatch#136


**Full Changelog**:
PaulTrampert/PTrampert.SimplePatch@v1.4.0...v1.5.0

## 1.4.0

## What's Changed
* (MINOR): Add IPatchClassBuilder, with PatchClassBuilder delegating to
an internal RoslynPatchClassBuilder by @​PaulTrampert in
PaulTrampert/PTrampert.SimplePatch#133


**Full Changelog**:
PaulTrampert/PTrampert.SimplePatch@v1.3.8...v1.4.0

## 1.3.8

## What's Changed
* (PATCH): Add an internal Reflection.Emit patch class builder by
@​PaulTrampert in
PaulTrampert/PTrampert.SimplePatch#130


**Full Changelog**:
PaulTrampert/PTrampert.SimplePatch@v1.3.7...v1.3.8

## 1.3.7

## What's Changed
* (PATCH): Bump the csharp-deps group with 6 updates by
@​dependabot[bot] in
PaulTrampert/PTrampert.SimplePatch#81
* (PATCH): Add AGENTS.md, CLAUDE.md symlink and /implement-unblocked by
@​PaulTrampert in
PaulTrampert/PTrampert.SimplePatch#125
* (PATCH): Extract the patch class model from PatchClassBuilder by
@​PaulTrampert in
PaulTrampert/PTrampert.SimplePatch#129


**Full Changelog**:
PaulTrampert/PTrampert.SimplePatch@v1.3.6...v1.3.7

Commits viewable in [compare
view](PaulTrampert/PTrampert.SimplePatch@v1.3.6...v2.0.3).
</details>

Updated
[PTrampert.SimplePatch.Swashbuckle](https://github.com/PaulTrampert/PTrampert.SimplePatch)
from 1.3.6 to 2.0.3.

<details>
<summary>Release notes</summary>

_Sourced from [PTrampert.SimplePatch.Swashbuckle's
releases](https://github.com/PaulTrampert/PTrampert.SimplePatch/releases)._

## 2.0.3

## Changes

- (PATCH): Drop the Roslyn patch class builder's own cache
([#​154](PaulTrampert/PTrampert.SimplePatch#154))



## 2.0.2

## Changes

- (PATCH): Route PatchClassBuilder.Instance through
CachingPatchClassBuilder
([#​155](PaulTrampert/PTrampert.SimplePatch#155))



## 2.0.1

## Changes

- (PATCH): Add an internal CachingPatchClassBuilder decorator
([#​153](PaulTrampert/PTrampert.SimplePatch#153))
- (PATCH): Document the release PR format for staged release branches
([#​152](PaulTrampert/PTrampert.SimplePatch#152))



## 2.0.0

## Changes

- (MAJOR): Release 2.0
([#​147](PaulTrampert/PTrampert.SimplePatch#147))
- (PATCH): Build PRs into release/** branches and document the release
flow
([#​146](PaulTrampert/PTrampert.SimplePatch#146))



## 1.5.0

## What's Changed
* (MINOR): Add PatchClassBuilder.UseExperimentalDynamicClassBuilder by
@​PaulTrampert in
PaulTrampert/PTrampert.SimplePatch#136


**Full Changelog**:
PaulTrampert/PTrampert.SimplePatch@v1.4.0...v1.5.0

## 1.4.0

## What's Changed
* (MINOR): Add IPatchClassBuilder, with PatchClassBuilder delegating to
an internal RoslynPatchClassBuilder by @​PaulTrampert in
PaulTrampert/PTrampert.SimplePatch#133


**Full Changelog**:
PaulTrampert/PTrampert.SimplePatch@v1.3.8...v1.4.0

## 1.3.8

## What's Changed
* (PATCH): Add an internal Reflection.Emit patch class builder by
@​PaulTrampert in
PaulTrampert/PTrampert.SimplePatch#130


**Full Changelog**:
PaulTrampert/PTrampert.SimplePatch@v1.3.7...v1.3.8

## 1.3.7

## What's Changed
* (PATCH): Bump the csharp-deps group with 6 updates by
@​dependabot[bot] in
PaulTrampert/PTrampert.SimplePatch#81
* (PATCH): Add AGENTS.md, CLAUDE.md symlink and /implement-unblocked by
@​PaulTrampert in
PaulTrampert/PTrampert.SimplePatch#125
* (PATCH): Extract the patch class model from PatchClassBuilder by
@​PaulTrampert in
PaulTrampert/PTrampert.SimplePatch#129


**Full Changelog**:
PaulTrampert/PTrampert.SimplePatch@v1.3.6...v1.3.7

Commits viewable in [compare
view](PaulTrampert/PTrampert.SimplePatch@v1.3.6...v2.0.3).
</details>

Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot show <dependency name> ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore <dependency name> major version` will close this
group update PR and stop Dependabot creating any more for the specific
dependency's major version (unless you unignore this specific
dependency's major version or upgrade to it yourself)
- `@dependabot ignore <dependency name> minor version` will close this
group update PR and stop Dependabot creating any more for the specific
dependency's minor version (unless you unignore this specific
dependency's minor version or upgrade to it yourself)
- `@dependabot ignore <dependency name>` will close this group update PR
and stop Dependabot creating any more for the specific dependency
(unless you unignore this specific dependency or upgrade to it yourself)
- `@dependabot unignore <dependency name>` will remove all of the ignore
conditions of the specified dependency
- `@dependabot unignore <dependency name> <ignore condition>` will
remove the ignore condition of the specified dependency and ignore
conditions


</details>

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@PaulTrampert