Knowledge pillar · v0.16.0
knowledge-artefact KnowledgeArtefact
Knowledge-artefact record.
$id · https://corpospec.com/schemas/v0.16.0/knowledge-artefact.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| audience | ArtefactAudience | yes | Audience. |
| body_ref | PathRef | yes | PathRef to the body artefact (Markdown / Notion / wiki). |
| confidentiality | Confidentiality | yes | Cross-cutting confidentiality classification used across privacy, security, knowledge, IR pillars. Default rendering rule: `corpospec-report` excludes `Restricted | BoardOnly | InvestorOnly` records from public output unless an explicit audience parameter overrides. See BDR 0076 §1. |
| created_at | IsoDate | yes | ISO 8601 date (YYYY-MM-DD). |
| entity | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| id | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| kind | KnowledgeKind | yes | Artefact kind. |
| last_reviewed | IsoDate | yes | ISO 8601 date (YYYY-MM-DD). |
| next_review_due | IsoDate | yes | ISO 8601 date (YYYY-MM-DD). |
| owner | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| review_cadence | string | yes | Review-cadence ISO 8601 duration. |
| status | ArtefactStatus | yes | Lifecycle. |
| summary | string | yes | Short summary / TL;DR. |
| title | string | yes | |
| contributors | PathRef[] | — | Co-maintainers. |
| references | PathRef[] | — | Cross-references to authoritative pillars. |
| supersedes | PathRef[] | — | PathRefs to predecessor artefacts, in chronological order. |
| tags | string[] | — | Free-form search tags. |
Definitions
Shared types referenced within this schema.
ArtefactAudience
Audience.
ArtefactStatus
Lifecycle.
Confidentiality
Cross-cutting confidentiality classification used across privacy,
security, knowledge, IR pillars. Default rendering rule: `corpospec-report`
excludes `Restricted | BoardOnly | InvestorOnly` records from public output
unless an explicit audience parameter overrides. See BDR 0076 §1.
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
KnowledgeKind
Artefact kind.
PathRef
Path-based cross-reference relative to .corpospec/ root.
Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.16.0/knowledge-artefact.schema.json