Skip to content

docs: feature-flows.md index is 527 lines, over the 400-line guideline — condense #1360

Description

@AndriiPasternak31

Problem

docs/memory/feature-flows.md is the index of vertical-slice flow docs and is meant to stay minimal and navigable. The /sync-feature-flows skill (Step 6) flags the index when it exceeds 400 lines and asks for a condensation pass.

As of 2026-06-26 the index is 527 lines — ~32% over the guideline. This is a long-standing, accumulating condition: each new feature appends a verbose multi-sentence row to the Recent Updates table (which never gets pruned), in addition to its category-table row. Individual sync runs correctly keep their own additions to one row, but no pass ever condenses the backlog, so the index grows unbounded.

Why it matters

  • The index is loaded for navigation/orientation; a bloated index defeats its "minimal, navigable" purpose.
  • The Recent Updates rows duplicate detail that already lives in the linked flow docs (the index should point, not narrate).

Proposed fix

  1. Trim the Recent Updates table — cap it at the most recent N entries (e.g. last ~15–20); older rows are already discoverable via their category-table entry + the flow doc itself.
  2. Shorten Recent Updates descriptions to one line that points at the flow doc, moving the multi-sentence detail (where not already there) into the doc.
  3. Re-check line count is back under 400 after the pass.

Acceptance criteria

  • wc -l docs/memory/feature-flows.md < 400
  • No flow-doc link removed from the category tables (navigability preserved)
  • Recent Updates table retains a bounded, recent window with one-line entries

Context

Surfaced during the /sync-feature-flows run for #1332. Not blocking that work — the #1332 entry itself stayed to a single row. This is the standing index-hygiene follow-up.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions