# docs-public — agent orientation

This folder is the public web root for this workspace.

**Base URL:** `https://pontiswerk.eu/temporary/claudestuff/`

Everything in `docs-public/` is reachable from the web under that base. For example:
- `docs-public/index.html` → `https://pontiswerk.eu/temporary/claudestuff/`
- `docs-public/links/` → `https://pontiswerk.eu/temporary/claudestuff/links/`
- `docs-public/peon-wsl-kit/` → `https://pontiswerk.eu/temporary/claudestuff/peon-wsl-kit/`

Everything **outside** `docs-public/` is private (not served).

---

## Structure

```
docs-public/
├── index.html            ← project directory / landing page
├── CLAUDE.md             ← this file
├── assets/
│   └── style.css         ← shared stylesheet (black bg, high contrast, Georgia serif)
├── links/                ← Linkshelf app
│   ├── index.html
│   ├── app.js
│   ├── app.css
│   ├── links.json        ← data store (editable via MCP)
│   └── CLAUDE.md
└── peon-wsl-kit/         ← WSL2 native audio guide for peon-ping
    ├── index.html
    ├── README.md
    ├── CLAUDE.md
    ├── scripts/
    │   └── peon-wsl-setup.sh
    └── skills/sounds/
        └── SKILL.md
```

---

## Projects

| Folder | Public URL | What it is |
|---|---|---|
| `links/` | `https://pontiswerk.eu/temporary/claudestuff/links/` | Linkshelf — personal link curation app with `links.json` data store |
| `peon-wsl-kit/` | `https://pontiswerk.eu/temporary/claudestuff/peon-wsl-kit/` | Guide + script for peon-ping C&C audio on WSL2 without PowerShell |
| `bude/` | `https://pontiswerk.eu/temporary/claudestuff/bude/` | Bodenpreise Österreich — interactive map + table for cheapest Austrian municipalities (land/house/apartment), Statistik Austria 2025 data |

---

## Conventions for adding a new project

1. Create a new folder under `docs-public/`, e.g. `docs-public/my-project/`.
2. Add an `index.html` (use `../assets/style.css` for the shared stylesheet).
3. Add a `CLAUDE.md` inside the folder documenting its public URL, files, and how to extend it.
4. Register the project in **this file** (add a row to the table above).
5. Register the project in **`docs-public/index.html`** (add a `<li>` in the `.project-list`).

That way any agent that reads this file knows exactly what's public, where it lives, and how to extend the index.

---

## Shared assets

`assets/style.css` — link with `<link rel="stylesheet" href="../assets/style.css">` from any project subfolder. Provides:
- Black background (`#000`), white text
- High-contrast blue links (`#66b3ff`)
- Georgia serif body font, monospace for code
- `.container` max-width 720 px
- Accessible focus rings, skip link, `.breadcrumbs`, `footer` styles
- Responsive down to 600 px