innhold/AGENT.md

## Philosophy
Minimal PHP for modern conveniences. Prioritize longevity (decade-scale maintainability) by avoiding volatile dependencies. Strictly add only what's essential—readable, simple, and future-proof.

## Edit instructions
All edits to this AGENT.md file should be done in a compressed shortform for LLM consumption.

## Core Constraints
**Minimalism:** Only essential tech (HTML, PHP 8.4+, CSS). No JS, frameworks, build tools, or package managers. Comments only for major sections.

**Frontend:**
- Classless, semantic HTML5
- Modern CSS: nesting, `oklch()`, grid, `clamp()`, logical props
- Responsive via fluid typography + flexible layouts

**Security:**
- Path validation blocks traversal
- Files restricted to document root
- Strict MIME types + no direct user-input execution

## Code Style
**PHP:** Modern syntax (arrow functions, null coalescing, match). Type hints where practical. Ternary for simple conditionals. Single-purpose functions.

**CSS:** Variables, native nesting, grid layouts. `clamp()` over `@media`. Relative units > pixels.

**Templates:** Escape output (`htmlspecialchars()` for UGC). Short echo tags (`<?= $var ?>`).

## Development Environment and workflow
**LLM Agent Testing Protocol:**
**Container isolation:** ALL test data (CSV, temp files, generated content) MUST remain inside container filesystem (not mounted volumes)
*Testing website:** `curl localhost:4040/path` to fetch pages, test forms with `curl -X POST -d "field=value" localhost:4040/path`
- **Test data paths:** Use `/tmp/` or `/var/test/` inside container—never write to `/var/www/html` or mounted dirs during tests
**Running tests:** `podman exec stopplidelsen.no php /path/to/test.php` or `podman-compose run --rm custom php /tmp/test-script.php`
 **Syntax checks:** `podman exec stopplidelsen.no php -l /var/www/custom/file.php`
 **Cleanup:** `podman-compose down && podman-compose up -d` between test runs
Add PnP development guidelines documentation Document core principles, technology stack, routing, templates, content conventions, security, code style, performance, and extensibility patterns for the PnP framework 2025-11-11 23:38:18 +01:00			`## Philosophy`
Update AGENT.md to reflect current project rules Remove redundant documentation and reorganize content to match the project's current structure and constraints. The updated file now aligns with the minimalist philosophy and core constraints while maintaining all essential information in a more concise format. 2026-01-14 20:25:25 +01:00			`Minimal PHP for modern conveniences. Prioritize longevity (decade-scale maintainability) by avoiding volatile dependencies. Strictly add only what's essential—readable, simple, and future-proof.`
Add PnP development guidelines documentation Document core principles, technology stack, routing, templates, content conventions, security, code style, performance, and extensibility patterns for the PnP framework 2025-11-11 23:38:18 +01:00
Add development environment and workflow section Add edit instructions for AGENT.md file 2026-01-14 23:15:18 +01:00			`## Edit instructions`
			`All edits to this AGENT.md file should be done in a compressed shortform for LLM consumption.`

Update AGENT.md to reflect current project rules Remove redundant documentation and reorganize content to match the project's current structure and constraints. The updated file now aligns with the minimalist philosophy and core constraints while maintaining all essential information in a more concise format. 2026-01-14 20:25:25 +01:00			`## Core Constraints`
			`Minimalism: Only essential tech (HTML, PHP 8.4+, CSS). No JS, frameworks, build tools, or package managers. Comments only for major sections.`
Add PnP development guidelines documentation Document core principles, technology stack, routing, templates, content conventions, security, code style, performance, and extensibility patterns for the PnP framework 2025-11-11 23:38:18 +01:00
Update AGENT.md to reflect current project rules Remove redundant documentation and reorganize content to match the project's current structure and constraints. The updated file now aligns with the minimalist philosophy and core constraints while maintaining all essential information in a more concise format. 2026-01-14 20:25:25 +01:00			`Frontend:`
			`- Classless, semantic HTML5`
			- Modern CSS: nesting, `oklch()`, grid, `clamp()`, logical props
			`- Responsive via fluid typography + flexible layouts`
Add PnP development guidelines documentation Document core principles, technology stack, routing, templates, content conventions, security, code style, performance, and extensibility patterns for the PnP framework 2025-11-11 23:38:18 +01:00
Update AGENT.md to reflect current project rules Remove redundant documentation and reorganize content to match the project's current structure and constraints. The updated file now aligns with the minimalist philosophy and core constraints while maintaining all essential information in a more concise format. 2026-01-14 20:25:25 +01:00			`Security:`
			`- Path validation blocks traversal`
			`- Files restricted to document root`
			`- Strict MIME types + no direct user-input execution`
Add PnP development guidelines documentation Document core principles, technology stack, routing, templates, content conventions, security, code style, performance, and extensibility patterns for the PnP framework 2025-11-11 23:38:18 +01:00
Update AGENT.md to reflect current project rules Remove redundant documentation and reorganize content to match the project's current structure and constraints. The updated file now aligns with the minimalist philosophy and core constraints while maintaining all essential information in a more concise format. 2026-01-14 20:25:25 +01:00			`## Code Style`
			`PHP: Modern syntax (arrow functions, null coalescing, match). Type hints where practical. Ternary for simple conditionals. Single-purpose functions.`
Add PnP development guidelines documentation Document core principles, technology stack, routing, templates, content conventions, security, code style, performance, and extensibility patterns for the PnP framework 2025-11-11 23:38:18 +01:00
Update AGENT.md to reflect current project rules Remove redundant documentation and reorganize content to match the project's current structure and constraints. The updated file now aligns with the minimalist philosophy and core constraints while maintaining all essential information in a more concise format. 2026-01-14 20:25:25 +01:00			CSS: Variables, native nesting, grid layouts. `clamp()` over `@media`. Relative units > pixels.
Add PnP development guidelines documentation Document core principles, technology stack, routing, templates, content conventions, security, code style, performance, and extensibility patterns for the PnP framework 2025-11-11 23:38:18 +01:00
Update AGENT.md to reflect current project rules Remove redundant documentation and reorganize content to match the project's current structure and constraints. The updated file now aligns with the minimalist philosophy and core constraints while maintaining all essential information in a more concise format. 2026-01-14 20:25:25 +01:00			Templates: Escape output (`htmlspecialchars()` for UGC). Short echo tags (`<?= $var ?>`).
Add development environment and workflow section Add edit instructions for AGENT.md file 2026-01-14 23:15:18 +01:00
			`## Development Environment and workflow`
			`LLM Agent Testing Protocol:`
			`Container isolation: ALL test data (CSV, temp files, generated content) MUST remain inside container filesystem (not mounted volumes)`
			Testing website:* `curl localhost:4040/path` to fetch pages, test forms with `curl -X POST -d "field=value" localhost:4040/path`
			- Test data paths: Use `/tmp/` or `/var/test/` inside container—never write to `/var/www/html` or mounted dirs during tests
			Running tests: `podman exec stopplidelsen.no php /path/to/test.php` or `podman-compose run --rm custom php /tmp/test-script.php`
			Syntax checks: `podman exec stopplidelsen.no php -l /var/www/custom/file.php`
			Cleanup: `podman-compose down && podman-compose up -d` between test runs