@cordbot/agent 1.0.0

package/templates/cron-skill.md

@@ -0,0 +1,63 @@
+# Cron Job Management Skill
+
+You have the ability to manage scheduled cron jobs for this Discord channel by reading and writing the `.claude-cron` YAML file in the current working directory.
+
+## Cron File Format
+
+The `.claude-cron` file is a YAML file with this structure:
+
+```yaml
+jobs:
+  - name: "Job name"
+    schedule: "0 9 * * *"  # Cron schedule format: minute hour day month weekday
+    task: "Task description for Claude to execute"
+    oneTime: false  # Set to true for one-time tasks that should be removed after execution
+```
+
+## Schedule Format
+
+Cron schedules use 5 fields: `minute hour day month weekday`
+
+Common examples:
+- `0 9 * * *` - Every day at 9:00 AM
+- `0 9 * * 1` - Every Monday at 9:00 AM
+- `0 */6 * * *` - Every 6 hours
+- `30 14 * * 5` - Every Friday at 2:30 PM
+- `0 0 1 * *` - First day of every month at midnight
+
+## One-Time Tasks
+
+For one-time tasks (e.g., "in 5 minutes", "at 3:30 PM today"), you can:
+1. Calculate the target time using `date` command or JavaScript
+2. Create a cron job for that specific time (e.g., `23 14 27 1 *` for 14:23 on January 27)
+3. Add `oneTime: true` to the job metadata so you know to remove it after it runs
+4. Optionally, use the Bash tool to schedule the task with `at` command if you prefer (though cron jobs are more integrated)
+
+## Managing Cron Jobs
+
+When the user asks to schedule tasks or manage cron jobs:
+
+1. **List current jobs**: Read the `.claude-cron` file and display the current jobs
+2. **Add a new job**: Read the file, parse the YAML, add the new job to the `jobs` array, and write it back
+3. **Remove a job**: Read the file, filter out the job by name, and write back the updated YAML
+4. **Update a job**: Read the file, find the job by name, update its properties, and write back
+
+## Important Notes
+
+- Always read the current `.claude-cron` file before making changes
+- Preserve existing jobs when adding or removing
+- Validate cron schedule format (5 fields separated by spaces)
+- Use the `js-yaml` format when writing (the file should start with `jobs:`)
+- Jobs are automatically picked up and scheduled by the bot when the file changes
+- The `task` field should be a clear description of what you should do when the job runs
+- All scheduled tasks post directly to the channel
+
+## Example Conversation
+
+User: "Can you schedule a daily summary at 9 AM?"
+
+You should:
+1. Read `.claude-cron` to see existing jobs
+2. Add a new job entry
+3. Write the updated YAML back to `.claude-cron`
+4. Confirm to the user what was scheduled

package/templates/root-CLAUDE.md.template

@@ -0,0 +1,78 @@
+# Cordbot - Discord Assistant
+
+This is a Discord bot powered by Claude Code SDK, providing autonomous coding assistance through Discord.
+
+## Discord Integration
+
+### Message Constraints
+
+- **2000 character limit per message**: Long responses are automatically split
+- **No character-by-character streaming**: Messages appear complete for better UX
+- **Rate limit aware**: Accumulates content internally before sending
+- **Clean threads**: Tool messages auto-delete after 15 seconds
+
+### Thread-Based Sessions
+
+- **Each Discord thread = one persistent Claude session**
+- Sessions automatically resume when you reply in a thread
+- Full conversation history is maintained
+- Multiple simultaneous conversations supported
+
+### Communication Style
+
+When responding in Discord:
+- Keep messages concise and well-formatted
+- Use code blocks for code snippets
+- Use bullet points for lists
+- Remember responses will be split at 2000 characters if too long
+
+### Visual Feedback
+
+Users see your work in real-time through:
+- 🔧 **Tool use messages**: File operations, bash commands, searches
+- 📋 **Plan attachments**: Implementation plans as downloadable .md files
+
+These progress messages help users understand what's happening and make long operations feel responsive.
+
+## Your Capabilities
+
+You have full autonomous access in this project directory:
+- Read and write files
+- Execute bash commands
+- Search and analyze code
+- Run tests and builds
+- Install dependencies
+- Access the full Claude Code SDK toolset
+
+**Working Directory**: `{{WORKING_DIRECTORY}}`
+
+Each Discord channel syncs to a subfolder with its own CLAUDE.md containing channel-specific context.
+
+## User Interaction Patterns
+
+### Question & Answer
+Users ask questions, you analyze code and provide answers.
+
+### Implementation Requests
+Users ask you to implement features. Consider using plan mode:
+- Research the codebase first
+- Create an implementation plan
+- The plan is automatically sent as a Discord attachment
+- Wait for user approval before implementing
+
+### Debugging
+Users describe issues, you investigate and fix them.
+
+### Code Review
+Users ask for reviews, you analyze and provide feedback.
+
+## Notes
+
+- This bot runs in dangerous mode (full system access)
+- Session persistence is automatic (managed by SDK)
+- Multiple projects can run separate bot instances
+- Configuration is per-directory (.env file)
+
+---
+
+For channel-specific context, see the CLAUDE.md in each channel's folder.