Skip to content

FEATURES.md — the feature inventory from #1536, as a standing document - #1587

Merged
brillout merged 1 commit into
mainfrom
claude/extract-features-md-urzm5k
Aug 18, 2026
Merged

FEATURES.md — the feature inventory from #1536, as a standing document#1587
brillout merged 1 commit into
mainfrom
claude/extract-features-md-urzm5k

Conversation

@brillout

Copy link
Copy Markdown
Member

The user-facing feature inventory written for the simplification review lived in TODO_SIMPLIFY.md and was deleted with it at the end of #1536. This extracts it as a standalone root document, FEATURES.md.

What was extracted, and from where

The source is Part 2 — "Every user-facing feature, and its verdict" at its last revision before the file was deleted (commit 4e160c9b, the parent of the deletion commit 2c1d66a7). The section structure and per-feature phrasing are carried over as they were.

What changed in the extraction

A standing FEATURES.md should describe the product as it is, and the review's verdicts have all landed — so the file is the inventory with its own verdicts applied, checked against the current code rather than copied blind:

  • The 47 Remove entries are gone, since their features are. The verdict and proposal-ref columns go with them — every surviving row would read "Keep".
  • Simplify verdicts are folded into the phrasing: one preference tier plus the repo file (B5), one gate shape (D6, from turn-gate.SPEC.md), the foreground-only CLI with four options and no verbs (D4/D4b, from cli.SPEC.md).
  • Vocabulary follows the D5 rename: the unit of work is an agent, the CLI driving it is the driver — matching today's dashboard labels and specs.
  • Three rows merged where the product merged: --help/--version joined --host/--port in one CLI-options row; "Import tickets from GitHub" is part of "Update from GitHub" (an empty tickets/ gets a full first import, per preset-catalog.SPEC.md — the catalog is 15 entries now, not 16); --context folded into the composer's @ triggers, which are that feature's surface now.
  • The tally is therefore 123 features (the original counted 173, of which 119 Keep + 7 Simplify = 126 survivors; the three merges above account for the difference).

The "What a user loses, stated plainly" section was not carried over — it documents the review's removals, which is #1536's record rather than a description of the product. The file ends with a provenance line pointing back to #1536.

Verification

Every row that the review changed was checked against the current source before being reworded: the CLI options (cli.SPEC.md), the single gate shape (turn-gate.SPEC.md), the handoff ladder defaulting to a PR (handoff-level.SPEC.md), the preset catalog (preset-catalog.ts — 15 entries), the routine rotation plus drain and maintenance jobs (auto-pm.ts), locations local/actions/web (agent-location.ts), personal and project-shared custom presets (project-presets.SPEC.md), and the agent actions menu (AgentActionsMenu.tsx).

🤖 Generated with Claude Code

https://claude.ai/code/session_017UiUhF9k34SRYiZuC4ubQG


Generated by Claude Code

The user-facing feature inventory written for the simplification review
(TODO_SIMPLIFY.md, #1536) was too good to lose with the file it lived in.
This restores it as a standing root document, updated to the product the
review left behind: the entries whose verdict was Remove are gone with
their features, the Simplify verdicts are folded into the phrasing, and
the vocabulary follows the D5 rename (agent / driver / location).

Co-Authored-By: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017UiUhF9k34SRYiZuC4ubQG
@brillout
brillout merged commit 22ce270 into main Aug 18, 2026
1 of 2 checks passed
@brillout
brillout deleted the claude/extract-features-md-urzm5k branch August 18, 2026 16:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants