Thenthe same items appear in the cart within 2 seconds
Drafting from the paragraph
Why a spec
Most features start as a paragraph in a ticket. The gaps in it show up in code review, or in production, when they cost the most to close. Shivo turns that paragraph into a spec your team can build from, and points at every sentence an engineer would have to guess at, before anyone writes a line.
Where a vague sentence gets caught
01In the spec
One sentence changes before anyone builds on it.
Shivo flags it here
02In code review
The pull request is reworked, then reviewed again.
03In production
A fix ships after people have already hit the gap.
Pick the document
Six documents, each with its own skeleton.
Choose what you are writing and Shivo drafts every section of it from your paragraph. Flip through the outlines it writes to.
PRD
templates/prd.mdPRD
Product Requirements Document
Define the problem, goals, users, and measurable requirements for a product or feature before a line of code is written.
01Executive Summary
02Problem Statement
03Goals & Success Metrics
04Target Users
05User Stories
06Functional Requirements
07Non-Functional Requirements
08Acceptance Criteria
09Risks & Mitigations
10Open Questions
10 sections, each drafted from your paragraph and linted.
TDD
templates/tdd.mdTDD
Technical Design Document
Document the architecture, data models, and trade-offs for an engineering effort so reviewers can reason about the build.
01Overview & Goals
02System Architecture
03Data Models
04API Specifications
05Sequence & Data Flow
06Performance Requirements
07Testing Strategy
08Monitoring & Observability
09Rollout Plan
9 sections, each drafted from your paragraph and linted.
Each requirement, mapped to the scenarios that prove it.
Shivo links every requirement to its Given, When, Then scenarios and marks what no scenario verifies yet. Pick a spec to see its map.
specs/saved-carts.md · 2 of 5 covered
40%coverage
2 covered
1 partial
2 uncovered
RequirementVerified by
FR-1Covered
Save the cart to the shopper's account
Cart saves after a change
Givena signed-in shopper with two items in their cart
Whenthey add a third item
Thenthe cart is saved to their account within 2 seconds
FR-2Covered
Restore the cart on any device
Cart follows the shopper
Givena shopper who saved a cart on their phone
Whenthey sign in on a laptop
Thenthe same items appear in the cart within 2 seconds
Carts merge without duplicates
Givena laptop cart with one item and a saved cart with two
Whenthe shopper signs in
Thenthe cart holds all three items
Andno item appears twice
FR-3Partial
Expire saved carts
Criteria exist, but the requirement is ambiguous and cannot be firmly verified.
Lint 65someshouldno measure
Expired cart explains itself
Givena saved cart that has expired
Whenthe shopper opens their cart
Thenthey see which items were removed
FR-4Uncovered
Remind before a cart expires
No acceptance criteria linked to this requirement.
Lint 66fewmayno measure
Gap
No Given, When, Then proves FR-4 yet. Shivo lists it here instead of letting it ship untested.
NFR-1Uncovered
Fast cart sync
No acceptance criteria linked to this requirement.
Lint 68fastno measure
Gap
No Given, When, Then proves NFR-1 yet. Shivo lists it here instead of letting it ship untested.
Covered
A scenario verifies it and the wording is testable.
Partial
A scenario exists, but vague wording keeps it from passing.
Uncovered
No scenario verifies it yet.
Review that converges
Request changes, ship a new version, approve.
Route the spec to a reviewer, argue in one thread and see exactly what changed between versions. Each version is scored, so the thread ends when the spec is ready.
specs/team-invites.md · v1.019 lines
1# Team invites
2
3## Problem
4Teams share one login to add people, so nobody can tell who changed what and access never gets removed.
5
6## Goals
7- Make invites easy to accept.
8- Reduce support tickets about shared logins.
9
10## Requirements
11- FR-1: Invite teammates by email. An admin enters one or more email addresses and the system sends each person an invite link within 1 minute.
12- FR-2: Accept an invite. The invited user sets a password and lands in the workspace with the default role in under 3 steps.
13- FR-3: Expire old invites. Invite links expire 7 days after they are sent, and an expired link offers a way to ask the admin for a new one.
14- FR-4: Resend or revoke an invite. An admin can resend or revoke any pending invite, and a revoked link stops working within 1 minute.
15- NFR-1: Reliable invite email. Invite emails should be reliable.
16
17## Out of scope
18- Single sign-on and SCIM provisioning
19- Custom roles
Review thread
In review
Completeness by version
Almost ready
0100
v1.082v1.1not written yet
You requested a reviewv1.0Ready for a look. The goals and the invite email are the parts I am least sure about.
Try both paths: approve now, or ask for changes first.
Pricing
Start free. Upgrade when it sticks.
Draft and lint for free. Pro adds the acceptance-criteria generator, the review workflow and saved history. Teams that need single sign-on or self-hosting talk to us.
Shivo turns a plain-English idea into a structured spec, including PRDs, technical design docs, RFCs, security specs, and one-pagers. It also lints requirements for ambiguity, testability, and completeness, generates Gherkin acceptance criteria, and supports a full review workflow with version diffs.
How does Shivo improve the quality of a spec?
Every requirement is scored for ambiguity, testability, and completeness, and Shivo flags the specific issues to fix. It also generates acceptance criteria so each requirement has a clear, testable definition of done, which catches vague or incomplete specs before engineering starts.
Can I edit specs and review them with my team?
Yes. Specs are fully editable, and you can route them for review, collect approvals or change requests through a comment thread, and compare what changed between versions with a side-by-side diff. Finished specs export to Markdown.
Is my spec content private?
Your specs, requirements, and comments are scoped to your account and encrypted at rest, and we never use your content to train models.
How much does Shivo cost?
The Free plan lets you generate specs from core templates and lint requirements with no credit card. Pro is $15 per month for unlimited generation, all templates, the acceptance-criteria generator, the review workflow, version diffs, Markdown export, and saved history. Enterprise is custom-priced with SSO, a self-host option, and dedicated support.
What exactly does the lint check?
Vague words such as fast, easy, secure or some; non-committal wording such as should, may or might; passive voice that hides who acts; requirements with no number, threshold or pass/fail condition; descriptions too thin to build from; and requirements with no clear subject. Each finding names the words that triggered it.
How is the completeness score worked out?
Three parts: the mean lint score of the requirements, the share of requirements fully covered by acceptance criteria, and the share of structure checks passed (a problem statement, measurable goals and an out-of-scope list). Completeness is 0.4 × lint + 0.4 × coverage + 0.2 × structure. The criteria sheet at the top of this page shows the math for each sample.
Can I look around before I sign up?
Yes. Try the demo from the sign-in page: it opens a seeded workspace with specs, requirements, reviews and templates, with no account and no API key.
Your next feature
Write the specbefore the code.
Paste a paragraph and get a PRD, its lint findings and acceptance criteria for every requirement. Core templates and the lint are free, with no credit card.