# Concepts

| Concept       | Definition                                                                                                                                                                                                          |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Sprint        | A markdown file (ex: `documentation.md`) that defines what you intend to build.                                                                                                                                     |
| Workflow      | The instructions and agent assignments to build a sprint.                                                                                                                                                           |
| Documentation | The analysis Guilde performs to understand the codebase structure, security, performance, code consistency, architecture, cyclomatic complexity and technical debt for any repository Guilde will generate code in. |

### Workflow

A WORKFLOW orchestrates several CODING AGENTS, as directed by the WORKFLOW STEPS and the AGENT definitions.

Each WORKFLOW STEP is afforded its own CODING AGENT and CONTEXT WINDOW.  WORKFLOW STEPs collaborate in a defined fashion to build software. The prompts in WORKFLOW STEPs instruct the CODING AGENT. &#x20;

Note that the same CODING AGENT can be used for 1 or more WORKFLOW STEPs.

Users can customize WORKFLOWs and AGENTs by modifying files in their repositories.

WORKFLOWS can be found at: `/.guilde/workflows/`

AGENTS can be found at: `/.opencode/agent/`

### Adding Workflow Templates

* Guilde includes a library of Workflow Templates to help you get started and improve the quality of the code Guilde authors. To adopt these templates, you will need to:
* Download this file: <https://sdlc-manifest.guilde.ai/DXJL6I1YHB/customer-template.zip>:&#x20;
* Unzip the file
* From the customer-template, copy the .guilde and .opencode folders into the root of your git repository. &#x20;
* Recreate the structure of docs/sprints/sprint-0001/sprint-0001.md in your repository or copy in the docs directory from the customer-template. &#x20;
* Push those changes and merge them into your default branch. Wait 5 minutes for those assets to be accessible to Guilde.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.guilde.ai/documentation/basics/editor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
