Design Md Front Matter
Every design.md file must begin with YAML front matter declaring at minimum: project name, persona archetype, and 3-5 aesthetic keywords. A design.…
$ aoe install @community/rule-design-md-front-matter Projection
Always in _index.xml · the agent never has to ask for this.
DesignMdFrontMatter [rule] v1.0.0
Every design.md file must begin with YAML front matter declaring at minimum: project name, persona archetype, and 3-5 aesthetic keywords. A design.md without front matter cannot be reliably indexed, queried, or referenced by an AI agent.
Loaded when retrieval picks the atom as adjacent / supporting.
DesignMdFrontMatter [rule] v1.0.0
Every design.md file must begin with YAML front matter declaring at minimum: project name, persona archetype, and 3-5 aesthetic keywords. A design.md without front matter cannot be reliably indexed, queried, or referenced by an AI agent.
Meta
- License: Apache-2.0
- License Provenance: package-authorship-claim
Severity
warning
Required Fields
- name: (project or component name)
- persona: (one of: brutalist | editorial | tokyo-minimal | warm-institutional | dense-pragmatist | swiss-modernist | custom)
- keywords: [list of 3-5 aesthetic descriptors]
Optional Fields
- version: (semver)
- status: (draft | validated | archived)
- created-at: (ISO date)
Loaded when retrieval picks the atom as a focal / direct hit.
DesignMdFrontMatter [rule] v1.0.0
Every design.md file must begin with YAML front matter declaring at minimum: project name, persona archetype, and 3-5 aesthetic keywords. A design.md without front matter cannot be reliably indexed, queried, or referenced by an AI agent.
Meta
- License: Apache-2.0
- License Provenance: package-authorship-claim
Severity
warning
Required Fields
- name: (project or component name)
- persona: (one of: brutalist | editorial | tokyo-minimal | warm-institutional | dense-pragmatist | swiss-modernist | custom)
- keywords: [list of 3-5 aesthetic descriptors]
Optional Fields
- version: (semver)
- status: (draft | validated | archived)
- created-at: (ISO date)
Relations
related: [@community/method-design-md-extraction, @community/method-gallery-research, @community/principle-design-philosophy-before-canvas]
Rationale
Design documents without machine-readable front matter are browsable by humans but invisible to automated systems. The front matter is the hook that allows AOE query tools to retrieve the right design context at generation time.
Meta
- License: Apache-2.0
- License Provenance: package-authorship-claim
Severity
warning
Required Fields
- name: (project or component name)
- persona: (one of: brutalist | editorial | tokyo-minimal | warm-institutional | dense-pragmatist | swiss-modernist | custom)
- keywords: [list of 3-5 aesthetic descriptors]
Optional Fields
- version: (semver)
- status: (draft | validated | archived)
- created-at: (ISO date)
Source
aoe-engine/examples/frontend-design/primes/compiled/@community/rule-design-md-front-matter/atom.yaml