Skip to content
Get started

Add Context to Chat

When a request depends on a specific part of the Project, attach that part to Chat instead of describing it from memory. Context helps Castaly understand exactly what you mean.

Context does not send on its own. It lands in the composer so you can add your intent, check the reference, and press Send when ready.

Spec selections

Select text, headings, or paragraphs from the read-only Spec when you want Castaly to discuss or change a specific requirement.

Preview elements

Inspect a real element in the running Preview when feedback depends on something you can see on the page.

Your instruction

Add the actual request in Chat. The attached context says where to look; your message says what should happen.

The Spec is read-only, so you never edit Markdown directly. Instead, attach the part you want Castaly to consider.

  1. Select in the Spec

    Open the Spec tab and select the text, heading, or paragraph you want to talk about.

  2. Use Ask Castaly

    A light Ask Castaly action appears near your selection. It carries the file and line numbers — for example spec/pages/user-management.md:42-56 — back into the Chat composer as context.

  3. Add your intent and send

    The reference lands above the composer but is not sent. Add what you want Castaly to do, then press Send.

Once a Preview is available, you can attach feedback to a real on-screen element.

  1. Turn on Inspect

    In the Preview tab, click Inspect, then click the element you want to give feedback on.

  2. Add a note

    A draft appears near the element. Write what you want changed — a note is required — and add it.

  3. Send when ready

    Your feedback drops into the Chat composer as a chip, summarizing the element and your note. It goes to Castaly only after you send the message.

Castaly handles a message with attached context like any other Project request, but with a more precise reference.

  1. Castaly reads the context

    It uses the attached Spec selection or Preview element to understand which part of the Project you mean.

  2. It combines context with your instruction

    The context identifies the target. Your message defines the requested change, question, or feedback.

  3. It clarifies if needed

    If the request still depends on a decision, Castaly asks before changing the Project definition.

  4. It prepares the next action

    Castaly may update the Spec and Graph, explain the issue, or prepare work for the next Build depending on what you asked.

Keep the work inside the Project you are shaping. Context attached from the Spec or Preview always points back to that same Project, so Castaly stays aligned with its Spec, Preview, and publish state.

Next: Manage Conversations.