@event4u/agent-config 5.2.0 → 5.3.0

package/.agent-src/skills/test-performance/SKILL.md

@@ -1,21 +1,12 @@
 ---
 name: test-performance
 description: "Use when optimizing test suite performance — database setup, seeder optimization, parallel testing, CI pipeline efficiency, or RefreshDatabase alternatives."
-source: package
 domain: quality
 framework: laravel
 workspaces:
   - engineering
 packs:
   - engineering-base
-lifecycle: active
-trust:
-  level: core
-  confidence: high
-  human_review_required: false
-install:
-  default: true
-  removable: false
 ---
 
 # test-performance

package/.agent-src/skills/testing-anti-patterns/SKILL.md

@@ -1,20 +1,11 @@
 ---
 name: testing-anti-patterns
 description: "Use BEFORE writing or changing tests, adding mocks, or putting test-only methods on production classes — five Iron Laws and gates against mocking-the-mock, production pollution, silent partial mocks."
-source: package
 domain: quality
 workspaces:
   - engineering
 packs:
   - engineering-base
-lifecycle: active
-trust:
-  level: core
-  confidence: high
-  human_review_required: false
-install:
-  default: true
-  removable: false
 ---
 
 # testing-anti-patterns

package/.agent-src/skills/threat-modeling/SKILL.md

@@ -3,21 +3,12 @@ name: threat-modeling
 description: "Use when adding auth, webhooks, uploads, queues, secrets, tenant boundaries, or public endpoints — produces trust boundaries + abuse cases mapped to files, BEFORE implementation."
 personas:
   - security-engineer
-source: package
 domain: quality
 council_depth: deep
 workspaces:
   - engineering
 packs:
   - engineering-base
-lifecycle: active
-trust:
-  level: core
-  confidence: high
-  human_review_required: false
-install:
-  default: true
-  removable: false
 ---
 
 # threat-modeling

package/.agent-src/skills/throughput-vs-morale-tradeoff/SKILL.md

@@ -3,20 +3,15 @@ name: throughput-vs-morale-tradeoff
 description: "Use when balancing eng-team velocity vs quality vs burnout — on-call load, focus fragmentation, reorg shock. Triggers on 'team is burning out', 'why is velocity dropping'."
 status: active
 tier: senior
-source: package
 domain: process
 context_spine: [org-stage, product, customer-segment]
 workspaces:
   - ops
 packs:
   - ops-people
-lifecycle: active
 trust:
   level: professional
-  confidence: high
-  human_review_required: false
 install:
-  default: true
   removable: true
 ---
 

package/.agent-src/skills/token-optimizer/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: token-optimizer
 description: "Use BEFORE any verbose CLI run, large file read, doc conversion, or near-context handoff — single decision tree keyed by intent that cites the canonical token-saving asset. Consult before the action."
-source: package
 domain: process
 execution:
   type: assisted
@@ -11,14 +10,6 @@ workspaces:
   - agent-config-maintainer
 packs:
   - meta
-lifecycle: active
-trust:
-  level: core
-  confidence: high
-  human_review_required: false
-install:
-  default: true
-  removable: false
 ---
 
 # Token Optimizer — decision tree + catalog

package/.agent-src/skills/traefik/SKILL.md

@@ -1,20 +1,11 @@
 ---
 name: traefik
 description: "Use when setting up Traefik as a local reverse proxy — real domains on 127.0.0.1, trusted HTTPS via mkcert, automatic service discovery, and multi-project routing."
-source: package
 domain: devops
 workspaces:
   - engineering
 packs:
   - engineering-base
-lifecycle: active
-trust:
-  level: core
-  confidence: high
-  human_review_required: false
-install:
-  default: true
-  removable: false
 ---
 
 # Traefik Skill

package/.agent-src/skills/ui-component-architect/SKILL.md

@@ -3,20 +3,11 @@ name: ui-component-architect
 description: "Use when shaping a UI component tree — composition vs inheritance, slot patterns, prop API design, controlled vs uncontrolled, polymorphic — even on 'split this component'."
 personas:
   - frontend-engineer
-source: package
 domain: engineering
 workspaces:
   - engineering
 packs:
   - engineering-base
-lifecycle: active
-trust:
-  level: core
-  confidence: high
-  human_review_required: false
-install:
-  default: true
-  removable: false
 ---
 
 # ui-component-architect

package/.agent-src/skills/unit-economics-modeling/SKILL.md

@@ -3,7 +3,6 @@ name: unit-economics-modeling
 description: "Use when modeling CAC, LTV, payback, contribution margin, or burn-multiple per customer — SaaS, marketplace, or transactional. Triggers on 'are we unit-economic', 'what is our LTV/CAC'."
 status: active
 tier: senior
-source: package
 domain: product
 context_spine: [product, fiscal-period]
 recommended_for_user_types: [founder, finance]
@@ -11,13 +10,9 @@ workspaces:
   - finance
 packs:
   - finance-basic
-lifecycle: active
 trust:
   level: professional
-  confidence: high
-  human_review_required: false
 install:
-  default: true
   removable: true
 ---
 

package/.agent-src/skills/universal-project-analysis/SKILL.md

@@ -1,20 +1,11 @@
 ---
 name: universal-project-analysis
 description: "ONLY when user asks for deep multi-pass codebase audit — orchestrator routing to `project-analysis-core` + framework-specific `project-analysis-*`. Single-pass scan → `project-analyzer`."
-source: package
 domain: discovery
 workspaces:
   - engineering
 packs:
   - engineering-base
-lifecycle: active
-trust:
-  level: core
-  confidence: high
-  human_review_required: false
-install:
-  default: true
-  removable: false
 ---
 
 # universal-project-analysis

package/.agent-src/skills/upstream-contribute/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: upstream-contribute
 description: "Use when a learning, new skill, rule improvement, or bug fix from a consumer project should be contributed back to the shared agent-config package."
-source: package
 domain: process
 execution:
   type: assisted
@@ -11,14 +10,6 @@ workspaces:
   - agent-config-maintainer
 packs:
   - meta
-lifecycle: active
-trust:
-  level: core
-  confidence: high
-  human_review_required: false
-install:
-  default: true
-  removable: false
 ---
 
 # upstream-contribute

package/.agent-src/skills/using-git-worktrees/SKILL.md

@@ -1,20 +1,11 @@
 ---
 name: using-git-worktrees
 description: "Use when starting parallel work in isolation from the current branch — spawn a git worktree with ignore-safety checks and a clean test baseline — even when the user says 'try this on the side'."
-source: package
 domain: process
 workspaces:
   - engineering
 packs:
   - engineering-base
-lifecycle: active
-trust:
-  level: core
-  confidence: high
-  human_review_required: false
-install:
-  default: true
-  removable: false
 ---
 
 # using-git-worktrees

package/.agent-src/skills/validate-feature-fit/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: "validate-feature-fit"
 description: "Validate whether a feature request fits the existing codebase — check for duplicates, contradictions, scope creep, and architectural misfit"
-source: package
 domain: quality
 execution:
   type: assisted
@@ -11,14 +10,6 @@ workspaces:
   - engineering
 packs:
   - engineering-base
-lifecycle: active
-trust:
-  level: core
-  confidence: high
-  human_review_required: false
-install:
-  default: true
-  removable: false
 ---
 
 # Validate Feature Fit

package/.agent-src/skills/verify-completion-evidence/SKILL.md

@@ -1,20 +1,11 @@
 ---
 name: verify-completion-evidence
 description: "Use when claiming 'done', suggesting a commit, push, or PR — runs the evidence gate so completion claims come from fresh output in this message, not memory or earlier runs."
-source: package
 domain: quality
 workspaces:
   - engineering
 packs:
   - engineering-base
-lifecycle: active
-trust:
-  level: core
-  confidence: high
-  human_review_required: false
-install:
-  default: true
-  removable: false
 ---
 
 # verify-completion-evidence

package/.agent-src/skills/video-director/SKILL.md

@@ -3,7 +3,6 @@ name: video-director
 description: "Use when turning a scene idea into the 11-block cinematic prompt for live-action AI video — lens, lighting, blocking, motion, negatives. Triggers 'cinematic prompt', 'film-grade scene'."
 personas:
   - hollywood-director
-source: package
 domain: product
 workspaces:
   - small-business
@@ -12,8 +11,6 @@ packs:
 lifecycle: experimental
 trust:
   level: experimental
-  confidence: high
-  human_review_required: false
 install:
   default: false
   removable: true

package/.agent-src/skills/vision-articulation/SKILL.md

@@ -3,20 +3,13 @@ name: vision-articulation
 description: "Use when articulating internal vision — where we're going / why now / why us, founder-mode anchor, distinct from fundraising pitch. Triggers on 'what's our vision', 'why are we doing this'."
 status: active
 tier: senior
-source: package
 domain: process
 context_spine: [org-stage, product, customer-segment]
 workspaces:
   - founder
 packs:
   - founder-strategy
-lifecycle: active
-trust:
-  level: core
-  confidence: high
-  human_review_required: false
 install:
-  default: true
   removable: true
 ---
 

package/.agent-src/skills/voc-extract/SKILL.md

@@ -3,7 +3,6 @@ name: voc-extract
 description: "Use when extracting Voice-of-Customer themes from existing artefacts — GH issues, PR threads, Sentry patterns. Triggers on 'what are users saying', 'recurring complaints', 'top themes'."
 status: active
 tier: senior
-source: package
 domain: product
 context_spine: [product]
 recommended_for_user_types: [gtm, creator]
@@ -11,11 +10,8 @@ workspaces:
   - product
 packs:
   - product-discovery
-lifecycle: active
 trust:
   level: professional
-  confidence: high
-  human_review_required: false
 install:
   default: false
   removable: true

package/.agent-src/skills/voice-and-tone-design/SKILL.md

@@ -3,7 +3,6 @@ name: voice-and-tone-design
 description: "Use when shaping brand voice — voice attributes, tone-by-context matrix, consistency review. Triggers on 'define our voice', 'why does our copy sound different on every surface'."
 status: active
 tier: senior
-source: package
 domain: product
 context_spine: [product, customer-segment]
 recommended_for_user_types: [creator, consultant, gtm]
@@ -11,13 +10,9 @@ workspaces:
   - gtm
 packs:
   - gtm-marketing
-lifecycle: active
 trust:
   level: professional
-  confidence: high
-  human_review_required: false
 install:
-  default: true
   removable: true
 ---
 

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Shared agent configuration \u2014 skills for AI coding tools (Claude Code, Augment, Cursor, Cline, Windsurf, Gemini CLI).",
-    "version": "5.2.0",
+    "version": "5.3.0",
     "keywords": [
       "agent-config",
       "skills",

package/CHANGELOG.md

@@ -802,6 +802,38 @@ our recommendation order, not its support status.
 > that forces a new era split (`# Era: 4.6.x`, etc.) — see
 > [`docs/contracts/CHANGELOG-conventions.md § Era splits`](docs/contracts/CHANGELOG-conventions.md).
 
+## [5.3.0](https://github.com/event4u-app/agent-config/compare/5.2.0...5.3.0) (2026-05-30)
+
+### Features
+
+* **ci:** lint frontmatter fields equal to their schema default ([3f56ed7](https://github.com/event4u-app/agent-config/commit/3f56ed74fae3fe20346130c790db2929093ae095))
+* **frontmatter:** add idempotent migrate_frontmatter_defaults script ([8c2d56d](https://github.com/event4u-app/agent-config/commit/8c2d56ddb17585540fef83589f5e3207e6583d4a))
+* **frontmatter:** inject schema defaults in discovery, checksum + condense consumers ([a69e51e](https://github.com/event4u-app/agent-config/commit/a69e51ef7b58d0f5e0eda2a600ce090ab203bef2))
+* **frontmatter:** declare schema defaults + inject them in the loader ([6de22ce](https://github.com/event4u-app/agent-config/commit/6de22ce9d89dc648b42b312e0694c621207ccad3))
+
+### Bug Fixes
+
+* **smoke:** inject schema defaults in skills smoke validation ([fc6524b](https://github.com/event4u-app/agent-config/commit/fc6524bc51f595de5a9173309fad17f321a7c892))
+* **lint:** re-anchor framework-leakage allowlist after frontmatter line shift ([13f5e5e](https://github.com/event4u-app/agent-config/commit/13f5e5ea7f933d5cb66550c4e90cd714c7683b87))
+* **frontmatter:** inject schema defaults in skill_linter; update frontmatter tests ([fff4b12](https://github.com/event4u-app/agent-config/commit/fff4b121fa318b0985a51287095b200b3d008642))
+
+### Documentation
+
+* **roadmap:** close + archive abstraction-reduction roadmap with evidence ([fcb8a33](https://github.com/event4u-app/agent-config/commit/fcb8a3322dcb2dc5f89c85c4132bab9286b2164a))
+* **roadmaps:** land Phase 0 preflight for frontmatter-defaults reduction ([70bd300](https://github.com/event4u-app/agent-config/commit/70bd300ef70f55344a22685545a21e2dc795d98b))
+
+### Refactoring
+
+* **frontmatter:** omit fields equal to their schema default across all artefacts ([bd8bc57](https://github.com/event4u-app/agent-config/commit/bd8bc57e104cc82a713f523f5f510e033688771f))
+
+### Chores
+
+* **frontmatter:** drop defaulted fields from the condensed .agent-src tree ([58e2c2a](https://github.com/event4u-app/agent-config/commit/58e2c2a6fc7cf7011e6c9b00801c9f8ff1412684))
+* **roadmaps:** archive road-to-distribution-identity — CI green on PR #290 ([2ffeb62](https://github.com/event4u-app/agent-config/commit/2ffeb6239697228541334c7e234554f77c6935aa))
+* **roadmaps:** flip Phase 0 checkboxes + regen dashboard ([070e33e](https://github.com/event4u-app/agent-config/commit/070e33e4fd704ec0257f4c5cf6a72052c97796d3))
+
+Tests: 5236 (+50 since 5.2.0)
+
 ## [5.2.0](https://github.com/event4u-app/agent-config/compare/5.1.0...5.2.0) (2026-05-29)
 
 ### Features

package/dist/discovery/deprecation-report.md

@@ -1,6 +1,6 @@
 # Discovery — Deprecation Report
 
-- Generated: `2026-05-29T14:14:52Z`
+- Generated: `2026-05-30T00:59:09Z`
 - Deprecated artefacts: **0**
 
 _None. Tree is clean._

package/dist/discovery/discovery-manifest.json

@@ -9452,7 +9452,7 @@
       ]
     }
   ],
-  "checksum": "sha256:653636e679543062954910f794e458eb8424d7f2618b889a29969d21c74fcf0e",
+  "checksum": "sha256:d8c983ca423afbd1d33c0dedcd540c3d13f2ae9399a6d8f2754c3a44dbc2cabf",
   "documented_unassigned": [
     {
       "category": "template",
@@ -9565,7 +9565,7 @@
       "reason": "scaffold for new SKILL.md authoring"
     }
   ],
-  "generated_at": "2026-05-29T14:14:52Z",
+  "generated_at": "2026-05-30T00:59:09Z",
   "packs": [
     {
       "artefact_count": 85,
@@ -9988,7 +9988,7 @@
       ]
     }
   ],
-  "scanner_version": "d75eba636abb",
+  "scanner_version": "ca7acd2ec7af",
   "stats": {
     "by_category": {
       "command": 135,

package/dist/discovery/discovery-manifest.json.sha256

@@ -1 +1 @@
-c0a417183acd5273d0cd21648816539b30da57dd1840f7e967f67ef90a1cffe5  discovery-manifest.json
+0e6f98f480590a02c00ae69b1276d91e390bd62bd3a6652ee7bd53afcc49c225  discovery-manifest.json

package/dist/discovery/discovery-manifest.summary.md

@@ -1,7 +1,7 @@
 # Discovery Manifest — Summary
 
-- Generated: `2026-05-29T14:14:52Z`
-- Scanner: `d75eba636abb`
+- Generated: `2026-05-30T00:59:09Z`
+- Scanner: `ca7acd2ec7af`
 - Artefacts: **433**
 - Unassigned: **0**
 

package/dist/discovery/orphan-report.md

@@ -1,6 +1,6 @@
 # Discovery — Orphan Report
 
-- Generated: `2026-05-29T14:14:52Z`
+- Generated: `2026-05-30T00:59:09Z`
 - Orphan artefacts: **0**
 
 > An orphan is an artefact whose declared pack has no other members.

package/dist/discovery/packs.json

@@ -1,6 +1,6 @@
 {
-  "checksum": "sha256:653636e679543062954910f794e458eb8424d7f2618b889a29969d21c74fcf0e",
-  "generated_at": "2026-05-29T14:14:52Z",
+  "checksum": "sha256:d8c983ca423afbd1d33c0dedcd540c3d13f2ae9399a6d8f2754c3a44dbc2cabf",
+  "generated_at": "2026-05-30T00:59:09Z",
   "packs": [
     {
       "artefact_count": 85,
@@ -1029,5 +1029,5 @@
       ]
     }
   ],
-  "scanner_version": "d75eba636abb"
+  "scanner_version": "ca7acd2ec7af"
 }

package/dist/discovery/trust-report.md

@@ -1,6 +1,6 @@
 # Discovery — Trust Report
 
-- Generated: `2026-05-29T14:14:52Z`
+- Generated: `2026-05-30T00:59:09Z`
 - Workspaces tracked: **8**
 - Human-review-required artefacts: **2**
 

package/dist/discovery/workspaces.json

@@ -1,7 +1,7 @@
 {
-  "checksum": "sha256:653636e679543062954910f794e458eb8424d7f2618b889a29969d21c74fcf0e",
-  "generated_at": "2026-05-29T14:14:52Z",
-  "scanner_version": "d75eba636abb",
+  "checksum": "sha256:d8c983ca423afbd1d33c0dedcd540c3d13f2ae9399a6d8f2754c3a44dbc2cabf",
+  "generated_at": "2026-05-30T00:59:09Z",
+  "scanner_version": "ca7acd2ec7af",
   "workspaces": [
     {
       "artefact_count": 126,

package/dist/mcp/registry-manifest.json

@@ -1,15 +1,15 @@
 {
   "discovery": {
     "artefact_count": 433,
-    "scanner_version": "d75eba636abb"
+    "scanner_version": "ca7acd2ec7af"
   },
-  "generated_at": "2026-05-29",
+  "generated_at": "2026-05-30",
   "package": {
     "description": "Universal AI Agent OS \u2014 audited skills, governance rules, commands, and templates for AI coding tools (Claude Code, Cursor, Windsurf, Copilot).",
     "homepage": "https://github.com/event4u-app/agent-config#readme",
     "name": "@event4u/agent-config",
     "repository": "https://github.com/event4u-app/agent-config",
-    "version": "5.2.0"
+    "version": "5.3.0"
   },
   "registries": [
     {

package/docs/guidelines/agent-infra/skill-quality-checklist.md

@@ -27,6 +27,31 @@ Every skill's YAML frontmatter MUST validate against `scripts/schemas/skill.sche
 Violations are reported by `scripts/skill_linter.py` as `schema_<rule>` errors
 and fail `python3 scripts/validate_frontmatter.py` and the full CI pipeline.
 
+### Omit fields equal to their schema default
+
+```
+NEVER write a frontmatter field whose value equals its schema `default`.
+OMIT IT — the loader injects the default at read time.
+```
+
+A field that carries the schema `default` (e.g. `trust.level: core`,
+`install.default: true`, `lifecycle: active`, `source: package`,
+`command.disable-model-invocation: true`) is redundant:
+`validate_frontmatter.apply_schema_defaults` injects it transparently for
+every consumer (validator, discovery manifest, drift checksum). Writing it
+anyway is boilerplate that `scripts/lint_frontmatter_boilerplate.py` rejects
+(wired into `task ci-fast`). To strip it across the tree, run
+`python3 scripts/migrate_frontmatter_defaults.py`. Background:
+`road-to-abstraction-reduction.md` +
+`agents/evidence/analysis/abstraction-reduction-preflight.md`.
+
+> **Changing a default is a breaking change.** The schema `default` is a
+> contract: artefacts that omit the field inherit whatever the default *is at
+> read time*. Flipping a default value (e.g. `lifecycle: active → deprecated`)
+> silently re-defaults every artefact that omits the field — so a default
+> change must pair with a re-run of `migrate_frontmatter_defaults.py` and an
+> explicit review of the affected artefacts.
+
 ## Description Triggering
 
 Claude routes skills by their frontmatter `description`. Pushy,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@event4u/agent-config",
-    "version": "5.2.0",
+    "version": "5.3.0",
     "description": "Universal AI Agent OS \u2014 audited skills, governance rules, commands, and templates for AI coding tools (Claude Code, Cursor, Windsurf, Copilot).",
     "license": "MIT",
     "private": false,

package/scripts/build_discovery_manifest.py

@@ -25,7 +25,12 @@ from typing import Any, Iterable
 import yaml
 
 sys.path.insert(0, str(Path(__file__).resolve().parent))
-from validate_frontmatter import _FRONTMATTER_RE, parse_frontmatter  # noqa: E402
+from validate_frontmatter import (  # noqa: E402
+    _FRONTMATTER_RE,
+    apply_schema_defaults,
+    load_schema,
+    parse_frontmatter,
+)
 from _lib.agent_src import artefact_roots, logical_relpath, resolve_logical, strip_source_prefix  # noqa: E402
 
 ROOT = Path(__file__).resolve().parents[1]
@@ -146,11 +151,23 @@ def _trusted(path: Path) -> bool:
     return any(rel.startswith(r + "/") for r in TRUST_ROOTS)
 
 
-def _parse(path: Path) -> dict[str, Any] | None:
+# Discovery category → frontmatter schema name. `template` has no schema and
+# carries none of the defaulted fields, so it is left raw.
+_CATEGORY_SCHEMA = {"skill": "skill", "rule": "rule", "command": "command"}
+
+
+def _parse(path: Path, category: str | None = None) -> dict[str, Any] | None:
     text = path.read_text(encoding="utf-8", errors="replace")
     fm, _ = parse_frontmatter(text)
     if not isinstance(fm, dict):
         return None
+    # Inject schema defaults so an artefact that omits a field equal to its
+    # default (post abstraction-reduction migration) still presents the field
+    # to the required-key checks AND the drift checksum — keeping the checksum
+    # byte-stable across the migration (preflight Decision B).
+    schema_name = _CATEGORY_SCHEMA.get(category or "")
+    if schema_name is not None:
+        apply_schema_defaults(fm, load_schema(schema_name))
     return fm
 
 
@@ -252,7 +269,7 @@ def _build(strict: bool) -> tuple[dict[str, Any], list[dict[str, Any]]]:
         if rel in overrides:
             documented_unassigned.append({"path": rel, "category": category, "reason": overrides[rel]})
             continue
-        fm = _parse(path)
+        fm = _parse(path, category)
         payload, reason = _classify(fm, ws_ids, pack_ids)
         if reason is not None:
             unassigned.append({"path": rel, "category": category, "reason": reason})