docs/git-strategy.md

# Git Strategy

## Repositories

Start with a mono-repo:

```text
astracloud-idp
```

Later, optional split:

```text
astracloud-platform
astracloud-gitops
astracloud-templates
sample-node-api
sample-python-api
sample-react-app
```

## Branching

- `main`: stable
- `dev`: active development
- `feature/*`: individual features

## Commit Style

Use clear commit prefixes:

```text
docs: add architecture diagram
infra: add terraform aws module
k8s: add argocd app
ci: add github actions workflow
security: add kyverno policy
obs: add grafana dashboard
```

## Pull Request Rules Later

- CI must pass.
- Security scans must pass.
- Terraform plan must be reviewed.
- GitOps changes must be approved.