AGENTS.md
Table of Contents
AGENTS.md
Overview
Personal markdown notes vault. Mostly .md files with occasional attachments (images, PDFs). This directory is the data store -- there is no code, build step, or package manager here.
Rules
Search the vault for the relevant note before reading or editing; never guess paths. Use the personal-notes skill's semantic-search CLI first, with scoped rg as a fallback.
See README.md for the notes web app setup.
Organization: services/ vs hardware/<machine>/services/
A doc about a service goes in one of two places, based on whether it's about the concept/product or about one machine's implementation of it:
- Top-level
services/— concept- or product-level docs: what the thing is, how you use it, how its pieces fit together. Should stay meaningful even if the underlying implementation moved to different hardware. Examples:dph-am-stack.md(the master index tying DNS → router → nginx → auth → PWA → certbot together — conceptually a stack, even though one machine runs all of it today),openclaw.md(usage guide),telegram-personal-cli.md(no machine tie at all). hardware/<machine>/services/— host-specific implementation detail: install paths, LaunchDaemon/LaunchAgent vs systemd quirks, the machine's LAN IP baked into config, ecosystem files that live at a specific path on that box. If the service moved to another machine, this doc would need a rewrite, not just a re-link. Examples:hardware/mac-studio/services/nginx.md,nginx-auth-service.md,nginx-pwa-injection.md,pm2-processes.md.
When both exist for the same thing, the top-level doc is the entry point and links down into the machine-specific one(s) for setup/ops detail (see services/dph-am-stack.md → hardware/mac-studio/services/*.md). Don't duplicate content across the two — the top-level doc explains what and why, the hardware doc explains how, on this box.
If a second machine ever hosts one of these services (or takes over from the Mac Studio), give it its own hardware/<machine>/services/ rather than growing a flat top-level services/ folder with machine-disambiguating filenames.