AI agents that respect your codebase

$ forge setup

Analyzing project structure...

Stack:      NestJS 10.x
Architecture: Clean Architecture
Layers:
  ├─ domain/       (entities, value objects)
  ├─ application/  (use cases, ports)
  └─ infrastructure/ (adapters, repos)
Database:   PostgreSQL 15 + TypeORM
CI/CD:      GitHub Actions (3 workflows)
Testing:    Jest + Supertest

→ 12 dev-skills generated
→ 24 quality patterns applied
→ Naming conventions: camelCase (code),
  kebab-case (files), PascalCase (classes)

✨ Project ready.

⚠ HALT: AI is skipping input validation
  on UserCreateDTO.

  Rule: All DTOs require class-validator
  decorators per quality-gates.md

  Detected: No validation on 'email',
  'name', 'password' fields.

  Action: Adding validators...

  ✓ Fixed:
    @IsEmail()     email: string
    @MinLength(2)  name: string
    @IsStrongPassword() password: string

  ✓ Validation gate passed.

Phase 0: Context
  ├─ Read specifications
  ├─ Load dev-skills
  └─ ✅ Context ready

Phase 1: Contracts
  ├─ Define types and interfaces
  ├─ Plan module boundaries
  └─ ✅ Contracts approved

Phase 2: Implement
  ├─ Build within contracts
  ├─ Agent self-review
  └─ ✅ Implementation clean

Phase 3: Verify
  ├─ Run generated tests
  ├─ 12/12 passing ✅
  └─ ✅ Task complete

// checkout.spec.ts

describe('US-3: Order Confirmation', () => {

  // AC: US-3.AC-1
  it('creates order with valid items
      and shipping address', async () => {
    const order = await checkout(validCart);
    expect(order.status).toBe('confirmed');
    expect(order.items).toHaveLength(3);
  });

  // AC: US-3.AC-2
  it('sends confirmation email within
      5 minutes', async () => {
    await checkout(validCart);
    const email = await getLastEmail(user);
    expect(email.subject).toContain('Order');
    expect(email.sentWithin).toBeLessThan(300);
  });

  // UX: loading-2
  it('shows spinner during payment
      processing', async () => {
    const { getByRole } = render(<Checkout />);
    fireEvent.click(getByRole('button'));
    expect(getByRole('progressbar')).toBeVisible();
  });
});