AGENTS.md is a project-level configuration file that provides AI coding assistants with complete project context, development principles, and operational guidelines. It follows the agents.md standard and works across Claude, Cursor, GitHub Copilot, and other AI tools.

What is Jimmy's Workflow?

Jimmy's Workflow is a four-phase validation system (PRE-FLIGHT, IMPLEMENT, VALIDATE, CHECKPOINT) designed to prevent AI hallucination and ensure robust implementation. Each phase has specific gates and confidence levels (HIGH/MEDIUM/LOW) that determine when human review is needed.

How do I set up multiple AI instances as a team?

Assign each AI instance a role card with identity, responsibilities, personality traits, and success criteria. Use file-based handoff protocols for coordination. Personality orchestration at the system prompt level produces measurably better results than treating AI instances as generic tools.

Templates

Ydun AI Workflow provides six core template files. Together, they give AI assistants full project context, a validation workflow, and session continuity.

Core templates

Template	Lines	Purpose
AGENTS.md	~600+	Primary AI guidelines — principles, project context, documentation standards
CLAUDE.md	~125	Quick-reference commands and rules for Claude Code
JIMMYS-WORKFLOW.md	~870	Validation checkpoint system v2.1
STATUS.md	~100+	Phase tracking, session history, health indicators
NEXT-SESSION-START-HERE.md	~100+	Session orientation — what to do next
JIMMYS-WORKFLOW-TEMPLATE.md	~300	Shorter version for embedding in docs directories

Support files

File	Purpose
init-project.md	14-step initialization checklist
AGENTS-TEMPLATE-GUIDE.md	Detailed guide for filling every AGENTS.md section
DOCUMENTATION-STANDARDS.md	AI-optimized documentation principles (7 principles, anti-patterns, examples)

How they work together

AGENTS.md          ← AI reads this first (project context + principles)
  ↓
CLAUDE.md          ← Quick reference (commands, critical rules)
  ↓
JIMMYS-WORKFLOW.md ← Validation system (PRE-FLIGHT → VALIDATE → CHECKPOINT)
  ↓
STATUS.md          ← Where the project is (phases, health, decisions)
  ↓
NEXT-SESSION       ← What to do next (orientation for new sessions)

Minimum viable setup

You need at least AGENTS.md and CLAUDE.md. Everything else adds value but is optional.

Setup level	Files	Benefit
Minimum	AGENTS.md + CLAUDE.md	AI understands your project
Standard	+ JIMMYS-WORKFLOW.md	AI validates its own work
Full	+ STATUS.md + NEXT-SESSION	Session continuity across conversations

Template locations

All templates live in the templates/ directory:

templates/
├── core/                    # Core project files
│   ├── AGENTS.md.template
│   ├── CLAUDE.md.template
│   ├── JIMMYS-WORKFLOW.md
│   ├── JIMMYS-WORKFLOW-TEMPLATE.md
│   ├── STATUS.md.template
│   └── NEXT-SESSION-START-HERE.md.template
├── init/                    # Initialization guides
│   ├── init-project.md
│   └── AGENTS-TEMPLATE-GUIDE.md
├── docs/                    # Documentation standards
│   ├── DOCUMENTATION-STANDARDS.md
│   ├── AI-DRIVEN-SEO-BEST-PRACTICES.md
│   └── doc-components/
├── tech/                    # Tech-specific templates
│   ├── cardano/
│   └── solidity/
└── tools/                   # Shell scripts
    ├── audit-project.sh
    ├── check-version.sh
    └── sync-templates.sh