w3dev specs

w3dev specs

A curated registry of software specifications — for humans and agents.

Not a tutorial. A registry.

15 specs · 9 official

Name
Status
Version
Tags
Updated
Links
Agent Skills spec-0002 · agent-skills SKILL.md folders package reusable, on-demand expertise (instructions, scripts, resources) that agents load only when triggered.
official
—
ai-agents convention
raw ↗
Agent Task Planning spec-0015 · agent-task Convention for an AI agent to turn a user objective into one implementation-ready epic of small task files under .agents/tasks/.
unofficial
—
ai-agents workflow convention
raw
AGENTS.md spec-0001 · agents-md Open-format README-for-agents file giving AI coding agents build, test, and convention context, read by 30+ coding tools.
official
—
ai-agents docs convention
raw ↗
Conventional Commits spec-0007 · conventional-commits Structured commit message format (type(scope): message) enabling automated changelogs and semver bumps.
official
1.0.0
git workflow tooling
raw ↗
EditorConfig spec-0009 · editorconfig A .editorconfig file at repo root defines indentation, line endings, charset, and trailing-whitespace rules across editors.
official
—
tooling formatting
raw ↗
Environment Variables spec-0012 · 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.
unofficial
—
config security
raw
JSON Schema spec-0005 · json-schema Declarative vocabulary for describing and validating the shape of JSON documents — configs, API payloads, frontmatter.
official
2020-12
api validation config
raw ↗
Keep a Changelog spec-0008 · keep-a-changelog Human-readable CHANGELOG.md convention: grouped Added/Changed/Fixed entries per version, newest first, for every release.
official
1.1.0
docs release
raw ↗
llms.txt spec-0004 · llms-txt Plain-markdown site index at /llms.txt that gives LLMs and agents a concise, links-first map of a site's content.
official
—
ai-agents docs seo
raw ↗
Model Context Protocol spec-0003 · mcp Open JSON-RPC protocol standardizing how LLM applications connect to external tools, data sources, and prompts.
official
2026-07-28
ai-agents protocol api
raw ↗
Pull Request Conventions spec-0014 · 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.
unofficial
—
git workflow review
raw
Repository Layout spec-0013 · repo-layout Canonical top-level structure for w3dev repos: root agent docs, docs/, scripts/, .github/workflows, pnpm, monorepo apps/packages.
unofficial
—
convention structure
raw
Sandbox Environments spec-0010 · sandbox Draft convention for isolated per-branch/per-PR sandbox environments: naming, provisioning, teardown, and how agents request one.
draft
—
infra dev-environment
raw
Semantic Versioning spec-0006 · semver MAJOR.MINOR.PATCH version scheme where each segment's bump signals breaking, additive, or fix-only changes.
official
2.0.0
versioning release
raw ↗
Work Chat spec-0011 · work-chat Draft convention for human/agent work communication: where updates post, threading, notification etiquette, and the structured status message shape.
draft
—
communication workflow
raw