# Product Requirements Document With Edge Cases

Source: https://maito.app/workflows/write-a-spec-with-the-edge-cases

Maito turns a feature idea into a spec that includes the edge cases your code already handles, plus the open decisions for the product lead.

Turn a feature idea into a spec that includes the cases the code already handles.

[Product](https://maito.app/workflows/team/product) · [Software](https://maito.app/workflows/industry/software) · When you ask · Updated October 19, 2026

Works with

-   Slack
-   Email
-   Notion
-   [Confluence](https://maito.app/workflows/tool/confluence)
-   Box

## How do you write a product requirements document with edge cases?

To write a product requirements document with edge cases, send Maito the feature idea. It reads your code to find behavior the feature has to respect, such as cascading deletes, writes the flows and edge cases, lists decisions that need an owner, and attaches the spec. It can also read your Notion, Confluence or Box docs.

## How it's done today

Specs miss cases engineers find mid-build.

## What Maito does

1.  Read the idea
2.  Check the current product behavior
3.  Draft goals, flows, edge cases and open questions

## Example

**Leo** (2:05 PM):

Write a spec for archiving projects.

**Maito** (2:11 PM):

Draft attached: archive-projects-spec.pdf. It has 4 flows (archive, view archived, restore, auto-archive after 90 days idle), 9 edge cases and 3 decisions for you.

One edge case the code already handles that specs usually miss: deleting a project cascades to its 6 webhook subscriptions. An archived project would keep firing them unless we pause them too. Other cases I wrote up:  
• Archiving a project with open invites  
• A user who is the only admin of an archived project  
• Restoring when the project name was reused

**Decisions for you**  
• Do archived projects count toward the seat limit?  
• Can editors archive, or only admins?  
• Should restoring be unlimited?

I read the current project code and the permissions in the Notion roles page.

**Leo** (2:30 PM):

Admins only, not counted toward seats, unlimited restores.

**Maito** (2:32 PM):

Updated the spec with all three and removed the open questions. Version 2 attached.

## How to set it up

When you ask Write a spec with the edge cases

Set up

Nothing to set up. Ask in Slack or by email whenever you need it.

Connect docs

-   Notion
-   Confluence
-   Box

Not connected yet? Your agent sends you a link to sign in.

## What it won't do

The spec covers what it finds in code and docs. Customer needs, priority and scope remain the product lead's call.

## Questions

### How does it find edge cases?

By reading what the code already does, for example what happens on delete, invite or permission changes, not from a generic checklist.

### Can it use our existing docs?

Yes. It reads Notion, Confluence or Box pages for background and follows your template if you share it.

### Does it make the product decisions?

No. It lists them as open questions for you to answer.

## More product workflows

-   [Answer "what happens if we change X?" Know what a change would touch before you put it on the roadmap. Product · When you ask Works with Slack, Email.](https://maito.app/workflows/answer-what-happens-if-we-change-x)
-   [Build a quick prototype See an idea working on a branch before committing the team to it. Product · When you ask Works with Slack, Email.](https://maito.app/workflows/build-a-quick-prototype)
-   [Group user feedback into themes See what users ask for most, with counts and quotes. Product · On a schedule Works with Intercom, Pylon, Granola, Fireflies, SurveyMonkey.](https://maito.app/workflows/group-user-feedback-into-themes)
-   [Investigate a drop in a metric When sign-ups or activation drop, get a first answer on why. Product · When you ask Works with Amplitude, Mixpanel, Datadog, Sentry.](https://maito.app/workflows/investigate-a-drop-in-a-metric)
-   [Write release notes customers will read Turn the engineering changelog into plain notes for customers. Product · When something happens Works with Slack, Email.](https://maito.app/workflows/write-release-notes-customers-will-read)
-   [Prep for a customer interview Know the customer's usage and history before the interview. Product · When you ask Works with Amplitude, Mixpanel, Intercom, Pylon, HubSpot, Salesforce.](https://maito.app/workflows/prep-for-a-customer-interview)

[See all workflows](https://maito.app/workflows)

## Put your AI teammate to work.

Set it up in minutes. Start with this one, and let it earn the next one.

[Put Maito to work](https://maito.app/login?returnTo=%2Fworkflows%2Fwrite-a-spec-with-the-edge-cases)[Book a demo](mailto:support@maito.app?subject=Maito%20demo)