portfolio-page/AGENTS.md

1.9 KiB

Sascha Bach Portfolio Agent Guide

This repository builds the public portfolio at https://sascha-bach.de.

Project Purpose

  • Public-facing portfolio for Sascha Bach, freelance software developer
  • Primary positioning: accessible web development, WCAG and BFSG compliance
  • Primary locales: German and English
  • Main user goals: understand services, review projects, and start contact via email or appointment booking

Runtime Shape

  • Frontend: React 19 + TypeScript + Vite
  • Hosting target: static output in dist/ with post-build prerendering
  • Routing: /de/, /en/, /de/technical, /en/technical, /imprint, /privacy-policy
  • The root path redirects to /de/

Useful Commands

  • npm run dev: local development server
  • npm run build: production build plus prerendering
  • npm run lint: ESLint validation

Agent-Facing Public Files

  • /llms.txt: concise site summary for language models
  • /llms-full.txt: expanded site and conversion guidance
  • /AGENTS.md: deployed guide for browsing agents
  • /.well-known/agents.json: agent index
  • /.well-known/agent-card.json: A2A-style agent card
  • /.well-known/webmcp.json: declarative website interaction hints
  • /.well-known/mcp.json: discovery card noting that no standalone MCP server is currently exposed

Content Guidance

  • German pages are the default and canonical entrypoint for the primary market.
  • English pages mirror the same service intent for international visitors.
  • Legal pages are informational and shared across languages.
  • The site is informational. It does not expose a public authenticated user workflow.
  • Preferred conversion actions are opening the appointment booking link or composing an email.

Source Anchors

  • Shared SEO and metadata live in index.html and src/hooks/usePageSeo.ts.
  • Route composition lives in src/app/AppRouter.tsx.
  • Personal business/contact data lives in src/config/personal.ts.
  • Public crawl and discovery assets live in public/.