Developer Tools Directory

Folder Structure

Canonical repository layout for plugins and MCP servers

Plugin Manifest

plugin.json specification and required fields

CI/CD

GitHub Actions workflows every repo must have

GitHub Pages

Documentation site setup and deployment

Commit Conventions

Conventional commits and version bumping rules

README Template

Standard README structure and required sections

AGENTS.md Template

AI agent guidance file structure

Versioning

Semver management and automated release flow

Release Doc Sync

Composite action contract for keeping CHANGELOG, CLAUDE, and ROADMAP in sync after a release

Testing

Test frameworks, minimum coverage bar, and CI wiring

Skills

SKILL.md structure and frontmatter conventions

Rules

.mdc structure, globs, and the secrets rule pattern

MCP Server

Tool naming, runtime, transport, and destructive operation handling

Security

Vulnerability disclosure, secrets handling, and workflow supply chain

Licensing

DCO + inbound license grant model

Scope

What belongs in the directory and what does not

Born-Green Contract

Acceptance criterion that any generator must produce a release-ready repo

Lifecycle

Tool status transitions from experimental to archived

Writing Style

Prose conventions across all repos