Files

Dmytro Stanchiev c2263602c4 chore: install openagent opencode

Signed-off-by: Dmytro Stanchiev <git@dmytros.dev>

2026-04-07 11:31:26 -04:00

1.6 KiB

Raw Blame History

Frontmatter Format

Purpose: HTML comment frontmatter format for all context files

Last Updated: 2026-01-27

Format

ALL context files MUST start with:

<!-- Context: {category}/{function} | Priority: {level} | Version: X.Y | Updated: YYYY-MM-DD -->

Components

Category/Function: {category}/{function}

Examples: ecommerce/concepts, development/examples, core/standards
Category = domain (ecommerce, payments, development)
Function = file type (concepts, examples, guides, lookup, errors)

Priority: critical | high | medium | low

critical: 80% of use cases (business logic, core concepts)
high: 15% of use cases (common workflows, examples)
medium: 4% of use cases (edge cases)
low: 1% of use cases (rare scenarios)

Version: X.Y (start 1.0, increment on changes)

Updated: YYYY-MM-DD (ISO 8601, must match metadata section)

Examples

<!-- Context: ecommerce/concepts | Priority: critical | Version: 1.0 | Updated: 2026-01-27 -->
<!-- Context: payments/guides | Priority: high | Version: 1.2 | Updated: 2026-01-27 -->
<!-- Context: development/examples | Priority: medium | Version: 1.0 | Updated: 2026-01-27 -->

Validation

Frontmatter is first line?
Format exact: ?
Priority is critical|high|medium|low?
Version is X.Y?
Date is YYYY-MM-DD?

structure.md - File organization
templates.md - File templates
codebase-references.md - Linking to code

1.6 KiB Raw Blame History