Quick start

This walkthrough gets a basic workflow running with the current schema and the default copilot-cli harness.

1. Open the FlightPath panel

Command Palette → FlightPath: Open FlightPath Panel

2. Create a workflow file

Create hello.flightpath.yaml in your workspace:

harness: copilot-cli
model: claude-sonnet-4.5

steps:
  - name: inspect
    prompt: |
      Review @README.md and summarize what this project does,
      who it is for, and what looks incomplete.

  - name: propose
    resumeSession: true
    prompt: |
      Based on the summary, propose the three most valuable
      next improvements for the project.

3. Load it into the panel

Use one of these entry points:

• FlightPath: Load in FlightPath from the file context menu
• FlightPath: Select Prompt File from the panel
• FlightPath: Run with FlightPath if you want to load and start in one step

4. Run the workflow

Click Run in the panel. FlightPath sends the first step to the active harness, waits for completion, stores the runtime metadata, and then advances to the next step.

5. Add validation when you are ready

Once the basic workflow works, add an end condition so the harness has to satisfy a real project check:

steps:
  - name: fix-tests
    prompt: Fix the failing tests in @src/
    endCondition:
      script: npm test
      returns: "0"
      compareSource: exitCode
      maxRetries: 2
      retryPrompt: |
        Tests are still failing.
        stdout:
        {stdout}

        stderr:
        {stderr}

        Fix the remaining issues.

Next steps

• Learn the building blocks in Core concepts
• See a fuller example in Your first workflow
• Look up schema fields in Workflow schema reference