evaluator-driven-agent-flow
CLAUDE.md1 starsChanged 10 months agoMITView on GitHub
This file is auto-generated by /setup command. Do not edit manually - run /setup again to change preferences. Current Settings: When implementing features, fixing bugs, or making changes, automatically follow this workflow: Triggered by natural language requests for implementation work (no need to say "EDAF") Detailed workflows: .claude/skills/edaf-orchestration/PHASE{1-7}-*.md For each phase: This feedback loop is EDAF's core quality mechanism. Artifacts by Phase: - Phase 1: .steering/{date}-{feature}/idea.md (requirements) - Phase 2: .steering/{date}-{feature}/design.md (technical design) - Phase 3: .steering/{date}-{feature}/tasks.md (task plan) -…
In this repository5 other files it gives its agents.
- edaf-evaluationSkill
- edaf-orchestrationSkill
- review-standardsSkill
- setupSkill
- ui-verificationSkill
The file
We split this CLAUDE.md into the rules it gives an agent
6 rules. About 0 are common, 3 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 6
Do not edit manually - run /setup again to change preferences.
- Distinctive: line 46
Read evaluator reports for specific feedback
- Distinctive: line 74
Read evaluator report for specific feedback
- Distinctive: line 80
UI verification required: if frontend modified (Phase 5)
- Very specific: line 112
Workers: Follow project coding standards in .claude/skills/
- Very specific: line 114
All agents: Read detailed phase instructions in .claude/skills/edaf-orchestration/
≈ “Common” is an estimate: at least 1 in 5 of the 26,980 CLAUDE.md 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.
Files
EDAF v1.0 - Claude Code Configuration
Language Preferences
This file is auto-generated by /setup command.
Do not edit manually - run /setup again to change preferences.
Current Settings:
- Documentation Language: English
- Terminal Output Language: English
- Save Dual Language Docs: No
EDAF 7-Phase Gate System
When implementing features, fixing bugs, or making changes, automatically follow this workflow:
Triggered by natural language requests for implementation work (no need to say "EDAF") Detailed workflows:
.claude/skills/edaf-orchestration/PHASE{1-7}-*.md
Quick Reference
| Phase | Agent | Evaluators | Pass Criteria |
| 1. Requirements | requirements-gatherer | 7 | All ≥ 8.0/10 |
| 2. Design | designer | 7 | All ≥ 8.0/10 |
| 3. Planning | planner | 7 | All ≥ 8.0/10 |
| 4. Implementation | 4 workers | 1 quality-gate | 10.0 (lint+tests) |
| 5. Code Review | - | 8 + UI | All ≥ 8.0/10 |
| 6. Documentation | documentation-worker | 5 | All ≥ 8.0/10 |
| 7. Deployment | - | 5 | All ≥ 8.0/10 |
EDAF Execution Pattern
For each phase:
- Execute → Run agent/worker to generate artifact
- Evaluate → Run ALL evaluators in parallel (use Task tool)
- Check results:
- ✅ ALL pass (≥ threshold) → Proceed to next phase
- ❌ ANY fail (< threshold) → Feedback loop:
- Read evaluator reports for specific feedback
- Revise artifact based on feedback
- Re-run ALL evaluators (not just failed ones)
- Repeat until ALL pass (unlimited iterations)
This feedback loop is EDAF's core quality mechanism.
Artifacts by Phase:
- Phase 1:
.steering/{date}-{feature}/idea.md(requirements) - Phase 2:
.steering/{date}-{feature}/design.md(technical design) - Phase 3:
.steering/{date}-{feature}/tasks.md(task plan) - Phase 4: Source code (implementation)
- Phase 5:
.steering/{date}-{feature}/reports/(evaluation reports) - Phase 6:
docs/(permanent documentation updates) - Phase 7: Deployment configs
Permanent Documentation (docs/):
product-requirements.md,functional-design.md,development-guidelines.mdrepository-structure.md,architecture.md,glossary.md
Critical Rules
- NEVER skip phases
- ALWAYS run evaluators in parallel (use Task tool)
- ALWAYS iterate until ALL evaluators pass (no exceptions)
- IF any evaluator fails:
- Read evaluator report for specific feedback
- Revise artifact based on feedback
- Re-run ALL evaluators (not just failed ones)
- Repeat until ALL pass (unlimited iterations)
- Phase 1 is mandatory for new features (requirements gathering)
- Phase 4 quality-gate is ultra-strict (10.0 = zero lint errors/warnings + all tests pass)
- UI verification required if frontend modified (Phase 5)
Component Discovery
All components are auto-discovered from file system. No manual listing needed.
Locations:
- Agents:
.claude/agents/*.md+.claude/agents/workers/*.md - Evaluators:
.claude/agents/evaluators/phase{1-7}-*/*.md - Skills:
.claude/skills/*/SKILL.md(coding standards, workflows, user-invocable commands like/setup,/review-standards) - Config:
.claude/edaf-config.yml,.claude/agent-models.yml
Component Count:
- 9 Agents (requirements-gatherer, designer, planner, 4 workers, documentation-worker, ui-verification-worker)
- 40 Evaluators (7 per phase for phases 1-3,6; 8 for phase 5; 1 for phase 4; 5 for phase 7)
- Total: 49 components
Phase 5 Note: Includes
standards-compliance-evaluatoras an independent gate for project coding standards.
Instructions for Claude Code
Terminal Output Language
Respond in ENGLISH for all output.
Documentation Language
Generate documentation in ENGLISH.
Agent Behavior
- Workers: Follow project coding standards in
.claude/skills/ - Evaluators: Output in terminal language, generate reports in documentation language
- All agents: Read detailed phase instructions in
.claude/skills/edaf-orchestration/
Setup
For initial project setup, see README.md for /setup command instructions.
Last Updated: Auto-generated by /setup command
Configuration: .claude/edaf-config.yml
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
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.

