turbo_promptable

Object-Oriented Prompting framework for the turbo ecosystem. Define AI agent prompts, roles, workflows, and tools as type-safe Dart objects that serialize to JSON, YAML, Markdown, and XML.

Features

• Type-safe workspace models: Role, Persona, Workflow, Step, Activity, Instruction, Input, Output, Goal, Issue, Context, Template, Tool, and more
• Spec models: Ability, Feature, Requirement, Scenario, Journey, Task, Module, Mockup, Prototype
• Tool models: Api, Cli, Script, Mcp, together with ToolCommand, ToolParameter, and ToolParameterOption for declarative command schemas
• Spawnable abstraction (TSpawnable) with CLI tool and prompt-delivery enums for launching agents against Claude Code, Cursor, Windsurf, and others
• Cross-referencing abstracts (OfAbilities, OfFeatures, OfIssues, OfJourneys, OfMockups, OfModules, OfPrds, OfProjects, OfPrototypes, OfScenarios) for composing specs
• JSON serialization on every model via json_serializable; YAML, Markdown, and XML output inherited from turbo_serializable
• Structured metadata (TMetaData) on every promptable

Installation

dependencies:
  turbo_promptable: ^0.4.0

Usage

import 'package:turbo_promptable/turbo_promptable.dart';

const workflow = Workflow(
  name: 'Review Workflow',
  steps: [
    Step(
      name: 'Analyse',
      input: Input(name: 'Source Code'),
      instructions: 'Analyse the provided source code for quality issues.',
      output: Output(
        name: 'Analysis Report',
        schema: 'markdown',
      ),
    ),
  ],
);

const role = Role(
  name: 'Code Reviewer',
  expertise: 'Static analysis and code quality',
  workflows: [workflow],
);

const persona = Persona(
  name: 'Code Reviewer',
  expertise: 'Static analysis and code quality',
  workflows: [workflow],
  identity: 'A meticulous reviewer focused on maintainability.',
);

print(persona.toJson());

Core Concepts

TPromptable

Every workspace model extends TPromptable, which itself extends TSerializable from turbo_serializable. Models have:

• name — required identifier
• metaData — optional TMetaData for frontmatter (description, tags, etc.) on models that declare it

Roles and Personas

• Role — a spawnable capability bundle with expertise, activities, checklists, instructions, templates, tools, and workflows
• Persona — a Role augmented with an identity string that describes the persona's character; construct via Persona(...) or Persona.fromRole(role: ..., identity: ...)

Workflows and Steps

A Workflow contains an ordered list of Steps. Each Step has a required Input, a string instructions field, and a required Output.

Specs

Spec models (Ability, Feature, Requirement, Scenario, Journey, Task, Module, Mockup, Prototype) describe intended behaviour and deliverables. They cross-reference each other via the Of* abstracts exported from workspace/abstracts/.

Tools

Tool subclasses (Api, Cli, Script, Mcp) extend the shared Tool base, which carries a list of ToolCommands. Each command declares its parameters via ToolParameter, and parameters can enumerate discrete ToolParameterOptions.

Spawnable

TSpawnable (used by Role and Persona) carries cliTool (TCliTool), command, and promptDelivery (TPromptDelivery) for orchestrating agent launches across tools like Claude Code, Cursor, Windsurf, and custom CLIs.

License

MIT