epic-harness AGENTS.md

epic-harness

25 skills (9 pipeline + 16 quality) + self-evolving agent harness.

Structure

• skills/ — 25 skills + _dispatch router + _critic reviewer
• registry/ — Seeding resources (embedded in Rust binary at compile time)
  • presets/ — Cold-start skill templates
  • rules/ — Seeded host rule files
  • scripts/install.js — Plugin bootstrap (SessionStart)
• src/ — Rust crate; single binary (epic-harness)
  • src/hooks/ — Ring 0 automation (guard, polish, observe, resume, snapshot, reflect)
  • src/evolve/ — Ring 3 evolution loop
• docs/ — User-facing documentation and assets
  • architecture.md, quickstart.md, demo/, references/, specs/
• integrations/common/ — HARNESS.md embedded into the binary (include_str!), self-seeded to ~/.harness/HARNESS.md

Architecture: 4-Ring Model

• Ring 0 (Autopilot): Hooks auto-maintain quality, restore sessions, learn
• Ring 1 (Pipeline): 9 skills that orchestrate multi-step workflows (discover → spec → go → audit → eval → ship, orbit, evolve, team)
• Ring 2 (Quality Gates): 17 skills that auto-trigger on context signals (tdd, debug, secure, threat-model, vuln-scan, triage, verify, etc.)
• Ring 3 (Evolve): Observe → Analyze → Evolve → Gate → Reload self-improvement loop

/orbit — Autonomous Pipeline

Single-command spec-to-PR execution with three entry modes.

flowchart TD
    START["/orbit"] --> MODE{"requirement?"}
    MODE -->|"unclear"| WAIT["Interactive\nUser runs /discover → /spec"]
    MODE -->|"clear + complex"| COUNCIL["Council\n4-Voice Auto-spec"]
    MODE -->|"clear + simple"| DIRECT["Direct\nAuto-spec"]
    WAIT --> SPEC["Load Approved Spec"]
    COUNCIL --> SPEC
    DIRECT --> SPEC
    SPEC --> GO["Go Phase\nPlan → Execute → Integrate"]
    GO --> CHECK["Check Phase\nReview + Audit + Test"]
    CHECK -->|"PASS"| SHIP["Ship Phase\nIsolated Test → PR → CI"]
    CHECK -->|"WARN"| SHIP
    CHECK -->|"FAIL"| RETRY{"retry < 3?"}
    RETRY -->|Yes| FIX["Go Fix\nTarget fixes from action items"]
    FIX --> CHECK
    RETRY -->|No| PAUSE["Pause — User decides"]
    PAUSE -->|continue| FIX
    PAUSE -->|abort| ABORT["Abort"]
    SHIP --> EVOLVE["Evolve\nAuto-analyze session"]
    EVOLVE --> DONE["Orbit Complete\nConsolidated Report"]