git:20260803.fa70e38 to git:20260809.63825ba

12 added, 11 removed. Audit A to A.

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

+ 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 # 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)

+ task sync # dist/agent-src/, .augment/

+ task generate-tools # .claude/, .cursor/, .clinerules/, .windsurfrules

+ task ci # full pipeline, green before PR

+ # maintainer: 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) — 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).

+ - **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 (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).

+ - **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; 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).