mirror of
https://github.com/documenso/documenso.git
synced 2026-07-12 22:15:01 +10:00
Lucas Smith
960217c78d
- Switch package manager to pnpm 10 via corepack - Add pnpm-workspace.yaml with 54+ shared dependency catalogs - Convert all workspace packages to catalog: and workspace:* protocols - Upgrade Turborepo from 1.x to 2.8.12 (pipeline -> tasks) - Upgrade apps/openpage-api from Next 15 to Next 16 - Update Docker, CI workflows, and GitHub Actions for pnpm - Convert patch file to pnpm native format - Replace deprecated next lint with standalone eslint - Update all documentation references from npm to pnpm - Fix stale dependabot config and documentation paths
77 lines
1.7 KiB
Markdown
77 lines
1.7 KiB
Markdown
---
|
|
description: Create a new scratch file in .agents/scratches/
|
|
argument-hint: <scratch-slug> [content]
|
|
---
|
|
|
|
You are creating a new scratch file in the `.agents/scratches/` directory.
|
|
|
|
## Your Task
|
|
|
|
1. **Determine the slug** - Use `$ARGUMENTS` as the file slug (kebab-case recommended)
|
|
2. **Gather content** - Collect or generate the scratch content
|
|
3. **Create the file** - Use the create-scratch script to generate the file
|
|
|
|
## Usage
|
|
|
|
The script will automatically:
|
|
|
|
- Generate a unique three-word ID (e.g., `calm-teal-cloud`)
|
|
- Create frontmatter with current date and formatted title
|
|
- Save the file as `{id}-{slug}.md` in `.agents/scratches/`
|
|
|
|
## Creating the File
|
|
|
|
### Option 1: Direct Content
|
|
|
|
If you have the content ready, run:
|
|
|
|
```bash
|
|
pnpm exec tsx scripts/create-scratch.ts "$ARGUMENTS" "Your scratch content here"
|
|
```
|
|
|
|
### Option 2: Multi-line Content (Heredoc)
|
|
|
|
For multi-line content, use heredoc:
|
|
|
|
```bash
|
|
pnpm exec tsx scripts/create-scratch.ts "$ARGUMENTS" << HEREDOC
|
|
Your multi-line
|
|
scratch content
|
|
goes here
|
|
HEREDOC
|
|
```
|
|
|
|
### Option 3: Pipe Content
|
|
|
|
You can also pipe content:
|
|
|
|
```bash
|
|
echo "Your content" | pnpm exec tsx scripts/create-scratch.ts "$ARGUMENTS"
|
|
```
|
|
|
|
## File Format
|
|
|
|
The created file will have:
|
|
|
|
```markdown
|
|
---
|
|
date: 2026-01-13
|
|
title: Scratch Title
|
|
---
|
|
|
|
Your content here
|
|
```
|
|
|
|
The title is automatically formatted from the slug (e.g., `quick-notes` → `Quick Notes`).
|
|
|
|
## Guidelines
|
|
|
|
- Use descriptive slugs in kebab-case (e.g., `exploration-ideas`, `temporary-notes`)
|
|
- Scratch files are for temporary notes, explorations, or ideas
|
|
- The unique ID ensures no filename conflicts
|
|
- Files are automatically dated for organization
|
|
|
|
## Begin
|
|
|
|
Create a scratch file using the slug from `$ARGUMENTS` and appropriate content for notes or exploration.
|