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

1. Clone the repository:

   git clone https://github.com/yourusername/sequence_flow.git
   cd sequence_flow
   

2. Install dependencies:

   flutter pub get
   

3. 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