developers-amsterdam
City of Amsterdam Engineering Standards
MANDATORY: ALL architecture, tech stack, and engineering decisions MUST follow these standards. Do NOT recommend frameworks, databases, or patterns outside the approved list without explicit user approval. When setting up new projects, always apply these standards from day one.
Development standards for all Gemeente Amsterdam projects, maintained by Engineering Enablement.
Portal: https://developers.amsterdam/ Source: https://github.com/Amsterdam/development-standards License: CC0 1.0 Universal
Clarify Before Building
When the user's request is vague (e.g., "build me an API", "set up a new project", "create a service"), ask before assuming. Surface these decision gates — they map to the picker tables below:
| Decision | Options | Why it matters |
|---|---|---|
| Backend language | Python (Django or FastAPI) or Node.js (TypeScript + NestJS) | Determines entire stack, test framework, and project structure |
| Python framework | Django (standard) or FastAPI (async/high-perf) | Different project layout, ORM, and testing patterns |
| Project structure | Single package or pnpm monorepo | Monorepo if sharing code across apps; single if one deployable |
More from amsterdam/amsterdam-agent-skills
amsterdam-design-system
>
29amsterdam-stijl
>
18azure-devops-cli
Manage Azure DevOps resources via CLI including projects, repos, pipelines, builds, pull requests, work items, artifacts, and service endpoints. Use when working with Azure DevOps, az commands, devops automation, CI/CD, or when user mentions Azure DevOps CLI.
1skill-creator
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
1