---
name: start
description: "Use when bootstrapping a cloned template: git remote, project rename, APM and WiCOP registration, Postgres, Entra ID, Vault, favicon, GitLab CI, and first push."
metadata:
  type: workflow
  library: wcz-layout
  disable-model-invocation: "true"
---

# Project initialization

## 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.
- Run terminal commands and browser actions yourself. When a step needs user input, ask only the required question through the prescribed question tool, consume the answer, and resume in the same turn.
- 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** for a new project
> - **Selected steps** from the list 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-wicop-setup.md](steps/04-wicop-setup.md)               | Request release management (CD) |
| 5   | [05-database-setup.md](steps/05-database-setup.md)         | Postgres via Docker or existing |
| 6   | [06-entra-setup.md](steps/06-entra-setup.md)               | Entra ID app registration       |
| 7   | [07-vault-setup.md](steps/07-vault-setup.md)               | Vault secrets configuration     |
| 8   | [08-generate-favicon.md](steps/08-generate-favicon.md)     | Generate and replace favicon    |
| 9   | [09-commit.md](steps/09-commit.md)                         | Commit and push to origin       |

## Completion

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