| name | create-scratch |
| description | Create a new scratch file in .agents/scratches/ |
You are creating a new scratch file in the .agents/scratches/ directory.
Your Task
- Determine the slug - Based on the conversation context and intent, determine an appropriate file slug (kebab-case recommended). Ask the user if unclear.
- Gather content - Collect or generate the scratch content from the discussion
- 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:
bun scripts/create-scratch.ts "<slug>" "Your scratch content here"
Option 2: Multi-line Content (Heredoc)
For multi-line content, use heredoc:
bun scripts/create-scratch.ts "<slug>" << HEREDOC
Your multi-line
scratch content
goes here
HEREDOC
Option 3: Pipe Content
You can also pipe content:
echo "Your content" | bun scripts/create-scratch.ts "<slug>"
File Format
The created file will have:
