bfd

Enforces Boundary-First Development rules during architecture, coding, and code review work.

1|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/ddnet-repo/boundary-first-development --skill bfd-ddnet-repo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bfd
Source: https://github.com/ddnet-repo/boundary-first-development/tree/main/skills/bfd
Command: npx skills add https://github.com/ddnet-repo/boundary-first-development --skill bfd-ddnet-repo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams following Boundary-First Development need every module, API, and frontend component to comply with a strict rule set (BFD-1 through BFD-33) covering contracts, sync, naming, state management, and release workflow. This Skill loads the complete rulebook into context so the AI designs, builds, and reviews code against those rules from the first line instead of catching violations in review. ## Core Features & Use Cases - Rule-driven building and review: Applies all 33 BFD rules during design and coding, and cites rule IDs (e.g., BFD-22) for every review finding. - Conformance verification: Guides use of the bfd conform CLI to deterministically check OpenAPI contracts, running APIs, lint gates, and git workflow discipline. - Lint gate setup: Provides canonical lint presets for Go (golangci), Python (ruff), and TS/JS (eslint) to satisfy BFD-17. - Use Case: A developer asks the AI to add a new API endpoint in a BFD project; the Skill ensures typed input/output structs, enumerated error codes, UTC timestamps, snake_case/camelCase translation, and a passing PR checklist before the work is declared done. ## Quick Start Tell the AI to follow BFD rules while designing and implementing a new backend endpoint with its contract, then verify the result with bfd conform.

Frequently Asked Questions about bfd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce Boundary-First Development rules in my project?

Activate the bfd Skill so the AI applies all 33 BFD rules while designing and coding, from contract structs to release workflow. Before declaring work done, run bfd conform from the repo root and check the six-question PR checklist.

What does the bfd conform CLI check?

bfd conform statically checks the project's OpenAPI contract, probes a running API with read-only GET requests, reads lint configs, and inspects the git graph for branch discipline and tagged releases. It proves rules BFD-2, 3, 7, 8, 11, 12, 13, 17, 18, 29, and 30-33.

How do I install the bfd conformance tool?

Install it with Go 1.24+ using go install codeberg.org/galaxi/boundary-first-development/cmd/bfd@latest, or pin it as a Go tool dependency with go get -tool. The binary lands in $(go env GOPATH)/bin, which may need to be added to PATH.

Which lint configs satisfy the BFD-17 lint gate rule?

Copy the canonical presets from the BFD repository: golangci.yml for Go, ruff.toml for Python, and eslint.config.mjs for TypeScript/JavaScript. Presets are floors, not ceilings — extend them but never trim the rule-annotated entries.

What are the limitations of automated BFD conformance checking?

bfd conform only proves wire-level and workflow rules; source-level rules are carried by lint gates, and design rules like BFD-13 plurals, BFD-28 name ordering, and any in Go parameters must be enforced by hand during review.