git404hub

what is evidence-first-agent-workflow fr?

sontaeksu/evidence-first-agent-workflow — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

A governance framework that forces AI coding agents through a five step verification process, using automated checks instead of trusting the agent's own claim that a task passed.

vibe map

mindmap
  root((repo))
    What it does
      Governance for AI agents
      Five stage Gate process
      Deterministic verification
    Tech stack
      Python tools
      Playwright tests
      Git hooks
    Use cases
      Long lived coding projects
      Closed network teams
      Small model workflows
    Audience
      Developers
      Coding agent builders
    Enforcement
      Commit time gate
      CI job checks
      Sanitization gate

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Set up a governance workflow that keeps an AI coding agent honest with verified checks instead of self reported passes.

VIBE 2

Track a long running coding project across sessions using a current state, a history log, and a temporary worklog.

VIBE 3

Add a stack specific rule pack, for example for React with ASP.NET Core, so the agent has accurate references to follow.

VIBE 4

Enforce commit rules automatically so unfinished or unverified work cannot be merged.

what's the stack?

PythonPlaywrightGit

how it stacks up fr

sontaeksu/evidence-first-agent-workflow0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires reading the stack readiness docs and supplying stack specific inputs before use.

Use freely for any purpose, including commercial and closed source use, as long as you keep the copyright notice.

in plain english

Evidence-First Agent Workflow is a governance system for AI coding agents, built for situations where verified facts matter more than guesses: small models, closed networks, long lived projects, and stacks where correctness counts more than speed. The project is currently in an alpha stage, and the author is inviting public feedback rather than claiming the system works perfectly on its own. The project has two parts. A generic core manages memory, routes context to the right place, and forces every task through a five stage process: Analysis, Task, Todo and Micro-Verify, Checklist, and Verification. If a step fails, the agent has to go back and redo it rather than move forward. The second part is a stack pack, a set of facts and rules specific to whatever tech stack is being used, for example React with ASP.NET Core, since the generic core cannot invent things like which SDK version is supported or what the internal conventions are. The repository tracks project state through a few files: a current state, a history of past changes, and a temporary worklog for work still in progress. This keeps an AI agent's context accurate across long sessions instead of relying on it remembering everything on its own. A core idea in the project is that a model saying a task passed is not proof by itself. Instead, the workflow relies on deterministic checks: validating the stack setup, checking that code changes match documentation, scanning build logs, and comparing rendered screens against reference images for visual correctness. It also checks color contrast and runs browser based end to end tests using Playwright. The tool works alongside several existing AI coding assistants, including Codex, Roo Code, Zoo Code, Cline, and Claude Code, connecting them to the same shared instructions file rather than requiring separate setup for each. The rules are enforced through automated checks at commit time and in continuous integration, not by simply asking the agent to follow instructions. It is released under the MIT License, so it can be used freely, including for commercial and closed source projects, as long as the copyright notice stays intact.

prompts (copy fr)

prompt 1
Help me set up the Evidence-First Agent Workflow's Portable Code Agent Kit for my project.
prompt 2
Walk me through the five stage Gate process, Analysis, Task, Todo, Checklist, and Verification, using this workflow.
prompt 3
Check whether my stack pack meets the Stack Input Requirements described in this repo.
prompt 4
Show me how to install the commit time enforcement hooks using install-hooks.sh.

Frequently asked questions

what is evidence-first-agent-workflow fr?

A governance framework that forces AI coding agents through a five step verification process, using automated checks instead of trusting the agent's own claim that a task passed.

What language is evidence-first-agent-workflow written in?

Mainly Python. The stack also includes Python, Playwright, Git.

What license does evidence-first-agent-workflow use?

Use freely for any purpose, including commercial and closed source use, as long as you keep the copyright notice.

How hard is evidence-first-agent-workflow to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is evidence-first-agent-workflow for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.