AGENTS.md git:20260809.9eead89A

Immutable. This exact content is served forever at /api/v1/blob/129b90ac315de425.

# event4u/agent-config

> Shared skill / rule / command suite for AI coding tools. No app runtime.

## Source of truth

Edit `src/` only (`skills`, `rules`, `agent-src`). `task sync` + `task generate-tools` regenerate the rest; never hand-edit.

## Working on this repo

```bash
task sync # dist/agent-src/, .augment/
task generate-tools # .claude/, .cursor/, .clinerules/, .windsurfrules
task ci # full pipeline, green before PR
# dev: AGENT_CONFIG_DEV_MODE=1 -> --scope=project (docs/maintainers/dev-mode.md)
```

## Pointers

- **Self-orientation**: [`package-self-orientation`](docs/contracts/package-self-orientation.md).
- **System map (maintainers)**: [`system-map`](docs/maintainers/system-map.md) — one-page overview.
- **Kernel + Router** — 9 Iron-Law rules + routing: [`kernel-membership`](docs/contracts/kernel-membership.md) + [`rule-router`](docs/contracts/rule-router.md).
- **Trust & Safety** — enum + floors: [`trust-and-safety`](docs/contracts/trust-and-safety.md) + [`ADR-018`](docs/decisions/ADR-018-trust-and-safety-layer.md).
- **Content pipelines** (A→D): [`docs/architecture.md`](docs/architecture.md).
- **Editing this repo**: [`source-of-truth`](src/rules/source-of-truth.md) + [`agents-md-thin-root`](src/skills/agents-md-thin-root/SKILL.md).
- **Consumer story** — `npx` + `scripts/install.sh`: [`README.md`](README.md).
- **Personas** — 34 lenses (core + specialists + advisors): [`docs/personas.md`](docs/personas.md).
- **Discovery** — workspaces/packs: [`ADR-013`](docs/decisions/ADR-013-discovery-frontmatter-contract.md) + [`customization`](docs/customization.md).
- **Root & `agents/` layout** — `src/` = source ([`ADR-050`](docs/decisions/ADR-050-workspace-vs-package-root-boundary.md)); contract: [`agents-layout`](docs/contracts/agents-layout.md).
- **Security** — [`SECURITY.md`](SECURITY.md); [`docs/threat-model.md`](docs/threat-model.md).
- **Delegate & review**: subagents take independent-slice work, not serial; in a team (host-flag gated) the lead coordinates, teammates implement; no mutating session ends without neutral review — [`delegation-policy`](dist/agent-src/rules/delegation-policy.md).

## Emergency triage — when nothing else is reachable

1. **What is this repo?** — `event4u/agent-config`: governed skill/rule/command suite for AI coding tools, no app runtime.
2. **What language?** — `.md` is English; agents mirror the user's language at runtime.
3. **Where do I edit?** — `src/` only, never the generated trees.
4. **Lint / test / sync entry?** — `task ci` (full); subsets `task sync`, `task generate-tools`, `task lint-skills`, `task test`.
5. **Where do the always-active rules live?** — `dist/agent-src/rules/` (kernel = 9 Iron-Law rules; tier-1/2 via `dist/router.json`).
6. **CI checks?** — [`branch-protection-policy`](docs/contracts/branch-protection-policy.md), [`ci-green-floor`](docs/contracts/ci-green-floor.md), [`release-pr-gating`](docs/contracts/release-pr-gating.md).