Skip to content
Navigation Menu
Sign in
Appearance settings
Platform
AI CODE CREATION
GitHub Copilot
Write better code with AI
GitHub Copilot app
Direct agents from issue to merge
MCP Registry
Integrate external tools
DEVELOPER WORKFLOWS
Actions
Automate any workflow
Codespaces
Instant dev environments
Issues
Plan and track work
Code Review
Manage code changes
Code Quality
Enforce quality at merge
APPLICATION SECURITY
GitHub Advanced Security
Find and fix vulnerabilities
Code security
Secure your code as you build
Secret protection
Stop leaks before they start
EXPLORE
Why GitHub
Documentation
Blog
Changelog
Marketplace
View all features
Solutions
BY COMPANY SIZE
Enterprises
Small and medium teams
Startups
Nonprofits
BY USE CASE
App Modernization
DevSecOps
DevOps
CI/CD
View all use cases
BY INDUSTRY
Healthcare
Financial services
Manufacturing
Government
View all industries
View all solutions
Resources
EXPLORE BY TOPIC
AI
Software Development
DevOps
Security
View all topics
EXPLORE BY TYPE
Customer stories
Events & webinars
Ebooks & reports
Business insights
GitHub Skills
SUPPORT & SERVICES
Documentation
Customer support
Community forum
Trust center
Partners
View all resources
Open Source
COMMUNITY
GitHub Sponsors
Fund open source developers
PROGRAMS
Security Lab
Maintainer Community
GitHub Stars
Archive Program
REPOSITORIES
Topics
Trending
Collections
Enterprise
ENTERPRISE SOLUTIONS
Enterprise platform
AI-powered developer platform
AVAILABLE ADD-ONS
GitHub Advanced Security
Enterprise-grade security features
Copilot for Business
Enterprise-grade AI features
Premium Support
Enterprise-grade 24/7 support
Pricing
Search
/
Sign in
Sign up
Appearance settings
You signed in with another tab or window.
Reload
to refresh your session.
You signed out in another tab or window.
Reload
to refresh your session.
You switched accounts on another tab or window.
Reload
to refresh your session.
Dismiss alert
{{ message }}
Uh oh!
There was an error while loading.
Please reload this page
.
GovStackWorkingGroup
/
bb-template
Public template
Notifications
You must be signed in to change notification settings
Fork
2
Star
0
Code
Issues
2
Pull requests
4
Security and quality
0
Insights
Additional navigation options
Code
Issues
Pull requests
Security and quality
Insights
Add draft API design guide and conformance tooling
- #17
#17
Open
jeremi
wants to merge 21 commits into
GovStackWorkingGroup:main
GovStackWorkingGroup/bb-template:main
from
jeremi:feat/api-design-guide-linter
jeremi/bb-template:feat/api-design-guide-linter
Copy head branch name to clipboard
Conversation
Commits
21
(21)
Checks
Files changed
Open
Add draft API design guide and conformance tooling
#17
jeremi
wants to merge 21 commits into
GovStackWorkingGroup:main
GovStackWorkingGroup/bb-template:main
from
jeremi:feat/api-design-guide-linter
jeremi/bb-template:feat/api-design-guide-linter
Copy head branch name to clipboard
Commits
Commits on Jul 10, 2026
docs: add cross-BB API design guide (draft) as standalone GitBook
Show description for fed99cb
jeremi
committed
fed99cb
View commit details
Copy full SHA for fed99cb
Browse repository at this point
feat: add GovStack Spectral ruleset and API lint tooling
Show description for 6ad82fc
jeremi
committed
6ad82fc
View commit details
Copy full SHA for 6ad82fc
Browse repository at this point
Commits on Aug 4, 2026
docs: extend API design guide to 171 rules
Show description for c1c9544
jeremi
committed
c1c9544
View commit details
Copy full SHA for c1c9544
Browse repository at this point
feat: add reference API example and vendored common components
Show description for fbf09af
jeremi
committed
fbf09af
View commit details
Copy full SHA for fbf09af
Browse repository at this point
feat: extend Spectral ruleset to 130 rules and add surface discovery
Show description for 35101e4
jeremi
committed
35101e4
View commit details
Copy full SHA for 35101e4
Browse repository at this point
docs: rewrite BB spec template around a reference example
Show description for 071dd12
jeremi
committed
071dd12
View commit details
Copy full SHA for 071dd12
Browse repository at this point
fix: repoint reverse-DNS namespace to global.govstack and docs to govstack.global
Show description for 2bb0111
jeremi
committed
2bb0111
View commit details
Copy full SHA for 2bb0111
Browse repository at this point
docs: stop citing an unpublished cross-BB audit as the evidence base
Show description for baed8c0
jeremi
committed
baed8c0
View commit details
Copy full SHA for baed8c0
Browse repository at this point
fix: qualify AsyncAPI 3.1.0 alongside 3.0.0 in 3.1
Show description for e013106
jeremi
committed
e013106
View commit details
Copy full SHA for e013106
Browse repository at this point
fix: state 17.4 against the AsyncAPI 3 Parameter Object
Show description for 98d1146
jeremi
committed
98d1146
View commit details
Copy full SHA for 98d1146
Browse repository at this point
fix: carve out of 9.7 the enum values other rules mandate
Show description for 19fd76d
jeremi
committed
19fd76d
View commit details
Copy full SHA for 19fd76d
Browse repository at this point
fix: exempt the 5.9 operational endpoints from 5.1 and 18.2
Show description for 4ab4365
jeremi
committed
4ab4365
View commit details
Copy full SHA for 4ab4365
Browse repository at this point
fix: reconcile guide rules with the immutable cross-functional requirements
Show description for 9d1ab6d
jeremi
committed
9d1ab6d
View commit details
Copy full SHA for 9d1ab6d
Browse repository at this point
docs: point the shipped rulesets at conventions an adopter can reach
Show description for c158081
jeremi
committed
c158081
View commit details
Copy full SHA for c158081
Browse repository at this point
fix: make the event-signing and common-error rules satisfiable
Show description for 3ddd28d
jeremi
committed
3ddd28d
View commit details
Copy full SHA for 3ddd28d
Browse repository at this point
fix: close the gaps an external adopter hit applying the guide
Show description for 1522904
jeremi
committed
1522904
View commit details
Copy full SHA for 1522904
Browse repository at this point
Commits on Aug 6, 2026
Simplify API design guide and template contracts
Show description for 85f7e7e
jeremi
committed
85f7e7e
View commit details
Copy full SHA for 85f7e7e
Browse repository at this point
Simplify API guide conformance model
Show description for 30b6476
jeremi
committed
30b6476
View commit details
Copy full SHA for 30b6476
Browse repository at this point
Commits on Aug 10, 2026
Narrow API guide template integration
Show description for 8eb6b3e
jeremi
committed
8eb6b3e
View commit details
Copy full SHA for 8eb6b3e
Browse repository at this point
Commits on Sep 2, 2026
Document optional RFC 9727 discovery
Show description for 14de6eb
jeremi
committed
14de6eb
View commit details
Copy full SHA for 14de6eb
Browse repository at this point
Commits on Sep 10, 2026
Simplify API guide applicability and align conformance checks
Show description for 7264848
jeremi
committed
7264848
View commit details
Copy full SHA for 7264848
Browse repository at this point
You can’t perform that action at this time.
