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. 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 context
Shared agent identity, team roster, skills, and cross-project rules live in `../docs/.agents/`. Read at session start: Shared agent identity, team roster, skills, and cross-project rules live in `../docs/.agents/`. Read at session start: