agentleFS
Tsuchiya2Tsuchiya2/evaluator-driven-agent-flow/.claude/CLAUDE.md

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) -…

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
  1. Very specific:

    Do not edit manually - run /setup again to change preferences.

    line 6
  2. Distinctive:

    Read evaluator reports for specific feedback

    line 46
  3. Distinctive:

    Read evaluator report for specific feedback

    line 74
  4. Distinctive:

    UI verification required: if frontend modified (Phase 5)

    line 80
  5. Very specific:

    Workers: Follow project coding standards in .claude/skills/

    line 112
  6. Very specific:

    All agents: Read detailed phase instructions in .claude/skills/edaf-orchestration/

    line 114

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
CLAUDE.md

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

PhaseAgentEvaluatorsPass Criteria
1. Requirementsrequirements-gatherer7All ≥ 8.0/10
2. Designdesigner7All ≥ 8.0/10
3. Planningplanner7All ≥ 8.0/10
4. Implementation4 workers1 quality-gate10.0 (lint+tests)
5. Code Review-8 + UIAll ≥ 8.0/10
6. Documentationdocumentation-worker5All ≥ 8.0/10
7. Deployment-5All ≥ 8.0/10

EDAF Execution Pattern

For each phase:

  1. Execute → Run agent/worker to generate artifact
  2. Evaluate → Run ALL evaluators in parallel (use Task tool)
  3. Check results:
    • ✅ ALL pass (≥ threshold) → Proceed to next phase
    • ❌ ANY fail (< threshold) → Feedback loop:
      1. Read evaluator reports for specific feedback
      2. Revise artifact based on feedback
      3. Re-run ALL evaluators (not just failed ones)
      4. 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.md
  • repository-structure.md, architecture.md, glossary.md

Critical Rules

  1. NEVER skip phases
  2. ALWAYS run evaluators in parallel (use Task tool)
  3. ALWAYS iterate until ALL evaluators pass (no exceptions)
  4. 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)
  5. Phase 1 is mandatory for new features (requirements gathering)
  6. Phase 4 quality-gate is ultra-strict (10.0 = zero lint errors/warnings + all tests pass)
  7. 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-evaluator as 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

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.