Files
documenso/.opencode/commands/create-scratch.md
T
Lucas Smith 960217c78d build: migrate from npm to pnpm with workspace catalogs
- 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
2026-03-06 14:28:12 +11:00

1.7 KiB

description, argument-hint
description argument-hint
Create a new scratch file in .agents/scratches/ <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:

pnpm exec tsx scripts/create-scratch.ts "$ARGUMENTS" "Your scratch content here"

Option 2: Multi-line Content (Heredoc)

For multi-line content, use heredoc:

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:

echo "Your content" | pnpm exec tsx scripts/create-scratch.ts "$ARGUMENTS"

File Format

The created file will have:

---
date: 2026-01-13
title: Scratch Title
---

Your content here

The title is automatically formatted from the slug (e.g., quick-notesQuick 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.