Skip to content

docs: add ENGINE_PERFORMANCE.md with some notes on engine internals#2919

Merged
bruno-dasilva merged 4 commits into
masterfrom
bruno/coding-docs-2
Jun 29, 2026
Merged

docs: add ENGINE_PERFORMANCE.md with some notes on engine internals#2919
bruno-dasilva merged 4 commits into
masterfrom
bruno/coding-docs-2

Conversation

@bruno-dasilva

@bruno-dasilva bruno-dasilva commented Apr 11, 2026

Copy link
Copy Markdown
Collaborator

Purpose

A few separate discussions got some good answers worth putting in docs for coding agents as context.

Meant to be simple/vague, as coding agents can dig deeper for specifics when they need to.

NOTE: LLM generated by heavily reviewed/cut by me.

@bruno-dasilva bruno-dasilva added the area: documentation Improvements or additions to documentation label Apr 11, 2026
@bruno-dasilva

bruno-dasilva commented Apr 11, 2026

Copy link
Copy Markdown
Collaborator Author

@lostsquirrel1 lostsquirrel1 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A nice start. Here's a few more thoughts from me to help improve the information presented to the AI.

Comment thread coding-agents/ENGINE_PERFORMANCE.md Outdated
Comment thread coding-agents/ENGINE_PERFORMANCE.md Outdated
Comment thread coding-agents/ENGINE_PERFORMANCE.md Outdated
Comment thread coding-agents/ENGINE_PERFORMANCE.md
@bruno-dasilva bruno-dasilva changed the base branch from bruno/coding-docs-1 to graphite-base/2919 April 14, 2026 02:45
@bruno-dasilva bruno-dasilva changed the base branch from graphite-base/2919 to master April 14, 2026 02:45
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Comment thread coding-agents/ENGINE_PERFORMANCE.md Outdated
Comment thread coding-agents/ENGINE_PERFORMANCE.md Outdated
Comment thread coding-agents/ENGINE_PERFORMANCE.md Outdated
@bruno-dasilva bruno-dasilva requested a review from sprunk June 28, 2026 16:22
@bruno-dasilva

Copy link
Copy Markdown
Collaborator Author

I changed some bits from feedback and to match my current knowledge now that I've worked with engine a bit more. would love a final pass from y'all in case anything jumps out :)

@sprunk sprunk left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks alright. I don't believe it's going to make any difference but at least that means it shouldn't hurt to include either.

@bruno-dasilva

Copy link
Copy Markdown
Collaborator Author

thanks. fwiw I've run into many sessions having to re-explain / re-derive how frames work in engine so this should hopefully be a shortcut. my 2c 🤷‍♂️

@bruno-dasilva bruno-dasilva merged commit 4034d5a into master Jun 29, 2026
5 checks passed
Comment thread AGENTS.md
5. Disclose any AI assistance used

### Additional docs
Please see @coding-agents/ for additional documentation:

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.

@bruno-dasilva I didn't think @ includes worked outside of claude code?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

you could be right for harness-forced includes. But regardless any modern model should see that as a dir and read it when it chooses to 🤷

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants