DevilsAdvocate

Multi-agent debate framework for fact-checking and bias detection with real-time streaming dual-perspective analysis

---

Quick Start

Prerequisites

• Node.js 18+ and npm (or pnpm)
• TypeScript 5+

Setup

1. Clone the repository

   cd C:\Users\cclem\Dropbox\Source\Projects-26\DevilsAdvocate

2. Install dependencies

   npm install

3. Configure environment

   Copy-Item .env.local.example .env.local
   # Edit .env.local with your values

4. Start development

   npm run dev

---

Project Structure

DevilsAdvocate/
├── .github/
│   └── copilot-instructions.md  # AI agent development rules
├── app/                          # Next.js App Router
│   ├── api/                      # API routes
│   ├── (features)/               # Feature route groups
│   └── layout.tsx                # Root layout
├── src/
│   ├── lib/                      # Core business logic
│   ├── components/               # React components
│   └── server/                   # Server-side utilities
├── public/                       # Static assets
├── CLAUDE.md                     # Claude Code agent guidance
├── .cursor/rules/critical.md    # Cursor IDE rules
├── .windsurf/rules/critical.md  # Windsurf IDE rules
├── .agent/rules/critical.md     # Generic agent rules
├── PDR.md                        # Project Design Record
└── README.md                     # This file

---

Key Files

• .github/copilot-instructions.md - Agent development rules and conventions
• CLAUDE.md - Agent guidance for Claude Code and direct Claude usage
• .cursor/rules/critical.md - Rules for Cursor IDE
• .windsurf/rules/critical.md - Rules for Windsurf IDE
• .agent/rules/critical.md - Rules for generic AI agents
• PDR.md - Project Design Record (architecture, design decisions)

---

Development Guidelines

• Follow workspace standards: Check .github/copilot-instructions.md
• Reference PDR.md: For architectural patterns and design decisions
• Create test pages: Use /tests/ directory for rapid iteration (app/tests/)
• Git checkpoints: Run git add .; git commit -m "checkpoint: before [change]" before major changes
• TypeScript: NEVER use any types - all types must be explicitly defined
• PowerShell: Use ; for command chaining, NEVER &&

---

Technologies

• Framework: next-js
• Language: TypeScript
• Database: TBD
• Services: openai,anthropic

---

Getting Help

1. Read .github/copilot-instructions.md for agent rules
2. Check PDR.md for architecture decisions
3. Review project-specific notes in code comments

---

Created: January 28, 2026
Framework: next-js
Status: Ready for development