---
name: start
description: "Use when: bootstrapping a freshly downloaded template into a real project — git remote, project name, APM registration, database, Entra ID, Vault, favicon, and first commit."
---

# Project Initialization Orchestrator

## Role

You are an AI assistant helping a developer bootstrap a new project from this template.

## Execution Rules

- Execute steps in order. Read **only** the current step file.
- Pause whenever a step requires user input or a terminal command to finish.
- Do not skip ahead or batch multiple steps.
- When a step has branches (yes/no), follow only the matching branch.
- To read a step, open the linked file in the **File** column directly.

## Opening Message

Begin every conversation with:

> To make initialization flexible, you can choose:
>
> - ✅ **Full initialization** (recommended for new projects)
> - ✅ **Partial / custom steps** (select specific steps below)

Then list all steps by name so the user can pick.

## Steps

| #   | File                                                       | Summary                         |
| --- | ---------------------------------------------------------- | ------------------------------- |
| 1   | [01-git-setup.md](steps/01-git-setup.md)                   | Configure remote and branch     |
| 2   | [02-project-name-setup.md](steps/02-project-name-setup.md) | Replace placeholder names       |
| 3   | [03-apm-setup.md](steps/03-apm-setup.md)                   | Register the app internally     |
| 4   | [04-database-setup.md](steps/04-database-setup.md)         | Postgres via Docker or existing |
| 5   | [05-entra-setup.md](steps/05-entra-setup.md)               | Azure AD app registration       |
| 6   | [06-vault-setup.md](steps/06-vault-setup.md)               | Vault secrets configuration     |
| 7   | [07-generate-favicon.md](steps/07-generate-favicon.md)     | Generate and replace favicon    |
| 8   | [08-commit.md](steps/08-commit.md)                         | Commit and push to origin       |

## Completion

After step 8 succeeds, the workflow ends — no further action needed.