AgentCustomization

@a16njs/models

---

@a16njs/models / AgentCustomization

Interface: AgentCustomization

Defined in: types.ts:29

Base interface for all agent customization items. Every customization discovered or emitted extends this interface.

BREAKING CHANGES (Phase 9):

• version is now required (was not present)
• sourcePath is now optional (was required)
• relativeDir added as optional field for directory structure preservation

Extended by

• GlobalPrompt
• SimpleAgentSkill
• AgentSkillIO
• FileRule
• AgentIgnore
• ManualPrompt

Properties

id

id: string

Defined in: types.ts:31

Unique identifier for this item

---

type

type: CustomizationType

Defined in: types.ts:33

The type of customization

---

version

version: string

Defined in: types.ts:35

IR version (required, e.g., 'v1beta1')

---

sourcePath?

optional sourcePath?: string

Defined in: types.ts:37

Original file path where this was discovered (optional, omitted in IR format)

---

relativeDir?

optional relativeDir?: string

Defined in: types.ts:39

Relative directory path for preserving directory structure (optional)

---

content

content: string

Defined in: types.ts:41

The actual prompt/rule content

---

metadata

metadata: Record<string, unknown>

Defined in: types.ts:48

Tool-specific extras that don't fit the standard model (transient, not serialized in IR).

This is not the AgentSkills.io metadata frontmatter field — that one is author-authored and must persist. See AgentSkillSpecFields.specMetadata.