Before you start
- The code must be in the project’s repository. To bring in an existing app, import its branch first. Without a repository, the worker can still discuss the architecture but can’t read any code.
- You need an active Planning worker. See AI workers and teams.
Steps
1
Start guided design
Open the project and choose Architecture. Under Design through chat, click Start guided design, then choose the Architecture worker.
2
Ask it to describe the app
For example: “Read the repository and describe this app’s architecture: its main parts, where data lives, and the decisions you can see in the code.” Add what the code can’t show, such as goals, constraints and plans. The worker uses your current draft as context.
3
Work through what it finds
Correct anything it got wrong, and settle the decisions it raises. Ask about tradeoffs, such as whether a part should become its own service.
4
Prepare the update
Click Prepare draft update. The worker turns the conversation into a complete draft update. It keeps decisions already made, and lists anything still unresolved as assumptions or open questions.
5
Apply, review and publish
Click Apply to Architecture draft. Read the draft, edit it if needed, and publish it.
Getting a good result
- Ask about one area at a time in a large app, such as data, then integrations, then background work.
- Tell it what’s intended, not just what’s there. The code shows what exists. Only you know what’s a deliberate decision and what’s an accident.
- Keep unresolved questions in the draft. An open question recorded in the architecture is better than a guess, and planning will respect it.