UX Flow Plan

SkillFiles & storage

Lets your agent plan app UX as flow trees and then attach function names and files to each step.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the UX Flow Plan skill

About this capability

Create UX-first plans as flow trees, then attach concrete function names, files, and implementation anchors after the high-level flow is clear.

What this skill tells your AI

The instructions your AI receives, as published by trycompai/crm in .agents/skills/ux-flow-plan/SKILL.md and read by ahel’s review.

Create a high-level architecture plan that starts from the user experience and only then maps to code-level anchors.

Steps

  1. Restate the feature goal in product terms, using the user's language.

  2. Build the current-state UX flow as a tree:

    User action
    └─ System behavior
       └─ Existing architectural layer
          └─ Relevant function/file anchor
    
  3. Build the desired-state UX flow as a second tree:

    User action
    └─ System behavior
       └─ New or changed architectural layer
          └─ Relevant function/file anchor
    
  4. Identify the architectural boundary decisions:

    • Which layer detects the condition
    • Which layer owns side effects
    • Which layer updates UI/status
    • Which layer persists or mutates state
  5. Attach implementation anchors after the trees, not before:

    • Function names
    • File paths
    • Existing abstractions to reuse
    • Tests that should cover the flow
  6. End with a small decision list:

    • Recommended architecture
    • Alternatives rejected
    • Open questions or assumptions

Rules

  • Start with UX and system flow, not line numbers or code edits.
  • Use tree diagrams for flows whenever possible.
  • Keep function names and file paths attached as anchors, not as the main narrative.
  • Do not over-specify implementation details before the architectural boundary is clear.
  • Separate "current flow" from "desired flow".
  • Call out whether a feature is coupled to an existing concept or intentionally independent from it.
  • Prefer plain product and architecture language over framework-specific jargon unless the jargon names a real boundary.

Signals

GitHub stars
10k
Forks
1k
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
ux-flow-plan
Source
github.com/trycompai/crm