Example

Turn rough notes into a structured spec

Paste a Slack dump or a half-written brief. Get a first-draft spec you can paste into Confluence. Not the official record.

Notes you paste

Partner login on the customer portal.

Problem: staff share one password for the vendor portal. Security flagged it. Sales wants “sign in with your company” for US customers first.

Users: customer admins at mid-market accounts. They already have Okta or Azure AD.

Must: keep email/password for staff. Session length same as today. If the IdP is down, show a clear error, don’t lock them out of password login.

Out of scope: customer-facing mobile app, EU tenants this quarter.

Open: who owns the security questionnaire? Do we need SCIM in v1?

First draft

# Partner SSO on the customer portal

## Problem / Opportunity
Staff share one portal password. Security flagged it. Sales wants company sign-in for US customers first.

## Users & Context
Customer admins at mid-market accounts. They already have Okta or Azure AD.

## Functional Requirements
- Keep email/password for staff.
- Session length matches today.
- IdP outage must not block password login.

## Non-Goals
Mobile app. EU tenants this quarter.

## Open Questions
Who owns the security questionnaire? Is SCIM in v1?

Fake example — no real systems. Review before anything official.