DESIGN.md

Editorial technology blog

A typography-led publication with a strong cover story, reading rhythm, article metadata, and editorial hierarchy.

Revision: 1
Verified: 2026-07-26

Save or explore

#blog #editorial #typography

Compatibility and paths

GenericProject convention; requires an explicit reference.

CodexDESIGN.mdReference it from AGENTS.md.

Claude CodeDESIGN.mdImport it from CLAUDE.md.

Gemini CLIDESIGN.mdReference it from GEMINI.md.

Trust and provenance

Curated record reviewed 2026-07-26. Results still depend on the supplied context and target environment.

Live preset preview

See the design before you give it to an agent

This sandboxed preview is rendered directly from the same DesignBrief embedded in the downloadable DESIGN.md.

Customize

What this preset defines

The file gives an agent concrete design constraints instead of a vague request to “make it look good.”

Product: documentation
Layout archetype: editorial
Density: spacious
Base radius: 2px
Type scale: 1.2

background#f4efe7surface#fffaf2text#211f1bmuted#756f65accent#d1492esuccess#3c7a57warning#a66b16danger#b5382f

Required layout sections

Cover story
Latest essays
Field notes
Author desk
Newsletter

How to use it

The preset is useful without AI and does not execute code.

01
Preview and customize
Check desktop and mobile, then open the visual builder if the palette, typography, spacing, or sections need adjustment.
02
Download DESIGN.md
Save it in the repository root. It contains readable design rules plus the versioned machine-readable DesignBrief.
03
Connect your agent
Add the generated integration snippet to AGENTS.md, CLAUDE.md, or GEMINI.md so the agent explicitly reads the design system.

DESIGN.md is a OneLiners convention. The included integration file explains exactly how to use it with your selected agent.

Export pack

Start with DESIGN.md, then take only the extras you need

The main download is human-readable Markdown. JSON is available only as an optional design-token file.

Agent integration

DESIGN.md

Product direction, semantic palette, typography, layout, responsive behavior, accessibility, and an importable DesignBrief.

3411 bytes · Markdown

Download DESIGN.md

View generated DESIGN.md

# Editorial technology blog

## Product direction

- **Page type:** documentation
- **Layout archetype:** editorial
- **Audience:** Technical readers following long-form analysis
- **Goal:** Make a featured story irresistible while keeping the archive easy to scan.
- **Tone:** Editorial, informed, and human

## Visual system

- Use the semantic palette below; never use color without meaning.
- Heading: Inter, ui-sans-serif, system-ui, sans-serif; body: Inter, ui-sans-serif, system-ui, sans-serif; code: JetBrains Mono, ui-monospace, monospace.
- Density is spacious; base radius is 2px; shadows are subtle.
- Icons: Lucide-style outline icons with consistent 1.75px strokes.
- Imagery: Use product-specific imagery only when it explains the workflow; never use decorative filler..

## Semantic palette

| Role | Value | Intended use |
| --- | --- | --- |
| Background | `#f4efe7` | Page canvas and the deepest application layer |
| Surface | `#fffaf2` | Cards, panels, navigation, and raised regions |
| Text | `#211f1b` | Primary copy, labels, and high-emphasis content |
| Muted | `#756f65` | Secondary copy, metadata, and inactive controls |
| Accent | `#d1492e` | Primary actions, focus, selection, and active state |
| Success | `#3c7a57` | Confirmed success and healthy state |
| Warning | `#a66b16` | Caution, pending review, and non-blocking risk |
| Danger | `#b5382f` | Errors, destructive actions, and blocking risk |

The optional `design-tokens.css` from the full export pack mirrors these values. This `DESIGN.md` remains complete when used on its own.

## Layout and content

1. Cover story
2. Latest essays
3. Field notes
4. Author desk
5. Newsletter

## Responsive and accessibility

- Collapse sidebars into an explicit drawer and preserve the primary task before secondary metadata..
- Meet WCAG AA contrast, preserve visible focus, and respect reduced motion.
- Do not reduce essential content or actions on mobile.

## Machine-readable OneLiners DesignBrief

<!-- oneliners-design-brief:v1 -->
```json
{
  "schemaVersion": "1",
  "name": "Editorial technology blog",
  "pageType": "documentation",
  "layoutStyle": "editorial",
  "audience": "Technical readers following long-form analysis",
  "goal": "Make a featured story irresistible while keeping the archive easy to scan.",
  "tone": "Editorial, informed, and human",
  "palette": {
    "background": "#f4efe7",
    "surface": "#fffaf2",
    "text": "#211f1b",
    "muted": "#756f65",
    "accent": "#d1492e",
    "success": "#3c7a57",
    "warning": "#a66b16",
    "danger": "#b5382f"
  },
  "typography": {
    "heading": "Inter, ui-sans-serif, system-ui, sans-serif",
    "body": "Inter, ui-sans-serif, system-ui, sans-serif",
    "mono": "JetBrains Mono, ui-monospace, monospace",
    "baseSize": 16,
    "scale": 1.2
  },
  "density": "spacious",
  "radius": 2,
  "shadow": "subtle",
  "sections": [
    "Cover story",
    "Latest essays",
    "Field notes",
    "Author desk",
    "Newsletter"
  ],
  "iconStyle": "Lucide-style outline icons with consistent 1.75px strokes",
  "imagery": "Use product-specific imagery only when it explains the workflow; never use decorative filler.",
  "mobileStrategy": "Collapse sidebars into an explicit drawer and preserve the primary task before secondary metadata.",
  "accessibility": {
    "contrastTarget": "WCAG AA",
    "reducedMotion": true,
    "visibleFocus": true
  }
}
```

Real example

Input

documentation: Make a featured story irresistible while keeping the archive easy to scan.

Expected result

A spacious documentation using #d1492e as the semantic accent and 5 defined sections.

Source evidence

Web Content Accessibility Guidelines 2.2official MDN responsive designofficial