docs: add PROMPT.md — master prompt for production full-stack app generation#2
docs: add PROMPT.md — master prompt for production full-stack app generation#2
Conversation
Co-authored-by: SMSDAO <[email protected]>
SMSDAO
left a comment
SMSDAO
left a comment
There was a problem hiding this comment.
Description
This PR adds a master prompt for generating production-ready full-stack applications with Next.js 14+, Node.js 20+, and PostgreSQL. The prompt enforces strict implementation rules and includes:
- 🔐 Complete authentication & authorization
- 👑 Multi-role dashboards (Admin/Dev/User)
- 🌐 Web3 integration with smart contract deployment
- 🤖 AI agent swarm architecture
- 🎨 Flash neo glow effects
- 🗑️ Auto dead code elimination
- 🚀 Production deployment ready
Key Features
- Zero Placeholders: Every function fully implemented
- Auto-Resolve: Built-in conflict resolution
- Multi-Chain Web3: Deploy to any blockchain
- Dynamic UI: Menu/Content builders from admin
- Production Stabilizers: Health checks, monitoring, auto-scaling
Technical Stack
- Node.js 20+, Next.js 14+ (App Router), React 18+
- PostgreSQL + Prisma ORM
- TypeScript (strict mode)
- TailwindCSS + Framer Motion
- RainbowKit v2 + Wagmi v2 (Web3)
- Docker + Kubernetes ready
Testing Instructions
- Copy the prompt from
PROMPT.md - Feed to any AI agent
- Verify generated app meets all checklist items:
- Full auth working
- Admin dashboard functional
- Database connected
- Web3 features (if detected)
- No placeholders/mock data
Checklist
- Prompt enforces complete implementation
- All security best practices included
- Production monitoring configured
- CI/CD pipeline defined
- Documentation generated
- No TODOs or placeholders allowed
Additional Notes
This prompt solves the "fix one thing breaks another" problem by enforcing complete, error-free implementations with auto-resolve mechanisms and dead code elimination.
There was a problem hiding this comment.
Pull request overview
Adds a root-level “master prompt” document intended to be used with AI coding agents for scaffolding production-ready full-stack apps, and links it from the README for discoverability.
Changes:
- Added
PROMPT.mdcontaining the full builder prompt content (including CSS and Prisma snippets). - Updated
README.mdwith a new “Master Prompt” section linking toPROMPT.md.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
README.md |
Adds a short section pointing readers to the new master prompt doc. |
PROMPT.md |
Introduces the master prompt content (architecture rules, optional Web3/agents, UI effects, and base schema). |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
PROMPT.md
Outdated
| @@ -0,0 +1,349 @@ | |||
| # 🚀 COMPLETE FULL-STACK PRODUCTION APP BUILDER PROMPT | |||
|
|
|||
| ```markdown | |||
There was a problem hiding this comment.
The outer fenced block starts with markdown, but the prompt text later contains inner css / ```prisma fences. This will prematurely close the outer block and break rendering/copy/paste. Use a longer outer fence (e.g., markdown … ) or escape/indent the inner fences so the entire prompt remains a single contiguous block.
| ```markdown | |
| ````markdown |
PROMPT.md
Outdated
| sessions Session[] | ||
| accounts Account[] | ||
| contentEntries ContentEntry[] | ||
| contracts Contract[] |
There was a problem hiding this comment.
The Prisma schema snippet is not self-contained: User references Session[] and Account[], but those models aren’t defined in this block. As-is, copying this into schema.prisma will fail validation/generation. Either include the Auth.js/NextAuth Prisma models in the snippet or remove those fields and add a note pointing to the official schema.
| sessions Session[] | |
| accounts Account[] | |
| contentEntries ContentEntry[] | |
| contracts Contract[] | |
| // For Auth.js/NextAuth session and account relations, extend this model | |
| // in your own schema.prisma using the official adapter schema: | |
| // https://authjs.dev/reference/adapter/prisma | |
| // Add any app-specific relations (e.g. ContentEntry[], Contract[]) once | |
| // those models are defined in your full schema. |
| model Menu { | ||
| id String @id @default(cuid()) | ||
| name String | ||
| path String @unique | ||
| icon String? | ||
| parentId String? @map("parent_id") | ||
| parent Menu? @relation("MenuToMenu", fields: [parentId], references: [id]) | ||
| children Menu[] @relation("MenuToMenu") | ||
| permissions Permission[] | ||
| order Int @default(0) |
There was a problem hiding this comment.
In the Prisma schema snippet, Menu.permissions Permission[] has no opposite relation field on Permission (e.g., menus Menu[]) and no explicit @relation configuration. Prisma will error on a missing opposite relation field. Add the inverse field (and optionally name the relation) so the schema validates.
| ## 📋 Master Prompt | ||
|
|
||
| See [`PROMPT.md`](./PROMPT.md) for the master prompt used to generate production-ready full-stack applications with this stack. Feed it to any AI coding agent to scaffold a complete, working implementation. | ||
|
|
There was a problem hiding this comment.
This README section says the master prompt generates apps “with this stack”, but the repo’s documented architecture is Astro+Vite (public), Angular (admin), and a one-file Node backend, while PROMPT.md specifies Next.js/Turborepo/NextAuth. To avoid misleading readers, either adjust the README phrasing (e.g., “a reference prompt for scaffolding full-stack apps”) or align the prompt’s stated stack with this repository’s stack.
|
@copilot apply changes based on the comments in this thread |
…eview Co-authored-by: SMSDAO <[email protected]> Agent-Logs-Url: https://github.com/CastQuest/SocialAi/sessions/22353300-c994-450f-9a1a-233749170410
Applied all four review suggestions in commit
|
Adds the master AI prompt document requested by maintainers for scaffolding production-ready full-stack applications with this repo's stack.
Changes
PROMPT.md(new) — Root-level doc containing the full builder prompt verbatim. Covers mandatory implementation rules, Web3 auto-detection, RBAC dashboards, Flash Neo Glow effects, dead code elimination, Turborepo project structure, CI/CD, and a base Prisma schema.README.md— Added a short "📋 Master Prompt" section linking toPROMPT.md.Corrections applied during review
The Prisma schema block in the prompt had structural issues that would cause
prisma generateto fail; fixed before committing:Roleenum (USER | ADMIN | DEVELOPER)contentEntries ContentEntry[]andcontracts Contract[]back-relations onUsernpm run dev→pnpm devto match the declared package managerOriginal prompt
Add a new documentation file containing the provided master prompt for generating production-ready full-stack applications.
Goal
Create a pull request against
maininCastQuest/SocialAithat adds the user's supplied prompt content verbatim in a markdown file, with a concise repository-appropriate placement and any minimal supporting documentation needed so the prompt is easy to find and use.Required changes
PROMPT.mdat the repository root unless the existing repo structure strongly suggests a better docs location.README.mdpointing maintainers to the new prompt file, but only if that is a natural fit for the repository.Constraints
main.Deliverable
Open a pull request with the new prompt file committed to a branch off
main, using a clear title and a short PR description summarizing that this adds the master prompt document.The following is the prior conversation context from the user's chat exploration (may be truncated):
User: You are an expert full-stack Web3/full-app developer using the absolute latest stable versions as of March 2026. Build a COMPLETE, production-ready, error-free full-stack application from scratch based on the following detailed specification. Use Next.js 15+ (App Router only, with server actions, partial prerendering, React 19 support), TypeScript, Node.js 20+, Tailwind CSS + shadcn/ui or similar for components. Apply modern best practices: audited dependencies only, no deprecated packages, strict type safety, ESLint + Prettier + Biome/Turbo enforced, Turbopack in dev where possible.
Project name: CastQuest Platform (or customize to user's repo name if provided).
Core features:
This pull request was created from Copilot chat.
💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.