Project short description

This file provides guidance for AI Assistants

## Project short description
Docker Controller is a CLI tool that manages the startup of Docker containers via a YAML configuration file. It integrates with systemd to replace the default Docker container startup mechanism and supports installation on Arch Linux and Ubuntu.

## General
- Be brief, techn. precise, direct, honest, no flattery
- If documentatation creation is needed create them in `devdoc/`, prefer small distinc file per topic over single large ones. Prefer tables and diagrams
- You can only add links in section below, not change this document otherwise
- git user name: Auto Coder, auto.coder@dy-mail.de
- you are running in a Docker container

## Development Approach
- This is a POC/MVP, NOT an enterprise project
- Start with the simplest solution that works
- Avoid frameworks unless absolutely necessary
- Prefer single-file implementations when feasible
- Hardcode reasonable defaults instead of complex config systems
- Don't add abstractions until genuinely needed
- Skip complex error handling for unlikely edge cases
- Don't optimize prematurely
- If in a git repo commit after each major step
- Never commit file which contain personal data or crypt. artifacts. Put them to gitignore, create samples and commit
- Update the documentation files after finishing and verifing a feature

## Links (`devdoc/`)
- [Base Requirements](devdoc/requirements_base_2026-03-15.md) — original spec from user
- [Detailed Requirements](devdoc/requirements_detailed_2026-03-15.md) — all decisions resolved, use this as implementation reference
- [Architecture](devdoc/architecture_2026-03-15.md) — component structure, data flows, concurrency model