Skip to content

Agent guidance around memory lifecycle edges - #1406

Merged
alan-george-lk merged 3 commits into
alan/bugfix-room-lifecyclefrom
alan/bugfix-memory-lifecycle-guardrails
Sep 8, 2026
Merged

Agent guidance around memory lifecycle edges#1406
alan-george-lk merged 3 commits into
alan/bugfix-room-lifecyclefrom
alan/bugfix-memory-lifecycle-guardrails

Conversation

@alan-george-lk

Copy link
Copy Markdown
Contributor

Introduce AGENTS.md guidance around some of the fixes done in this PR stack, to hopefully avoid/catch future regressions.

@devin-ai-integration devin-ai-integration Bot 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.

🔍 Devin Review: 1 flag

Not posted on this PR by your GitHub settings — view it in Devin Review. (Configure)

Devin Review

@alan-george-lk
alan-george-lk force-pushed the alan/bugfix-memory-lifecycle-guardrails branch from aba8023 to b920bc1 Compare September 4, 2026 18:16

@ladvoc ladvoc 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! These all seem like good suggestion. My only question is whether we should move the more specific points (e.g. FFI, C++) to separate AGENTS.md files within the related crates to keep the top-level one lean.

@alan-george-lk
alan-george-lk force-pushed the alan/bugfix-memory-lifecycle-guardrails branch 2 times, most recently from ba35b57 to cee0e54 Compare September 8, 2026 04:44
@github-actions

github-actions Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Changeset ✓

This PR includes a changeset covering all affected packages:

Package Bump
libwebrtc patch
livekit patch
livekit-ffi patch
webrtc-sys patch

@alan-george-lk
alan-george-lk force-pushed the alan/bugfix-memory-lifecycle-guardrails branch from 1fa787f to 0c56037 Compare September 8, 2026 13:58
@alan-george-lk
alan-george-lk merged commit f76b7ac into main Sep 8, 2026
8 checks passed
@alan-george-lk
alan-george-lk deleted the alan/bugfix-memory-lifecycle-guardrails branch September 8, 2026 15:56
1egoman added a commit that referenced this pull request Sep 8, 2026
The release page formatting is inconsistient - some entries are
changelog bullets, others are `####` headings followed by further
markdown.

That is knope's rendering rule, not a knope bug. A changeset whose
summary is **one line** becomes a bullet:

```
- Add data streams v2 to exposed uniffi interface - #1286 (@1egoman)
```

A summary spanning **more than one line** is promoted to a heading, with
everything after the first line dropped below it as loose body text:

```
#### Moves the signalling client into a new `livekit-signaling` crate. livekit-api

re-exports it under the historical `livekit_api::signal_client` path, now marked
deprecated: ...
```

Markdown blocks (tables, bullet lists, bold-led paragraphs) guarantee
this, and they keep showing up in agent-written changesets — but a plain
hard line wrap is enough on its own. The changeset for #1406 was plain
text wrapped at 80 columns and still rendered as `#### Add agent
guidance for detecting and preventing memory-lifecycle regressions in`.

So this adds a rule under **Documenting changes** in `AGENTS.md`: write
the changeset summary as a single unwrapped line of plain prose, no
Markdown blocks (inline backticks are fine — they render correctly), and
keep detail in the PR description instead.

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
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