AGENTS.md git:20260803.fa70e38A

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

# event4u/agent-config

> Shared skill / rule / command suite for AI coding tools. No app runtime. AGENTS.md of the **package itself**.

## Source of truth

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

## Working on this repo

```bash
task sync              # regenerate dist/agent-src/, .augment/
task generate-tools    # regenerate .claude/, .cursor/, .clinerules/, .windsurfrules
task ci                # full pipeline — green before PR
# maintainer: AGENT_CONFIG_DEV_MODE=1 opens --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) — the one-page how-it-fits-together.
- **Kernel + Router** — 9 Iron-Law rules, tier-1/2 routing: [`kernel-membership`](docs/contracts/kernel-membership.md) + [`rule-router`](docs/contracts/rule-router.md).
- **Trust & Safety** — enum, HRR banner, 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 (5 core + 24 specialists + 5 advisors): [`docs/personas.md`](docs/personas.md).
- **Discovery** — workspaces/packs: [`ADR-013`](docs/decisions/ADR-013-discovery-frontmatter-contract.md) + [`customization`](docs/customization.md#workspaces--packs-discovery).
- **Root & `agents/` layout** — `src/` = source ([`ADR-050`](docs/decisions/ADR-050-workspace-vs-package-root-boundary.md)); `agents/` contract: [`agents-layout`](docs/contracts/agents-layout.md).
- **Security** — [`SECURITY.md`](SECURITY.md); [`docs/threat-model.md`](docs/threat-model.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).