[
  {
    "id": "agent-skills",
    "title": "Agent Skills",
    "status": "official",
    "summary": "SKILL.md folders package reusable, on-demand expertise (instructions, scripts, resources) that agents load only when triggered.",
    "owner": "w3dev",
    "updated": "2026-08-22",
    "number": "0002",
    "canonical_url": "https://agentskills.io/specification",
    "maturity": "stable",
    "tags": [
      "ai-agents",
      "convention"
    ],
    "adopted_date": "2026-08-22",
    "related": [
      "agents-md"
    ],
    "url": "/specs/agent-skills/",
    "raw_url": "/specs/agent-skills/SPEC.md"
  },
  {
    "id": "agent-task",
    "title": "Agent Task Planning",
    "status": "unofficial",
    "summary": "Convention for an AI agent to turn a user objective into one implementation-ready epic of small task files under .agents/tasks/.",
    "owner": "w3dev",
    "updated": "2026-08-22",
    "number": "0015",
    "maturity": "experimental",
    "tags": [
      "ai-agents",
      "workflow",
      "convention"
    ],
    "applies_to": [
      "all"
    ],
    "related": [
      "agents-md",
      "agent-skills"
    ],
    "url": "/specs/agent-task/",
    "raw_url": "/specs/agent-task/SPEC.md"
  },
  {
    "id": "agents-md",
    "title": "AGENTS.md",
    "status": "official",
    "summary": "Open-format README-for-agents file giving AI coding agents build, test, and convention context, read by 30+ coding tools.",
    "owner": "w3dev",
    "updated": "2026-08-22",
    "number": "0001",
    "canonical_url": "https://agents.md",
    "maturity": "stable",
    "tags": [
      "ai-agents",
      "docs",
      "convention"
    ],
    "applies_to": [
      "all"
    ],
    "adopted_date": "2026-08-22",
    "url": "/specs/agents-md/",
    "raw_url": "/specs/agents-md/SPEC.md"
  },
  {
    "id": "conventional-commits",
    "title": "Conventional Commits",
    "status": "official",
    "summary": "Structured commit message format (type(scope): message) enabling automated changelogs and semver bumps.",
    "owner": "w3dev",
    "updated": "2026-08-22",
    "number": "0007",
    "canonical_url": "https://www.conventionalcommits.org/en/v1.0.0/",
    "version": "1.0.0",
    "maturity": "stable",
    "tags": [
      "git",
      "workflow",
      "tooling"
    ],
    "applies_to": [
      "all"
    ],
    "adopted_date": "2026-08-22",
    "related": [
      "semver",
      "keep-a-changelog"
    ],
    "url": "/specs/conventional-commits/",
    "raw_url": "/specs/conventional-commits/SPEC.md"
  },
  {
    "id": "editorconfig",
    "title": "EditorConfig",
    "status": "official",
    "summary": "A .editorconfig file at repo root defines indentation, line endings, charset, and trailing-whitespace rules across editors.",
    "owner": "w3dev",
    "updated": "2026-08-22",
    "number": "0009",
    "canonical_url": "https://editorconfig.org",
    "maturity": "stable",
    "tags": [
      "tooling",
      "formatting"
    ],
    "applies_to": [
      "all"
    ],
    "adopted_date": "2026-08-22",
    "url": "/specs/editorconfig/",
    "raw_url": "/specs/editorconfig/SPEC.md"
  },
  {
    "id": "env-vars",
    "title": "Environment Variables",
    "status": "unofficial",
    "summary": "NEXT_PUBLIC_ prefix for client-safe values, .env.local never committed, DATABASE_URL points at hosted neon.tech Postgres, secrets kept apart from plain config.",
    "owner": "w3dev",
    "updated": "2026-08-22",
    "number": "0012",
    "maturity": "stable",
    "tags": [
      "config",
      "security"
    ],
    "url": "/specs/env-vars/",
    "raw_url": "/specs/env-vars/SPEC.md"
  },
  {
    "id": "json-schema",
    "title": "JSON Schema",
    "status": "official",
    "summary": "Declarative vocabulary for describing and validating the shape of JSON documents — configs, API payloads, frontmatter.",
    "owner": "w3dev",
    "updated": "2026-08-22",
    "number": "0005",
    "canonical_url": "https://json-schema.org",
    "version": "2020-12",
    "maturity": "stable",
    "tags": [
      "api",
      "validation",
      "config"
    ],
    "adopted_date": "2026-08-22",
    "url": "/specs/json-schema/",
    "raw_url": "/specs/json-schema/SPEC.md"
  },
  {
    "id": "keep-a-changelog",
    "title": "Keep a Changelog",
    "status": "official",
    "summary": "Human-readable CHANGELOG.md convention: grouped Added/Changed/Fixed entries per version, newest first, for every release.",
    "owner": "w3dev",
    "updated": "2026-08-22",
    "number": "0008",
    "canonical_url": "https://keepachangelog.com",
    "version": "1.1.0",
    "maturity": "stable",
    "tags": [
      "docs",
      "release"
    ],
    "applies_to": [
      "all"
    ],
    "adopted_date": "2026-08-22",
    "related": [
      "semver",
      "conventional-commits"
    ],
    "url": "/specs/keep-a-changelog/",
    "raw_url": "/specs/keep-a-changelog/SPEC.md"
  },
  {
    "id": "llms-txt",
    "title": "llms.txt",
    "status": "official",
    "summary": "Plain-markdown site index at /llms.txt that gives LLMs and agents a concise, links-first map of a site's content.",
    "owner": "w3dev",
    "updated": "2026-08-22",
    "number": "0004",
    "canonical_url": "https://llmstxt.org",
    "maturity": "stable",
    "tags": [
      "ai-agents",
      "docs",
      "seo"
    ],
    "adopted_date": "2026-08-22",
    "url": "/specs/llms-txt/",
    "raw_url": "/specs/llms-txt/SPEC.md"
  },
  {
    "id": "mcp",
    "title": "Model Context Protocol",
    "status": "official",
    "summary": "Open JSON-RPC protocol standardizing how LLM applications connect to external tools, data sources, and prompts.",
    "owner": "w3dev",
    "updated": "2026-08-22",
    "number": "0003",
    "canonical_url": "https://modelcontextprotocol.io",
    "version": "2026-07-28",
    "maturity": "stable",
    "tags": [
      "ai-agents",
      "protocol",
      "api"
    ],
    "adopted_date": "2026-08-22",
    "url": "/specs/mcp/",
    "raw_url": "/specs/mcp/SPEC.md"
  },
  {
    "id": "pr-conventions",
    "title": "Pull Request Conventions",
    "status": "unofficial",
    "summary": "Every PR includes a Manual Testing Guide, splits large work into focused stacked PRs, follows branch/title conventions, and never bypasses commit hooks.",
    "owner": "w3dev",
    "updated": "2026-08-22",
    "number": "0014",
    "maturity": "stable",
    "tags": [
      "git",
      "workflow",
      "review"
    ],
    "related": [
      "conventional-commits"
    ],
    "url": "/specs/pr-conventions/",
    "raw_url": "/specs/pr-conventions/SPEC.md"
  },
  {
    "id": "repo-layout",
    "title": "Repository Layout",
    "status": "unofficial",
    "summary": "Canonical top-level structure for w3dev repos: root agent docs, docs/, scripts/, .github/workflows, pnpm, monorepo apps/packages.",
    "owner": "w3dev",
    "updated": "2026-08-22",
    "number": "0013",
    "maturity": "stable",
    "tags": [
      "convention",
      "structure"
    ],
    "applies_to": [
      "all"
    ],
    "url": "/specs/repo-layout/",
    "raw_url": "/specs/repo-layout/SPEC.md"
  },
  {
    "id": "sandbox",
    "title": "Sandbox Environments",
    "status": "draft",
    "summary": "Draft convention for isolated per-branch/per-PR sandbox environments: naming, provisioning, teardown, and how agents request one.",
    "owner": "w3dev",
    "updated": "2026-08-22",
    "number": "0010",
    "maturity": "experimental",
    "tags": [
      "infra",
      "dev-environment"
    ],
    "url": "/specs/sandbox/",
    "raw_url": "/specs/sandbox/SPEC.md"
  },
  {
    "id": "semver",
    "title": "Semantic Versioning",
    "status": "official",
    "summary": "MAJOR.MINOR.PATCH version scheme where each segment's bump signals breaking, additive, or fix-only changes.",
    "owner": "w3dev",
    "updated": "2026-08-22",
    "number": "0006",
    "canonical_url": "https://semver.org",
    "version": "2.0.0",
    "maturity": "stable",
    "tags": [
      "versioning",
      "release"
    ],
    "adopted_date": "2026-08-22",
    "related": [
      "conventional-commits",
      "keep-a-changelog"
    ],
    "url": "/specs/semver/",
    "raw_url": "/specs/semver/SPEC.md"
  },
  {
    "id": "work-chat",
    "title": "Work Chat",
    "status": "draft",
    "summary": "Draft convention for human/agent work communication: where updates post, threading, notification etiquette, and the structured status message shape.",
    "owner": "w3dev",
    "updated": "2026-08-22",
    "number": "0011",
    "maturity": "experimental",
    "tags": [
      "communication",
      "workflow"
    ],
    "url": "/specs/work-chat/",
    "raw_url": "/specs/work-chat/SPEC.md"
  }
]