Sequence Flow
by stepanic
Sequence Flow is a Flutter application for visualizing and managing Hierarchical Task Networks (HTN). It enables users to model complex planning problems through a guided AI conversation and provides a visual representation of planning tasks.
Last updated: N/A
sequence-flow-experiment-with-desktop-commander
Fully AI generated Flutter app in Claude Desktop with 3.7 Sonnet by MCP servers desktop-commander and sequential-thinking
Sequence Flow - HTN Planning System
A Flutter application for visualizing and managing Hierarchical Task Networks (HTN).
Overview
Sequence Flow is an interactive HTN Planning System that enables users to model complex planning problems through a guided AI conversation. It provides a visual representation of planning tasks as a directed graph and supports hierarchical compression of subgraphs to manage complexity while preserving cross-boundary references.
Key Features
- Interactive Modeling: Guided AI conversation for complex planning problems
- Directed Graph Visualization: Planning tasks displayed as a directed graph with complex dependencies
- Hierarchical Compression: Compress subgraphs to manage complexity while preserving references
- Three-Column Interface: AI chat, interactive graph, and hierarchical task list
- Iterative Problem Solving: Dynamic question selection based on current planning state
- External Persistence: Prevents data loss from LLM context limitations
Project Structure
sequence_flow/
├── lib/
│ ├── behaviors/ # Implements HTN planning behaviors
│ ├── models/ # Data models for the application
│ │ └── entities/ # Core entity definitions
│ ├── screens/ # Application screens
│ ├── services/ # External service integrations
│ ├── utils/ # Utility functions and helpers
│ └── widgets/ # Reusable UI components
├── assets/ # Static assets (icons, images)
└── test/ # Unit and widget tests
Getting Started
Prerequisites
- Flutter (>= 3.6.1)
- Dart (>= 3.6.0)
- An IDE (VS Code, Android Studio, or IntelliJ)
Installation
-
Clone the repository:
git clone https://github.com/yourusername/sequence_flow.git cd sequence_flow
-
Install dependencies:
flutter pub get
-
Run the app:
flutter run
Core Components
Entities
- Task: The fundamental building block of HTN planning
- Method: Defines ways to decompose a compound task
- TaskDecomposition: Hierarchical relationship between tasks
- TaskDependency: Non-hierarchical dependencies between tasks
- CrossBoundaryReference: References that span compressed subgraph boundaries
- WorldState: Representation of world states during planning
- Plan: Solution to a planning problem
- Conversation: AI-guided planning conversation
Behaviors
- HierarchicalCompression: Manages compression/expansion of subgraphs
- AIGuidedPlanning: Controls the AI-driven planning conversation
- GraphStateManagement: Manages persistence and history of graph state
User Interface
- ThreeColumnLayout: Main application layout with three panels
- AIChat: Left column for conversation with AI
- DirectedGraph: Middle column for graph visualization
- TaskList: Right column for hierarchical task view
Development
Code Style
This project follows the official Dart style guide and uses the recommended Flutter lints.
Building
Build for web deployment:
flutter build web
Acknowledgments
- This project is based on HTN planning techniques for complex domain modeling
- The UI/UX design is inspired by modern graph visualization tools