Examples
Real-world PromptScript configuration examples.
Choose by Goal
Start Here
| Goal | Example |
|---|---|
| Compile first project | Minimal |
| Roll out a production service | Real-Life Checkout Service |
| Adopt existing instructions | Migration Guide |
| Upgrade PromptScript 1.15 | Upgrade 1.15 to 1.16 |
Understand Language
| Goal | Example |
|---|---|
| Resolve composition step by step | Composition and Order |
| Choose additive or replacement operation | Merge vs Replace |
| Fix canonical block shape warnings | Fix Block Shape Warnings |
| Customize generated section titles | Custom Section Headers |
Automate Agents
| Goal | Example |
|---|---|
| Define portable lifecycle policy | Portable Hooks |
| Move legacy Factory hooks safely | Migrate Factory Hooks |
| Combine skills, agents, MCP, hooks, and workflows | Agent Platform |
| Define specialized workers | Agents |
Build Applications
| Goal | Example |
|---|---|
| Compile prompts for an application to JSON | Application Prompts |
Scale Organization
| Goal | Example |
|---|---|
| Share team configuration | Team Setup |
| Govern organization-wide configuration | Enterprise |
| Pin remote sources | Git Registry |
| Package reusable capabilities | Skills and Local Memory |
Complete Examples
Real-Life Checkout Service
End-to-end production rollout with composition, native agents, safe takeover, CI drift checks, and rollback.
Minimal
The simplest possible PromptScript configuration - just the essentials.
Team Setup
Multi-project setup with shared team configuration and standards.
Enterprise
Full enterprise deployment with governance, private registries, and compliance.
Skills & Local
Advanced AI skills and private local memory for specialized workflows.
Agent Platform
Runnable examples for MCP, hooks, workflows, plugins, field replacement, skills, and build profiles.
Application Prompts
Four prompts for applications with typed inputs, enum outputs, defaults, and citations, compiled to content-hashed JSON bundles.
Agents
Define portable AI subagents with custom tools, models, skills, and MCP access.
Git Registry
Use Git repositories as shared registries with version control and authentication.
Quick Examples
Basic Project
@meta { id: "my-project" syntax: "1.5.0"}
@identity { """ You are a helpful coding assistant. """}
@shortcuts { "/help": "Show available commands"}React Project
@meta { id: "react-app" syntax: "1.5.0"}
@identity { """ You are a React expert specializing in modern TypeScript applications. """}
@context { framework: "React 18" language: "TypeScript" styling: "TailwindCSS" testing: "Vitest + Testing Library"}
@standards { code: [ "Use functional components with hooks", "React Query for server state, Zustand for client", "Use Tailwind utility classes for styling" ]}
@shortcuts { "/component": "Create a new React component" "/hook": "Create a custom hook" "/test": "Write component tests"}API Service
@meta { id: "api-service" syntax: "1.5.0"}
@identity { """ You are a backend expert building RESTful APIs with Node.js. """}
@context { runtime: "Node.js 20" framework: "Express" database: "PostgreSQL" orm: "Prisma"}
@standards { api: [ "Use URL path versioning", "Document with OpenAPI 3.0", "Use JWT for authentication" ]
database: [ "Use migrations for schema changes", "Use transactions for multi-step operations" ]}
@restrictions { - "Never expose internal errors to clients" - "Always validate request body" - "Never store plain-text passwords"}
@shortcuts { "/endpoint": "Design a new API endpoint" "/migration": "Create a database migration" "/test": "Write API tests"}Configuration Examples
Basic Config
id: basic-examplesyntax: '1.5.0'
input: entry: .promptscript/project.prs
targets: - githubFull Config (Local Registry)
id: local-registry-examplesyntax: '1.5.0'
input: entry: .promptscript/project.prs include: - '.promptscript/**/*.prs'
registry: path: ./registry
targets: - github: output: .github/copilot-instructions.md - claude: output: CLAUDE.md - cursor: output: .cursor/rules/project.mdc
watch: debounce: 300Full Config (Git Registry)
id: git-registry-examplesyntax: '1.5.0'
input: entry: .promptscript/project.prs
registry: git: url: https://github.com/your-org/promptscript-registry.git ref: v1.0.0 auth: type: token tokenEnvVar: GITHUB_TOKEN cache: enabled: true ttl: 3600000
targets: - github - claude - cursor