From 56795b680f3a8d62d9cb85ae8ca9a34f824122b6 Mon Sep 17 00:00:00 2001
From: ozan <ozan@tinqs.com>
Date: Mon, 8 Jun 2026 00:23:33 +0100
Subject: [PATCH] chore(.agents): adopt the .agents/ agent-context convention
 (matches studio)

Add .agents/ (AGENTS.md Knowledge-map + skills/plans/handoffs/wiki) so blog matches the
cross-repo structure; human content (posts/HTML/templates) stays at repo root. Root agents.md
points to .agents/.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 .agents/AGENTS.md         | 28 ++++++++++++++++++++++++++++
 .agents/handoffs/.gitkeep |  0
 .agents/plans/.gitkeep    |  0
 .agents/skills/.gitkeep   |  0
 .agents/wiki/.gitkeep     |  0
 agents.md                 |  2 ++
 6 files changed, 30 insertions(+)
 create mode 100644 .agents/AGENTS.md
 create mode 100644 .agents/handoffs/.gitkeep
 create mode 100644 .agents/plans/.gitkeep
 create mode 100644 .agents/skills/.gitkeep
 create mode 100644 .agents/wiki/.gitkeep

diff --git a/.agents/AGENTS.md b/.agents/AGENTS.md
new file mode 100644
index 0000000..2693d59
--- /dev/null
+++ b/.agents/AGENTS.md
@@ -0,0 +1,28 @@
+# AGENTS — tinqs-blog
+
+## This agent
+
+**tinqs-blog** — the public Tinqs blog: static HTML built from `posts/*.md` via `build.js`. Human content
+(posts, templates, generated HTML, `img/`) lives at the **repo root**; this `.agents/` folder is the
+agent-context home. Shared identity/soul + team roster live in the hub (`../docs/.agents/`, `../docs/ai/`).
+
+## Shared context (read at session start)
+
+- `../docs/.agents/SOUL.md` — shared agent identity
+- `../docs/ai/company.md` · `../docs/ai/siblings.md` — team + repo map
+- `../docs/.agents/rules/shared-context.md` — cross-repo conventions (HTML, S3 img, deploy)
+- Root `agents.md` — blog architecture, build pipeline, post conventions (edit `.md`, never generated `.html`)
+
+## Knowledge map
+
+| Category | Path | Tag |
+|----------|------|-----|
+| Agent entry | root `agents.md` | **always-on** |
+| This index | `.agents/AGENTS.md` | **always-on** |
+| Skills | `.agents/skills/` | consult-when |
+| Plans | `.agents/plans/` | consult-when |
+| Handoffs | `.agents/handoffs/` | consult-when |
+| Wiki | `.agents/wiki/` | consult-when |
+
+Convention: **human content stays at repo root** (tinqs.com / Git Studio renders it); `.agents/` is
+agent-only context. Mirrors the structure in `tinqs/studio/.agents/`.
diff --git a/.agents/handoffs/.gitkeep b/.agents/handoffs/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/.agents/plans/.gitkeep b/.agents/plans/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/.agents/skills/.gitkeep b/.agents/skills/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/.agents/wiki/.gitkeep b/.agents/wiki/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/agents.md b/agents.md
index 09ec3e6..819be96 100644
--- a/agents.md
+++ b/agents.md
@@ -2,6 +2,8 @@
 
 This file teaches AI agents (Pi, Cursor, Claude Code) how to work with the Tinqs blog repo. Read it before making any changes.
 
+> **Repo agent context + Knowledge map:** [`.agents/AGENTS.md`](.agents/AGENTS.md) (skills, plans, handoffs, wiki). Human content (posts/HTML/templates) stays at the repo root.
+
 ## Shared context
 
 Shared agent identity, team roster, skills, and cross-project rules live in `../docs/.agents/`. Read at session start: