Skip to main content

Frontmatter Reference

Complete reference for HarnSpec frontmatter fields.

This page provides a quick reference of all available fields. For usage examples and best practices, see the main frontmatter documentation.

Required Fields​

status​

Type: string
Values: planned | in-progress | complete | archived
Description: Current state of the spec

Icons:

  • 📅 Planned
  • ⏳ In progress
  • ✅ Complete
  • 📦 Archived

created​

Type: string
Format: YYYY-MM-DD
Description: Date when spec was created

Auto-filled by harnspec create.

Optional Fields​

tags​

Type: array
Description: Categories for organization and filtering

Example:

tags: [api, security, mvp]

priority​

Type: string
Values: low | medium | high | critical
Description: Importance level

depends_on​

Type: array
Description: Hard dependencies (directional blocking)

Spec cannot start until dependencies complete. Shows directionally in harnspec deps.

Example:

depends_on: [018-spec-validation]

Symbol: → (depends on) or ← (blocks)

Use when:

  • Spec truly cannot start until another completes
  • There's a clear dependency chain
  • Work must be done in specific order

completed​

Type: string
Format: YYYY-MM-DD
Description: Date when work was completed

Auto-added when status is set to complete.

Custom Fields​

Define in .harnspec/config.json:

{
  "frontmatter": {
    "custom": {
      "assignee": "string",
      "reviewer": "string",
      "epic": "string",
      "sprint": "number",
      "estimate": "string",
      "issue": "string"
    }
  }
}

Supported types:

  • string - Text values
  • number - Numeric values
  • boolean - true/false
  • array - Lists

Complete Example​

---
status: in-progress
created: 2025-11-02
completed: 
tags: [api, authentication, security]
priority: high
depends_on: [037]
assignee: alice
reviewer: bob
epic: PROJ-123
sprint: 42
estimate: large
needs_security_review: true
---

See also: