manage-features

Manage Features

Create, group, and rearrange Switchboard features. This skill consolidates four feature-management operations into one discoverable skill:

• Create — write a feature file directly (remote-session fallback when the extension is not running).
• Create from Plans — create a feature from a known set of plans via create-feature.js (extension running).
• Group — scan pre-coding columns, cluster loose plans by capability, propose groupings for one approval, then create features.
• Rearrange — restructure a feature's subtasks (split/move/merge/reorder) without rewriting their content.

When a directive says "invoke the manage-features skill and follow the Create from Plans section", jump to that section below.

---

Create

Create a Switchboard feature by writing the feature file directly to .switchboard/features/. Use this section when you are in a remote session (Claude Code web, claude.ai) and the VS Code extension is not running — create-feature.js routes through the extension's LocalApiServer and has no direct-DB fallback, so it fails when the extension is unreachable.

When to Use

• You are in a remote session (no VS Code extension running).
• The user asks to create a new feature (grouping plans together, or a standalone feature).
• Do NOT use this section if the extension IS running — call create-feature.js instead (it's authoritative: does DB upsert, subtask linking, file write, and board refresh atomically).

How to Detect Whether the Extension Is Running

1. Check for .switchboard/api-server-port.txt in the workspace root.
2. If present and the health endpoint responds (GET http://127.0.0.1:{port}/health), the extension is live — use create-feature.js.
3. If absent or health check fails, proceed with direct file write.

Feature File Format

Feature files live in .switchboard/features/ and follow this structure:

---
description: '{Feature Name}'
---

# {Feature Name}

## Goal

{Description of what this feature achieves and why it matters.}

## How the Subtasks Achieve This

{Narrative connecting the subtasks to the goal. Written once by the agent;
preserved by _regenerateFeatureFile on subsequent subtask changes.}

<!-- BEGIN SUBTASKS (auto-generated, do not edit) -->
## Subtasks
- [ ] (no subtasks)
<!-- END SUBTASKS -->