Skip to main content

From Description to Issues

Start with a general functional description. It should explain the user, the goal, the important behavior, and the constraints. It does not need to contain implementation details yet.

Example:

# Functional Description

Build a product overview page for internal users.

Users must be able to:

- see active products
- search by product name or SKU
- filter by stock status
- open the product detail page

The page must follow existing React, testing, accessibility, and domain modeling skills.

The AI can turn this rough description into smaller user stories. Each story should describe one user goal and one clear outcome.

Example:

## Generated User Stories

1. As an internal user, I want to see active products so that I can inspect the current catalog.
2. As an internal user, I want to search products by name or SKU so that I can find a product quickly.
3. As an internal user, I want to filter products by stock status so that I can focus on available or unavailable products.
4. As an internal user, I want to open a product detail page so that I can inspect all product information.

After the stories are clear, the AI can propose the functions needed for each story. These functions are not final code; they are a planning tool that makes the issue smaller and easier to test.

Example:

## Functional Breakdown

### Product list

- `getActiveProducts()`
- `mapProductToOverviewItem(product)`
- `renderProductOverviewList(items)`

### Search

- `normalizeProductSearchTerm(value)`
- `filterProductsBySearch(products, term)`

### Stock filter

- `filterProductsByStockStatus(products, status)`
- `getStockStatusLabel(status)`

The final output of this step is a proposed issue list. Each issue should be small enough to implement, test, review, and merge independently.

Example:

ISSUE-1.md  Define product overview model
ISSUE-2.md  Load active products
ISSUE-3.md  Add product search
ISSUE-4.md  Add stock status filter
ISSUE-5.md  Render product overview page
ISSUE-6.md  Add product overview stories and tests

Mini Exercise​

Write a five-line functional description for a feature in your own project. Ask an AI to generate user stories, function groups, and a first ISSUE-n.md list.