Documentation

Edit View

Feature tree and detail editing.

The Edit view is a two-pane layout: feature tree on the left and feature detail on the right.

Feature tree (left panel)

Your feature hierarchy with state indicators:

  • Proposed: Idea in backlog
  • Blocked: Waiting on dependencies
  • In progress: Currently being worked
  • Implemented: Complete
  • Archived: Soft-deleted

Click to select. Drag features to reparent them within the tree. Right-click for context menu.

Context menu actions

For normal features:

  • Add Child Feature: Create a new feature under this one (making it a feature set)
  • Wrap in Group: Create a new parent feature and move selected features under it
  • Create Group: Create an empty feature set under this one
  • Archive: Soft-delete the feature

For archived features:

  • Restore: Return the feature to proposed state
  • Delete Permanently: Remove from database (cannot be undone)

Feature sets

Features with children are called feature sets. They organize related features into groups. When you add a child to a leaf feature, it becomes a feature set.

Feature detail (center panel)

The center panel shows the selected feature with three tabs:

  • View: Rendered markdown preview of the feature spec
  • Edit: Title, state, and a markdown editor for details
  • Diff: Review and accept or discard proposed changes (from agent desired_details)

Feature details format

Use markdown in the details field:

## User story
As a user, I can sign in with my Google account.

## Acceptance criteria
- [ ] Google OAuth button on login page
- [ ] Creates account on first login
- [ ] Links to existing account if email matches

## Technical notes
- Use passport-google-oauth20
- Store refresh tokens securely