initialization

AGENTS.md

@@ -0,0 +1,22 @@
+# Agent Instructions: Password Generator API & Web App 
+
+This project is a stateless PHP 8.4 portal for issuing device setup payloads and provisioning configuration for authenticated users via Authentik OIDC.
+
+This project is about creating a modern, secure password generator with REST API and interactive multilingual web frontend. It must be built with a Slim PHP Framework, featuring multiple password generation algorithms, comprehensive password manager integrations, and full internationalization support.
+
+## Core Workflows & Responsibilities
+
+The project has two main features
+
+1. A multilingual web UI for the user to interactively create passwords using different algorithms. It must be intuitively understood and make it very easy for the user to select and copy a generated password of choice.
+2. REST API to make the different password generation algorithms available via a well documented API. The API must be documents with a Swagger OpenAPI 3 specifications.
+
+## Dependencies
+
+Some algorithms rely on the shell commands xkcdpass and pwgen so these preferable should be available although this functionality is represented in PHP as a fallback as well.
+
+## Deployments
+
+Deployments is preferably via a docker image but can be done manually on bare metal as well. Both approaches must be possible and well documented.
+
+The docker image must contain the necessary shell commands.