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>
This commit is contained in:
2026-06-08 00:23:33 +01:00
parent 5b30c6b705
commit 56795b680f
6 changed files with 30 additions and 0 deletions
+28
View File
@@ -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/`.
View File
View File
View File
View File
+2
View File
@@ -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: