add undocumented composition order flow

[drocko]

Description

Appended Composition Order Details into Official Documentation
Linked to Issue #5112

Checklist

• I've read the contributing guide
• The relevant docs, if any, have been updated or created
• [] The relevant tests, if any, have been updated or created

Screenshots

No additional screenshots at the moment

Tests

No additional tests at the moment

[cubic-dev-ai]

Your cubic subscription is currently inactive. Please reactivate your subscription to receive AI reviews and use cubic.

[netlify]

✅ Deploy Preview for continuedev ready!

Name	Link
🔨 Latest commit	3a0dc77
🔍 Latest deploy log	https://app.netlify.com/projects/continuedev/deploys/683fe69bbcc48300080a9b22
😎 Deploy Preview	https://deploy-preview-5977--continuedev.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[drocko]

I have read the CLA Document and I hereby sign the CLA

[github-actions]

All contributors have signed the CLA ✍️ ✅
_{Posted by the CLA Assistant Lite bot.}

[Patrick-Erichsen]

Hi @drocko , apologies for the delay here, I thought I had already reviewed this.

I'm a bit confused by what "Composition Order Flow" is supposed to mean though, even after reading the issue and viewing that image.

Is the goal here to try to clarify how the context window is filled?

[drocko]

Hi @Patrick-Erichsen, no worries at all about the delay, and sorry if my diagram caused any confusion!

Yes, my goal was to clarify how the context window was filled aka the "Composition Order" defined by lisyoen in the original issue. Thought it would be a good first issue for me to try and tackle!

And about that diagram - I’m not sure if it’s a bug but I noticed the newest message sometimes doesn’t show up in the console logs, which made it a bit confusing to determine the actual composition order. My earlier notes and diagram were an attempt to explain that behavior, but they may have ended up making things more confusing instead.

[Patrick-Erichsen]

Got it - I appreciate the contribution but I don't think we really have anywhere good to put this in the docs right now. It isn't specifically related to the prompts.md file you added it to since that is specifically about prompt files, this "composition flow" is moreso about how we construct user messages, which is a bit too in the weed for the docs.

Closing the issue out with that in mind, but if you're looking for a good first issue I think this might be a good one: #6222

[Patrick-Erichsen]

Eventually I could see this going into some sort of "Context management" doc however so I'll keep it in mind 👍