Skip to content

ai-run-task-fast-path.md

Latest commit

 

History

History
64 lines (46 loc) · 1.37 KB

ai-run-task-fast-path.md

File metadata and controls

64 lines (46 loc) · 1.37 KB

AI Run Task Fast Path

Goal: let AI add a run task in one edit, return a runnable f ... command, and optionally push.

Prompt Contract

make public task <doc-path.md> <thing>
make internal task <doc-path.md> <thing>

<doc-path.md> is implementation context. Do not edit docs unless asked.

File Targeting

  • Public: ~/run/flow.toml
  • Internal shared: ~/run/i/flow.toml
  • Internal project (only if project is explicitly requested): ~/run/i/<project>/flow.toml

Fast Rules

  • Read only:
    • <doc-path.md>
    • target flow.toml
  • Edit one flow.toml file.
  • Add one [[tasks]] block unless user asks for multiple.
  • Required fields: name, description, command.
  • Add interactive = true only for prompts/TUI.
  • Use "$@" passthrough when args should flow through.
  • Keep shell idempotent and non-destructive.

Required AI Reply Format

Changed:
- /abs/path/to/flow.toml

Run:
f <r|ri|rip ...> <task-name> [args]

Share:
cd <repo> && git add <flow.toml> && git commit -m "add <task-name>" && git push

Shortcut map:

  • Public -> f r <task>
  • Internal shared -> f ri <task>
  • Internal project -> f rip <project> <task>

Push Confidence Gate

Include Share command only when all are true:

  • single-file flow.toml change
  • no secrets
  • no destructive commands
  • no uncertain behavior

Otherwise:

Share:
skip (manual review)