Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,20 +39,24 @@ Deploy to production:
pnpm run deploy:trigger-prod
```

## Agent

Sandbox tasks use **[Claude Code](https://claude.ai/code)** as the AI agent. The Claude Code CLI is installed into Vercel Sandboxes and configured to route through the **Vercel AI Gateway** for model access. Prompts are executed via the Claude Code agent, which autonomously performs coding tasks, manages files, and interacts with GitHub.
Comment on lines +42 to +44
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Check if AGENTS.md exists and verify link validity

# Check for AGENTS.md file
echo "=== Checking for AGENTS.md ==="
fd -t f '^AGENTS\.md$'

# Test Claude Code link
echo -e "\n=== Testing Claude Code link ==="
curl -I -L -s -o /dev/null -w "%{http_code}" https://claude.ai/code

Repository: recoupable/tasks

Length of output: 138


🌐 Web query:

Is https://claude.ai/code a valid URL for Claude Code documentation?

💡 Result:

https://claude.ai/code may be a real Claude/Anthropic route (it’s referenced in some repo tooling as the place Claude looks for “guidance” files), but it is not the canonical/public Claude Code documentation URL. [3]

The official Claude Code docs are hosted on Anthropic/Claude documentation sites, e.g.:

  • https://docs.anthropic.com/en/docs/claude-code/overview [1]
  • https://docs.claude.com/en/docs/claude-code/guide [2]

Move Agent documentation to AGENTS.md and update documentation link.

Agent implementations should be documented in AGENTS.md (not README.md). Additionally, the Claude Code reference link https://claude.ai/code returns 403 and is not the official documentation URL. Use the official Anthropic documentation instead: https://docs.anthropic.com/en/docs/claude-code/overview.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 42 - 44, Move the "Agent" section out of README.md
into a new or existing AGENTS.md file and update the documentation link: replace
the Claude Code URL in the moved section with the official Anthropic
documentation URL "https://docs.anthropic.com/en/docs/claude-code/overview";
then add a short pointer in README.md linking to AGENTS.md (e.g., "See AGENTS.md
for agent implementations and docs") so references to the agent are preserved.


## Tasks

| Task | ID | Trigger | Description |
|------|----|---------|-------------|
| `customerPromptTask` | `customer-prompt-task` | Dynamic schedule | Runs a customer-configured prompt on a schedule, fetching task config and generating a chat response. |
| `proArtistSocialProfilesScrape` | `pro-artist-social-profiles-scrape` | Cron (daily midnight ET) | Scrapes and updates social profiles for all pro-tier artists. |
| `sendPulsesTask` | `send-pulses-task` | Schedule | Generates and sends daily Pulse email digests with artist insights, social stats, and connected-app context. |
| `runSandboxCommandTask` | `run-sandbox-command` | On-demand (schema) | Connects to a Vercel Sandbox, installs Claude Code with Vercel AI Gateway, runs a prompt via Claude Code, snapshots the result, and pushes to GitHub. |
| `runSandboxCommandTask` | `run-sandbox-command` | On-demand (schema) | Connects to a Vercel Sandbox, installs the Claude Code CLI with Vercel AI Gateway, runs a prompt via the Claude Code agent, snapshots the result, and pushes to GitHub. |

## Project Structure

- `src/tasks/` - Task definitions (see table above)
- `src/recoup/` - Recoup API client functions
- `src/sandboxes/` - Vercel Sandbox helpers (Claude Code install, config, GitHub push, snapshots)
- `src/sandboxes/` - Vercel Sandbox helpers (Claude Code CLI install, Claude Code agent config, GitHub push, snapshots)
- `src/github/` - GitHub repo creation and utilities
- `src/chats/` - Chat room helpers
- `src/pulse/` - Pulse email formatting
Expand Down
Loading