Skip to main content
← back to extensions

External Reviewer

@atalanta/external-reviewerv2026.06.27.1· 1d agoWORKFLOWSSKILLS
01README

External, independent adversarial review for swamp software factories. Tool-neutral: any CLI coding agent (codex, claude, gemini, ...) can play the reviewer.

This is a composition, not a fork. It bridges two existing extensions:

  • @swamp/software-factory — the generic SDLC state machine (untouched).
  • @mgreten/cli-agent — invokes external CLI coding agents and parses output.

The factory driver implements; a SEPARATE agent reviews. The two never share a context, so the review is genuinely adversarial. The factory already exposes the seam (mode: workflow review stages); this bundle carries the bridge.

Contents

  • external-review-findings — run an external agent as the adversarial reviewer over a factory work item; persists findings JSON for the driver to record via resolve_findings.
  • external-review-plan-author — run an external agent to author/revise a plan payload from swamp records; persists it for the driver to record via record_artifact.
  • external-reviewer (skill) — scaffolds a fresh repo: prints a runbook to pull the dependencies, create the reviewer model instance, and drop a generic, language-agnostic factory skeleton wired to the bridge workflows.

Use

swamp extension pull @atalanta/external-reviewer
# then invoke the bundled `external-reviewer` skill and follow the runbook
02Workflows2
@atalanta/external-reviewer/external-review-findings49aad5eb-89b1-454c-a2fd-ebb50f1c4b21

Run an independent external CLI agent as the adversarial reviewer for a @swamp/software-factory review stage. The reviewer reads the work products and prior records from swamp itself and returns findings JSON. The parsed findings are persisted on the cli-agent invocation resource (tagged with factory, workItem, and artifact); the factory driver reads them from swamp data and records them via resolve_findings. Tool-neutral generalization of slack-firehose's codex-factory-findings-review.

reviewInvoke the external reviewer and persist its parsed findings on the cli-agent invocation resource.
1.invoke-reviewer${{ inputs.reviewerModel }}.invokeAndParse— Run the external reviewer agent and parse the returned findings JSON.
@atalanta/external-reviewer/external-review-plan-author71858827-3139-4bc4-aef3-67e7a2c9419d

Run an independent external CLI agent as the plan author for a @swamp/software-factory planning stage. The agent reads the prior plan and any review findings from swamp itself and returns a revised plan payload JSON. The parsed payload is persisted on the cli-agent invocation resource (tagged with factory, workItem, and artifact); the factory driver reads it from swamp data and records it via record_artifact. Tool-neutral generalization of slack-firehose's codex-factory-plan-author.

authorInvoke the external agent and persist its parsed plan payload on the cli-agent invocation resource.
1.invoke-author${{ inputs.reviewerModel }}.invokeAndParse— Run the external agent and parse the returned plan payload JSON.
03Skills1
external-reviewer2 files
04Stats
A
100 / 100
Downloads
0
Archive size
10.0 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
Repository
https://github.com/Atalanta/swamp-external-reviewer
05Platforms
06Labels
#software-factory#adversarial-review#cli-agent