Setup Agents — Reference Index
Routes to mode-specific reference files. Only load what the mode needs.
Mode routing
| Mode | Load |
|---|---|
| generate | setup-agents-build.md, setup-agents-prompts.md, setup-agents-schemas.md, setup-agents-template.md |
| upgrade | setup-agents-build.md, setup-agents-prompts.md, setup-agents-schemas.md, setup-agents-template.md |
| add | setup-agents-add.md, setup-agents-prompts.md, setup-agents-schemas.md |
| review | setup-agents-review.md |
Signal → Roster Decision Table
| Signal | Confidence | Agent |
|---|---|---|
| Terraform / CDK / SAM / Pulumi + deploy workflow | HIGH | infra |
| FastAPI / Express / Rails / Spring / Spring Boot / Django | HIGH | app |
build.gradle.kts / settings.gradle.kts / Kotlin source in src/main/kotlin/ | HIGH | app (Kotlin/Spring Boot) |
pom.xml or build.gradle with spring-boot-starter dependency | HIGH | app (Spring Boot) |
| GHA workflows are the product (reusable/composite) | HIGH | platform |
| pytest / jest / go test / rspec / JUnit / Kotest | MEDIUM | test-writer (offer) |
| Airflow / Prefect / dbt / Glue / Step Functions | HIGH | data-pipeline |
| torch / sklearn / sagemaker / mlflow | HIGH | ml |
| Any repo | ALWAYS | navigator (offer) |
| boto3 only, no IaC, no framework | AMBIGUOUS | ask 1 question |
| Monorepo with 3+ signals | MINIMUM SET | generate confident + ask team ownership |
AGENTS.md — hand-authored detection
Line 1 check: <!-- generated by platform-skills -->
- Present → managed; overwrite freely
- Absent → hand-authored; read for context, append only
The same marker check applies to every per-tool agent file. See references/setup-agents-schemas.md → "Managed-file marker" for the per-format rule and the managed() helper — that file is the single source of truth for this rule.
.platform-skills/ — commit this directory
The .platform-skills/ directory is structural metadata — commit it. It is not personal state.
- Commit:
manifest— defines which tool targets were generated;scripts/verify-agents.shreads it. If gitignored, CI will silently skip all tool-target checks and report 0 issues. - Nothing to exclude: the directory contains only the manifest — no secrets, no personal state. If
.platform-skills/is gitignored (e.g. via a.*glob), remove the exclusion.
.platform-skills/manifest — format
One token per line. Lines starting with # are comments. Blank lines ignored.
Valid tokens:
| Token | File verified |
|---|---|
copilot-vscode | .github/agents/*.agent.md |
copilot-cloud | .github/agents/*.agent.md (cloud target) |
copilot-app | .github/copilot-setup-steps.yml |
cursor | .cursor/rules/*.mdc |
codex | agents/openai.yaml |
windsurf | .windsurfrules |
vscode-mcp | .vscode/mcp.json (servers key) or .vscode/settings.json (github.copilot.chat.mcpServers key) |
Example:
# generated by platform-skills setup-agents
copilot-vscode
codex
scripts/verify-agents.sh reads this file to know which checks to run. generate writes it at Step 9. add appends to it at Step 7. upgrade reads it to know which tool paths to scan.