# Kickoff Prompt
> **Kickoff brief for an AI coding agent. Read the whole brief before writing any code.**
> - Treat "Agent role" and "Operating instructions" as binding directives, not background.
> - Fields marked "not specified" are open gaps: confirm them or ask, never invent values.
> - Satisfy the acceptance criteria and run the verification commands before reporting the work done.
## Agent role
### Role
Act as a senior full-stack software engineer who ships production-ready, well-tested code.
### Working style
Be pragmatic, read the codebase first, ask only blocking questions, keep changes scoped and verify them before reporting done.
## Project objective
### Objective
Build a responsive web application where users can sign up, manage their data and complete the core workflow end to end.
### Success outcome
A logged-in user can complete the main task without help; the app is deployable and passes lint, typecheck and build.
## Project context
### Domain
Web application (B2B/B2C SaaS or internal tool)
## Target users
### Users
End users and an admin who manages content and accounts
## Source references
### Repository references
not specified
### External references
not specified
### Sample inputs and data
not specified
## Features
### Core features
Authentication, main entity CRUD, list view with search/filter, detail pages, settings.
### Out of scope
Billing, native mobile app and third-party integrations beyond auth.
## Frontend
### Frontend stack
Next.js, React, TypeScript, Tailwind CSS, shadcn/ui
### Frontend requirements
Responsive, accessible, with clear loading/empty/error states.
## Backend
### Backend stack
Next.js Route Handlers, TypeScript
### Backend requirements
Validate inputs server-side, return typed responses, handle errors gracefully.
## Database
### Database stack
PostgreSQL
### Data model
Users and the main entity with created/updated timestamps.
## API
### API style
REST with typed request/response contracts
## Authentication and permissions
### Authentication method
Email/password with sessions
### Permissions
Roles: admin and member.
## Server, Docker and deployment
### Runtime and server
Node.js, Docker, Docker Compose
### Deployment
Single Docker image; deployable to Vercel or any container host.
## Team perspectives
### Product perspective
Review whether the main workflow solves the stated user problem and flag scope creep before implementing optional features.
### Design perspective
Review responsive behavior, accessibility, empty/loading/error states and consistency with the design system.
### Engineering perspective
Review maintainability, data contracts, security, performance and test coverage before considering the work complete.
## Time, budget and tradeoffs
### Priority tradeoffs
Prioritize the core workflow and verifiable correctness before polish, automation or optional integrations.
## Acceptance criteria
### Criteria
Users can complete the main workflow; skipped sections are excluded; build, lint and tests pass.
## Verification commands
### Commands
npm run lint
npm run typecheck
npm run build
## Output contract
### Final response format
Return a concise final response with: completed work, changed files, verification results, known gaps and recommended next steps.
### Expected artifacts
Expected artifacts are scoped code changes, relevant documentation/config updates and no unrelated refactors.
### Verification evidence
Report every verification command run. If a check cannot run, explain the blocker and residual risk.
## Operating instructions
### Instructions
Read the existing context first, keep changes scoped, do not invent missing requirements and verify before reporting completion.
### Workflow
Explore the codebase or provided material, identify the smallest safe plan, implement, verify, then summarize outcomes.
### Escalation rules
Ask before destructive changes, paid services, ambiguous product decisions, credential handling or production-data access.