agentleFS
MetaKnown publisherfacebookresearch/autoform-bot/skills/debrief-orchestrator/SKILL.md

debrief-orchestrator

Skill136 starsChanged 19 days agoMITView on GitHub

Once a Setup, Roadmap, or Formalize run is over, record what got in the way: friction from the user's local setup, kept apart from friction with AutoformBot itself, and draft an AutoformBot issue from the latter for the user to review and send. On by default; `AUTOFORM_DEBRIEF=0` turns it off.

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 0 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Run autoform debrief orchestrator form <PROJECT> --skill setup|roadmap|formalize, naming the skill that ran (see the CLI reference).

    line 21
  2. Very specific:

    When the answer reports friction with AutoformBot, record writes a draft issue for facebookresearch/autoform-bot outside the working tree …

    line 30

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Debrief a finished run

The agent that led the run debriefs once, after its final validation and before its final report. Subagents do not run this skill; fold the AutoformBot friction they reported to you into your own answer.

There is no autoform on PATH in a Lean project. Run it from <PROJECT> as uv run --project "<AUTOFORM_PLUGIN_ROOT>" autoform, where the root is the absolute plugin directory holding skills/, pyproject.toml, and autoform_cli/; give a subagent that prefix, with the root filled in.

Run autoform debrief orchestrator form <PROJECT> --skill setup|roadmap|formalize, naming the skill that ran (see the CLI reference). If it says orchestrator debriefs are disabled, stop: there is nothing to do.

Otherwise answer the form from your experience of the run and store the answer with autoform debrief orchestrator record <PROJECT> --skill <SKILL>, from --answer FILE or standard input. If record rejects it, correct and resubmit.

When the answer reports friction with AutoformBot, record writes a draft issue for facebookresearch/autoform-bot outside the working tree and prints its absolute path. The user does not see command output, so end your final report with the draft as a Markdown link to the whole path, exactly as printed and in angle brackets; the draft usually lives under .git, which editors hide: [Draft AutoformBot issue](</home/me/proj/.git/autoform/debriefs/issues/RUN_ID.md>). Say that nothing was sent and that the link at the bottom of the draft opens the issue form pre-filled with the recorded draft, so edits belong in the form; if record says the draft is too long for a link, say instead that the link fills in only the title. Do not paste that link. Never submit the issue yourself, with gh or otherwise: the user reviews it, edits it, and sends it. The draft is only as private as your answer, so leave project-specific content out of it.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.