fix: agent tidy up

AGENTS.md

@@ -1,12 +1,33 @@
-## Agent skills
+## Related repositories
+
+This is the Data Controller **marketing site, blog and feed** (Gatsby). It has two sibling repos, usually checked out side by side:
+
+- **`dc`** - the product source (Angular client + SAS backend). Behaviour of the product itself is defined there; see its `CONTEXT.md` for the domain glossary.
+- **`docs.datacontroller.io`** - the user-facing product documentation (MkDocs), published at docs.datacontroller.io.
+
+When writing marketing/blog/feed copy about a feature, treat `docs.datacontroller.io` and `dc` as the source of truth for how the product actually behaves.
+
+## Content structure
+
+- **Blog** (`content/blog/`) - long-form articles, published at `/blog/`.
+- **Feed** (`content/feed/`) - short announcements, published at `/feed/`.
+- Both are combined into a single RSS feed at `/rss.xml`.
+- To add a feed post, use the `add-feed-post` skill (`.agents/skills/add-feed-post/SKILL.md`).
+
+## Agent files
+
+All agent-facing material lives under `.agents/`:
+
+- `.agents/skills/` - pi-discovered skills (e.g. `add-feed-post`).
+- `.agents/docs/` - reference docs consumed by skills and these instructions.
 
 ### Issue tracker
 
-Issues live as markdown files under `.scratch/`. See `docs/agents/issue-tracker.md`.
+Issues live as markdown files under `.scratch/`. See `.agents/docs/issue-tracker.md`.
 
 ### Domain docs
 
-Single-context layout - `CONTEXT.md` + `docs/adr/` at the repo root. See `docs/agents/domain.md`.
+Single-context layout - `CONTEXT.md` at the repo root + ADRs in `.agents/adr/`. See `.agents/docs/domain.md`.
 
 ### Writing style