Using Grit with Claude

I want to build a [PROJECT NAME] using the Grit framework.

Grit is a full-stack meta-framework that uses:
- Go backend (Gin web framework + GORM ORM)
- Next.js frontend (React + App Router + TypeScript)
- Admin panel (resource-based, Filament-like)
- Monorepo with shared types and validation (Zod)
- Docker for infrastructure (PostgreSQL, Redis, MinIO)

Here's what I want to build:
[DESCRIBE YOUR PROJECT IN DETAIL]

Please create these 3 files for me:

1. project-description.md — Full project spec with all models, their
   fields (use Grit field types: string, text, int, uint, float, bool,
   datetime, date, slug, belongs_to, many_to_many), relationships,
   user roles, and features.

2. claude-code-prompt.md — Step-by-step instructions that I'll give
   to Claude Code (AI coding agent). Include exact grit CLI commands
   to run in order. Use `grit generate resource <Name> --fields "..."`
   syntax.

3. project-phases.md — A phased build plan with checkboxes. Phase 1:
   scaffold + core models. Phase 2: relationships + complex features.
   Phase 3: frontend customization + polish.

I want to build a Job Board using the Grit framework.

Grit is a full-stack meta-framework that uses:
- Go backend (Gin web framework + GORM ORM)
- Next.js frontend (React + App Router + TypeScript)
- Admin panel (resource-based, Filament-like)
- Monorepo with shared types and validation (Zod)
- Docker for infrastructure (PostgreSQL, Redis, MinIO)

Here's what I want to build:
A job board where companies can post job listings and
candidates can browse and apply. Companies have profiles
with a name, logo, website, and description. Jobs have a
title, description, location, salary range (min and max),
job type (full-time, part-time, contract, remote), and
a category. Applications track which user applied to which
job, with a cover letter and resume URL. There should be
an admin panel for managing all resources, and a public
frontend for browsing published jobs.

User roles: ADMIN (manages everything), EMPLOYER (posts
jobs for their company), USER (browses and applies).

Please create these 3 files for me:

1. project-description.md
2. claude-code-prompt.md
3. project-phases.md

# Grit Framework — AI Skill Context

> Give this file to any AI coding assistant to teach it how to work with your Grit project.

## What is Grit?

Grit is a full-stack framework: Go (Gin + GORM) backend + Next.js (React + TypeScript) frontend in a monorepo.

## CLI Commands

grit new <name>                    # Scaffold full project
grit new <name> --api              # API only
grit generate resource <Name> --fields "field:type,..."  # Full-stack CRUD
grit remove resource <Name>        # Remove a resource
grit sync                          # Sync Go types → TypeScript
grit migrate                       # Run GORM AutoMigrate
grit seed                          # Seed database
grit add role <ROLE>               # Add a new role

## Field Types

string, text, int, uint, float, bool, datetime, date, slug
belongs_to (e.g., category:belongs_to)
many_to_many (e.g., tags:many_to_many:Tag)

## Project Structure

project/
├── apps/api/           # Go backend (Gin + GORM)
│   ├── cmd/server/     # Entry point
│   └── internal/       # models, handlers, services, middleware, routes
├── apps/web/           # Next.js frontend
├── apps/admin/         # Admin panel (resource-based)
├── packages/shared/    # Zod schemas, TS types, constants
└── docker-compose.yml  # PostgreSQL, Redis, MinIO, Mailhog

## Conventions

- Go models: PascalCase structs with gorm/json/binding tags
- API responses: { "data": ..., "meta": { "total", "page", "page_size", "pages" } }
- Errors: { "error": { "code": "...", "message": "..." } }
- TS files: kebab-case (use-users.ts, api-client.ts)
- Routes: plural, lowercase (/api/users, /api/posts)
- Validation: Zod schemas in packages/shared/schemas/
- Data fetching: React Query hooks (useQuery, useMutation)
- Styling: Tailwind CSS + shadcn/ui, dark theme default
- Admin: defineResource() API with DataTable, FormBuilder, widgets

## Code Generation Markers (DO NOT REMOVE)

// grit:models, /* grit:studio */, // grit:handlers, // grit:routes:protected,
// grit:routes:admin, // grit:routes:custom, // grit:schemas, // grit:types,
// grit:api-routes, // grit:resources, // grit:resource-list

## How to Build with Grit

1. grit new myapp && cd myapp && docker compose up -d
2. grit generate resource <Name> --fields "..." for each model
3. cd apps/api && air (hot reload)
4. cd apps/admin && pnpm install && pnpm dev
5. Customize handlers, add business logic, build frontend pages

I want to build a [PROJECT NAME] using the Grit framework.

Grit is a full-stack meta-framework that uses:
- Go backend (Gin web framework + GORM ORM)
- Next.js frontend (React + App Router + TypeScript)
- Admin panel (resource-based, Filament-like)
- Monorepo with shared types and validation (Zod)
- Docker for infrastructure (PostgreSQL, Redis, MinIO)

Here's what I want to build:
[DESCRIBE YOUR PROJECT IN DETAIL]

Please create these 3 files for me:

1. project-description.md — Full project spec with all models, their
   fields (use Grit field types: string, text, int, uint, float, bool,
   datetime, date, slug, belongs_to, many_to_many), relationships,
   user roles, and features.

2. claude-code-prompt.md — Step-by-step instructions that I'll give
   to Claude Code (AI coding agent). Include exact grit CLI commands
   to run in order. Use `grit generate resource <Name> --fields "..."`
   syntax.

3. project-phases.md — A phased build plan with checkboxes. Phase 1:
   scaffold + core models. Phase 2: relationships + complex features.
   Phase 3: frontend customization + polish.