# Create architecture overviews

> For the complete documentation index, see [llms.txt](https://falconer.com/docs/llms.txt).

Ask Falconer to explain how any part of your codebase works -- from high-level system architecture down to how a specific feature is implemented.


Ask Falconer to explain how any part of your codebase works -- from high-level system architecture down to how a specific feature is implemented. Falconer reads your connected repositories and synthesizes answers with citations to the actual files.

## Prerequisites

[Connect GitHub](https://falconer.com/docs/set-up/connect-sources.md) as a source so Falconer can read your codebase.

## Ask about your architecture

Use the agent from the homepage or the editor sidebar. Ask in plain language -- no need to know which files are relevant:

```kotlin
Give me an overview of how this codebase is structured
```

```vbnet
How does our authentication flow work end-to-end?
```

```perl
Explain the relationship between our API gateway and the services behind it
```

Falconer searches across your connected repositories, synthesizes an explanation, and cites the specific files and functions it drew from.

![](/docs/images/architecture-overviews.png)

## Generate diagrams

Ask Falconer to produce a visual diagram of any system, service, or data flow:

```rust
Create an architecture diagram for the notification service
```

Architecture diagrams render inline using D2 with TALA layout. Falconer also supports Mermaid for flowcharts, sequences, and other diagram types. You can ask Falconer to adjust the scope or level of detail, or request either language explicitly.

## Drill into specific implementations

Once you have the high-level picture, follow up to go deeper:

```csharp
How is retry logic handled in the webhook service?
```

```vbnet
Walk me through how we handle session expiry
```

Use **@** to focus Falconer on specific files or directories:

![](/docs/images/architecture-overviews-reference.png)

## Turn answers into documents

After getting an explanation you want to preserve, ask Falconer to write it up:

```css
Write a doc explaining what you just described
```

The draft opens in the editor, where you can refine it and publish it to your company collection.