php-devops/TEMPLATE_SETUP.md

Template Setup Guide

You've created a new repo from the core-devops template. Follow these steps to customize it.

Automated Setup

When you first push, the template-bootstrap.yml workflow will:

• ✅ Create standard labels (agent workflow, priorities, types)
• ✅ Enable security features (Dependabot, vulnerability alerts)
• ✅ Create a setup checklist issue

Files to Customize

Required Changes

File	Action
repos.yaml	Replace with your package registry or delete if single-repo
CLAUDE.md	Update with your project's architecture and commands
README.md	Replace with your project description
package.json	Update name, or delete if not using VitePress

Optional Changes

File	Action
.coderabbit.yaml	Customize review instructions for your codebase
.core/workspace.yaml	Update active package and settings
doc/	Replace with your documentation
scripts/	Keep if useful, or replace with your setup scripts
Makefile	Update targets for your workflow

Files to Delete (if not needed)

# If not using VitePress docs
rm -rf .vitepress doc package.json

# If not a multi-repo workspace
rm -rf packages repos.yaml .core/workspace.yaml

# This file (after reading!)
rm TEMPLATE_SETUP.md

Secrets to Configure

If using the auto-project workflow:

# Org-level secret (already set if in host-uk org)
gh secret set PROJECT_TOKEN --org YOUR_ORG --visibility all

Branch Strategy

The template uses dev as the default branch:

• dev - Development (default, PRs merge here)
• main - Production releases

To switch to main-only:

gh repo edit --default-branch main

Adding to Org Projects

# Add repo's issues to a project when labeled
gh workflow run auto-project.yml

Verification Workflow

The template includes the agent verification workflow:

agent:ready → agent:wip → agent:review → verified/verify-failed

This enforces the rule: no agent can verify their own work.

---

Delete this file once setup is complete:

rm TEMPLATE_SETUP.md && git add -A && git commit -m "chore: complete template setup"