Get your team aligned
before anyone starts building.
Publish a spec, share a link. Teammates leave structured feedback, AI revises the doc, you approve — and it commits back to GitHub.
How it works
Publish
Run alignspec publish spec.md from your terminal. Your spec goes live and you get a share URL.
✓ Published → alignspec.io/d/k8x2m
Review
Share the link in Slack. Teammates open it, sign in with GitHub, and leave typed comments on each section.
Approve
Triage feedback, generate an AI revision that addresses every comment. Accept — and the approved spec commits back to your repo.
→ Committed to main
The review experience
Token Strategy
Access tokens expire after 60 minutes. Refresh tokens are single-use and rotate on each refresh. Revoked tokens are stored in a blocklist checked on every authenticated request.
60 minutes is too long for access tokens in a financial app. Can we cap at 15 minutes?
Session Storage
Sessions are stored server-side in Redis with a 7-day TTL. Client receives an opaque session ID in an httpOnly cookie.
What happens when Redis is unavailable? Do we fall back to JWT-only?
Reviewers see formatted prose — not raw markdown. No install required.
Features
Structured feedback
Four comment types — Change Request, Question, Suggestion, Decision — keep reviews focused and actionable.
AI revision
Claude reads every comment, proposes a revision with a change summary citing each piece of feedback.
GitHub native
Accepting a revision commits directly to your repo. No manual copy-paste, no extra push step.
Link-based access
Share a URL. Any GitHub collaborator on the repo can view and comment — no invite system needed.
Section-level comments
Feedback attaches to specific spec sections. Comments stay anchored even across revisions.
Status lifecycle
Specs move from Open → In Review → Approved. Everyone knows where things stand at a glance.
Developer experience
Get started in 30 seconds.
Install the CLI, log in, publish your first spec.
Works with Claude Code, Cursor, and any terminal.
Stop building from specs nobody reviewed.
Alignspec makes spec review as fast as sharing a link.