Components

Border Box

Isolate →

A utility class for bordered containers:

.border-box {
  border: 1px solid var(--c-border);
  padding: var(--s-gap);
}

Status Badge

Isolate →

Monospace badges for status indicators:

Draft Proposed Live Deprecated Experimental
<StatusBadge status="Live" />

Spec Card (Article Card)

Isolate →

Card component for index pages representing a single article item. Includes an optional description snippet.

<SpecCard 
  title="Context Engineering" 
  description="A set of practices designed to optimize what an AI agent 'sees'..."
  url="/concepts/context-engineering"
  meta="Oct 12, 2026"
  status="Live"
  tags={["context", "agentic-sdlc"]}
/>

Spec List Item

Isolate →

Dense row component for directory listings. Designed for use in status-grouped lists where items need to be scanned quickly by title.

Each row renders as a single semantic <a> tag with a title and optional description. Status, tags, and dates are intentionally omitted — status is communicated by the parent grouping; everything else lives on the detail page.

  • Root element: Semantic <a> tag — the entire row is clickable.
  • Context: Must be placed inside a <li> within a <ul class="spec-list"> for correct list semantics.
  • Description: Optional secondary text for disambiguation when titles are similar.
<ul class="spec-list">
  <li>
    <SpecListItem
      title="Living Specs"
      url="/practices/living-specs"
      description="A practice for maintaining specifications..."
    />
  </li>
</ul>

Spec Header

Isolate →

Standardized header for specification pages (Concepts, Patterns, Practices). Supports data-driven metadata rendering.

Example Specification

Description
A standardized header component for specification pages.
Status
Live
Last Updated
Tags
example, demo
<SpecHeader
  data={articleSchema.parse({
    title: "Example Specification",
    description: "A standardized header component...",
    status: "Live",
    lastUpdated: new Date(),
    tags: ["example"]
  })}
/>

Warning Banner

Isolate →

Used for critical system-wide alerts (e.g., Alpha Release warning).

<div class="banner-warning">
  SYSTEM ALERT: EXAMPLE WARNING BANNER
</div>

Article References

Isolate →

Structured reference component for citing external sources in APA-inspired format. Supports 7 reference types: website, paper, book, podcast, video, repository, and standard.

References

  1. OpenAI (2024). OpenAI Best Practices for Prompt Engineering . Accessed January 8, 2026.

    Foundational guidance on structuring prompts for LLMs, covering prompt engineering techniques and best practices.

  2. Yuntao Bai, Saurav Kadavath, Sandipan Kundu, & Amanda Askell (2022). Constitutional AI: Harmlessness from AI Feedback .

    Introduces the constitutional training methodology underpinning Claude's behavior and safety constraints.

  3. Eric Evans (2003). Domain-Driven Design: Tackling Complexity in the Heart of Software . ISBN: 978-0321125217.

    Seminal work on modeling complex domains in software through strategic design patterns.

<ArticleReferences references={[
  {
    type: "website",
    title: "OpenAI Best Practices for Prompt Engineering",
    url: "https://platform.openai.com/docs/guides/prompt-engineering",
    author: "OpenAI",
    published: new Date("2024-01-15"),
    accessed: new Date("2026-01-08"),
    annotation: "Foundational guidance on structuring prompts..."
  },
  // ... more references
]} />

Features:

  • APA-inspired citation format: Author (Year). Title. Metadata.
  • Semantic HTML with <cite>, <ol>, and proper accessibility
  • Automatic handling of missing optional fields
  • External links with rel="external noopener"
  • Required accessed date for website references (validated in schema)