# w3dev specs

> Registry of software specifications tracked and adopted by w3dev.

- [Agent Skills](https://spec.w3dev.app/specs/agent-skills/): SKILL.md folders package reusable, on-demand expertise (instructions, scripts, resources) that agents load only when triggered.
- [Agent Task Planning](https://spec.w3dev.app/specs/agent-task/): Convention for an AI agent to turn a user objective into one implementation-ready epic of small task files under .agents/tasks/.
- [AGENTS.md](https://spec.w3dev.app/specs/agents-md/): Open-format README-for-agents file giving AI coding agents build, test, and convention context, read by 30+ coding tools.
- [Conventional Commits](https://spec.w3dev.app/specs/conventional-commits/): Structured commit message format (type(scope): message) enabling automated changelogs and semver bumps.
- [EditorConfig](https://spec.w3dev.app/specs/editorconfig/): A .editorconfig file at repo root defines indentation, line endings, charset, and trailing-whitespace rules across editors.
- [Environment Variables](https://spec.w3dev.app/specs/env-vars/): 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.
- [JSON Schema](https://spec.w3dev.app/specs/json-schema/): Declarative vocabulary for describing and validating the shape of JSON documents — configs, API payloads, frontmatter.
- [Keep a Changelog](https://spec.w3dev.app/specs/keep-a-changelog/): Human-readable CHANGELOG.md convention: grouped Added/Changed/Fixed entries per version, newest first, for every release.
- [llms.txt](https://spec.w3dev.app/specs/llms-txt/): Plain-markdown site index at /llms.txt that gives LLMs and agents a concise, links-first map of a site's content.
- [Model Context Protocol](https://spec.w3dev.app/specs/mcp/): Open JSON-RPC protocol standardizing how LLM applications connect to external tools, data sources, and prompts.
- [Pull Request Conventions](https://spec.w3dev.app/specs/pr-conventions/): Every PR includes a Manual Testing Guide, splits large work into focused stacked PRs, follows branch/title conventions, and never bypasses commit hooks.
- [Repository Layout](https://spec.w3dev.app/specs/repo-layout/): Canonical top-level structure for w3dev repos: root agent docs, docs/, scripts/, .github/workflows, pnpm, monorepo apps/packages.
- [Sandbox Environments](https://spec.w3dev.app/specs/sandbox/): Draft convention for isolated per-branch/per-PR sandbox environments: naming, provisioning, teardown, and how agents request one.
- [Semantic Versioning](https://spec.w3dev.app/specs/semver/): MAJOR.MINOR.PATCH version scheme where each segment's bump signals breaking, additive, or fix-only changes.
- [Work Chat](https://spec.w3dev.app/specs/work-chat/): Draft convention for human/agent work communication: where updates post, threading, notification etiquette, and the structured status message shape.