Quick Start Guide 5 minutes

Conduct is a unified CLI for screenplay analysis, coverage generation, and production workflow management. This guide will get you analyzing your first screenplay in under 5 minutes.

1. Installation

1Clone and Build

Download and install Conduct from source.

# Clone the repository
git clone https://github.com/AGI-Tooling/Orchestrator.git
cd Conduct

# Build and install to ~/bin (no sudo required)
make install

# Or install globally (requires sudo)
make install-global
Installation Options

make install installs to ~/bin (user-level), while make install-global installs to /usr/local/bin (system-wide). Ensure your PATH includes the installation directory.

2. Verify Installation

2Test the Installation

Confirm that Conduct is properly installed and available.

# Check version (both commands work)
conduct --version
conduct --version

# View available commands
conduct --help

You should see the version number and help information confirming successful installation.

3. Your First Screenplay Analysis

3Analyze a Screenplay

Generate professional coverage using the industry-standard 16-point rubric.

Generate Full Coverage Report

# Create complete coverage analysis in HTML format
conduct coverage full screenplay.pdf --output-format html --output report.html

# Or generate JSON output for programmatic use
conduct coverage full screenplay.pdf --output-format json --output report.json

Analyze Individual Elements

You can also analyze specific rubric items individually:

# Generate a compelling logline
conduct coverage logline screenplay.pdf

# Analyze story structure
conduct coverage structure screenplay.pdf

# Evaluate character development
conduct coverage characters screenplay.pdf

# Assess dialogue quality
conduct coverage dialogue screenplay.pdf
First Analysis Complete

You've just generated professional screenplay coverage using AI-powered analysis. The report includes scores, recommendations, and actionable insights based on industry standards.

4. Most Common Commands

conduct coverage full [screenplay]
Generate complete 16-point coverage analysis with scores and recommendations
conduct coverage logline [screenplay]
Create a professional logline that captures the essence of the story
conduct coverage structure [screenplay]
Analyze narrative structure, pacing, and story progression
conduct coverage characters [screenplay]
Evaluate character development, arcs, and relationships
conduct architect plan [model]
View deployment plan for AI model on GPU infrastructure
conduct screenplays list
View all screenplays in your library with metadata
conduct docs
Launch embedded documentation server in your browser

5. Next Steps

Explore the Coverage System

Learn about the comprehensive 16-point rubric used for professional screenplay evaluation:

Advanced Features

Feature Command Description
Model Deployment architect serve Deploy AI models on GPU infrastructure
Fine-Tuning producer train Customize models with LoRA adapters
GPU Management lambda status Monitor Lambda Labs GPU clusters
Experiments experiment run Run multi-model analysis experiments
Library Management screenplays import Import and organize screenplay collections

Interactive Walkthrough

Complete Analysis Workflow

Here's a complete workflow for analyzing a screenplay from start to finish:

# 1. Import screenplay into library
conduct screenplays import screenplay.pdf --title "My Screenplay" --author "Jane Smith"

# 2. Generate full coverage analysis
conduct coverage full screenplay.pdf --output-format html --output coverage.html

# 3. Open the report in your browser
open coverage.html

# 4. Get quick individual insights
conduct coverage logline screenplay.pdf
conduct coverage hook screenplay.pdf
conduct coverage marketability screenplay.pdf
Model Requirements

Coverage analysis requires a configured AI model. Use conduct architect list to view available models, or conduct architect serve [model] to deploy one.

Get Help

Every command has detailed help available:

# General help
conduct --help

# Command-specific help
conduct coverage --help
conduct architect --help

# Subcommand help
conduct coverage full --help

Additional Resources

Need More Help?

Visit the main documentation for comprehensive guides, or run conduct docs to browse the embedded documentation locally.