# 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/`.