Functional Specification (FS)

The Functional Specification (FS) describes how the product’s features are organized and how they work in detail. It breaks down the system into three levels — Requirements → Features → Specifications to design how the product works in detail. The FS also serves as the foundation for Information Architecture (IA).

Two viewing modes are available:

  • Tree View – visualize the overall structure at a glance.

  • Directory View – manage detailed policies and descriptions efficiently.

1. Understanding the Structure

The Functional Specification consists of three levels: Requirements → Features → Detailed Specifications

Requirement

Represents the high-level goals or user needs of the project.

e.g., “Member Management,” “Payment & Billing”

Acceptance Criteria

  • Define the conditions or policies that must be satisfied for the requirement to be considered complete, typically in checklist form.

  • e.g., “Users can sign up via email,” “Menu layout changes depending on user role”

Feature

Represents a specific function that fulfills a requirement.

e.g., “Sign Up,” “Document Sharing,” “Payment Management”

User Role

  • You can assign a responsible role to each feature, using the roles defined in the PRD.

  • e.g., “Planner,” “Manager,” “Guest”

Importance

  • Set the priority or importance of each feature. (Low / Medium / High)

Specification

Defines the specific actions or policies within each feature.

e.g., “Email Sign-Up,” “Change Password,” “Session Management”

circle-check

2. Switching Views

You can switch between different viewing modes using the toolbar buttons at the bottom of the FS tab.

Tree View

Get a full view of the functional hierarchy at a glance. Requirements, features, and specifications are displayed as connected nodes. This view is useful when you want to quickly understand the overall structure or review relationships between features.

Directory View

Explore and manage items step by step. The hierarchy — Requirement → Feature → Specification — is displayed as a structured list. Selecting an item opens detailed information on the right panel, where you can review and edit it. Edits to Acceptance Criteria or assigned user roles are made in the Directory View.

3. Adding & Editing

Editing in Tree View

  1. Select a node and click the edit (✏️) icon at the top to enter edit mode. You can also double-click the node to edit it.

  2. Editable fields vary by node type:

    1. Requirement – name, description

    2. Feature – name, importance, user role

    3. Specification – name only

  3. To add a new child node, select a node and click the “+” button that appears on the right.

circle-check

Editing in Directory View

  1. Click the “+” button at the top of each section (Requirement / Feature / Specification) to add a new item.

  2. Double-click any list item to rename it.

  3. Select an item to edit its name, description, and detailed info in the right panel.

  4. Use the Edit or Delete buttons on the right to manage items. When deleting, note that all sub-items will also be removed.

circle-check

4. Ask AI

  1. Click the '+' button on the left side of an item, then use the 'Generate with AI' feature to create sub-items.

  2. When the AI updates an item, a blue highlight icon appears in the Tree View. Click it to preview the changes in the Directory View.

  3. Review and approve / reject each change, or approve / reject all at once using the buttons at the bottom.

  4. Click the chat icon on the left panel to open the AI assistant and discuss revisions directly.

  5. While selecting items in the Tree or Directory View, you can provide context to the chat so the AI follows more precise instructions.

circle-exclamation

Last updated