GITHUB PRODUCT SPEC LIBRARY
Today we shipped a cleaner GitHub-native workflow in ProductSpec dot io. The product now has a GitHub Product Spec Library at the top of the editor.
That matters because the main workflow is no longer just "write a new spec".
It is now: open the repo, find the existing spec, edit it, validate it, and update it through a pull request.
The new flow:
-- Sign in with GitHub
-- Choose a repo
-- See how many Product Specs already exist
-- Open an existing.product-spec.md file
-- Edit it in the ProductSpec dot io editor
-- Validate it against the open ProductSpec standard
-- Update it via pull request
ProductSpec dot io now treats GitHub as the durable home for Product Specs, while keeping the authoring experience clean for PMs, founders, designers, and product-minded engineers.
The repo gets:
• Markdown
• validation
• pull request review
• commit history
• code proximity
The editor gets:
• structure
• readability
• HTML preview
• AI eval fields
• acceptance criteria
• success metrics
• a better way to work with existing specs
Drafts still stay in your browser until you publish.
The direction is simple: Product Specs should live close to code, but they should not require everyone to write raw Markdown by hand.
ProductSpec dot io is free to use.
Try the new GitHub Product Spec Library at ProductSpec dot io. Pick one existing PRD, move it into GitHub as a.product-spec.md file, and make the next edit through a pull request.