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: 

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.sh reads 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.