## What
Adds `docs/agents/` — an onboarding pack for external contributors using
their own AI coding agent (Claude Code, Codex, Cursor, Aider, OpenClaw,
etc.).
## Why
Maintainers run an agent-driven workflow against this repo. External
contributors using agents benefit from the same discipline (TDD
red→green, PII preflight, parallel persona polish, three-axis merge
readiness) but had nothing portable to point at. This documents the
**process** and the **reusable building blocks** in an agent-agnostic
way.
## Contents
```
docs/agents/
README.md
WORKFLOW.md # pipeline + planning + PII preflight + force-push + worktrees
RULES.md # 36 hard-won discipline rules
TDD.md # red→green requirement, exemptions
SUBAGENT-BRIEF-TEMPLATE.md
skills/ # 14 task playbooks (intake, fix, polish, merge-gate, release, ops...)
personas/ # 14 review voices (carmack, dijkstra, torvalds, meshcore, taleb, ...)
```
## Scope
Docs-only. No code changes. Existing `AGENTS.md` is unchanged. All
committed text uses sanitized placeholders (`<workspace>`, `<repo>`,
`YOUR_NAME`, `YOUR_HANDLE`, etc.) — no personal names, phones, IPs,
keys, or absolute home/root paths.
## Verification
- PII preflight grep on staged diff: only matches are the literal
placeholders inside the documented sanitized example
(`YOUR_NAME|YOUR_HANDLE|...|api[_-]?key|...`).
- Off-topic skill grep on `docs/agents/`: clean (zero hits for the
wrong-language/off-topic skill names that were scrubbed from the prior
attempt).
---------
Co-authored-by: meshcore-bot <bot@meshcore.local>
Co-authored-by: Kpa-clawbot <bot@openclaw.local>
Co-authored-by: efiten <erwin.fiten@gmail.com>
Kpa-clawbot