New project

Empty repos, young repos, and ideas that still mostly live in your head all need the same first move: survey the site, draft a small blueprint, and prove one build-and-inspect loop.

1. Open the repo

cd ~/projects/my-new-app
guildhall serve

Guildhall opens the setup wizard if the folder is not registered yet.

2. Name the project

Use a real project name and a stable slug. The slug keeps URLs scoped to this project, so do not tie it to a throwaway folder name.

3. Choose how Guildhall does AI work

Pick the account, CLI, or local model Guildhall uses for the first run. You can change this later; the first run only needs one working path.

4. Draft one starter blueprint

Start with a task blueprint that proves the system can move:

• create the first README
• add a tiny route or component
• wire one test command
• fix one known setup failure

Avoid "build the whole app" as the first task. That belongs after Guildhall has enough project context and a shaped plan.

5. Start and watch

Press Start once the task is clear enough to judge. You should see live movement in the shell: the task changing state, notes appearing, checks or review evidence accumulating, and any blocker attached to the project.

Next: First task set.