agents: align guidance with current workflows#1266
Merged
Conversation
I tried rewriting the `AGENTS.md` around the workflows and failure modes that recur in current OpenTUI development. I had opencode look at: - The most recent 50 commits, especially runtime portability, native lifecycle, renderer behavior, terminal width, and FFI changes. - My OpenCode sessions to identify recurring agent mistakes and unnecessary abstractions. - Current package scripts, CI workflows, development documentation, and runtime implementations. The previous guide mixed project-specific constraints with generic TypeScript advice. I think many of these were stale. The replacement keeps the guide to that cannot be inferred from nearby code: ownership across TypeScript and Zig, display-cell width semantics, package-specific verification, Bun and Node portability, terminal-driven debugging, and borrowed FFI pointer lifetimes. If this turns out to not work lets revert to the previous one and iterate in smaller steps.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
I tried rewriting the
AGENTS.mdaround the workflows and failure modes that recur incurrent OpenTUI development.
I had opencode look at:
renderer behavior, terminal width, and FFI changes.
abstractions.
implementations.
The previous guide mixed project-specific constraints with generic
TypeScript advice. I think many of these were stale.
The replacement keeps the guide to that cannot be inferred from nearby
code: ownership across TypeScript and Zig, display-cell width semantics,
package-specific verification, Bun and Node portability, terminal-driven
debugging, and borrowed FFI pointer lifetimes.
If this turns out to not work lets revert to the previous one and iterate in
smaller steps.