snwlee

Nereus

Name: Nereus
Author: snwlee

Testing community

SOURCE https://github.com/snwlee/Nereus

Description

An opinionated development harness for Claude Code — interview → spec → TDD build → parallel review → finish, with hooks that actually block.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

Nereus

An opinionated development harness for Claude Code.

Version

English · 한국어

Interview first. Spec before code. TDD enforced by hooks. Three reviewers in parallel. Hand off before the context window fills.

Install

/plugin marketplace add snwlee/Nereus
/plugin install nereus@nereus
/nereus:setup

Requires Node 20+ and Git. `setup` detects the external tools, installs what you approve, and writes the config file.

Flow

flowchart LR
    I[intake
interview] -->|ambiguity ≤ 0.2| S[spec
tasks + done criteria]
    S --> B[build
RED → GREEN → REFACTOR]
    B -->|tests pass| E{"[flow] tasks?"}
    E -->|yes| Q[e2e]
    E -->|no| R
    Q -->|pass| R[review
OCR · Codex · Gemini]
    R -->|CRITICAL/HIGH = 0| F[finish
commit · archive · handoff]
    R -->|findings| B

    subgraph Baton [Baton — context handoff]
        direction LR
        W[50% warn:
finish current task] --> H[write handoff.md
commit · stop]
        H --> N[/clear
auto-resumes]
    end

    B -. context ≥ 50% .-> W
    N -. continues at same stage .-> B

Each stage calls the next when its gate passes. Day to day you only type `/nereus:intake`.