datacontroller.io/AGENTS.md

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 .agents/docs/issue-tracker.md.

Domain docs

Single-context layout - CONTEXT.md at the repo root + ADRs in .agents/adr/. See .agents/docs/domain.md.

Writing style

Use regular dashes (-) in content, not em-dashes (—).