PHPackages event4u/agent-config - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. event4u/agent-config ActiveLibrary[Utility & Helpers](/categories/utility) event4u/agent-config ==================== Shared agent configuration — skills, rules, commands, guidelines, and templates for AI coding tools 1.41.2(4w ago)66.0k[3 issues](https://github.com/event4u-app/agent-config/issues)[1 PRs](https://github.com/event4u-app/agent-config/pulls)MITPythonPHP >=8.0CI failing Since Apr 14Pushed 6d agoCompare [ Source](https://github.com/event4u-app/agent-config)[ Packagist](https://packagist.org/packages/event4u/agent-config)[ RSS](/packages/event4u-agent-config/feed)WikiDiscussions main Synced 1w ago READMEChangelog (10)DependenciesVersions (140)Used By (0) [![event4u Agent Config](.github/assets/banner.png)](https://event4u.app) Agent Config — Universal AI Agent OS ==================================== [](#agent-config--universal-ai-agent-os) [![Smoke](https://github.com/event4u-app/agent-config/actions/workflows/smoke.yml/badge.svg)](https://github.com/event4u-app/agent-config/actions/workflows/smoke.yml) [![Public install smoke (3 OS × 2 Node)](https://github.com/event4u-app/agent-config/actions/workflows/smoke-public-install.yml/badge.svg)](https://github.com/event4u-app/agent-config/actions/workflows/smoke-public-install.yml) [![npm](https://camo.githubusercontent.com/d91f5756db8d19eb6ca0e1812317369992aa0fb04dc73f343a2f0319756e8c9a/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f406576656e7434752f6167656e742d636f6e6669673f7374796c653d666c61742d737175617265266c6162656c3d6e706d26636f6c6f723d6f72616e6765)](https://www.npmjs.com/package/@event4u/agent-config) > **Choose your experience — developer · founder · content · agency · finance · ops. Add packs. Get a focused command set, not a 500-artefact dump.** Bring your own AI provider. Six role-shaped entry paths, one shared **skills + rules + commands** layer that turns any host agent (Claude Code, Augment, Cursor, Copilot, Windsurf) into a reliable team member — without locking you to a single model or vendor. ### Pick your profile — six entry paths [](#pick-your-profile--six-entry-paths) `agent-config setup` writes `profile.id` to `.agent-settings.yml`; each anchor below is the first-screen the wizard sends you to. One README, six entries, no role-detection guesswork. Profile (`profile.id`)AudienceFirst commandsFirst skills👩‍💻 [`developer`](docs/profiles.md#profile-developer)IC engineer`/implement-ticket` · `/work` · `/review-changes` · `/fix` · `/commit``developer-like-execution` · `verify-completion-evidence` · `minimal-safe-diff` · `systematic-debugging` · `test-driven-development`✍️ [`content_creator`](docs/profiles.md#profile-content_creator)Writers, ghostwriters, marketers`/work` · `/post-as` · `/ghostwriter` · `/optimize-prompt` · `/video:from-script` · `/video:storyboard``voice-and-tone-design` · `messaging-architecture` · `editorial-calendar` · `release-comms` · `character-consistency`🚀 [`founder`](docs/profiles.md#profile-founder)Solo / early-stage founder`/work` · `/feature` · `/challenge-me` · `/council``refine-prompt` · `rice-prioritization` · `vision-articulation` · `fundraising-narrative` · `runway-cognition`🏛 [`agency`](docs/profiles.md#profile-agency)Multi-client delivery shop`/work` · `/implement-ticket` · `/refine-ticket` · `/feature` · `/roadmap``doc-coauthoring` · `decision-record` · `refine-ticket` · `estimate-ticket` · `perf-feedback-craft`💼 [`finance`](docs/profiles.md#profile-finance)CFO / fractional finance / FP&A`/work` · `/council` · `/challenge-me``dcf-modeling` · `forecasting` · `scenario-modeling` · `unit-economics-modeling` · `runway-cognition`🛡 [`ops`](docs/profiles.md#profile-ops)RevOps, support, SRE-adjacent`/work` · `/threat-model` · `/review-changes` · `/fix``incident-commander` · `dashboard-design` · `logging-monitoring` · `threat-modeling` · `launch-readiness`**Not sure which one?** Run `npx @event4u/agent-config init` then `agent-config setup` — the browser wizard asks a single 8-option role question and maps to the closest profile. Source-of-truth: [`packages/core/.agent-src.uncondensed/profiles/`](packages/core/.agent-src.uncondensed/profiles/) · schema: [`docs/contracts/profile-system.md`](docs/contracts/profile-system.md). Beyond software: [`user-types/`](packages/core/.agent-src.uncondensed/user-types/)(galabau · metalworking · truck — see [Beyond software](#beyond-software). [CHANGELOG](CHANGELOG.md) · [Breaking changes](CHANGELOG.md#breaking--v400-unified-setup-road-to-unified-setup) · [Latest release](https://github.com/event4u-app/agent-config/releases/latest) · [Discussions](https://github.com/event4u-app/agent-config/discussions) Distribution: `npm install @event4u/agent-config` · npm-primary per [ADR-033](docs/decisions/ADR-033-distribution-identity-npm-primary.md). Major bumps follow [semver](CONTRIBUTING.md#versioning-policy); each ships a [`### Breaking`](CHANGELOG.md#breaking--v400-unified-setup-road-to-unified-setup) entry — all majors indexed in [BREAKING\_CHANGES.md](BREAKING_CHANGES.md). --- > **Creative Pack — cinematic AI video.** script → character-locked image → motion+audio prompt → provider render → stitched clip, with `AIV_DRYRUN=true` as the cost-safety default. A first-class capability inside the **content / creator** experience — no longer the package's headline. See [`/video:from-script`](.augment/commands/video/from-script.md). **Catalog at a glance** — raw artefact counts (maintainer reference)[![Skills](https://camo.githubusercontent.com/2506978139ad3c43b9964d844b75d43dafbdcf4b932bdcca66866b26ce4a4d4e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f536b696c6c732d3232332d6f72616e67653f7374796c653d666c61742d737175617265)](.agent-src/skills/) [![Rules](https://camo.githubusercontent.com/6990b29cdd5452a76cf680a73ef91c2f0abeaa2d809611d646b9d8497b71538a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f52756c65732d37392d6f72616e67653f7374796c653d666c61742d737175617265)](.agent-src/rules/) [![Commands](https://camo.githubusercontent.com/6fb645eef9c1c446630b0f4aba7c4865b1bc3eaae85da18e13bc6c48211056b6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6d6d616e64732d3135302d6f72616e67653f7374796c653d666c61742d737175617265)](.agent-src/commands/) [![Guidelines](https://camo.githubusercontent.com/a2629cef6467c27f065d2380eaeb7e913e07f9d1fb24a844491f69c943577ed3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f47756964656c696e65732d37342d6f72616e67653f7374796c653d666c61742d737175617265)](docs/guidelines/) [![Personas](https://camo.githubusercontent.com/11ac158b75872e4d58b6fca1372c3e39cc50146fcf1a318dcf56a65253c07f09/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f506572736f6e61732d32342d6f72616e67653f7374796c653d666c61742d737175617265)](.agent-src/personas/) [![Advisors](https://camo.githubusercontent.com/8a1e1a24b3a253ba8d4694bb37e6576ccd85a1e1f02a6375a46e650626ab9060/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f41647669736f72732d352d6f72616e67653f7374796c653d666c61742d737175617265)](.agent-src/personas/advisors/) The headline is the **experience** (profile + packs), not the raw counts. Full catalog: [`docs/catalog.md`](docs/catalog.md). Use it in your project ---------------------- [](#use-it-in-your-project) Run from a consumer repo — bootstrap via `npx`, the agent picks up your stack, and you ship work end-to-end. New install? Start with the [Quickstart](#quickstart). Already installed? [Supported tools](#supported-tools)shows the wired AIs; [`docs/featured-commands.md`](docs/featured-commands.md)lists the end-to-end workflows (`/implement-ticket`, `/work`, `/commit`, `/create-pr`). Deeper tour: [2-minute demo](#2-minute-demo--implement-ticket). **Install scope.** Pick **one** scope per machine — project-local (default, recommended for application repos) or user-global (recommended for tooling repos / dotfiles). The installer refuses cross-scope drift via the `scope_guard` pre-flight. Contract: [`docs/contracts/install-scopes.md`](docs/contracts/install-scopes.md). Cleanup when needed: `bash scripts/cleanup_other_scope.sh --confirm`. Harness expectations -------------------- [](#harness-expectations) Three classes of behaviour look like package bugs but are host-harness behaviour the package cannot control — sibling-plugin namespaces (`codex:*`, `cc-gemini-plugin:*`), deferred tools surfaced via `ToolSearch`, and cross-scope skill drift (real bug, fixed in the distribution-channels track). Diagnostics + the package's response: [`docs/contracts/harness-expectations.md`](docs/contracts/harness-expectations.md). First step when a skill appears twice: `task probe:skills`. Prove it -------- [](#prove-it) Audit-disciplined by construction — every memory consult, decision key, and hook concern lands in `agents/runtime/state/` so you can replay it. [Core principles](#core-principles) names the four invariants; [What `agent-config` is — and what it isn't](#what-agent-config-is--and-what-it-isnt)draws the scope boundary. Contribute ---------- [](#contribute) Working on the package itself? [Development](#development) covers the `task ci` pipeline, [Requirements](#requirements) the toolchain, [Maintainer telemetry](#maintainer-telemetry-opt-in-default-off) the opt-in measurement loop. Source-of-truth tree is `packages/core/.agent-src.uncondensed/`; never hand-edit `.augment/` or `.agent-src/`. --- Quickstart ---------- [](#quickstart) **Three steps. Five minutes. Browser wizard, no YAML by hand.** ``` # 1. Install — on a terminal with a display, the browser wizard launches # automatically; the same install.py runs the real install behind it. npx -y @event4u/agent-config init # 2. Pick your profile + tools in the wizard, click Finish. # (Writes ~/.event4u/agent-config/, ~/.claude/, ~/.cursor/, …) # 3. First real task — agent refines, plans, verifies. /work "your first real task" ``` **Headless / CI:** `init` skips the GUI automatically when `CI` is set, stdout is not a TTY, `--no-ui` is passed, **or** an explicit `--tools=` selection is given — it then runs the non-interactive installer directly. Pass flags (`--profile=developer --tools=claude-code,cursor`); add `--dry-run` to preview writes. The GUI and the CLI share one installer (`scripts/install.py`), so both produce identical results. Reference: [`docs/wizard.md`](docs/wizard.md). **Pick specific AIs:** `--tools=claude-code,cursor,augment,windsurf,cline,gemini-cli,copilot,roocode,aider,codex,claude-desktop,continue` (any subset). Visual picker: add `--gui` (loopback-bound, CSRF-gated; contract [`gui-wizard`](docs/contracts/gui-wizard.md)). **Verify hook coverage:** `npx @event4u/agent-config hooks:status` prints the per-platform matrix (`--strict` for CI, `--format json` for tooling). > **Scope (v2.5+):** `init` writes **global** only — `~/.event4u/agent-config/`, `~/.claude/`, `~/.cursor/`, …. The project tree gets `agents/overrides/` + `agents/.event4u-bridge.yml`. `--project` is maintainer-only behind `AGENT_CONFIG_DEV_MODE=1` ([ADR-020](docs/decisions/ADR-020-global-only-consumer-scope.md), [dev-mode](docs/maintainers/dev-mode.md)). Migrating from a v1.x install? `npx @event4u/agent-config migrate` — full notes in [`docs/migration/v1-to-v2.md`](docs/migration/v1-to-v2.md). > **`npm error ETARGET` / `No matching version found for `?** Re-run with a forced fresh metadata fetch: > > ``` > npx -y --prefer-online @event4u/agent-config init > ``` > > > > This happens when the project's `.npmrc` sets `prefer-offline=true` (or points at a private-registry mirror): npm resolves our dependencies against stale cached metadata that predates a recently published version. `--prefer-online`bypasses the cache for this run; `npm cache verify` fixes it permanently for that machine. --- What `agent-config` is — and what it isn't ------------------------------------------ [](#what-agent-config-is--and-what-it-isnt) A **content layer** — skills, rules, commands, guidelines, personas — distributed via npm and projected into every supported AI tool's native config format. It follows the [Agent Skills open standard](https://agentskills.io). It is **not** an agent runtime. The agent loop, the LLM dispatcher, and tool orchestration stay with the host tool (Claude Code, Augment, Cursor, Cline, Windsurf, Gemini CLI, Copilot). Think of it as a playbook and style guide for those tools — not a replacement. In scopeOut of scopeSkills, rules, commands, guidelines, personasAgent loop / LLM dispatcherMulti-tool projection + condensation pipelineExecution engine inside the packageMemory helpers (`memory-add`, `memory-promote`)Cross-tool observability dashboardLinters, CI, frontmatter validation against [JSON-Schema](scripts/schemas/) ([contract](agents/reference/docs/frontmatter-contract.md))Runtime GUI / web dashboardSkill orchestration via citations + deterministic helpersOpinionated *automatic* skill-resolver (ML / relevance ranking that decides for you)User-driven projection-time filtering by profile + packs ([ADR-040](docs/decisions/ADR-040-execution-model-projection-time-filtering.md))A *runtime* resolver / daemon (mid-session switching — conditional, post-6.0.0)### What your agent is asked to do [](#what-your-agent-is-asked-to-do) Default behaviorWith agent-configGuess and edit blindlyAnalyze code before changing itDrift from project conventionsFollow detected stack conventionsSkip or invent testsWrite tests in the project's frameworkGeneric commit messagesConventional Commits with scope + ticket linksSkip quality checksRun the project's quality pipeline and fix reported errorsOpen PRs without contextStructured PR descriptions from Jira / Linear / GitHubClaim "done" without proofVerify with real execution before claiming done--- 2-minute demo — `/implement-ticket` ----------------------------------- [](#2-minute-demo--implement-ticket) The flagship command. Drives a ticket end-to-end through a fixed linear flow — and **blocks on ambiguity instead of guessing**. ``` /implement-ticket PROJ-123 ``` The agent runs this sequence: ``` refine → memory → analyze → plan → implement → test → verify → report ``` - **Refines** the ticket if acceptance criteria are vague. - **Queries memory** for past decisions, invariants, incidents. - **Plans** the change; you confirm before any file is touched. - **Implements** under `minimal-safe-diff` + `scope-control` — no drive-by edits. - **Tests** (targeted first, full suite on success). - **Reviews** the diff through four judges (bugs, security, tests, code quality). - **Reports** changes, verdicts, follow-ups — then stops. `/commit` and `/create-pr` are suggestions, never auto-run. Any ambiguity halts the flow with numbered options — never a silent guess. Persona comes from `.agent-settings.yml` (`roles.active_role`): `senior-engineer` (default), `qa`, or `advisory` (plan-only). → [Command reference](.agent-src/commands/implement-ticket.md) · [Flow contract](docs/contracts/implement-ticket-flow.md) ### Sibling — `/work` (free-form prompt) [](#sibling--work-free-form-prompt) Same engine, no ticket required: ``` /work add a CSV export endpoint to the audit-log controller ``` The first pass scores the prompt on five dimensions and routes on the band: BandScoreAction**high**`≥ 0.8`Silent proceed — AC + assumptions in the report**medium**`0.5–0.79`Halts with assumptions report; confirm or edit**low**`< 0.5`Halts with **one** clarifying question on the weakest dimensionAfter the band gate, the flow is identical to `/implement-ticket`. Free-form goal → `/work`; ticket payload → `/implement-ticket`. → [Command reference](.agent-src/commands/work.md) · [`refine-prompt` skill](.agent-src/skills/refine-prompt/SKILL.md) **After the run:** `agent-config explain last` reconstructs the trace (route · memory · council · halts · provider) — read-only, PII-scrubbed, offline. [Docs](docs/customization.md#explainability--explain-last) ### Product UI track [](#product-ui-track) UI-shaped work routes to one of three directive sets — `ui` (full audit→design→apply→review→polish→report), `ui-trivial` (≤ 1 file, ≤ 5 lines: apply→test→report), `mixed` (backend + UI: contract→ui→stitch). Existing-UI audit is a **hard gate** ([`ui-audit-gate`](.agent-src/rules/ui-audit-gate.md)); polish has a 2-round ceiling with a11y precedence. Stack detection → `blade-livewire-flux` / `react-shadcn` / `vue` / `plain`. → [Mental model](docs/ui-track-mental-model.md) (1 page) · [Flow contract](docs/contracts/ui-track-flow.md) --- Customize --------- [](#customize) ### Profiles — how much governance gets loaded [](#profiles--how-much-governance-gets-loaded) Safety floor (non-destructive defaults · ask-before-guessing · mirror-the-user's-language) ships in **every** profile. What changes is how much extra coaching gets pulled in. ProfileWhat you getWhen to pick it**`minimal`**Non-negotiable safety floor only. Cheapest, fastest.Quick questions · throw-away scripts · CI · tight token budgets**`balanced`** (default)Safety floor + everyday coaching (sensible defaults, review nudges, common pitfalls).Day-to-day work**`full`**Everything, including long-tail rules normally only maintainers need.Working on `agent-config` itself · audits · max-fidelity demosUnder the hood: kernel-only · kernel + tier-1 · kernel + tier-1 + tier-2. Details: [`rule-router`](docs/contracts/rule-router.md) · [`kernel-membership`](docs/contracts/kernel-membership.md) · [Configure →](docs/customization.md). > **Stability:** [`STABILITY.md`](docs/contracts/STABILITY.md) for the full matrix. Work Engine (`/work` + `/implement-ticket`): **beta**. Runtime Dispatcher: **stable**. Tool Adapters: **experimental** (`full` profile only). ### `.agent-user.md` and Ghostwriter — voice primitives [](#agent-usermd-and-ghostwriter--voice-primitives) PrimitiveVoiceDisclosure[`personas/*.md`](.agent-src/personas/)Review-lens (internal critique)n/a`.agent-user.md` (project root, gitignored)The maintainer's own voice — `/post-as:me`None (you are the author)[`agents/reference/ghostwriter/.md`](docs/contracts/ghostwriter-schema.md) (gitignored)Documented public figure — `/post-as:ghostwriter`**Mandatory, non-removable** footerCreate the user file interactively: `/agents user init` ([schema](docs/contracts/agent-user-schema.md)). Ghostwriter cluster: `/ghostwriter:fetch ` runs an attestation gate; private individuals rejected; paywalled / leaked / DM content banned at the schema level. ### Self-hosted MCP on Cloudflare — zero local install [](#self-hosted-mcp-on-cloudflare--zero-local-install) Skills, commands, rules, and guidelines can be served as an MCP endpoint from your own Cloudflare Worker — any MCP client (Claude Desktop, Claude Code, Cursor, Zed, Continue, hosted agents) talks to it over HTTP. Two auth modes: `public` (default, OSS read-only deploys) and `bearer-auth` (operator opt-in, `MCP-Token` Wrangler secret). ``` task mcp:cloud:login # one-time, opens browser task mcp:cloud:setup # check → r2-create → r2-verify → whoami task mcp:cloud:secret-put # opt in to bearer-auth (recommended for private deploys) ``` → Operator walkthrough: [`mcp-cloud-setup`](docs/setup/mcp-cloud-setup.md) · Per-client config: [`mcp-client-config`](docs/setup/mcp-client-config.md) · Endpoints: [`mcp-cloud-endpoints`](docs/setup/mcp-cloud-endpoints.md). > **Scope — Lite, not Full.** The Worker serves read-only governance (skills · commands · rules · guidelines · contexts) as MCP prompts and resources, plus small read-only tools (`memory_lookup`, `chat_history_read`, `list_*`). It does **not** execute the ~112 Python scripts (linters, audits, `task ci`, work-engine hooks) — those require local install per [Quickstart](#quickstart). ### Deployment posture [](#deployment-posture) ShapeStatusPath**Single-user workspace**✅ today`npx @event4u/agent-config init` — single machine, single user; no remote sync**Small team (3–10 people)**✅ todayShared `agents/overrides/` Git repo + shared NAS for knowledge — no code change, no new server. Recipe: [`docs/deploy/small-team-recipe.md`](docs/deploy/small-team-recipe.md)**Organization mode** (SSO · central policy · team context · internal connectors)⏸ not startedEach shape gated on a recruited customer + funded audit + maintainer ADR. Posture rationale: [`docs/deploy/team-deployment-posture.md`](docs/deploy/team-deployment-posture.md)The Hard Floor on organization-mode features (SSO, central policy, OAuth connectors, team-context) is preserved by design — they stay cancelled until a real first customer + funded security audit lifts them. The small-team recipe is the supported path in the meantime. > *The 9.3/10 feedback round (2026-05-25) re-asked for OAuth knowledge connectors, IAM / org governance, and organization-shared memory. Each is a stable cancellation row in [`team-deployment-posture`](docs/deploy/team-deployment-posture.md) under the same three release gates — recruited team customer · funded audit · maintainer ADR.* ### Optional: persistent agent memory [](#optional-persistent-agent-memory) [`@event4u/agent-memory`](https://www.npmjs.com/package/@event4u/agent-memory) — MCP-based backend for cross-session learnings. **Strictly optional**; without it, skills fall back to file-based memory under `agents/memory/`. ``` npm install --save-dev @event4u/agent-memory ``` → [Memory contract](docs/contracts/agent-memory-contract.md) · [Built-in MCP server](docs/mcp-server.md) (experimental) --- Supported tools --------------- [](#supported-tools) ### Project-installed (`npx`) [](#project-installed-npx) ToolRulesSkillsCommandsHow it works**Claude Code**✅✅✅Reads `.claude/`**Cursor**✅—☑️Reads `.cursor/rules/` + commands via AGENTS.md**Cline**✅—☑️Reads `.clinerules/` + commands via AGENTS.md**Windsurf**✅—☑️Reads `.windsurfrules` + commands via AGENTS.md**Gemini CLI**✅—☑️Reads `GEMINI.md`**GitHub Copilot**✅—☑️Reads `.github/copilot-instructions.md`**Roo Code**✅—☑️Auto-discovers `.roo/rules/*.md` + AGENTS.md**Codex CLI**✅—☑️Auto-discovers `AGENTS.md`**Continue.dev**✅—☑️Auto-discovers `.continue/rules/*.md` + AGENTS.md**Aider**📌——Manual `read:` in `.aider.conf.yml`**Augment** (VSCode/IntelliJ)📌——Global-only; project writes marker**Claude Desktop**📌——Global-only✅ native ☑️ text reference (in AGENTS.md, not invokable as native slash-command) 📌 marker only — not available > **Team reproducibility:** every tool you `init` is recorded in `agents/installed-tools.lock` (committed, machine-managed). New team members run `npx @event4u/agent-config sync` after cloning; CI gates drift with `agent-config validate`. Schema: [`installed-tools-manifest`](docs/guidelines/agent-infra/installed-tools-manifest.md). ### Plugin-installed (optional, global) [](#plugin-installed-optional-global) ToolInstall**Augment CLI** · **Claude Code** · **Copilot CLI**[Install →](docs/installation.md) — rules + skills + commands, marketplace-updatedKeep the global install current with `agent-config upgrade` (latest) or `agent-config refresh --global` (same-version re-install); `agent-config doctor`flags a missing-from-`PATH` binary or binary↔plugin version drift. See [getting-started § Keeping current](docs/getting-started.md#keeping-current). ### Cloud / Hosted-agent surfaces [](#cloud--hosted-agent-surfaces) For platforms where the package's scripts cannot run, artefacts are built for paste-in or upload: - **Linear AI** (Codegen, Charlie, …) — `dist/linear/{workspace,team,personal}.md` - **Claude.ai Web Skills** — `dist/cloud/.zip` → [Install →](docs/installation.md#linear-ai-codegen-charlie-) --- Who this is for --------------- [](#who-this-is-for) Stack-agnostic governance core (orchestration · role modes · command clusters · quality gates · audit-discipline) plus parallel stack-specific skill sets: StackCoverage**Laravel · modern PHP** (deepest)Pest · PHPStan · Rector · ECS · Eloquent · Livewire/Flux · Horizon · Pulse · Reverb · Pennant**Symfony**`symfony-workflow` (DI · Doctrine · Messenger · voters · Twig) + project-analysis**Next.js App Router**`nextjs-patterns` (RSC · Server Actions · caching · route handlers) + UI `react-shadcn`**Zend / Laminas**project-analysis + shared PHP coder/quality skills**React · Node / Express**project-analysis + UI `react-shadcn`**Vue · plain HTML**UI directive set (`vue` / `plain`)**Cross-stack**API design · testing · security · database · Docker · Git · CI · review · threat modeling · observability### Beyond software [](#beyond-software) The same orchestration core drives non-software trades via [`user-types/`](packages/core/.agent-src.uncondensed/user-types/): [`galabau-field-crew`](packages/core/.agent-src.uncondensed/user-types/galabau-field-crew.md) · [`metalworking-shop`](packages/core/.agent-src.uncondensed/user-types/metalworking-shop.md) · [`truck-driver`](packages/core/.agent-src.uncondensed/user-types/truck-driver.md). Contribute your own — [5-minute scaffold](packages/core/.agent-src.uncondensed/user-types/_template/). --- Data governance & domain safety ----------------------------------- [](#data-governance--domain-safety) Three domain-safety rules ([`domain-safety-pii`](packages/core/.agent-src.uncondensed/rules/domain-safety-pii.md), [`domain-safety-disclaimer`](packages/core/.agent-src.uncondensed/rules/domain-safety-disclaimer.md), [`domain-safety-retention`](packages/core/.agent-src.uncondensed/rules/domain-safety-retention.md)) act as per-domain output floors across ~12 areas — PII redaction (support / finance / recruiting / marketing), advice disclaimers (legal / financial / medical / consulting), retention guidance (finance / support), ops floors (logging / export). Full surface → rule → floor matrix: [`docs/safety.md`](docs/safety.md). Beta contracts: [`memory-visibility-v1`](docs/contracts/memory-visibility-v1.md) · [`decision-trace-v1`](docs/contracts/decision-trace-v1.md). ### Maintainer telemetry (opt-in, default-off) [](#maintainer-telemetry-opt-in-default-off) Local-only artefact-engagement log. Set `telemetry.artifact_engagement.enabled: true` in `.agent-settings.yml`. Records which skills / rules / commands / guidelines the agent consults during `/implement-ticket` / `/work`. JSONL under the project root, nothing uploaded. Reports: `npx @event4u/agent-config telemetry:report`. ### Context-aware command suggestion [](#context-aware-command-suggestion) When a prompt matches a command's purpose ("setze ticket ABC-123 um" → `/implement-ticket`), the agent surfaces matches as numbered options — **nothing auto-executes**. Per-conversation off: `/command-suggestion-off`. Settings: `commands.suggestion.{enabled,blocklist,confidence_floor}` in `.agent-settings.yml`. --- Core principles --------------- [](#core-principles) - **Analyze before implementing** — no guessing, no blind edits - **Verify with real execution** — no "should work" - **Challenge to improve** — agents are thought partners, not yes-machines - **Strict by design** — quality over flexibility - **Zero overhead by default** — nothing runs until you ask for it --- Documentation ------------- [](#documentation) DocumentContent[**Getting Started**](docs/getting-started.md)First run, 3-test experience, profiles, next steps[**Installation**](docs/installation.md)All install paths, Composer/npm, orchestrator details[**Architecture**](docs/architecture.md)System layers, content pipeline, tool support matrix[**Customization**](docs/customization.md)Overrides, AGENTS.md, agent settings, cost profiles[**Quality & CI**](docs/quality.md)Linting, CI pipeline, condensation system[**Migration**](docs/MIGRATION.md)Per-version upgrade steps[**Showcase**](docs/showcase.md)More examples & expected behaviorBrowse content: [all 150 commands](.agent-src/commands/) · [skills catalog](docs/skills-catalog.md) · [full catalog](docs/catalog.md) · [`llms.txt`](llms.txt). --- Development ----------- [](#development) Working on the package itself? Edit `packages/core/.agent-src.uncondensed/`, regenerate trees: ``` task sync # regenerate .agent-src/ and .augment/ task generate-tools # regenerate .claude/, .cursor/, .clinerules/, .windsurfrules task ci # full pipeline — green before PR task test # unit + integration tests task dev:setup # boot the onboarding wizard against the working tree ``` **Invoking the CLI from a source checkout:** `./agent-config ` (the maintainer shim at the repo root → `scripts/agent-config` → `dist/cli/agent-config.js`). `npx @event4u/agent-config` doesn't resolve in the source repo without a prior `npm link`, since there's no `node_modules/.bin/agent-config` symlink — use `./agent-config` instead. Build the TS binary with `npm run build:cli` if `dist/cli/agent-config.js` is missing. → Full project structure and commands: [**docs/development.md**](docs/development.md) · [CONTRIBUTING.md](CONTRIBUTING.md). Stack: **TypeScript** CLI/UI + **Python 3.10+** build/lint scripts. MCP registry payloads render under `dist/mcp/` ([submission checklist](docs/distribution/mcp-submission-checklist.md)). --- Requirements ------------ [](#requirements) - **Node ≥ 18** — `npx @event4u/agent-config init` is the canonical install path. - **Python 3.10+** — bridge stage only; missing → installer skips bridges. - **Platform:** macOS 12.3+, Linux, WSL2. Git Bash needs Developer Mode for symlinks; native PowerShell / cmd unsupported. Contributors rebuilding `.augment/` also need [Task](https://taskfile.dev/). License ------- [](#license) [MIT](LICENSE). ### Health Score 49 — FairBetter than 94% of packages Maintenance87 Actively maintained with recent releases Popularity30 Limited adoption so far Community9 Small or concentrated contributor base Maturity56 Maturing project, gaining track record Bus Factor1 Top contributor holds 99.9% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 55 Last Release 29d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/351a95acbe6b88310de48ea00204e58b0ea216cb1160a3130ffd3dc0b42ef448?d=identicon)[matze4u](/maintainers/matze4u) --- Top Contributors [![matze4u](https://avatars.githubusercontent.com/u/171579628?v=4)](https://github.com/matze4u "matze4u (3340 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (2 commits)")[![php-jesus](https://avatars.githubusercontent.com/u/112096505?v=4)](https://github.com/php-jesus "php-jesus (1 commits)") --- Tags agent-governanceai-agentai-videoclaude-codecursorllmmcpprompt-engineeringskillswindsurf ### Embed Badge ![Health badge](/badges/event4u-agent-config/health.svg) ``` [![Health](https://phpackages.com/badges/event4u-agent-config/health.svg)](https://phpackages.com/packages/event4u-agent-config) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)